小微企业内部知识库搭建实战：用 Wiki.js 实现文档协作、权限分级与全文检索

摘要

用开源 Wiki.js 给小微企业搭建内部知识库，覆盖 Docker 部署、企微/钉钉登录、多级权限与全文检索，把制度、客户资料与项目经验沉淀下来，避免人员流动造成知识流失。

为什么小微企业也需要知识库

十人出头的小公司，最容易踩的坑是"人在知识在，人走知识没"：客户跟进记录散在个人微信里，制度文档躺在某个人的 U 盘，项目复盘写在临时 Excel，一旦离职或换电脑，这些东西就再也找不回来。知识库不是大厂的专利，恰恰是资源紧张的小微企业，更该用低成本工具把组织记忆固化下来。Wiki.js 是 MIT 协议的开源项目，基于 Node.js，轻量、部署简单，正好适合这个场景。

为什么选 Wiki.js

它有几个对小团队特别友好的特性：支持 Markdown 与可视化双编辑器、代码块高亮；存储后端可接 PostgreSQL/MySQL/SQLite/MongoDB；搜索引擎可用 PostgreSQL 内置全文检索或 Elasticsearch；身份认证丰富（本地、LDAP、OAuth、企业微信、钉钉 SAML）；页面级细粒度权限（按分组、按路径读写）。换句话说，一台 2 核 4G 的云服务器就能跑起来，还能和现有企微账号打通。

Docker Compose 部署

version: "3"
services:
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: wikijs
      POSTGRES_USER: wikijs
      POSTGRES_PASSWORD: 换成强密码
    volumes:
      - ./db:/var/lib/postgresql/data
  wiki:
    image: requarks/wiki:2
    depends_on: [db]
    ports:
      - "3000:3000"
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_NAME: wikijs
      DB_USER: wikijs
      DB_PASS: 换成强密码
    volumes:
      - ./data:/wiki/data

要点：先起 db 再起 wiki；./db 与 ./data 两个卷必须持久化；生产环境前面套一层 Nginx 反代并上 HTTPS，不要裸跑 3000 端口。

权限分级怎么做

建分组：管理员 / 部门主管 / 普通员工 / 外部协作。
用命名空间（路径）映射部门：/hr、/sales、/tech、/public。
页面级权限：公开制度对全员可读，财务与薪酬目录仅 HR 组可读写。
关闭匿名访问，强制登录，杜绝外链泄露。

接入企微/钉钉单点登录

在"管理 → 认证"中添加 OIDC/SAML。以企业微信为例：在企微后台自建应用，把回调 URL 填成 https://wiki.你的域名.com/auth/...，员工就能用现有企微账号一键登录。好处是降低了使用门槛——大家不用再记一套新密码，权限还能随企微组织架构同步。

内容治理与备份

给常用文档定模板：会议纪要、需求文档、故障复盘，统一结构。
给每篇文档标"负责人"和"最后更新时间"，定期审计死链。
开启 Git 同步，把 Wiki 内容自动备份到私有仓库，防止服务器故障丢数据。

几个容易踩的坑

别用 SQLite 跑生产，并发写入容易锁表，老老实实用 PostgreSQL。
反代要透传 X-Forwarded-* 头，否则登录回调的域名会错，跳转回不去。
上传的附件默认存在本地卷 ./data，备份时千万别漏掉这一块。
中文全文检索在 PostgreSQL 下需要配置 zhparser 分词，或直接上 Elasticsearch 的 ik 分词插件，否则中文搜索分词不准、命中率低。

小结

Wiki.js 让小微企业用一台小服务器就能拥有结构化的内部知识库：Docker 一键部署、企微账号打通、页面级权限可控、全文检索可用。把制度、客户与复盘沉淀进去，知识不再随人走，组织能力才能真正累积。