
详细介绍
一句话结论:BookStack 是我见过最不折腾的自建 wiki:MIT 授权、书/章/页三层结构,PHP 8.3 + MySQL 8.0 就能跑,官网自己说一台 2.5 英镑的 VPS 也够。
这是什么
BookStack 是 PHP + Laravel 写的开源 wiki,GitHub 19.1k star,当前版本 v26.09.3,授权是 MIT——下载、改、商用、再分发都不受限制。
它的内容模型非常克制:Book(书)→ Chapter(章)→ Page(页),只有三层,不给你无限嵌套的机会。页面用传统所见即所得编辑器,全文搜索能搜到书、章、页三级,也支持直接链接到某个段落。身份认证支持 SAML 2.0、OIDC、LDAP,权限可以按书限制,整个站也能设成公开可读或必须登录。
环境要求官网写得很直白:PHP 8.3 起(8.4、8.5 的安装脚本也有),MySQL 8.0 或 MariaDB 10.6 起。没有 Redis、没有消息队列,就是一个普通 LAMP 应用。
我怎么用它
我给 BookStack 的定位是「结构化的内部手册」,不是自由 wiki。落地时按这个规矩来:
- 一本书对应一个稳定主题,比如「服务器运维」「客服手册」,不要按部门建书;
- 一章对应一个阶段或一个子系统,控制在 5–12 章;
- 一页只写一件事,页标题写成能直接被搜索到的结果句,比如「MySQL 8 升级前检查清单」;
- 需要权限隔离的内容单独成书,用书级权限控制,不要在一页里混放;
- 图片统一走对象存储或 CDN,别让附件把服务器磁盘吃满。
它没有实时协作,两个编辑同时改一页会按保存时间覆盖。我的处理办法是把「谁负责哪本书」写进书名页,同一页只安排一个 owner,需要讨论的内容放评论区。
上手截图

图:BookStack 官网首屏,Simple & Free Wiki Software,下方明写 MIT 授权与最新版本 v26.09.3
优点
- MIT 授权,商用和二次开发都没有授权风险;
- 三层结构强制约束,新人不会把目录建成一团乱麻;
- 全文搜索和段落级链接好用,适合当排障手册;
- 依赖极简,一台小 VPS 就能跑,备份就是数据库加附件目录。
缺点
- 没有实时协作,多人同页编辑会互相覆盖;
- 编辑器是传统 WYSIWYG,没有块编辑、数据库视图、看板;
- PDF 导出要额外配渲染服务,默认导出格式有限;
- PHP 版本和安全补丁要自己跟,官网首页那条 PHP 安全提示就是提醒。
什么时候别用它
需要多人同时编辑同一页、需要表格数据库或看板视图、需要 AI 检索,就别选 BookStack。它最适合的是「写完就相对稳定」的手册型内容——流程、规范、排障记录,而不是天天改的协作文档。
网友评论