搭建自己的企业知识库系统:基于 Wiki.js 的云服务器部署实战
在团队协作和信息管理日益复杂的今天,企业内部需要一套结构化、统一化、可长期沉淀的知识系统。不少公司会选择使用 Confluence、语雀、Notion 等第三方工具,但这些平台要么收费较高,要么数据控制权在第三方手里。
如果你想拥有一套完全可控、可扩展的知识管理系统,部署一套开源的 Wiki 系统是个非常合适的选择。本文将介绍如何基于 Wiki.js 搭建属于你的企业知识库系统,并通过宝塔面板简化服务器环境管理。
一、为什么选择 Wiki.js?
Wiki.js 是一款现代化、界面简洁的开源 Wiki 系统,基于 Node.js 构建,支持多种数据库后端。主要优势包括:
-  支持 Markdown 与富文本编辑器 
-  页面版本控制、权限控制、全文搜索 
-  支持多语言、主题切换、自定义导航 
-  多种认证方式(OAuth、LDAP、本地) 
-  与 Git 同步、导入导出、API 支持 
对于希望构建自用文档系统、团队内部知识库、API文档中心的用户,Wiki.js 是非常理想的选择。
二、部署准备
推荐服务器配置:
| 项目 | 建议配置 | 
|---|---|
| 操作系统 | Ubuntu 20.04 / CentOS 7 | 
| 内存 | 2GB+(推荐 4GB 以上) | 
| 数据库 | PostgreSQL(默认) | 
| Node.js | 16.x 或以上 | 
三、安装宝塔面板(推荐管理方式)
宝塔支持一键管理 Nginx、数据库、网站目录,非常适合部署 Node 应用。
按系统选择安装命令:
Ubuntu 系统:
wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh 02f332488
CentOS 系统:
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh 02f332488
安装完成后,登录宝塔后台,统一配置运行环境。
四、安装 PostgreSQL 数据库
Wiki.js 默认使用 PostgreSQL,宝塔面板也支持一键安装:
-  打开宝塔【软件商店】 
-  安装 PostgreSQL 13 或以上版本 
-  设置数据库名、用户、密码并记录 
五、安装 Node.js 与 Wiki.js
安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo bash -
sudo apt install -y nodejs
下载 Wiki.js 程序
mkdir /www/wwwroot/wikijs
cd /www/wwwroot/wikijs
wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
tar -xvzf wiki-js.tar.gz
创建配置文件 .env
 
参考示例修改配置:
PORT=3000
DB_TYPE=postgres
DB_HOST=localhost
DB_PORT=5432
DB_USER=youruser
DB_PASS=yourpass
DB_NAME=wikidb
六、使用 PM2 守护进程运行 Wiki.js
安装 PM2:
npm install -g pm2
启动 Wiki.js:
pm2 start server --name wikijs
pm2 save
pm2 startup
此时 Wiki.js 会在 3000 端口运行。
七、配置 Nginx 反向代理
在宝塔后台创建网站并设置反向代理:
-  将请求代理到 http://127.0.0.1:3000
-  配置 HTTPS(使用 Let’s Encrypt 免费证书) 
-  设置伪静态规则为空 
访问你绑定的域名,即可进入 Wiki.js 安装向导。
八、完成初始化配置
-  设置管理员账户 
-  选择默认编辑器(Markdown 或富文本) 
-  设置站点名称、语言等参数 
-  创建首页并开始撰写内容 
九、日常运维建议
-  定期备份数据库和站点数据目录 
-  限制公开注册,仅限团队成员访问 
-  使用 LDAP/OAuth 实现企业内部账号登录 
-  可结合 Git 做文档自动同步与版本控制 
-  安装全文搜索插件提升检索效率 
十、总结
部署 Wiki.js 是构建企业知识库、自定义文档系统、API说明中心的优秀方案,拥有以下优势:
-  界面美观、上手简单 
-  文档结构清晰、支持嵌套分类 
-  高度可定制、安全可控 
-  完全离线部署、数据自主掌控 
相比市面上封闭的 SaaS 工具,自部署方案适合对数据安全、访问控制有较高要求的组织使用。
📌 本项目部署使用的服务器由慈云数据提供,搭载宝塔面板,便于对数据库、Nginx、文件目录等进行统一管理,稳定性良好,适合长期托管文档服务。
