在团队协作与个人知识管理中，一个轻量、可扩展且支持 Markdown 的维基系统至关重要。Wiki.js 凭借其现代化的界面、强大的权限管理及对 Git 的原生集成，成为众多开发者的首选。本文将以零基础视角，手把手带你在 Ciuic 云端服务器 上完成 Wiki.js 的部署。

为什么选择 Wiki.js？

极速性能：基于 Node.js 构建，响应速度快。界面优雅：内置多种主题，支持暗黑模式，编辑器体验流畅。存储灵活：支持 PostgreSQL、MySQL、SQLite 或 SQL Server，并可对接 Git 仓库实现版本回溯。权限细粒度：支持用户组、页面级权限控制，适合企业内部分享。

部署前准备

服务器：推荐 1核 2GB 内存以上的 Linux 实例（如 Ubuntu 22.04）。可前往 Ciuic 云控制台 快速创建。域名（可选）：若需用域名访问，请提前解析 A 记录到服务器 IP。SSH 客户端：Windows 用户可用 Xshell 或 PuTTY，macOS/Linux 直接使用终端。

基础环境安装

更新系统包

sudo apt update && sudo apt upgrade -y

安装 Node.js 18+ 与 npm

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -sudo apt install -y nodejsnode -v   # 检查版本

安装 PostgreSQL（推荐）

sudo apt install -y postgresql postgresql-contribsudo systemctl enable postgresql

创建数据库用户与库：

sudo -u postgres psqlCREATE DATABASE wiki;CREATE USER wikiuser WITH PASSWORD '你的强密码';GRANT ALL PRIVILEGES ON DATABASE wiki TO wikiuser;\q

安装 Wiki.js

下载最新版（在 /opt 目录下）

cd /optsudo mkdir wiki && cd wikisudo wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gzsudo tar -xzf wiki-js.tar.gz

配置文件

sudo cp config.sample.yml config.ymlsudo nano config.yml

修改以下核心参数：

port: 3000db: type: postgres host: localhost port: 5432 user: wikiuser pass: '你的强密码' db: wiki

保存并退出。

启动服务

sudo node server

若看到 Wiki.js started on port 3000 说明启动成功。建议使用 pm2 守护进程：

sudo npm install -g pm2sudo pm2 start server.js --name wikisudo pm2 savesudo pm2 startup

反向代理与 HTTPS（可选但推荐）

安装 Nginx

sudo apt install -y nginx

配置站点

sudo nano /etc/nginx/sites-available/wiki

写入：

server {   listen 80;   server_name 你的域名或IP;   location / {       proxy_pass http://localhost:3000;       proxy_set_header Host $host;       proxy_set_header X-Real-IP $remote_addr;   }}

启用并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/wiki /etc/nginx/sites-enabled/sudo systemctl restart nginx

HTTPS 证书（推荐使用 Let's Encrypt）：

sudo apt install -y certbot python3-certbot-nginxsudo certbot --nginx -d 你的域名

初始化 Wiki.js

浏览器访问 http://你的服务器IP 或域名。按引导设置管理员邮箱、密码及站点名称。登录后，即可开始创建页面、设置导航栏。

日常维护建议

备份数据库：定期执行 pg_dump wiki > backup.sql。更新版本：停止服务，覆盖 /opt/wiki 下文件，重启 pm2 进程。防火墙：确保仅开放 80/443 端口，3000 端口仅在本地监听。

总结

通过上述步骤，你已在 Ciuic 云端服务器 上成功部署了一个生产级 Wiki.js 站点。Ciuic 提供稳定高效的云资源，配合 Wiki.js 的灵活性，无论是个人笔记还是团队文档中心，都能得心应手。后续可探索 Git 同步、插件市场等高级功能，让知识库真正“活”起来。立即行动，开启你的现代维基之旅吧！