# BookStack 让团队把操作流程写成找得到的工作手册

> BookStack 用书籍、章节和页面组织团队文档，提供可视化编辑、全文搜索、修订记录与角色权限。适合整理操作流程和内部手册，可免费自托管，服务器维护与备份需要自行安排。

## 关键信息

- 分类：开源自托管
- 支持平台：Web / Docker
- 收费方式：开源软件免费，服务器、存储与维护成本自理
- 开源协议：MIT
- 官网：https://www.bookstackapp.com/
- 源码仓库：https://codeberg.org/bookstack/bookstack
- 标签：BookStack、团队知识库、工作手册、开源自托管
- 收录日期：2026-10-31 14:47:21

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

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

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

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

![BookStack 官方展示的文档阅读页与目录导航](/assets/post-images/bookstack-team-wiki-official-ui.webp)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- [访问 BookStack 官网](https://www.bookstackapp.com/)
- [查看官方源码仓库](https://codeberg.org/bookstack/bookstack)
- [阅读安装文档](https://www.bookstackapp.com/docs/admin/installation/)
- [阅读备份与恢复说明](https://www.bookstackapp.com/docs/admin/backup-restore/)

---

网页版：https://aronshare.com/posts/bookstack-team-wiki/
发现线索：BookStack 官网与官方文档 https://www.bookstackapp.com/
来源站点：AronShare 资源库（https://aronshare.com）