这份手册应该部署在哪：国内访问优先的方案
#部署#国内访问#博客#静态站
2026年 5月 12日

如果目标是让国内读者稳定访问，这份手册不一定要做成独立网站。更实用的做法是：并入现有博客，同时保留一份可以同步到国内文档平台或国内云厂商的 Markdown 内容。

本文核对时间：2026-05-12。

先看结论

这份手册当前已经适合并入博客：每个主题拆成一篇文章，读者可以从博客分类进入，也可以直接分享单篇链接。

但“并入博客”不等于“国内一定稳定访问”。访问质量取决于博客部署位置、CDN 线路、域名解析和备案情况。

如果国内访问是硬要求，优先级建议是：

  1. 国内云厂商静态站 / 对象存储 + CDN。
  2. 国内云服务器自托管。
  3. 国内文档平台同步一份只读手册。
  4. Cloudflare / Vercel / Netlify / GitHub Pages 作为海外主站或备用站。

方案一：直接加入现有博客

适合现在这个项目。

优点：

  • 不需要维护第二套站点。
  • 文章可以进入博客分类、RSS、搜索引擎索引。
  • 后续更新某一章，只改对应文章。
  • 对个人博客读者更自然，不像外部手册站。

缺点：

  • 国内访问仍然受博客部署环境影响。
  • 如果博客托管在海外平台，国内线路不一定稳定。
  • 手册内容较长，需要控制文章结构和目录。

当前这套博客的内容模型是：

public/blogs/index.json
public/blogs/categories.json
public/blogs/<slug>/config.json
public/blogs/<slug>/index.md

所以手册迁移方式很直接：新增一组文章目录，更新文章索引和分类即可。

方案二：国内云厂商静态站 / 对象存储 + CDN

适合“国内访问优先”的正式发布。

可选形态：

  • 静态站构建产物上传到对象存储。
  • 对象存储绑定 CDN。
  • 域名解析到国内 CDN。
  • 根据实际情况完成备案。

优点：

  • 国内访问质量通常更可控。
  • 成本低，适合纯文档和博客静态内容。
  • 不依赖海外平台线路。

缺点：

  • 需要处理备案、域名、CDN、缓存刷新。
  • Next.js 动态能力如果用得多，纯静态部署会受限制。
  • OpenNext / Cloudflare 这类运行时能力不能直接照搬到对象存储。

适合手册的折中方式是：博客主站继续保留，手册部分额外导出为静态 Markdown 或静态页面，同步到国内对象存储。

方案三：国内云服务器自托管

适合想完全控制运行环境的人。

常见部署：

Nginx
  ↓
Next.js / 静态导出目录
  ↓
本机文件或对象存储

优点：

  • 控制力强。
  • 可以同时跑 Next.js 服务端能力、API、评论服务等。
  • 排障路径清楚。

缺点：

  • 运维成本高于静态站。
  • 需要维护系统更新、HTTPS、备份、日志、安全策略。
  • 国内服务器通常涉及备案流程。

如果只是发布手册，不建议一开始就为了它单独维护服务器。

方案四：国内文档平台同步

如果“先让人看见”比“技术形态完整”更重要，可以把手册同步到国内文档平台。

适合：

  • 语雀、飞书文档、腾讯文档等团队常用文档工具。
  • 临时给非技术读者阅读。
  • 做公开分享页或内部知识库。

优点：

  • 发布快。
  • 国内访问通常更友好。
  • 编辑、评论、权限管理简单。

缺点：

  • 样式和信息架构受平台限制。
  • 不完全属于自己的站点。
  • 代码块、目录、SEO、迁移能力不如自有博客可控。

我的建议是把它作为镜像或备份，而不是唯一版本。主版本仍然保留在博客仓库，避免后续迁移困难。

方案五：Cloudflare / Vercel / GitHub Pages

这些平台适合海外访问或开发者读者，但如果目标是“保证国内可访问”，不能把它们当唯一答案。

当前博客项目使用 Next.js + OpenNext Cloudflare。这个技术栈适合部署到 Cloudflare Workers / Pages 一类平台，但国内访问质量需要按真实线路测试，不能只看本机网络。

建议定位：

  • 海外主站：可以继续使用。
  • 国内镜像：另行部署或同步。
  • 公开分享：给两个入口，主站和国内镜像。

备案和域名问题

如果使用中国大陆境内服务器或 CDN，通常要考虑 ICP 备案。具体要求会随服务商、域名、业务性质和部署方式变化，实际操作以服务商控制台和主管部门说明为准。

不要把“能部署成功”和“能长期公开访问”混为一谈。正式对外访问前至少确认：

  • 域名是否已备案或是否需要备案。
  • CDN 是否允许未备案域名接入。
  • HTTPS 证书是否正常。
  • 国内多个运营商网络能否访问。
  • 页面资源是否依赖海外域名。

对这份手册的推荐落地

短期：

  • 把手册拆成博客文章。
  • 新增“AI 工具”分类。
  • 不依赖外链图片。
  • 文章里保留官方参考链接。

中期：

  • 加一个总入口文章，作为系列目录。
  • 如果博客部署在 Cloudflare，继续作为海外主站。
  • 同步一份 Markdown 到国内文档平台，方便分享。

长期：

  • 如果读者主要在国内，考虑把博客静态页面或手册部分同步到国内对象存储 + CDN。
  • 给国内镜像绑定自己的子域名，例如 handbook.example.cn。
  • 维护一份发布脚本，避免手动复制导致内容分叉。

最小发布检查清单

发布前检查：

  • 文章能从博客列表进入。
  • 分类里能看到“AI 工具”。
  • 移动端标题、表格、代码块不横向撑破。
  • 代码块里的 key 都是占位值。
  • 外部链接不是阅读主路径，只作为参考。
  • 构建命令通过。

参考来源