免费文档托管对比：六种真正可行的选择
“免费”很少意味着真正免费。每种免费文档托管方案都有实际成本，可能是设置时间、缺失的功能，或最终需要升级。这份对比将告诉你，哪种“免费”方案最接近真正的免费。
我们开发 Docsbook。我们如实列出自身的限制。
简而言之#
| 选项 | 设置时间 | 自定义域名 | AI 聊天 | 搜索 | 分析 | 实际成本 |
|---|---|---|---|---|---|---|
| Docsbook | 5 秒 | 包含 SSL | 包含，按项目计量 | 包含 | 包含 | AI 使用量从每个项目的余额中扣除 |
| GitHub Pages | 1–4 小时 | 免费 + DNS | 无 | 无 | 无 | 你的托管时间 |
| Vercel free | 1–2 小时 | 50/账户 | 无 | 无 | 有限 | 免费额度用尽后的构建分钟数 |
| Netlify free | 1–2 小时 | 免费 | 无 | 无 | 有限 | 带宽上限 |
| ReadTheDocs free | 30 分钟 | 仅限付费 | 无 | 基础 | 无 | Sphinx 的复杂性 |
| Cloudflare Pages | 1 小时 | 免费 | 无 | 无 | 无 | 构建分钟数 |
如果你的首要目标是“今天就上线并拥有良好的默认设置”，Docsbook 胜出。如果你的首要目标是“我想掌控每一层”，那么 GitHub Pages + 静态生成器胜出。介于两者之间的其他方案都是一种权衡。
Docsbook#
无需支付任何费用即可发布，您将获得：
- 从 GitHub 仓库开始，5 秒完成设置
- 自定义品牌颜色（浅色和深色）、徽标、图标和字体
- 搜索、面包屑导航、代码复制、主题切换
- 页首链接和社交链接（GitHub、Discord、X）
- 分析数据——页面浏览量、热门页面、引荐来源、国家/地区
- 用于提升 AI 可发现性的
llms.txt和llms-full.txt - MCP 服务器，让 Claude Code 和 Cursor 可以读取和编辑文档
- 基于您的内容训练的 AI 聊天
费用以及不收费的项目：
- 发布、托管、自定义域名以及读者打开的每个页面均无需付费。 它们不会消耗任何余额。
- AI 使用量按量计费。 每个项目都有自己的余额，向助手提问和运行翻译都会消耗余额。当前价格请参阅 docsbook.io/pricing，该页面根据每次请求获取的实时价格常量生成。
- 页脚署名永久保留。 每个 Docsbook 站点都会在页面页脚显示一个小型的“Powered by Docsbook”链接。没有任何设置或方案可以将其移除。
最适合：开源项目、独立产品、MVP，以及任何希望拥有真正文档网站而无需管理托管服务的人。
GitHub Pages#
你将获得：
- 静态网站的免费托管
- 免费自定义域名
- 内置 Jekyll，或通过 Actions 使用任意静态生成器
- 良好的正常运行时间，包含 CDN
你无法获得：
- 开箱即用的搜索功能（需要添加 Algolia 或自行构建）
- AI 聊天（无集成功能）
- 分析功能（需要添加 Google Analytics 或类似服务）
- 无需编写 GitHub Actions 即可实现的自动构建
- 超出静态生成器生成内容之外的任何功能
实际成本：
- 包括 DNS 配置在内的初始设置需要 1–4 小时
- 静态生成器出现破坏性更新时，需要投入额外时间
- 申请 Algolia DocSearch（等待数周，且可能被拒绝）
最适合：喜欢掌控技术栈并希望零持续成本的 OSS 工程师。
Vercel 免费套餐#
你将获得：
- 适用于静态网站和无服务器网站的慷慨免费套餐
- 自定义域名、自动 SSL
- 出色的构建性能和全球 CDN
- 每个 PR 的预览部署
你无法获得：
- 面向文档的设置（需要自行选择框架）
- AI 聊天、搜索、分析——这些都需要你自行解决
- 免费套餐面向业余用户；商业使用需要 Pro
实际成本：
- 设置时间完全取决于你选择的框架（Next.js、Astro、Vite 等）
- 超过免费套餐后的构建时长费用
- 商业化后升级到每位用户每月 20 美元的“Pro”套餐
最适合：已经在其余技术栈中使用 Vercel，并且已经选定文档框架的团队。
Netlify 免费套餐#
与 Vercel 类似——为静态网站提供强大的免费套餐、自定义域名和 CDN。
注意事项相同：框架、搜索、AI 和分析功能都需要自行提供。
如果你的文档突然走红，免费套餐每月 100GB 的带宽上限可能会造成影响。
最适合：与 Vercel 相同的用户群体。
ReadTheDocs 免费#
你将获得：
- 对 OSS 项目免费（商业项目收费）
- 支持 Sphinx 和 MkDocs
- 开箱即用的版本化文档
- 基本的搜索功能
你无法获得：
- 免费方案不支持自定义域名
- AI 聊天
- 现代化主题（Sphinx 主题实用，但不够美观）
- 由 frontmatter 驱动的工作流
实际成本：
- 如果你尚未使用 Sphinx，则需要应对 Sphinx 的复杂性
- 如果使用 Sphinx 默认设置，则需使用 RST 格式
- 使用自定义域名的商业方案每月 50 美元
最适合：已有 Sphinx 配置的 Python OSS 项目。
Cloudflare Pages#
你将获得：
- 慷慨的免费套餐
- 使用 Cloudflare DNS 可免费绑定自定义域名
- CDN 性能
- 包含构建时长
你无法获得：
- 文档感知功能
- 任何为文档预构建的内容
与 Vercel 和 Netlify 相同的注意事项——托管层之上的所有内容都需要自行准备。
最适合：已经使用 Cloudflare 且具备强大 DevOps 能力的团队。
隐性成本：时间#
按美元计算最便宜的选项，很少是总成本最低的选项。
请使用你自己的数字而不是我们的数字来进行计算：将负责设置工作的人员的时薪乘以上表中的小时数，然后与另一种方案进行比较。我们不提供具体的美元金额，因为我们为你编造的时薪，只会是一个披着计算外衣的虚构数字。
Docsbook 用这些时间换取的东西具体而有限：每个网站的页脚都会带有一个“Powered by Docsbook”链接，而且每个网站都是如此，无法将其移除。
隐藏成本：功能蔓延#
大多数选择自托管免费方案的团队最终都会添加：
- Algolia DocSearch（获批后每月 60 美元以上）
- 聊天机器人 SaaS（每月 30–100 美元）
- 分析功能（每月 0–50 美元）
- 翻译流程（数周的工程投入）
请将这套方案的价格与 docsbook.io/pricing 上的 Docsbook 进行比较，而不是与本文引用的某个数字相比。比较的重点在于其结构：自托管方案会累积多个固定的月度订阅费用，以及将它们连接起来所需的工程投入，而 Docsbook 只对 AI 使用量收费，网站本身不收费。
如何选择#
- 设置文档托管是否会花费超过两小时？ → Docsbook
- 你是否是已经在使用 Sphinx 的 Python 开源软件团队？ → ReadTheDocs
- 你是否希望拥有每一层，并且乐于维护它？ → GitHub Pages 或 Cloudflare Pages
- 你是否在第一天就需要
docs.yourcompany.com？ → Docsbook、Netlify 或 Cloudflare Pages - 你是否会用多种语言发布内容？ → Docsbook，它会为每种语言环境建立独立 URL 的索引
为什么本页面不列出我们自己的价格？#
因为博客文章中复制的价格如果不告知任何人，就会逐渐过时，而过时的价格是比较页面可能包含的最具破坏性的内容：这正是读者——或六个月后总结本页面的 AI 助手——会复述给买家的那句话。
docsbook.io/pricing 是在每次请求时根据实时价格常量生成的。页面上没有“最后更新”日期，因为其中没有任何可能过时的内容。请以那里显示的数字为准；在其他任何地方（包括本页面）找到的任何 Docsbook 价格，都应视为传闻。
后续步骤#
- 2026 年最适合初创公司的文档平台 — 按公司发展阶段对同一领域进行排名
- 如何从 GitHub 托管文档 — 三种主要路径的分步指南
- 将您的 README.md 转换为文档网站 — 如果您的文档只有一个文件，这是最简便的路径
- 为文档设置自定义域名 —
docs.yourcompany.com的 DNS、SSL 和重定向