BookStack

同一个操作流程，老同事在聊天里解释过，新同事却找不到；共享文件夹里有几份手册，也说不清哪份还在更新。 这类问题适合用一套有固定目录、方便查找的团队文档来处理。 BookStack 提供的就是这样的空间：把知识写成页面，放进章节和书籍里，让成员沿目录阅读，也能直接搜索需要的内容。

一本书可以对应一项长期工作

BookStack 官网把它定位为简单、易用的自托管知识整理平台。 它用书籍、章节和页面组织内容，读者看到的是一本可以逐页查阅的在线手册。

例如，小团队可以建立一本“网站运营手册”，把内容发布、图片规范和故障处理分成章节，每个具体问题各写一页。 “如何替换文章配图”和“发现错误链接怎么处理”就能有各自的固定位置。 这样的目录适合规则较稳定、需要反复查阅的内容，也方便维护者判断某页该放在哪里。

图片来自 BookStack 官网，展示页面正文、左侧目录和右侧操作区。

写文档的人可以选择熟悉的编辑方式

BookStack 提供所见即所得编辑器，也提供带实时预览的 Markdown 编辑器。 习惯普通文档的人可以直接编辑页面，习惯 Markdown 的人也有对应入口。 页面修订记录、图片管理和内容排序等功能，都列在官方功能说明中。

这些能力适合持续维护的操作说明。 一次流程调整可以落到对应页面，读者使用同一个入口查看内容，维护者则可以结合修订记录回看变化。 建议在重要页面写清适用对象、操作条件和负责人，软件提供的结构才更容易被团队用起来。

搜索和段落链接让回答问题更直接

BookStack 支持在书籍内搜索，也支持搜索整个知识库中的书籍、章节和页面。 如果同事只记得某个报错词，可以从关键词查起；已经知道所属流程，就沿目录定位。 官网还说明，页面中的段落可以被直接链接，方便在讨论中引用具体说明。

例如，别人询问上传图片的尺寸要求时，可以发送手册中对应段落的链接。 长期使用同一个文档入口，也有助于把新的说明补回原页面，减少聊天记录与手册各写一套的情况。 这里的效果依赖团队持续维护内容，过期规则仍需要有人更新。

团队知识库需要分清谁能看和谁能改

官方提供角色与权限系统，可以限制内容访问和操作，并支持控制整个站点是否公开可见。 登录方式包括常规账号密码，以及按环境配置的 OIDC、SAML2 和 LDAP 等方案。 多因素认证也在内置功能中，可按角色要求启用。

对于内部流程，可以按职责安排编辑权限，让负责维护的人更新页面，让需要查资料的人读取内容。 如果准备开放部分内容给外部读者，建议用普通读者身份检查可见范围，确认内部资料没有被一起开放。 权限配置属于知识库日常维护的一部分，不能只在安装当天处理一次。

自托管要把运行环境和备份一起考虑

BookStack 软件采用 MIT 许可，下载和安装自己的实例无需软件授权费。 服务器、域名、存储以及维护所需的时间，需要自行安排。

截至 2026 年 10 月 31 日，官方安装文档列出的核心条件包括 PHP 8.2 或以上、MySQL 8.0 或 MariaDB 10.6 或以上，以及 Git、Composer 和支持 PHP 的 Web 服务器。 PHP 还需要安装文档列出的扩展。 版本下限用于说明兼容要求，实际部署应使用仍受维护、已安装安全更新的版本。

官网列出的 Docker 部署方案由社区维护，选择时应核对镜像维护方、配置说明与持久化目录。 官方也提供 Ubuntu 安装脚本，但脚本面向全新系统，可能覆盖机器上已有的 Web 服务配置。 已有网站的服务器适合按自己的环境评估手动安装或容器方案。

官方备份文档把备份分为数据库和文件两部分。 除数据库记录外，配置文件、上传图片、附件及自定义主题也需要纳入备份；恢复时还应保留原配置中的应用密钥。 给知识库安排异机备份和恢复检查，比只复制几篇页面更完整。

用一份经常被问到的流程判断是否合适

可以从团队最常重复解释的一项工作开始，把相关说明整理成一本小手册。 选择一名熟悉流程的人负责维护，让另一名成员按文档完成任务，并记录缺失的条件或找不到的步骤。 这样能直接检查目录是否清楚、内容是否够用、权限是否符合工作需要。

BookStack 更适合需要共同查阅、持续更新的工作手册、内部帮助中心和项目文档。 如果团队愿意指定维护者，也愿意承担服务器与备份工作，它提供的目录、搜索和权限就是一套清晰的起点。

• 访问 BookStack 官网
• 查看官方源码仓库
• 阅读安装文档
• 阅读备份与恢复说明