Wiki.js：轻量级且功能强大的Wiki程序

目前我觉得比较好用的wiki程序是bookstack，不过这个wiki.js也相当不错，ui非常华丽~

wiki.js除了上手（新手可能有点不太会用）比bookstack难一点外，其他可以说是各有千秋。。。

我先前手动部署了一遍，后来想想还是用docker算了，所以这里把手动和docker的过程都记录一下。

手动安装，安装所有需要用到的软件：

apt -y update
apt -y install build-essential nginx python-certbot-nginx gnupg apt-transport-https curl wget
echo "deb http://apt.postgresql.org/pub/repos/apt/ buster-pgdg main" > /etc/apt/sources.list.d/pgdg.list
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add -
curl -sL https://deb.nodesource.com/setup_14.x | bash -
apt -y update
apt -y install nodejs postgresql-12

设置nginx/postgresql自启：

systemctl enable nginx postgresql

登录到postgresql的shell：

sudo -u postgres psql

创建数据库/用户/授权：

CREATE DATABASE wiki;
CREATE USER wikijs WITH PASSWORD '设置你的数据库用户密码';
GRANT ALL PRIVILEGES ON DATABASE wiki to wikijs;
\q

备份数据库/恢复：

sudo -u postgres pg_dump wiki > wiki.sql
sudo -u postgres psql wiki < wiki.sql

下载程序解压/复制一份配置文件/给予正确的文件权限：

mkdir -p /opt/wiki && cd /opt/wiki
wget https://github.com/Requarks/wiki/releases/download/2.4.107/wiki-js.tar.gz
tar -xzvf wiki-js.tar.gz
mv config.sample.yml config.yml
chown -R nobody:nogroup /opt/wiki

编辑配置文件：

nano config.yml

填写你的postgresql数据库信息：

db:
  type: postgres
  host: localhost
  port: 5432
  user: wikijs
  pass: 设置你的数据库用户密码
  db: wiki
  ssl: false

还是在这个配置文件内，把监听地址改为本地，因为等会我们会使用nginx反向代理：

bindIP: 127.0.0.1

新建一个systemd服务文件：

nano /lib/systemd/system/wiki.service

写入如下配置：

[Unit]
Description=Wiki.js

[Service]
Type=simple
User=nobody
Environment=NODE_ENV=production
WorkingDirectory=/opt/wiki
ExecStart=/usr/bin/node server
Restart=always

[Install]
WantedBy=multi-user.target

启动wiki.js/设置开机自启：

systemctl start wiki
systemctl enable wiki

新建一个nginx站点配置文件用于反向代理：

nano /etc/nginx/conf.d/wiki.conf

写入如下配置：

server {
    listen       80;
    server_name  wiki.imlala.best; # 换成你的域名

location / {
    proxy_pass       http://127.0.0.1:3000;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_next_upstream error timeout http_502 http_503 http_504;
    }
}

最后使用certbot签发一个ssl证书：

certbot --nginx --agree-tos --no-eff-email --email xxxxx@qq.com

手动安装的过程就到此结束了，打开你的域名就能看到wiki.js的向导界面了，这里就不截图了。

如果你使用docker和docker-compose来部署的话可以节省你很多的时间，首先我们安装docker和docker-compose：

curl -sSL https://get.docker.com/ | sh
systemctl start docker
systemctl enable docker
curl -L https://github.com/docker/compose/releases/download/1.25.4/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

然后新建一个docker-compose.yml：

mkdir -p /opt/docker-wikijs && cd /opt/docker-wikijs && nano docker-compose.yml

写入如下配置：

version: '3.5'

services:
  wiki-db:
    image: postgres:11-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: password
      POSTGRES_USER: wikijs
    logging:
      driver: "none"
    restart: unless-stopped
    volumes:
      - ./data:/var/lib/postgresql/data

  wiki:
    image: requarks/wiki:2
    depends_on:
      - wiki-db
    environment:
      DB_TYPE: postgres
      DB_HOST: wiki-db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: password
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "3000:3000"

up起来即可：

docker-compose up -d

反代使用上面的nginx配置文件即可，这里不重复叙述了。打开你的域名就能看到wiki.js的向导界面了，填写管理员账号和密码以及你的域名：

UI很漂亮的：

这里就不介绍怎么使用了，刚开始用你可能需要摸索一下，程序是支持中文的，在后台可以安装语言包：