Confluence太贵？我用3分钟给团队搭了个免费知识库，同事直呼好用！

Confluence太贵？我用3-分钟给团队搭了个免费知识库，同事直呼好用！

我们团队的文档管理，简直是一场灾难。需求文档在语雀，技术方案在Notion，接口文档在Swagger，还有一部分散落在各个Git仓库的README里。找个东西要问半天，新人入职更是痛苦不堪。

我们也考虑过用Confluence，但它高昂的订阅费用让小团队望而却步。我需要一个强大、开源、易于部署的替代品，来打造我们团队的“中央大脑”。最终，我选择了Wiki.js。

Wiki.js：现代化的团队知识库

Wiki.js 是一款非常强大且现代化的开源Wiki软件，它在GitHub上斩获了 23.4k Star，是目前最受欢迎的开源知识库解决方案之一。

它彻底征服了我：

• 美观且响应式：界面清爽现代，完美适配PC和移动端，阅读体验极佳。

• 强大的编辑器：支持多种编辑器，包括Markdown、富文本、代码等，还可以直接从VS Code中同步，对开发者极其友好。

• 灵活的权限管理：可以精细地控制到每个页面、每个用户组的读写权限，非常适合团队协作。

• 多重存储后端：内容可以直接同步到Git仓库，实现文档的版本化管理，也可以存在数据库中。

自己部署？先做好心理准备

Wiki.js虽然优秀，但自己从零开始部署，绝对是个技术活：

1. 准备环境：需要Node.js v18或更高版本，以及一个PostgreSQL数据库（官方首推）。

2. 数据库配置：你需要手动创建数据库，并把连接信息写入一个config.yml配置文件中，格式要求严格，多一个空格都可能出错。

3. 启动与守护：需要通过node server命令启动，并且为了保证服务稳定，必须配置systemd或pm2这类进程守护工具。

4. 升级维护：版本升级时，需要备份数据、下载新版本、重新安装依赖，过程繁琐且有数据丢失的风险。

这套流程对普通开发者来说，门槛不低，也容易因为环境问题卡住。

然而，在Sealos上，这一切都不再是问题。

保姆级一键部署教程

第一步：准备数据库（推荐）

Wiki.js强依赖数据库。最稳妥的方式是在Sealos「应用商店」里，先一键部署一个高可用的「PostgreSQL」集群。部署后，进入其详情页，在“连接信息”中找到内网地址、用户名和密码，复制下来备用。

第二步：在应用商店搜索“Wiki.js”

回到「应用商店」，搜索 wiki.js，点击进入它的部署页面。

第三步：填写数据库连接信息（核心步骤）

在部署页面的“基础配置”部分，这是最关键的一环。你需要将刚才准备好的PostgreSQL连接信息准确填入：

• DB_TYPE: 选择 postgres。

• DB_HOST: 填入PostgreSQL的内网地址。

• DB_PORT: 填入 5432。

• DB_USER: 填入数据库用户名。

• DB_PASS: 填入数据库密码。

• DB_NAME: 填入数据库名称。

第四步：部署并完成初始化

确认配置无误后，点击“部署应用”。等待大约2分钟，看到应用状态变为 Running。

首次访问Wiki.js的公网地址时，会进入一个初始化向导。你需要设置管理员邮箱、密码以及站点URL（直接使用当前访问的公网地址即可）。完成向导后，你的团队专属知识库就正式建好了！

快速上手：创建你的第一篇团队文档

1. 用管理员账号登录后，点击右上角的“新建页面”。

2. 选择一个路径，比如 tech/backend/api-guide，然后选择你喜欢的编辑器（强烈推荐Markdown）。

3. 撰写你的文档内容，完成后点击“创建”。

4. 进入“管理”->“用户组”，创建不同的用户组（如“开发”、“产品”），并邀请你的同事加入。

5. 在页面设置中，为不同用户组分配“读取”或“更新”权限，实现精细化的文档协作。

总结

自从团队用上了Wiki.js，文档混乱的问题得到了彻底解决。所有知识和经验都有了沉淀的地方，团队协作效率肉眼可见地提升了。

Sealos应用商店将部署Wiki.js的复杂过程简化到了极致，让我们无需专业的运维就能享受到顶级开源工具带来的便利。如果你的团队也正被文档问题所困扰，别再犹豫了，花三分钟时间去搭建一个属于你们的Wiki吧！