Docker 企业知识库搭建｜一键部署

在企业数字化办公过程中，知识沉淀是一件非常重要但又容易被忽视的事情。项目文档、运维手册、产品规范、客户资料、故障排查记录、研发流程、制度公告等内容，如果长期散落在个人电脑、微信群、网盘或邮件中，不仅查找困难，也容易造成知识断层。一旦核心成员离职或岗位调整，很多经验就会随之流失。

因此，搭建一套企业内部知识库系统，是提升团队协作效率、降低沟通成本、沉淀组织经验的重要手段。相比传统手工部署方式，使用 Docker 部署知识库具有环境隔离、安装简单、迁移方便、升级快速等优势。本文将以常见的开源知识库系统为例，介绍如何通过 Docker Compose 一键部署企业知识库，并提供完整的部署思路、配置文件、访问方式、数据备份和后期维护建议。

一、为什么企业需要知识库？

企业知识库不是简单的“文档仓库”，它更像是组织内部的“经验中台”。一个高质量的知识库，可以帮助团队解决以下问题：

1. 降低重复沟通成本

很多问题其实并不复杂，但如果没有统一的知识沉淀位置，员工就会反复询问同样的问题。例如：

• 服务器如何登录？
• 项目如何发布？
• 新员工入职需要配置哪些环境？
• 某个系统接口文档在哪里？
• 常见故障如何处理？

如果这些内容被整理到知识库中，新成员可以自主查阅，老成员也不用反复解释。

2. 提升团队协作效率

研发、测试、运维、产品、售前、客服等岗位都需要共享信息。知识库可以将不同部门的内容统一管理，避免信息孤岛。

例如研发团队可以维护接口文档，运维团队可以维护服务器和部署文档，产品团队可以维护需求说明，客服团队可以沉淀客户常见问题。

3. 保证知识传承

企业发展过程中，人员流动不可避免。如果核心经验只掌握在少数人手中，一旦人员变动，团队就可能陷入被动。知识库可以让经验被结构化保存，降低人员流动带来的风险。

4. 规范企业内部流程

通过知识库，可以统一发布制度规范、操作流程、项目模板、代码规范、发布规范等内容，让团队工作更加标准化。

二、为什么选择 Docker 部署？

传统部署知识库系统时，通常需要手动安装 Node.js、Java、PHP、数据库、反向代理等环境。不同系统之间存在依赖版本差异，部署和维护成本较高。

Docker 则可以很好地解决这些问题。

Docker 部署的优势

对于中小企业、研发团队、运维团队而言，Docker 是搭建内部知识库非常合适的方式。

三、知识库系统选型

目前比较常见的开源知识库系统有很多，例如：

• Wiki.js
• BookStack
• Outline
• DokuWiki
• Confluence 替代方案
• Halo 文档站
• Docsify / VitePress 静态文档

如果企业希望快速搭建一个现代化、界面美观、权限灵活、支持 Markdown 的知识库系统，推荐使用 Wiki.js。

Wiki.js 的特点

Wiki.js 是一款基于 Node.js 的开源 Wiki 系统，界面现代，功能丰富，适合企业内部知识库场景。

主要特点包括：

• 支持 Markdown 编辑
• 支持可视化编辑器
• 支持多用户协作
• 支持权限管理
• 支持全文搜索
• 支持 Git、数据库等多种存储方式
• 支持 PostgreSQL 数据库
• 支持 Docker 部署
• 界面简洁，学习成本低

本文将以 Wiki.js + PostgreSQL + Docker Compose 为例，完成一套企业知识库的一键部署。

四、部署前准备

在开始部署之前，需要准备一台 Linux 服务器。推荐配置如下：

服务器配置建议

如果只是企业内部使用，可以部署在内网服务器上。如果需要远程访问，可以部署在云服务器，并配合域名和 HTTPS。

五、安装 Docker 和 Docker Compose

如果服务器尚未安装 Docker，可以参考以下命令进行安装。

1. 安装 Docker

以 Ubuntu / Debian 为例：

curl -fsSL https://get.docker.com | bash

安装完成后，启动 Docker：

systemctl enable docker
systemctl start docker

查看 Docker 版本：

docker -v

如果能够正常输出版本号，说明 Docker 已安装成功。

2. 安装 Docker Compose

新版 Docker 通常已经内置 Compose 插件，可以使用以下命令检查：

docker compose version

如果能够看到版本号，则表示可直接使用。

如果服务器不支持 docker compose，也可以安装独立版 docker-compose，但建议优先使用新版 Compose 插件。

六、创建部署目录

为了方便后续维护，我们将知识库相关文件统一放在 /opt/wikijs 目录下。

mkdir -p /opt/wikijs
cd /opt/wikijs

建议后续所有配置文件、备份脚本、说明文档都放在该目录下，方便迁移和备份。

七、编写 Docker Compose 一键部署文件

在 /opt/wikijs 目录下创建 docker-compose.yml 文件：

vim docker-compose.yml

写入以下内容：

version: "3.8"

services:
  db:
    image: postgres:15
    container_name: wikijs-db
    restart: unless-stopped
    environment:
      POSTGRES_DB: wiki
      POSTGRES_USER: wikijs
      POSTGRES_PASSWORD: wikijs_password_please_change
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    networks:
      - wikijs-net

  wiki:
    image: ghcr.io/requarks/wiki:2
    container_name: wikijs
    restart: unless-stopped
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijs_password_please_change
      DB_NAME: wiki
    ports:
      - "3000:3000"
    volumes:
      - ./data/wiki:/wiki/data
    networks:
      - wikijs-net

networks:
  wikijs-net:
    driver: bridge

配置说明

• postgres:15：使用 PostgreSQL 15 作为数据库。
• ghcr.io/requarks/wiki:2：Wiki.js 官方镜像。
• POSTGRES_DB：数据库名称。
• POSTGRES_USER：数据库用户名。
• POSTGRES_PASSWORD：数据库密码，正式环境请务必修改为复杂密码。
• ports：将容器内的 3000 端口映射到服务器 3000 端口。
• volumes：将数据库和 Wiki.js 数据持久化到本地目录。
• restart: unless-stopped：容器异常退出后自动重启。

注意：生产环境一定要修改默认密码，避免安全风险。

八、一键启动知识库

在 /opt/wikijs 目录下执行：

docker compose up -d

首次启动时，Docker 会自动拉取所需镜像并创建容器。等待一段时间后，查看容器状态：

docker ps

正常情况下，可以看到类似如下容器：

wikijs
wikijs-db

查看日志：

docker logs -f wikijs

如果没有明显错误，说明服务已经启动成功。

九、访问 Wiki.js 初始化页面

打开浏览器访问：

http://服务器IP:3000

如果服务器 IP 为 192.168.1.100，则访问：

http://192.168.1.100:3000

首次访问会进入 Wiki.js 初始化页面，需要创建管理员账号。

通常需要填写：

• 管理员邮箱
• 管理员密码
• 网站名称
• 访问地址
• 语言设置

初始化完成后，即可进入知识库后台。

十、配置中文界面

进入后台后，可以在管理面板中设置语言。

一般路径为：

Administration → Locale

选择简体中文，并应用配置。部分界面可能仍保留英文，但主要使用体验已经足够友好。

如果需要完整中文化，可以结合社区语言包或根据实际版本进行调整。

十一、企业知识库栏目规划

系统部署完成只是第一步，更重要的是知识库的内容规划。很多企业搭建知识库后长期无人维护，最终变成“文档垃圾场”。因此，一开始就要设计清晰的栏目结构。

推荐企业知识库可以按照以下目录组织：

企业知识库
├── 公司制度
│   ├── 考勤制度
│   ├── 报销流程
│   ├── 信息安全规范
│   └── 入职离职流程
├── 项目文档
│   ├── 项目介绍
│   ├── 需求文档
│   ├── 接口文档
│   ├── 数据库设计
│   └── 发布记录
├── 研发规范
│   ├── Git 使用规范
│   ├── 代码提交规范
│   ├── 分支管理规范
│   ├── 代码评审流程
│   └── 开发环境搭建
├── 运维手册
│   ├── 服务器清单
│   ├── 应用部署流程
│   ├── 日志查看方法
│   ├── 常见故障处理
│   └── 备份恢复方案
├── 产品资料
│   ├── 产品说明
│   ├── 原型文档
│   ├── 版本规划
│   └── 用户手册
├── 客户支持
│   ├── 常见问题 FAQ
│   ├── 客户部署说明
│   ├── 售后处理流程
│   └── 问题案例库
└── 新人专区
    ├── 入职指南
    ├── 常用系统入口
    ├── 环境配置指南
    └── 团队协作规范

良好的目录规划可以让知识库更容易被使用，也能减少后期混乱。

十二、权限管理建议

企业知识库通常涉及不同部门和不同权限级别的内容，因此权限配置非常重要。

常见角色设计

权限设计原则

1. 最小权限原则
   用户只获得完成工作所需的最小权限，避免误删或泄露。

2. 按部门划分空间
   研发、产品、运维、行政等部门可以拥有不同栏目权限。

3. 重要文档限制编辑
   制度、服务器信息、数据库信息等敏感内容应限制编辑权限。

4. 定期检查账号
   离职员工账号应及时禁用或删除。

5. 管理员账号单独管理
   管理员账号不要多人共用，方便审计和追踪。

十三、配置反向代理和域名访问

如果希望通过域名访问知识库，例如：

https://wiki.example.com

可以使用 Nginx 作为反向代理。

Nginx 配置示例

在 Nginx 中添加站点配置：

server {
    listen 80;
    server_name wiki.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

保存后检查配置：

nginx -t

重载 Nginx：

systemctl reload nginx

如果需要 HTTPS，可以使用 Certbot 申请免费 SSL 证书：

certbot --nginx -d wiki.example.com

启用 HTTPS 后，建议在 Wiki.js 后台将站点访问地址改为 HTTPS 域名。

十四、数据备份方案

知识库最核心的资产是数据。Docker 容器可以随时重建，但文档内容和数据库不能丢失。因此，必须制定备份策略。

1. 备份 PostgreSQL 数据库

可以在 /opt/wikijs 下创建备份目录：

mkdir -p /opt/wikijs/backup

手动备份数据库：

docker exec wikijs-db pg_dump -U wikijs wiki > /opt/wikijs/backup/wiki_$(date +%F).sql

2. 备份数据目录

除了数据库，也建议备份整个数据目录：

tar -zcvf /opt/wikijs/backup/wikijs_data_$(date +%F).tar.gz /opt/wikijs/data

3. 自动备份脚本

创建脚本：

vim /opt/wikijs/backup.sh

写入：

#!/bin/bash

BACKUP_DIR="/opt/wikijs/backup"
DATE=$(date +%F_%H-%M-%S)

mkdir -p $BACKUP_DIR

docker exec wikijs-db pg_dump -U wikijs wiki > $BACKUP_DIR/wiki_$DATE.sql

tar -zcf $BACKUP_DIR/wikijs_data_$DATE.tar.gz /opt/wikijs/data

find $BACKUP_DIR -type f -mtime +30 -delete

赋予执行权限：

chmod +x /opt/wikijs/backup.sh

添加定时任务：

crontab -e

每天凌晨 2 点自动备份：

0 2 * * * /opt/wikijs/backup.sh

建议将备份文件同步到其他服务器、NAS 或对象存储，避免单机故障导致数据丢失。

十五、系统升级方法

使用 Docker 部署的另一个好处是升级非常方便。

进入部署目录：

cd /opt/wikijs

拉取最新镜像：

docker compose pull

重启服务：

docker compose up -d

清理无用镜像：

docker image prune -f

升级前建议先执行一次完整备份：

/opt/wikijs/backup.sh

如果升级后出现异常，可以使用备份数据进行恢复。

十六、常见问题排查

1. 页面无法访问

检查容器是否运行：

docker ps

检查端口是否监听：

ss -lntp | grep 3000

检查防火墙是否放行 3000 端口：

ufw allow 3000

或者在云服务器安全组中放行对应端口。

2. 数据库连接失败

查看 Wiki.js 日志：

docker logs -f wikijs

确认 docker-compose.yml 中数据库用户名、密码、数据库名称是否一致。

3. 容器频繁重启

查看容器日志：

docker logs wikijs
docker logs wikijs-db

常见原因包括数据库未正常初始化、磁盘空间不足、配置文件错误等。

4. 修改配置后不生效

修改 docker-compose.yml 后，需要重新创建容器：

docker compose up -d

如果仍不生效，可以尝试：

docker compose down
docker compose up -d

注意：只要数据目录没有删除，文档数据不会丢失。

十七、安全加固建议

企业知识库可能包含内部资料，因此安全配置不能忽视。

1. 使用强密码

数据库密码、管理员密码必须使用复杂密码，不要使用默认值或弱密码。

2. 开启 HTTPS

如果知识库需要公网访问，必须启用 HTTPS，避免登录信息和文档内容被明文传输。

3. 限制访问来源

如果只是内部系统，建议只允许内网访问，或通过 VPN、堡垒机访问。

4. 定期备份

备份不仅要做，还要定期验证是否可以恢复。

5. 关闭不必要端口

如果使用 Nginx 反向代理，可以将 Wiki.js 的 3000 端口仅绑定到本机：

ports:
  - "127.0.0.1:3000:3000"

这样外部不能直接访问 3000 端口，只能通过 Nginx 访问。

6. 定期升级镜像

定期升级 Wiki.js、PostgreSQL 和宿主机系统补丁，减少安全漏洞风险。

十八、知识库运营建议

技术搭建完成后，真正决定知识库价值的是后续运营。建议企业建立一套知识库维护机制。

1. 指定负责人

每个部门至少指定一名知识库负责人，负责本部门内容整理和审核。

2. 制定文档规范

统一文档标题、格式、目录、标签和更新时间。例如：

标题：项目名称 + 文档类型
更新时间：2025-01-01
负责人：张三
适用范围：研发部 / 运维部 / 全员

3. 建立审核机制

重要文档发布前应经过审核，避免错误信息影响团队操作。

4. 定期清理过期内容

过期文档比没有文档更危险。建议每季度检查一次文档有效性。

5. 鼓励团队贡献

可以将知识库贡献纳入团队绩效或项目复盘流程，让知识沉淀成为日常工作的一部分。

十九、完整一键部署命令汇总

如果你希望快速完成部署，可以按以下步骤执行：

mkdir -p /opt/wikijs
cd /opt/wikijs

cat > docker-compose.yml <<'EOF'
version: "3.8"

services:
  db:
    image: postgres:15
    container_name: wikijs-db
    restart: unless-stopped
    environment:
      POSTGRES_DB: wiki
      POSTGRES_USER: wikijs
      POSTGRES_PASSWORD: wikijs_password_please_change
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    networks:
      - wikijs-net

  wiki:
    image: ghcr.io/requarks/wiki:2
    container_name: wikijs
    restart: unless-stopped
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijs_password_please_change
      DB_NAME: wiki
    ports:
      - "3000:3000"
    volumes:
      - ./data/wiki:/wiki/data
    networks:
      - wikijs-net

networks:
  wikijs-net:
    driver: bridge
EOF

docker compose up -d

部署完成后访问：

http://服务器IP:3000

然后根据页面提示完成管理员初始化即可。

二十、总结

通过 Docker Compose 部署企业知识库，可以大幅降低安装和维护成本。本文介绍了基于 Wiki.js 和 PostgreSQL 的一键部署方案，涵盖了环境准备、Compose 配置、系统启动、中文设置、权限规划、反向代理、数据备份、系统升级、安全加固和知识库运营等内容。

需要注意的是，知识库的价值并不只在于系统本身，而在于企业是否持续沉淀、更新和复用知识。一个长期无人维护的知识库，很快就会失去意义；而一个结构清晰、内容准确、权限合理、持续更新的知识库，则可以成为企业内部非常重要的基础设施。

如果你的团队还没有统一的知识沉淀平台，可以从 Docker 一键部署 Wiki.js 开始，用较低成本快速搭建一套属于自己的企业知识库系统。