Docker 企业知识库搭建｜零基础可学

在企业数字化办公场景中，知识库已经成为团队协作、经验沉淀和流程管理的重要工具。无论是技术团队的接口文档、运维手册，还是行政部门的制度规范、销售团队的话术资料，都需要一个统一、稳定、易维护的平台进行集中管理。

传统方式中，很多企业会使用网盘、Word 文档、微信群文件或本地共享目录来保存资料，但这些方式往往存在版本混乱、搜索困难、权限不清晰、多人协作不方便等问题。相比之下，搭建一个企业内部知识库系统，可以让资料管理更加规范，也能显著提升团队的信息流转效率。

本文将以零基础也能学会为目标，介绍如何使用 Docker 搭建企业知识库。文章会从 Docker 基础概念讲起，再到知识库系统选择、部署流程、数据持久化、反向代理、备份维护和安全建议，帮助你完整理解企业知识库的搭建思路。

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

企业在发展过程中会不断产生各种资料，例如：

• 产品说明文档
• 项目需求文档
• 技术接口文档
• 运维部署手册
• 员工培训资料
• 公司规章制度
• 客户服务话术
• 销售方案模板
• 常见问题 FAQ
• 会议纪要与复盘报告

如果这些内容没有统一管理，就会出现很多问题。

1. 文档分散，查找困难

很多企业资料散落在个人电脑、微信群、邮箱、网盘、项目群文件中。需要使用时，员工往往不知道该找谁，也不知道最新版本在哪里。

2. 经验无法沉淀

老员工掌握大量经验，但如果没有形成文档，新员工入职后只能靠口口相传。人员流动后，企业知识资产也会随之流失。

3. 协作效率低

多人共同维护文档时，如果依赖本地 Word 或 Excel，很容易出现版本冲突。例如“最终版”“最终修改版”“最终确认版”等文件名让人无从判断。

4. 权限管理不规范

不同部门、不同岗位能看到的资料应该有所区别。如果所有资料都放在一个公共网盘中，可能存在敏感信息泄露风险。

5. 缺少统一搜索入口

企业资料越来越多时，如果没有全文搜索功能，员工很难快速找到需要的内容。

因此，一个稳定、易用、权限清晰的知识库平台，对企业管理来说非常重要。

二、为什么选择 Docker 搭建知识库？

Docker 是一种容器化技术，可以把应用程序及其运行环境打包到容器中运行。对初学者来说，可以简单理解为：Docker 让你不用手动配置复杂环境，只需要几条命令，就能启动一个完整的软件系统。

使用 Docker 搭建知识库有以下优势。

1. 部署简单

传统部署可能需要安装 Node.js、Java、数据库、Nginx 等各种环境，并处理版本兼容问题。而 Docker 已经把这些环境打包好了，用户只需要拉取镜像并运行容器即可。

2. 环境隔离

不同应用运行在不同容器中，互不影响。例如知识库系统、数据库、缓存服务都可以分别运行在独立容器中。

3. 方便迁移

只要保存好配置文件和数据目录，就可以将知识库迁移到另一台服务器上，重新运行 Docker Compose 即可恢复服务。

4. 易于维护

升级、重启、备份都比较方便。容器出现问题时，也可以快速重建，而不会破坏数据目录。

5. 适合中小企业

对于没有专业运维团队的公司来说，Docker 可以大幅降低自建系统的门槛。

三、知识库系统如何选择？

目前常见的开源知识库系统有很多，例如 Wiki.js、BookStack、Outline、DokuWiki、MediaWiki、Halo、Docsify 等。不同工具适合不同场景。

下面简单介绍几个常见选择。

1. Wiki.js

Wiki.js 是一个现代化的开源 Wiki 系统，界面美观，支持 Markdown，支持权限管理、多语言、搜索、版本历史等功能。它适合技术团队和企业内部知识库使用。

特点：

• 界面现代
• 支持 Markdown
• 支持用户和权限管理
• 支持全文搜索
• 支持多种数据库
• 支持 Git 同步等高级功能

2. BookStack

BookStack 是一个结构清晰的知识库系统，它采用“书架、书籍、章节、页面”的层级结构，非常适合企业文档管理。

特点：

• 文档结构直观
• 上手简单
• 支持 WYSIWYG 富文本编辑
• 适合非技术人员
• 权限管理较完善
• 适合行政、产品、运营、客服等部门

3. Outline

Outline 是一个现代化团队知识库工具，界面非常简洁，体验接近 Notion。它适合追求美观和协作体验的团队，但部署依赖相对复杂。

特点：

• 界面漂亮
• 编辑体验优秀
• 适合团队协作
• 支持权限管理
• 部署要求较高

4. DokuWiki

DokuWiki 是一个经典 Wiki 系统，不依赖数据库，数据以文本文件形式保存，轻量稳定。

特点：

• 轻量
• 不需要数据库
• 易备份
• 插件丰富
• 界面相对传统

如果你是零基础用户，建议优先选择 BookStack 或 Wiki.js。本文将以 BookStack 为主要示例进行讲解，因为它结构清晰、部署简单、适合企业内部知识库。

四、部署前准备工作

在正式搭建之前，需要准备一台服务器或本地电脑。

1. 服务器配置建议

如果只是小团队内部使用，配置不需要太高：

如果企业资料中包含大量图片、附件、PDF，建议硬盘尽量大一些，并定期备份。

2. 操作系统建议

推荐使用 Linux 服务器，例如：

• Ubuntu 22.04 LTS
• Debian 12
• CentOS Stream
• Rocky Linux
• AlmaLinux

本文以 Ubuntu 为例，其他 Linux 系统命令略有差异。

3. 域名准备

如果只在公司内网使用，可以通过服务器 IP 访问。例如：

http://192.168.1.100:6875

如果希望通过域名访问，可以准备一个域名，例如：

https://kb.example.com

企业内部也可以通过内网 DNS 将域名解析到服务器。

4. 安装工具

需要安装：

• Docker
• Docker Compose
• Git，可选
• Nginx，可选，用于反向代理
• Certbot，可选，用于 HTTPS 证书

五、安装 Docker 和 Docker Compose

首先登录服务器。

ssh root@你的服务器IP

更新系统软件包：

apt update && apt upgrade -y

安装基础工具：

apt install -y curl wget vim git ca-certificates gnupg lsb-release

安装 Docker：

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

安装完成后查看 Docker 版本：

docker version

设置 Docker 开机自启：

systemctl enable docker
systemctl start docker

查看 Docker 服务状态：

systemctl status docker

如果能看到 active running，说明 Docker 已经正常启动。

Docker Compose 现在通常以插件形式安装，可以使用：

docker compose version

如果系统提示没有该命令，可以执行：

apt install -y docker-compose-plugin

再次检查：

docker compose version

六、使用 Docker Compose 部署 BookStack

接下来创建一个专门用于存放知识库配置的目录。

mkdir -p /opt/bookstack
cd /opt/bookstack

创建 docker-compose.yml 文件：

vim docker-compose.yml

写入以下内容：

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    container_name: bookstack
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=http://你的服务器IP:6875
      - DB_HOST=bookstack_db
      - DB_PORT=3306
      - DB_USERNAME=bookstack
      - DB_PASSWORD=bookstack_password
      - DB_DATABASE=bookstackapp
    volumes:
      - ./bookstack_app_data:/config
    ports:
      - 6875:80
    restart: unless-stopped
    depends_on:
      - bookstack_db

  bookstack_db:
    image: lscr.io/linuxserver/mariadb:latest
    container_name: bookstack_db
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=root_password
      - TZ=Asia/Shanghai
      - MYSQL_DATABASE=bookstackapp
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=bookstack_password
    volumes:
      - ./bookstack_db_data:/config
    restart: unless-stopped

需要注意：

• APP_URL 要改成你实际访问地址。
• DB_PASSWORD 和 MYSQL_PASSWORD 要保持一致。
• MYSQL_ROOT_PASSWORD 建议设置为复杂密码。
• volumes 用于数据持久化，删除容器后数据不会丢失。
• restart: unless-stopped 表示服务器重启后容器自动启动。

保存文件后，启动服务：

docker compose up -d

查看容器状态：

docker ps

如果看到 bookstack 和 bookstack_db 都在运行，说明服务启动成功。

查看日志：

docker logs -f bookstack

第一次启动可能需要等待几分钟，因为系统会初始化数据库。

七、访问 BookStack 并完成初始化

浏览器访问：

http://你的服务器IP:6875

如果使用的是内网服务器，例如：

http://192.168.1.100:6875

默认管理员账号通常为：

邮箱：admin@admin.com
密码：password

登录后，务必第一时间修改管理员密码。

进入后台后，可以进行以下配置：

1. 修改站点名称，例如“企业知识库”
2. 修改管理员邮箱和密码
3. 创建部门用户
4. 创建用户角色
5. 设置访问权限
6. 创建书架、书籍、章节和页面

八、理解 BookStack 的文档结构

BookStack 的结构非常适合企业使用，它采用四层模型：

书架 Shelf
  └── 书籍 Book
        └── 章节 Chapter
              └── 页面 Page

可以这样理解：

1. 书架

书架相当于企业中的大分类，例如：

• 技术中心
• 产品中心
• 市场销售
• 客户服务
• 人力行政
• 财务制度
• 项目管理

2. 书籍

书籍相当于某个分类下的具体主题，例如在“技术中心”下可以创建：

• 运维手册
• 后端开发规范
• 前端开发规范
• 数据库规范
• 接口文档
• 故障处理记录

3. 章节

章节用于进一步划分内容。例如“运维手册”中可以有：

• Linux 基础
• Docker 部署
• Nginx 配置
• 数据库备份
• 服务器安全
• 常见故障处理

4. 页面

页面就是具体文档内容，例如：

• 如何重启 Docker 服务
• 如何查看服务器磁盘空间
• 如何备份 MySQL 数据库
• 如何配置 HTTPS 证书
• 线上故障排查流程

这种结构非常适合企业进行长期沉淀，不容易混乱。

九、企业知识库内容规划建议

系统搭建完成只是第一步，更重要的是如何规划内容。如果规划不好，知识库很快会变成另一个“杂乱网盘”。

1. 建议先设计目录结构

可以根据部门或业务线设计一级分类。

示例：

企业知识库
├── 公司制度
│   ├── 员工手册
│   ├── 考勤制度
│   ├── 报销制度
│   └── 信息安全规范
├── 产品资料
│   ├── 产品介绍
│   ├── 版本说明
│   ├── 用户手册
│   └── 常见问题
├── 技术文档
│   ├── 开发规范
│   ├── 接口文档
│   ├── 部署手册
│   └── 故障记录
├── 销售资料
│   ├── 销售话术
│   ├── 客户案例
│   ├── 报价模板
│   └── 竞品分析
└── 客服支持
    ├── FAQ
    ├── 工单处理流程
    ├── 标准回复模板
    └── 售后问题汇总

2. 统一文档命名规范

建议采用清晰的命名方式，例如：

系统名称-功能模块-文档类型

示例：

CRM系统-客户管理-操作手册
订单系统-支付模块-接口文档
服务器巡检-日常检查清单

3. 使用固定文档模板

不同类型文档可以采用统一模板。

例如操作手册模板：

# 文档标题

## 一、适用范围

## 二、操作前准备

## 三、操作步骤

## 四、注意事项

## 五、常见问题

## 六、相关负责人

故障处理模板：

# 故障标题

## 一、故障时间

## 二、影响范围

## 三、故障现象

## 四、原因分析

## 五、处理过程

## 六、恢复时间

## 七、复盘总结

## 八、改进措施

这样可以让知识库文档更加统一，也方便新员工阅读。

十、权限管理建议

企业知识库通常不适合所有人看到所有内容，因此权限管理非常重要。

可以按照部门或岗位创建角色，例如：

• 超级管理员
• 知识库管理员
• 技术人员
• 产品人员
• 销售人员
• 客服人员
• 普通员工
• 只读访客

权限规划原则

1. 最小权限原则

用户只拥有完成工作所需的最低权限，不要随意给编辑、删除或管理员权限。

2. 敏感资料单独管理

例如财务资料、合同模板、客户信息、账号密码等，不建议放在普通知识库中。如果必须存放，应严格限制访问权限。

3. 管理员账号不要多人共用

每个人应使用自己的账号登录，便于审计和追踪操作记录。

4. 离职员工及时禁用账号

员工离职后，应立即禁用或删除账号，避免资料泄露。

十一、配置域名访问

如果希望使用域名访问，例如：

http://kb.example.com

需要将域名解析到服务器 IP。

然后安装 Nginx：

apt install -y nginx

创建配置文件：

vim /etc/nginx/sites-available/bookstack.conf

写入：

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

    location / {
        proxy_pass http://127.0.0.1:6875;
        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;
    }
}

启用配置：

ln -s /etc/nginx/sites-available/bookstack.conf /etc/nginx/sites-enabled/bookstack.conf

检查配置：

nginx -t

重载 Nginx：

systemctl reload nginx

此时可以通过域名访问：

http://kb.example.com

同时要修改 docker-compose.yml 中的 APP_URL：

- APP_URL=http://kb.example.com

修改后重启容器：

docker compose down
docker compose up -d

十二、配置 HTTPS 证书

如果知识库通过公网访问，强烈建议启用 HTTPS。

安装 Certbot：

apt install -y certbot python3-certbot-nginx

申请证书：

certbot --nginx -d kb.example.com

按照提示输入邮箱并确认即可。

申请成功后，Certbot 会自动修改 Nginx 配置，并启用 HTTPS。

检查自动续期：

certbot renew --dry-run

如果测试成功，证书到期前会自动续期。

此时也需要将 APP_URL 修改为：

- APP_URL=https://kb.example.com

重启容器：

docker compose down
docker compose up -d

十三、数据备份与恢复

知识库一旦投入使用，数据备份非常重要。建议至少备份以下内容：

• BookStack 应用配置和附件数据
• MariaDB 数据库数据
• docker-compose.yml 配置文件
• Nginx 配置文件

由于本文使用了数据卷目录：

/opt/bookstack/bookstack_app_data
/opt/bookstack/bookstack_db_data

可以直接备份整个 /opt/bookstack 目录。

1. 简单备份方式

停止容器：

cd /opt/bookstack
docker compose down

压缩备份：

tar -czvf bookstack-backup-$(date +%F).tar.gz /opt/bookstack

启动容器：

docker compose up -d

这种方式适合小型团队，简单可靠。

2. 在线数据库备份方式

如果不想停止服务，可以使用数据库导出方式：

docker exec bookstack_db mysqldump -u root -proot_password bookstackapp > bookstack_db_$(date +%F).sql

然后再备份应用数据目录：

tar -czvf bookstack_app_data_$(date +%F).tar.gz /opt/bookstack/bookstack_app_data

3. 定时备份建议

可以使用 crontab 设置定时任务，例如每天凌晨 2 点备份：

crontab -e

添加：

0 2 * * * tar -czvf /backup/bookstack-$(date +\%F).tar.gz /opt/bookstack

注意：生产环境建议将备份文件同步到其他服务器、NAS 或对象存储，避免服务器硬盘损坏导致备份和数据同时丢失。

十四、升级知识库系统

Docker 部署的好处之一就是升级方便。

进入目录：

cd /opt/bookstack

拉取最新镜像：

docker compose pull

重新启动：

docker compose down
docker compose up -d

查看日志：

docker logs -f bookstack

升级前一定要备份数据，避免新版本不兼容或升级失败造成数据损失。

十五、常见问题排查

1. 页面无法访问

检查容器是否运行：

docker ps

检查端口是否监听：

ss -tulnp | grep 6875

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

ufw allow 6875

如果使用云服务器，还需要在云厂商安全组中放行端口。

2. 数据库连接失败

查看 docker-compose.yml 中以下配置是否一致：

DB_USERNAME
DB_PASSWORD
DB_DATABASE
MYSQL_USER
MYSQL_PASSWORD
MYSQL_DATABASE

同时查看数据库日志：

docker logs bookstack_db

3. 登录后样式异常

通常是 APP_URL 配置错误。例如你通过域名访问，但配置中仍然是 IP 地址，可能会导致跳转或资源加载异常。

修改 APP_URL 后重启：

docker compose down
docker compose up -d

4. 上传附件失败

检查数据目录权限：

ls -lah /opt/bookstack

可以尝试调整权限：

chown -R 1000:1000 /opt/bookstack

然后重启容器。

5. 容器启动失败

查看日志：

docker logs bookstack
docker logs bookstack_db

日志通常会提示具体原因，例如数据库密码错误、端口占用、目录权限不足等。

十六、安全加固建议

企业知识库中往往包含内部资料，因此不能只关注“能用”，还要关注安全。

1. 修改默认账号密码

系统初始化后，必须立即修改默认管理员账号和密码。

2. 使用强密码

密码建议至少包含：

• 大写字母
• 小写字母
• 数字
• 特殊符号
• 长度不少于 12 位

3. 限制公网访问

如果知识库只供公司内部使用，建议部署在内网，或通过 VPN 访问，而不是直接暴露在公网。

4. 启用 HTTPS

公网访问必须使用 HTTPS，避免账号密码和文档内容在传输过程中被窃听。

5. 定期更新镜像

定期执行：

docker compose pull
docker compose up -d

保持系统处于较新版本，减少安全漏洞风险。

6. 做好备份和恢复演练

备份不是目的，能恢复才是关键。建议定期在测试环境中演练恢复流程。

7. 控制管理员数量

管理员权限越多，风险越大。建议只保留少数可靠人员拥有管理员权限。

十七、企业落地实施流程

如果你准备在企业中正式推广知识库，可以按照以下步骤推进。

第一步：确定负责人

指定一名知识库管理员，负责整体目录规划、权限配置、文档规范和日常维护。

第二步：搭建测试环境

先在测试服务器或本地虚拟机上部署 BookStack，熟悉功能后再上线正式环境。

第三步：设计目录结构

根据公司部门、业务流程和使用场景设计书架、书籍和章节结构。

第四步：导入核心文档

优先导入高频使用的文档，例如制度、流程、FAQ、操作手册。

第五步：设置权限

按部门和岗位配置访问范围，避免无关人员访问敏感资料。

第六步：培训员工使用

安排一次简单培训，说明如何搜索、阅读、编辑和提交文档。

第七步：建立维护机制

例如规定：

• 每个部门指定文档负责人
• 文档每季度检查一次
• 过期文档要标记或归档
• 新项目必须同步创建文档
• 故障处理后必须写复盘文档

只有建立机制，知识库才能长期保持活力。

十八、知识库运营建议

很多企业知识库刚上线时热情很高，但过几个月后就无人维护。要避免这种情况，需要关注运营。

1. 不要追求一步到位

初期不需要把所有历史资料都整理进去，可以先从最常用、最重要的文档开始。

2. 鼓励员工贡献

可以设置“文档贡献榜”，鼓励员工总结经验。

3. 定期清理过期内容

过期文档比没有文档更危险，因为它可能误导员工。

4. 给文档加负责人

每篇重要文档都应该有负责人，便于后续更新。

5. 建立审批流程

对于制度类、财务类、客户类文档，发布前应经过负责人审核。

十九、总结

使用 Docker 搭建企业知识库并不复杂。对于零基础用户来说，只要理解 Docker 的基本作用，准备好服务器，按照 Docker Compose 配置文件启动服务，就可以快速拥有一套可用的企业知识库系统。

本文以 BookStack 为例，完整介绍了从环境准备、Docker 安装、系统部署、域名配置、HTTPS、备份恢复、升级维护到权限安全的全过程。

简单回顾一下核心步骤：

1. 准备服务器
2. 安装 Docker 和 Docker Compose
3. 创建 docker-compose.yml
4. 启动 BookStack 和数据库
5. 访问系统并修改默认密码
6. 规划知识库目录
7. 配置用户和权限
8. 设置域名与 HTTPS
9. 做好备份和安全维护

对于企业来说，知识库不是单纯的软件系统，而是一套知识管理机制。Docker 解决的是部署问题，BookStack 解决的是内容承载问题，而真正决定知识库价值的，是企业是否愿意持续整理、更新和复用知识。

只要从小范围开始，坚持沉淀，企业知识库就会逐渐成为团队协作、员工培训、项目交付和组织管理的重要基础设施。