<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>L3thargy-Blog</title><description>No description</description><link>https://www.l3thargy.cn/</link><templateTheme>Firefly</templateTheme><templateThemeVersion>6.16.9</templateThemeVersion><templateThemeUrl>https://github.com/CuteLeaf/Firefly</templateThemeUrl><lastBuildDate>2026年11月19日 20:19:06</lastBuildDate><item><title>我给我的博客做了一个后台</title><link>https://www.l3thargy.cn/posts/building-blog-admin/</link><guid isPermaLink="true">https://www.l3thargy.cn/posts/building-blog-admin/</guid><pubDate>Thu, 19 Nov 2026 19:33:11 GMT</pubDate><content:encoded>&lt;section&gt;&lt;h1&gt;从零给个人博客写一个管理后台：技术选型、一键启动与云端部署&lt;a href=&quot;#从零给个人博客写一个管理后台技术选型一键启动与云端部署&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h1&gt;&lt;blockquote&gt;&lt;p&gt;部署上线那天，后台登录正常、文章列表正常，唯独正文编辑区一片空白。
这篇文章记录了从选型到上线的全过程，以及四个真正花掉时间的坑。&lt;/p&gt;&lt;/blockquote&gt;&lt;section&gt;&lt;h2&gt;一、为什么自己写&lt;a href=&quot;#一为什么自己写&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;我的博客是纯 Markdown 驱动的静态站，文章就是服务器上的一个个 &lt;code&gt;.md&lt;/code&gt; 文件，发布靠 Git。市面上现成的后台，大多围绕 Cloudflare 全家桶设计——用 Pages 部署、用 D1 存数据，这套方案在国内访问不稳定，日常管理也别扭；剩下的基本都要绑定传统数据库，导出的内容还和我的目录结构对不上，改造成本比从零写还高。&lt;/p&gt;&lt;p&gt;说到底，我想要的是一个不依赖任何外部平台、数据始终留在自己服务器和 Git 仓库里的后台。&lt;/p&gt;&lt;p&gt;需求其实很收敛：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;文章、页面、项目的增删改查&lt;/li&gt;
&lt;li&gt;Markdown 编辑，支持图片上传&lt;/li&gt;
&lt;li&gt;一键 Git 提交发布&lt;/li&gt;
&lt;li&gt;首次访问的初始化引导和登录鉴权&lt;/li&gt;
&lt;li&gt;部署在我自己的服务器上，不依赖第三方&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;那就自己写。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;二、整体结构&lt;a href=&quot;#二整体结构&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;访客 ──HTTPS──▶ 腾讯云 EdgeOne（静态托管 + CDN）&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;&lt;span&gt;                  &lt;/span&gt;&lt;/span&gt;&lt;span&gt;└─ 博客构建产物（HTML / CSS / JS）&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;我 ──HTTPS──▶ admin.example.com&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;5&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;&lt;span&gt;                 &lt;/span&gt;&lt;/span&gt;&lt;span&gt;└─ 腾讯云轻量应用服务器&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;6&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;&lt;span&gt;                      &lt;/span&gt;&lt;/span&gt;&lt;span&gt;└─ Nginx ──▶ Fastify (127.0.0.1:5175)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;7&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;&lt;span&gt;                                     &lt;/span&gt;&lt;/span&gt;&lt;span&gt;├─ /admin/   管理前端（Vue SPA）&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;8&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;&lt;span&gt;                                     &lt;/span&gt;&lt;/span&gt;&lt;span&gt;├─ /api/     管理接口&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;9&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;&lt;span&gt;                                     &lt;/span&gt;&lt;/span&gt;&lt;span&gt;└─ 本地仓库    Markdown 文件 + Git 发布&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;实际部署是拆成两块的。博客本身是纯静态站，交给腾讯云 EdgeOne 托管：构建产物传上去就有 CDN 加速和自动 HTTPS，国内访问速度也稳。后台则需要一个能长期跑 Node 进程、读写本地文件的环境，所以放在一台腾讯云轻量应用服务器上，用独立的二级域名访问，Nginx 反代到 Fastify。&lt;/p&gt;&lt;p&gt;这样拆分的好处是互不打扰：博客出问题不影响后台发布，后台重启也不影响读者访问；管理端不暴露在主站域名下，攻击面更小；文章的源文件始终留在自己服务器的 Git 仓库里。&lt;/p&gt;&lt;p&gt;一个关键决定：&lt;strong&gt;前后端同源&lt;/strong&gt;。Fastify 同时提供 &lt;code&gt;/admin/&lt;/code&gt; 静态资源和 &lt;code&gt;/api/&lt;/code&gt; 接口，Nginx 只做一层反向代理。这样省掉了 CORS 配置，Cookie 也是天然的 SameSite，鉴权链路干净很多。&lt;/p&gt;&lt;p&gt;技术栈：&lt;/p&gt;

&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;层&lt;/th&gt;&lt;th&gt;选型&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;前端&lt;/td&gt;&lt;td&gt;Vue 3.5 + TypeScript + Vite 8 + Element Plus&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;编辑器&lt;/td&gt;&lt;td&gt;Vditor（Markdown，IR / 所见即所得 / 源码三模式）&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;后端&lt;/td&gt;&lt;td&gt;Fastify 5 + Zod 4&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;图片处理&lt;/td&gt;&lt;td&gt;sharp&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;工程&lt;/td&gt;&lt;td&gt;npm workspaces（web / server 两个包）&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;p&gt;前端构建的 &lt;code&gt;base&lt;/code&gt; 固定为 &lt;code&gt;/admin/&lt;/code&gt;，这样后台可以挂在独立域名的子路径下，静态资源和接口也天然同源。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;三、关键设计一：让人双击就能跑&lt;a href=&quot;#三关键设计一让人双击就能跑&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;这是我花时间最多、也最值得的一块。目标很朴素：拿到项目的人，双击 &lt;code&gt;start.bat&lt;/code&gt;（或执行 &lt;code&gt;./start.sh&lt;/code&gt;）就能用，不需要先看文档装环境。&lt;/p&gt;&lt;p&gt;脚本自动完成四件事：检测 Node.js ≥ 22、检测 Git、安装依赖并构建、检查端口后启动并打开浏览器。环境缺失时自动补：Node 从 npmmirror、华为云、清华、官方四个镜像依次尝试，并用 &lt;code&gt;SHASUMS256.txt&lt;/code&gt; 校验；Git 在 Windows 上装 PortableGit 到项目内的 &lt;code&gt;.runtime/git&lt;/code&gt;，Linux 走 apt / dnf / yum / apk / pacman。&lt;/p&gt;&lt;p&gt;坑基本都在 Windows 批处理上：文件必须 CRLF、消息只用 ASCII、流程用 &lt;code&gt;goto :label&lt;/code&gt; 组织；另外 &lt;code&gt;choice /C YN&lt;/code&gt; 之后 &lt;code&gt;if errorlevel 2&lt;/code&gt; 代表选了 N，和直觉相反。这些规则写进了 &lt;code&gt;.gitattributes&lt;/code&gt;：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;* text=auto&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;*.bat text eol=crlf&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;*.sh text eol=lf&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;四、关键设计二：构建与发布链路&lt;a href=&quot;#四关键设计二构建与发布链路&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;本地开发和生产部署是两条路径，中间需要一个稳定的交付物。&lt;/p&gt;&lt;p&gt;&lt;code&gt;build-release.mjs&lt;/code&gt; 负责产出一个自包含目录：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;release/firefly-admin-0.1.0/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;├── server/dist/          # 后端编译产物&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;├── web/dist/             # 前端构建产物（含 Vditor 静态资源）&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;├── scripts/              # 安装脚本&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;5&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;├── package.json          # 只含生产依赖&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;6&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;├── start.bat / start.sh&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;7&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;└── .env.example&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;build-upload.bat&lt;/code&gt; / &lt;code&gt;build-upload.sh&lt;/code&gt; 再把它打成 zip 方便上传。Windows 用系统自带的 &lt;code&gt;tar -a -c -f&lt;/code&gt;，Unix 用 &lt;code&gt;zip&lt;/code&gt;，不额外引入打包依赖。&lt;/p&gt;&lt;p&gt;这里有一个非常典型的坑：&lt;strong&gt;生产依赖边界&lt;/strong&gt;。&lt;/p&gt;&lt;p&gt;后台在服务器上启动时报：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;ERR_MODULE_NOT_FOUND: Cannot find package &apos;esbuild&apos;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;原因是 &lt;code&gt;esbuild&lt;/code&gt; 被放在了 &lt;code&gt;devDependencies&lt;/code&gt;，但服务端代码在运行时静态 &lt;code&gt;import&lt;/code&gt; 了它。本地 &lt;code&gt;npm install&lt;/code&gt; 会装全部依赖，一切正常；服务器执行 &lt;code&gt;npm install --omit=dev&lt;/code&gt; 之后，它就消失了。&lt;/p&gt;&lt;p&gt;修法只有一步——把它移进 &lt;code&gt;dependencies&lt;/code&gt;：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;&quot;dependencies&quot;&lt;/span&gt;&lt;span&gt;: {&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;  &lt;/span&gt;&lt;span&gt;&quot;esbuild&quot;&lt;/span&gt;&lt;span&gt;: &lt;/span&gt;&lt;span&gt;&quot;^0.28.2&quot;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;  &lt;/span&gt;&lt;span&gt;&quot;fastify&quot;&lt;/span&gt;&lt;span&gt;: &lt;/span&gt;&lt;span&gt;&quot;^5.12.8&quot;&lt;/span&gt;&lt;span&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;  &lt;/span&gt;&lt;span&gt;&quot;sharp&quot;&lt;/span&gt;&lt;span&gt;: &lt;/span&gt;&lt;span&gt;&quot;^0.35.5&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;5&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;但真正的经验是验证方式：&lt;strong&gt;不要只在开发环境验证部署包&lt;/strong&gt;。把 release 目录复制到临时目录，执行&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;install&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--omit=dev&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;node&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;server/dist/index.js&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;跑通才算完成。这个动作后来成了每次改依赖后的固定步骤。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;五、关键设计三：CSRF 与反向代理&lt;a href=&quot;#五关键设计三csrf-与反向代理&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;后台的写操作接口做了同源校验：取 &lt;code&gt;Origin&lt;/code&gt;（或 &lt;code&gt;Referer&lt;/code&gt;）里的 host，和请求头里的 &lt;code&gt;Host&lt;/code&gt; 严格比较，不一致直接 403。本地开发一切正常，部署到服务器、配好 HTTPS 之后，登录接口却稳定返回 403。&lt;/p&gt;&lt;p&gt;原因出在 Nginx 配置：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;proxy_set_header &lt;/span&gt;&lt;span&gt;Host $&lt;/span&gt;&lt;span&gt;host&lt;/span&gt;&lt;span&gt;:$&lt;/span&gt;&lt;span&gt;server_port&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;HTTPS 下 &lt;code&gt;$server_port&lt;/code&gt; 是 &lt;code&gt;443&lt;/code&gt;，后端收到的 &lt;code&gt;Host&lt;/code&gt; 是 &lt;code&gt;admin.example.com:443&lt;/code&gt;，而 &lt;code&gt;Origin&lt;/code&gt; 里的 host 没有端口，字符串自然不相等。改成原样透传：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;proxy_set_header &lt;/span&gt;&lt;span&gt;Host $&lt;/span&gt;&lt;span&gt;http_host&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;proxy_set_header &lt;/span&gt;&lt;span&gt;X-Real-IP $&lt;/span&gt;&lt;span&gt;remote_addr&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;proxy_set_header &lt;/span&gt;&lt;span&gt;X-Forwarded-For $&lt;/span&gt;&lt;span&gt;proxy_add_x_forwarded_for&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;proxy_set_header &lt;/span&gt;&lt;span&gt;X-Forwarded-Proto $&lt;/span&gt;&lt;span&gt;scheme&lt;/span&gt;&lt;span&gt;;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;$http_host&lt;/code&gt; 就是浏览器发来的原始 Host，带不带端口都与 &lt;code&gt;Origin&lt;/code&gt; 完全一致。注意也不要用 &lt;code&gt;$host&lt;/code&gt;——它在非标准端口访问时会丢端口，同样会踩坑。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;六、部署实录：EdgeOne + 轻量服务器&lt;a href=&quot;#六部署实录edgeone--轻量服务器&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;域名拆成两个：博客主站走 EdgeOne，后台用独立二级域名指向轻量应用服务器。两边的部署都很轻。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;博客主站&lt;/strong&gt;：本地构建出静态文件，上传到 EdgeOne 的静态托管，绑定主域名即可。CDN 加速、HTTPS 证书、缓存策略都由平台负责，服务器完全不用承担访问流量。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;后台服务&lt;/strong&gt;：轻量服务器上装宝塔面板，Node 项目指向后台目录，部署流程比想象中简单，但每一步都有细节。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;启动命令&lt;/strong&gt;：宝塔的 Node 项目默认启动方式可能解析不出命令，报 &lt;code&gt;nohup: failed to run command &apos;False&apos;&lt;/code&gt;。直接用自定义命令 &lt;code&gt;node server/dist/index.js&lt;/code&gt;，或者用 PM2 托管，都能解决。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;反向代理&lt;/strong&gt;：站点配置里把 &lt;code&gt;/&lt;/code&gt; 代理到 &lt;code&gt;127.0.0.1:5175&lt;/code&gt;，按上一节的四个 &lt;code&gt;proxy_set_header&lt;/code&gt; 配好。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;HTTPS&lt;/strong&gt;：证书部署本身没问题，但要注意两件事。一是云厂商安全组的 443 入站规则，二是宝塔防火墙的 443 放行——缺任何一个，浏览器都是 &lt;code&gt;ERR_CONNECTION_TIMED_OUT&lt;/code&gt;，和证书无关。判断方法很简单：&lt;code&gt;Test-NetConnection 域名 -Port 443&lt;/code&gt;，TCP 不通就是网络层，别去翻证书配置。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;环境变量&lt;/strong&gt;：&lt;code&gt;.env&lt;/code&gt; 在启动时自动加载，&lt;code&gt;PORT&lt;/code&gt;、&lt;code&gt;COOKIE_SECURE&lt;/code&gt; 这些都在里面。上了 HTTPS 之后记得把 &lt;code&gt;COOKIE_SECURE&lt;/code&gt; 打开。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;七、踩坑清单&lt;a href=&quot;#七踩坑清单&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;1. Vite 把静态资源当模块解析&lt;/strong&gt;&lt;/p&gt;&lt;p&gt;模板里直接写 &lt;code&gt;&amp;lt;img src=&quot;/admin/favicon.svg&quot;&amp;gt;&lt;/code&gt;，构建报 &lt;code&gt;Module not found&lt;/code&gt;。改用 &lt;code&gt;%BASE_URL%&lt;/code&gt; 和 &lt;code&gt;import.meta.env.BASE_URL&lt;/code&gt; 拼路径即可。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;2. devDependencies 里的运行时依赖&lt;/strong&gt;&lt;/p&gt;&lt;p&gt;见第四节。判断标准只有一条：代码里有没有 &lt;code&gt;import&lt;/code&gt; 它。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;3. Nginx 给 Host 加了默认端口&lt;/strong&gt;&lt;/p&gt;&lt;p&gt;见第五节。反向代理一律用 &lt;code&gt;$http_host&lt;/code&gt;。&lt;/p&gt;&lt;p&gt;&lt;strong&gt;4. 一个 &lt;code&gt;.gitignore&lt;/code&gt; 规则让编辑器消失&lt;/strong&gt;&lt;/p&gt;&lt;p&gt;这是最后一个、也是最隐蔽的坑。&lt;/p&gt;&lt;p&gt;上线后打开文章编辑页，「正文」区域一片空白，没有工具栏，也没有报错弹窗。&lt;/p&gt;&lt;p&gt;编辑器是 Vditor，它需要从 &lt;code&gt;/admin/vditor/...&lt;/code&gt; 加载自己的 i18n、语法高亮、&lt;code&gt;lute&lt;/code&gt; 等资源。直接在浏览器打开那个核心脚本的地址：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;https://admin.example.com/admin/vditor/dist/js/lute/lute.min.js&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;看到的却是后台自己的「页面不存在」——因为服务端对所有未知的 &lt;code&gt;/admin/*&lt;/code&gt; GET 请求都会返回 &lt;code&gt;index.html&lt;/code&gt; 做 SPA 兜底。脚本请求拿到一段 HTML，解析失败，编辑器容器就一直空着。&lt;/p&gt;&lt;p&gt;资源为什么不在？继续查仓库：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;git&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;check-ignore&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-v&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;web/public/vditor/dist/js/lute/lute.min.js&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;# .gitignore:2:dist/   web/public/vditor/dist/js/lute/lute.min.js&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;.gitignore&lt;/code&gt; 里的 &lt;code&gt;dist/&lt;/code&gt; 没有前导斜杠，会匹配&lt;strong&gt;任意层级&lt;/strong&gt;的 &lt;code&gt;dist&lt;/code&gt; 目录，把 &lt;code&gt;web/public/vditor/dist/&lt;/code&gt; 整个吞掉了。于是这批静态资源从未进入 Git，从仓库拉下来构建的包自然没有编辑器。&lt;/p&gt;&lt;p&gt;修法是锚定路径：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;node_modules/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;/web/dist/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;/server/dist/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;/release/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;同时在构建脚本里加一道校验，缺资源就中止构建：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;try&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;  &lt;/span&gt;&lt;span&gt;await&lt;/span&gt;&lt;span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;fs&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;access&lt;/span&gt;&lt;span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;path&lt;/span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;&lt;span&gt;join&lt;/span&gt;&lt;span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;root&lt;/span&gt;&lt;span&gt;, &lt;/span&gt;&lt;/span&gt;&lt;span&gt;&quot;web/dist/vditor/dist/js/lute/lute.min.js&quot;&lt;/span&gt;&lt;span&gt;));&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;} &lt;/span&gt;&lt;span&gt;catch&lt;/span&gt;&lt;span&gt; {&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;  &lt;/span&gt;&lt;span&gt;throw&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;new&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;Error&lt;/span&gt;&lt;span&gt;(&lt;/span&gt;&lt;span&gt;&quot;缺少 Vditor 静态资源：请确认 web/public/vditor 完整后重新构建&quot;&lt;/span&gt;&lt;span&gt;);&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;5&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;八、可以带走的几条结论&lt;a href=&quot;#八可以带走的几条结论&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;ol&gt;
&lt;li&gt;反向代理透传 Host，用 &lt;code&gt;$http_host&lt;/code&gt;，别用 &lt;code&gt;$host:$server_port&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;运行时 &lt;code&gt;import&lt;/code&gt; 的包，一律放 &lt;code&gt;dependencies&lt;/code&gt;；部署包必须用 &lt;code&gt;--omit=dev&lt;/code&gt; 实测&lt;/li&gt;
&lt;li&gt;&lt;code&gt;.gitignore&lt;/code&gt; 里的目录规则要加前导斜杠，否则会误伤深层同名目录&lt;/li&gt;
&lt;li&gt;SPA 兜底会掩盖静态资源的 404，排查时先看返回体是不是 HTML&lt;/li&gt;
&lt;li&gt;构建产物要加断言，让缺资源在构建期暴露，而不是上线后&lt;/li&gt;
&lt;/ol&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;九、开源与使用&lt;a href=&quot;#九开源与使用&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;项目已经开源：&lt;a href=&quot;https://gitee.com/L3thargy/firefly-admin-console&quot; target=&quot;_blank&quot;&gt;Firefly Admin Console&lt;/a&gt;。&lt;/p&gt;&lt;p&gt;三种启动方式：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;本地一键：Windows 双击 &lt;code&gt;start.bat&lt;/code&gt;，macOS / Linux 执行 &lt;code&gt;./start.sh&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;构建上传：运行 &lt;code&gt;build-upload.bat&lt;/code&gt; 或 &lt;code&gt;./build-upload.sh&lt;/code&gt;，产出可直接上传的 zip&lt;/li&gt;
&lt;li&gt;服务器手动：解压后 &lt;code&gt;npm install --omit=dev&lt;/code&gt;，&lt;code&gt;node server/dist/index.js&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;仓库地址：&lt;a href=&quot;https://gitee.com/L3thargy/firefly-admin-console&quot; target=&quot;_blank&quot;&gt;https://gitee.com/L3thargy/firefly-admin-console&lt;/a&gt;
（顺手点个 Star 就更好了。）&lt;/p&gt;&lt;p&gt;如果你也在给自己的博客写后台，希望这几个坑能帮你省掉一个晚上。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;</content:encoded></item></channel></rss>