自建团队 Wiki 该不该用：先看它解决的问题是不是你的问题

Outline 必须接 OIDC 或第三方登录，没有本地账号，部署前要先有身份源

它擅长的是团队文档与规范；如果你只是运维手册，用现成的东西更省事。

先说结论

Wiki 的成败在「有没有人写」，工具只影响写起来顺不顺

• 适合：团队文档与规范
• 不适合：个人长期笔记
• 学习成本：Postgres 默认全文检索不切中文词，中文搜索要靠 zhparser 或 pg_jieba
• 最大收益：BookStack 正文存在 MySQL 页表里，图片在 storage 目录，备份要一起做
• 最大风险：只备份了数据库，恢复后所有图片都是裂的

它到底解决什么

Outline 必须接 OIDC 或第三方登录，没有本地账号，部署前要先有身份源。

换句话说，它把「团队文档与规范」这件事从手工变成可重复的流程。这是它真正的价值，而不是功能列表的长度。

什么时候不该用

下面三种情况，用了反而更累：

只备份了数据库，恢复后所有图片都是裂的

用默认检索搜中文，怎么搜都只有标题命中

把 Wiki 放在没有身份源的环境，最后全员共用一个账号

和替代方案比

Wiki 的附件增长比正文快，图片一年能占几 GB。

这台工具的关键细节

几个决定长期体验的点：

• Postgres 默认全文检索不切中文词，中文搜索要靠 zhparser 或 pg_jieba
• BookStack 正文存在 MySQL 页表里，图片在 storage 目录，备份要一起做
• Wiki 的附件增长比正文快，图片一年能占几 GB
• 全文索引是异步更新的，刚写的文档可能要几秒才搜得到

我的建议

Wiki 的成败在「有没有人写」，工具只影响写起来顺不顺。

先用两周，跑一个真实的小任务；两周后你还想用它，再谈长期。

还有几处容易忽略的

都是小地方，但出问题时往往就卡在这里。

• 导出 Markdown 能保底，但层级和附件链接通常要手工修

工具是解法，不是身份。