前言

在当今信息爆炸的时代，一个高效的知识管理系统对于团队和个人都至关重要。Wiki.js是一款现代化的开源Wiki系统，基于Node.js开发，具有响应式设计、Markdown支持、多用户协作等强大功能。本文将详细介绍如何使用Docker在推荐服务器平台Cloud CIUIC上部署Wiki.js。

准备工作

服务器选择

对于Wiki.js的部署，我们推荐使用Cloud CIUIC的云服务器。它们提供高性能的SSD存储、稳定的网络连接和灵活的资源配置，非常适合运行数据库和Web应用。

建议选择以下配置：

CPU: 2核或以上内存: 4GB或以上存储: 50GB SSD操作系统: Ubuntu 20.04 LTS

软件需求

确保服务器已安装以下软件：

Docker 20.10或更高版本Docker Compose 1.29或更高版本

安装Docker和Docker Compose

如果您的服务器尚未安装Docker，可以按照以下步骤安装：

# 更新软件包索引sudo apt-get update# 安装必要的依赖sudo apt-get install \    apt-transport-https \    ca-certificates \    curl \    gnupg \    lsb-release# 添加Docker官方GPG密钥curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg# 设置稳定版仓库echo \  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null# 安装Docker引擎sudo apt-get updatesudo apt-get install docker-ce docker-ce-cli containerd.io# 验证Docker安装sudo docker run hello-world# 安装Docker Composesudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

创建Wiki.js的Docker Compose文件

我们将使用PostgreSQL作为Wiki.js的数据库，下面是完整的docker-compose.yml文件：

version: '3'services:  db:    image: postgres:13    environment:      POSTGRES_DB: wiki      POSTGRES_PASSWORD: wikijsrocks      POSTGRES_USER: wikijs    logging:      driver: "none"    restart: unless-stopped    volumes:      - db_data:/var/lib/postgresql/data    networks:      - wikinet  wiki:    image: ghcr.io/requarks/wiki:2    depends_on:      - db    environment:      DB_TYPE: postgres      DB_HOST: db      DB_PORT: 5432      DB_USER: wikijs      DB_PASS: wikijsrocks      DB_NAME: wiki    restart: unless-stopped    ports:      - "80:3000"    networks:      - wikinetvolumes:  db_data:networks:  wikinet:

部署Wiki.js

创建一个专门的项目目录：

mkdir wikijs && cd wikijs

将上面的docker-compose.yml文件保存到该目录中

启动服务：

docker-compose up -d

这个命令会下载所需的镜像并启动容器。-d参数表示在后台运行。

访问和初始化Wiki.js

服务启动后，打开浏览器访问您的服务器IP地址(如果您在Cloud CIUIC上部署，可以使用他们提供的IP或域名)。您将看到Wiki.js的初始化页面。

按照以下步骤完成设置：

选择语言(简体中文可用)设置管理员账户配置Wiki名称和描述确认数据库连接(已经在docker-compose中配置好了)完成安装

配置Nginx反向代理(可选)

为了更好的性能和安全性，建议设置Nginx作为反向代理并启用HTTPS。

首先安装Nginx：

sudo apt install nginx

然后创建一个新的配置文件/etc/nginx/sites-available/wikijs：

server {    listen 80;    server_name your-domain.com; # 替换为您的域名    location / {        proxy_pass http://localhost:80; # 指向Wiki.js容器        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;    }}

启用配置并测试：

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

启用HTTPS(推荐)

使用Let's Encrypt免费SSL证书：

sudo apt install certbot python3-certbot-nginxsudo certbot --nginx -d your-domain.com

按照提示操作，Certbot会自动配置Nginx使用HTTPS。

备份和恢复

备份数据库

docker exec wikijs_db_1 pg_dump -U wikijs wiki > wiki_backup.sql

恢复数据库

cat wiki_backup.sql | docker exec -i wikijs_db_1 psql -U wikijs wiki

备份上传的文件

Wiki.js的上传文件存储在./storage目录(如果您按照官方文档映射了卷)，只需备份这个目录即可。

升级Wiki.js

要升级到最新版本，只需停止并重新启动容器：

docker-compose downdocker-compose pulldocker-compose up -d

性能优化

增加缓存：在Wiki.js管理面板中启用Redis缓存调整PostgreSQL配置：根据服务器内存大小优化数据库参数使用CDN：对于公共Wiki，可以考虑使用CDN加速静态资源

常见问题解决

1. 无法访问Wiki.js

检查容器是否正常运行：

docker ps

如果容器没有运行，查看日志：

docker logs wikijs_wiki_1

2. 数据库连接问题

确保PostgreSQL容器正在运行，并验证环境变量是否正确：

docker exec -it wikijs_db_1 psql -U wikijs -d wiki

3. 忘记管理员密码

可以通过以下命令重置密码：

docker exec -it wikijs_wiki_1 node wiki reset-admin

通过本教程，您已经成功在Cloud CIUIC服务器上使用Docker部署了Wiki.js。这个现代化的Wiki系统将为您的团队或个人提供强大的知识管理功能。Docker的容器化部署方式使得维护和升级变得非常简单，而Cloud CIUIC的高性能服务器确保了Wiki.js的流畅运行。

Wiki.js还支持许多高级功能，如：

LDAP/Active Directory集成Git存储后端多语言支持API访问控制

您可以通过访问官方文档探索更多功能，不断优化您的Wiki系统。