18 10 月 2026
团队的文档散在微信群、网盘、个人电脑里,是效率流失最隐蔽的地方。搭一个自托管知识库,一次投入长期收益。这篇对比三个主流开源方案,手把手部署最好用的一个。

一、三个方案对比

维度Wiki.jsOutlineMrDoc(觅道)
技术栈Node.js + PostgreSQLNode.js + PostgreSQL + RedisPython + MySQL
内存要求2G 起,推荐 4G4G 起2G 就够
编辑器Markdown + 富文本 + 可视化极致流畅的富文本Markdown 为主
权限管理细(页面级)细(空间级)中(文档级)
全文搜索内置(PostgreSQL/ES)快内置
国产/中文中文界面完整中文界面完整原生中文,文档友好
亮点模块生态多、双链、图谱编辑体验天花板轻量、私有化部署简单
适合技术团队注重写作体验的团队中小企业内网文档

选型建议:

  • 技术团队、要 API 和集成 → Wiki.js
  • 团队写作量大、追求体验、机器够 → Outline
  • 内网用、机器小、要中文原生 → MrDoc

二、Wiki.js 部署实战(最均衡的选择)

Wiki.js 是三者里生态最全的,2核4G 跑得很舒服。

1. 用 Docker Compose 部署(官方推荐姿势,升级也靠它):

services:
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_USER: wikijs
      POSTGRES_PASSWORD: 改成强密码
    volumes: ["db-data:/var/lib/postgresql/data"]
    restart: unless-stopped

  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on: [db]
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: 改成强密码
      DB_NAME: wiki
    ports: ["3000:3000"]
    restart: unless-stopped

volumes:
  db-data:
docker compose up -d

2. Nginx 反代 + HTTPS:

server {
    listen 443 ssl;
    server_name wiki.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;      # WebSocket 支持
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

WebSocket 那三行别省,Wiki.js 的实时协作和搜索建议靠它。反向代理细节见Nginx 反向代理与多站点配置。

3. 初始化:访问 https://wiki.yourdomain.com,管理员账号、存储引擎(本地或对象存储)、搜索引擎(PostgreSQL 够用)一路下一步。第一次就把管理员密码和备份策略设好。

三、知识库怎么用才不荒废

工具只是三分之一,另外三分之二是规矩:

  1. 分类先于内容:一上来就定好目录结构(按项目 / 按部门 / 按流程),别等文档堆成山再整理
  2. 权限最小化:财务、人事类文档设成私密空间。Wiki.js 的页面级权限能满足大多数场景
  3. 搜索是生命线:文档找不到 = 没有文档。Wiki.js 数据量大后换 Elasticsearch,小规模 PostgreSQL 搜索足够
  4. 导出和备份:Markdown 是通用格式,定期导出全站,即使平台挂了内容也在。备份方案见服务器备份与快照策略
  5. 新人第一周:把"常见问题""环境搭建""发布流程"三篇写好,比一百篇流水账有用

四、团队文档的协作流程建议

写(Markdown,Git 可选版本管理)
  → 审(PR 或管理员审核)
  → 发(打标签/版本号)
  → 归档(过期文档移入归档区,别删)

技术团队可以把文档目录直接挂 Git,改动走 review,Wiki.js 有 Git 存储模块支持。版本管理见Git 版本控制与服务器部署。

五、资源与成本

团队规模文档量推荐配置
10 人以内几百篇2核2G(MrDoc)/ 2核4G(Wiki.js)
50 人几千篇4核8G + 对象存储附件
200 人+几万篇4核8G + Elasticsearch

图片附件走对象存储,数据库每日备份,安全基线照服务器安全基线检查清单过一遍——知识库是公司最敏感的资产集合,它值得比普通网站更高的安全等级。


结语

知识库的价值不在工具,在坚持写 + 找得到。Wiki.js 这类自托管方案的好处是数据在自己手里、没有席位费、没有"文档超过 X 篇要升级套餐"的套路。一次部署,用五年。

需要搭知识库服务器,可以看看财富云计算:NAT 型云服务器支持 443 映射,2核4G 起步够跑 Wiki.js,SSD + 快照,价格比独立 IP 机型省一半以上——团队文档这种"要 HTTPS 但不需要独立 IP"的场景,刚好对症。

延伸阅读
  1. 网站环境怎么选:LNMP 手动 / 宝塔面板 / Docker / 云开发
  2. 问卷表单系统搭建:SurveyKing / Formbricks,数据自己收
  3. 图床搭建:Lsky Pro / Lychee,自托管图片托管方案
  4. 邮件列表搭建:listmonk 自托管 Newsletter,把读者握在自己手里
  5. 文档站点搭建:MkDocs / VuePress / Docsify,产品文档与技术手册方案
  6. RSS 阅读器搭建:FreshRSS 自托管,把信息流拿回自己手里
  7. 短链接服务搭建:Shlink 自托管,链接数据自己掌握
  8. 网站状态监控页搭建:Uptime Kuma,服务器挂了第一时间知道
更多阅读
  1. 上一篇:论坛网站搭建:Discourse / Flarum / NodeBB 对比与部署实战
  2. 下一篇:导航网站搭建:OneNav / WebStack,个人网址收藏夹上线实战
发表评论 1

取消回复