获取下载链全程约 1 分钟

打开微信，搜索「软件教程管家」关注，或长按下方二维码关注
回复关键词 writebook
公众号自动回复网盘链接，点击即可保存下载

Writebook：Markdown 在线书籍发布工具，免费自托管出版你的电子书

打开微信扫一扫关注
或搜索【软件教程管家】

想把自己写的长篇内容做成一个能在线翻阅、能搜索的电子书站，又不想把稿子交给第三方平台？Writebook 就是为这件事准备的开源工具：用 Markdown 写书，一键发布成网站，公开或私密由你定。它是 Basecamp 团队出品的自托管出版应用，跑在你自己的服务器上，内容、域名、访问权限全在自己手里。

软件信息表

软件名称	Writebook
开发方	Basecamp
开源协议	MIT
技术栈	Ruby，Docker 镜像分发
内容格式	Markdown
部署方式	ONCE 一键安装、docker run、Docker Compose
官方镜像	ghcr.io/basecamp/writebook
最新版本	见仓库 Releases 页（已发布 8 个版本）
适用平台	任意可运行 Docker 的服务器

在线书籍发布：Writebook 能做什么

Writebook 的定位很聚焦：它不做通用 CMS，也不做博客，只解决“把 Markdown 稿子变成一本能在线读的书”这一个问题。书的内容按章节、图片页、标题页组织，读者打开就是一本排版好的在线书，还能全文搜索。

Markdown 写作：整本书用 Markdown 写，纯文本稿子方便版本管理和批量修改，不用在编辑器里逐段调格式。
章节结构：书籍支持章节、图片页和标题页三种内容组织方式，适合教程、手册、课程讲义这类有层级的内容。
公开或私密：每本书可以设为公开或私密，公开的书对外就是一个阅读站，私密的书只给指定范围的人看。
全文搜索：已发布的内容支持搜索，读者不用一页页翻，直接搜关键词定位到相关章节。
自托管：应用和数据都在自己的服务器上，不依赖第三方出版平台，换域名、迁服务器自己说了算。

三种部署方式怎么选

结论先行：第一次部署直接用 ONCE 一键安装；已经有现成 Docker 编排习惯的用 Docker Compose；只有想改代码、参与开发的人才需要走本地开发模式。

方式	操作	适合谁
ONCE 一键安装	终端执行官方安装脚本	只想快速上线、不想写配置的新手
docker run / Docker Compose	拉取官方镜像，自写启动参数	已有服务器和反代习惯、想自己控制细节的人
本地开发运行	bin/setup 安装依赖，bin/dev 启动	想改源码、提 PR 的开发者

三种方式跑的是同一个应用，选哪种只影响你第一次上手的麻烦程度，不影响后续写书和发布的使用体验。

安装步骤：三步跑起来

准备一台能跑 Docker 的服务器，并准备好一个指向这台服务器的域名。没有域名也能先用 IP 跑起来，但公开出版建议尽早配域名。
用 ONCE 一键安装：在目标机器的终端执行官方安装命令 curl https://get.once.com/writebook | sh，按提示完成安装；或者手动拉取镜像 ghcr.io/basecamp/writebook，用 docker run 或 Docker Compose 启动。
挂载持久化卷并放行端口：把 Docker 卷挂载到 /rails/storage，把 Web 流量转发到 80 和 443 端口。做完这一步打开域名就能进入 Writebook，开始建第一本书。

部署后必做的 4 件事

确认持久化卷真的挂上了：应用数据存在 /rails/storage，没挂卷的情况下容器重建数据就没了。部署完先写一页测试内容，重启一次容器确认内容还在，再正式动笔。
把 SSL 配好：设 SSL_DOMAIN 环境变量为你的域名，Let’s Encrypt 会自动签发证书；如果确定只在内网用、走 HTTP，设 DISABLE_SSL 关掉 SSL。公开出版的书站建议走 HTTPS，读者浏览器才不会报不安全。
定好每本书的可见性：建书时就想清楚这本是公开还是私密，公开书会被搜索引擎收录，内部手册、手稿草稿一律设私密，别等发出去再改。
单独做一份备份：仓库说明没有提到内置备份机制，/rails/storage 的定期备份和镜像更新、回滚流程要自己定。建议备份和更新分开做：先备份再升级镜像，出问题能立刻回滚。

注意事项

协作和权限能力要先核实：据仓库 README 说明，多人协作、细粒度权限这类能力没有明确说明。如果你是团队共用一本书，部署前先看 README 或源码确认是否满足，别默认它有。
备份、监控、升级没有现成方案：长期运行的运维工作要自己安排，包括存储备份、镜像更新和升级兼容性检查，升级前先读仓库的版本说明。
端口和域名要提前对齐：Web 流量要转发到 80 和 443 端口，启用 SSL 时域名、入口端口和 SSL_DOMAIN 三处必须一致，否则证书签发会失败。
它不是通用知识库：复杂的内容管理、审批流、企业知识库这类需求超出了它的定位，硬套只会越用越别扭。