Skip to content

✨ feat(deploy): 挂载简历快速预览入口 - #147

Merged
ZhaoXingPeng merged 1 commit into
mainfrom
feat/146-cv-preview
Sep 11, 2026
Merged

ZhaoXingPeng merged 1 commit into
mainfrom
feat/146-cv-preview

Conversation

@ZhaoXingPeng

Copy link
Copy Markdown
Owner

关联 Issue

Closes #146

结论

提供 https://www.babelflux.icu/cv 的 PDF 内联预览入口,个人简历不进入仓库。

实现与边界

  • 增加精确 /cv Nginx location 模板,固定 alias 到 /opt/babelflux/public/cv.pdf。
  • 设置 application/pdf 与 Content-Disposition: inline,不开放目录浏览。
  • 部署文档记录根域/www 配置、文件权限和回退方式。
  • 不改变 BabelFlux 前端、API、WebSocket 或数据卷。

实验记录

阶段:D0 设计
假设:固定路径的 Nginx alias 足以支持浏览器快速预览且不会影响其他路由。
环境:现有 Ubuntu 22.04 + Nginx TLS server。
输入:用户授权的单个 PDF 文件。
结果:模板仅匹配精确 /cv,回退只需移除 location。
结论:接受。

验证

  • git diff --check:通过。
  • CI:由 GitHub Actions 验证。
  • 服务器发布后验证 /cv 的 HTTP 状态、MIME、内容长度和 PDF 签名。

风险与回退

简历是公开站点内容,文件权限设为 0644 以供 Nginx 读取;不记录或提交文件内容。回退时恢复 Nginx 备份并 reload。

背景:提供无需下载的浏览器简历预览地址。

变更:增加精确 /cv 的 Nginx location 模板并记录只读 PDF 部署边界。

验证:待 CI 与服务器发布后验证。

Refs #146
@ZhaoXingPeng
ZhaoXingPeng merged commit 142fdee into main Sep 11, 2026
3 checks passed
@ZhaoXingPeng
ZhaoXingPeng deleted the feat/146-cv-preview branch September 11, 2026 16:51
@ZhaoXingPeng

Copy link
Copy Markdown
Owner Author

阶段:D4 real
假设:精确 /cv Nginx alias 可在不影响既有站点路由的条件下内联提供授权 PDF。
环境:Ubuntu 22.04、Nginx TLS。
输入:用户授权的单页 PDF,1,756,510 bytes。
命令:nginx -t && reload;curl https://www.babelflux.icu/cv 和根域对照。
结果:www 与根域 /cv 均 200,Content-Type 为 application/pdf,Content-Disposition 为 inline,PDF 签名正确;www 根路径仍为 301,/devbrief/ 与 favicon 均为 200。
结论:发布通过。
限制:简历文件仅位于服务器固定路径,不提交仓库。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

✨ feat(deploy): 挂载简历快速预览入口

1 participant