如何在CentOS 7上安装Wiki.js

• 要求
• 安装Git
• 安装Node.js
• 安装MongoDB
• 安装和配置Nginx
• 安装Acme.sh客户端并获取Let's Encrypt证书（可选）
• 安装Wiki.js
• 设置PM2

Wiki.js是基于Node.js，MongoDB，Git和Markdown构建的免费，开源的现代Wiki应用程序。Wiki.js源代码公开托管在Github上。本指南将向您展示如何使用Node.js，MongoDB，PM2，Nginx，Git和Acme.sh在新的CentOS 7 Vultr实例上安装Wiki.js。

要求

运行Wiki.js的要求如下：

• Node.js版本6.9.0或更高版本
• MongoDB 3.2版或更高版本
• Nginx的
• Git 2.7.4或更高版本
• 符合Git的存储库（公共或私有）（可选）
• 至少768MB RAM
• 带有A/ AAAA记录的域名

检查CentOS版本。

cat /etc/centos-release
# CentOS Linux release 7.5.1804 (Core)

创建一个non-root具有sudo访问权限的新用户帐户并切换到该帐户。

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

注意：用您的用户名替换johndoe。

设置时区。

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

确保您的系统是最新的。

sudo yum update -y

安装必要的软件包以完成本教程。

sudo yum install -y wget curl vim zip unzip bash-completion

禁用SELinux和防火墙。

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

启用EPEL存储库。

sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

安装Git

CentOS储存库提供了一个非常过时的Git版本，因此我们将需要从源代码构建Git。

通过从源代码构建Git来安装它。

# Remove existing git package if installed: 
sudo yum remove -y git
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gettext-devel openssl-devel perl-CPAN perl-devel zlib-devel curl-devel
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.17.1.tar.gz && tar zxvf git-2.17.1.tar.gz
rm git-2.17.1.tar.gz
cd git-2.17.1
make configure
./configure
make prefix=/usr/local all
sudo make prefix=/usr/local install
cd ~

# Confirm this command returns /usr/local/bin/git:
which git

验证版本。

git --version
# git version 2.17.1

安装Node.js

Wiki.js需要Node.js 6.9.0或更高版本，因此我们首先需要安装Node.js。

通过使用Node.js的NodeSource YUM存储库来安装Node.js。

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum install -y nodejs

检查Node.js和NPM版本。

node -v && npm -v
# v8.11.2
# 5.6.0

安装MongoDB

Wiki.js使用MongoDB作为数据库引擎。我们将使用官方的MongoDB存储库，其中包含最新的主要和次要MongoDB版本。

安装MongoDB社区版。

sudo vim /etc/yum.repos.d/mongodb-org-3.6.repo

# Copy/paste this
[mongodb-org-3.6]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc

sudo yum install -y mongodb-org

检查版本。

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.5
# db version v3.6.5

启用并启动MongoDB。

sudo systemctl enable mongod.service
sudo systemctl start mongod.service

安装和配置Nginx

强烈建议在Wiki.js前面放置一个标准的Web服务器。这样可以确保您可以使用SSL，多个网站，缓存等功能。

安装Nginx。

sudo vim /etc/yum.repos.d/nginx_mainline.repo

# Copy/paste this
[nginx]
name=nginx repo
baseurl=https://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=1
enabled=1

wget https://nginx.org/keys/nginx_signing.key
sudo rpm --import nginx_signing.key
rm nginx_signing.key

sudo yum install -y nginx

检查版本。

nginx -v
# nginx version: nginx/1.15.0

启用并启动Nginx。

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

配置Nginx的作为HTTP或HTTPS反向代理用于Wiki.js.

运行sudo vim /etc/nginx/conf.d/wiki.js.conf并使用下面的基本反向代理配置填充它。

server {

    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://127.0.0.1:3000;
        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;
    }

}

在上述配置中server_name，唯一需要更改的是伪指令，proxy_pass如果决定配置除以外的任何其他端口，则可能是伪指令3000。Wiki.js 3000默认使用端口。

检查配置。

sudo nginx -t

重新加载Nginx。

sudo systemctl reload nginx.service

安装Acme.sh客户端并获取Let's Encrypt证书（可选）

HTTPS不必使用Wiki保护您的Wiki ，但这是确保您的网站访问量的一个好习惯。为了从Let's Encrypt获得SSL证书，我们将使用Acme.sh客户端。Acme.sh是一个纯UNIX shell脚本，用于以零依赖关系从Let's Encrypt获得SSL证书。与其他一些需要大量依赖才能成功运行的Acme协议客户端相比，它非常轻巧。

下载并安装Acme.sh。

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail your_email@example.com
cd ~

检查版本。

/etc/letsencrypt/acme.sh --version
# v2.7.9

为您的域名/主机名获取RSA和ECDSA证书。

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail your_email@example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail your_email@example.com --ocsp-must-staple --keylength ec-256 

运行上述命令后，您的证书和密钥将位于以下目录中：

• 对于RSA： /etc/letsencrypt/wiki.example.com
• 对于ECC / ECDSA： /etc/letsencrypt/wiki.example.com_ecc

注意：不要忘记wiki.example.com用您的域名替换。

从Let's Encrypt获得证书后，我们需要配置Nginx来利用它们。

sudo vim /etc/nginx/conf.d/wiki.js.conf再次运行，并将Nginx配置为HTTPS反向代理。

server {

    listen [::]:443 ssl http2;
    listen 443 ssl http2;
    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    # RSA
    ssl_certificate /etc/letsencrypt/wiki.example.com/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com/wiki.example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/wiki.example.com.key;

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://127.0.0.1:3000;
        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;
    }

}

检查配置。

sudo nginx -t

重新加载Nginx。

sudo systemctl reload nginx.service

安装Wiki.js

在应该安装Wiki.js的地方创建一个空的文档根文件夹。

sudo mkdir -p /var/www/wiki.example.com

导航到文档根文件夹。

cd /var/www/wiki.example.com

将/var/www/wiki.example.com文件夹的所有权更改为user johndoe。

sudo chown -R johndoe:johndoe /var/www/wiki.example.com

在该/var/www/wiki.example.com文件夹中，运行以下命令以下载并安装Wiki.js。

curl -sSo- https://wiki.js.org/install.sh | bash

您可以运行以下命令以查看Wiki.js的当前安装版本。

node wiki --version
# 1.0.78

安装完成后，系统将提示您运行配置向导。

启动配置向导。

node wiki configure

这将通知您导航http://localhost:3000以配置Wiki.js。如果您在Wiki.js前面有Nginx，则可以打开域名（例如http://wiki.example.com），而不用打开localhost。

使用网络浏览器，浏览http://wiki.example.com并遵循屏幕上的说明。在配置向导期间输入的所有设置都已保存在config.yml文件中。配置向导将自动为您启动Wiki.js。

设置PM2

默认情况下，Wiki.js在系统重启后不会自动启动。为了使其在启动时启动，我们需要设置PM2进程管理器。

告诉PM2将其自身配置为启动服务。

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup

最后，通过运行命令保存当前的PM2配置。

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

您的Wiki.js实例使用PM2作为其进程管理器，作为后台进程运行。您可以使用重新启动操作系统，sudo reboot并确保Wiki.js在重新启动后启动。