搭建自己的企业知识库系统:基于 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、文件目录等进行统一管理,稳定性良好,适合长期托管文档服务。