如何在FreeBSD 11上安装Wiki.js

• 要求
• 在你开始之前
• 安装Node.js
• 安装MongoDB
• 安装Acme.sh并获取“让我们加密”证书（可选）
• 安装和配置Nginx
• 安装Wiki.js
• 安装和设置PM2流程管理器

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

要求

运行Wiki.js的要求如下：

• Node.js版本6.11.1或更高版本
• MongoDB 3.2版或更高版本
• Git 2.7.4或更高版本
• Web服务器，例如Nginx，Apache，IIS，Caddy或H2O。本指南将使用Nginx。
• 兼容Git的存储库（公共或私有），这是可选的
• 至少512MB RAM。强烈建议使用内存至少为1GB的计算机。
• 带有A/ AAAA记录的域名。在本指南中，我们将以wiki.example.com域为例。

在你开始之前

检查FreeBSD版本。

uname -ro
# FreeBSD 11.2-RELEASE

确保您的FreeBSD系统是最新的。

freebsd-update fetch install
pkg update && pkg upgrade -y

安装sudo，vim，unzip，wget，git，bash和socat包，如果它们不存在您的系统上。

pkg install -y sudo vim unzip wget git bash socat

使用您的首选用户名创建一个新用户帐户（我们将使用johndoe）。

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

运行visudo命令并取消注释该%wheel ALL=(ALL) ALL行，以允许该wheel组的成员执行任何命令。

# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

现在，切换到新创建的用户。

su - johndoe

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

设置时区。

sudo tzsetup

安装Node.js

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

安装Node.js和NPM。

sudo pkg install -y node8 npm-node8

检查版本。

node -v && npm -v
# v8.12.0
# 6.4.1

安装MongoDB

Wiki.js使用MongoDB作为数据库引擎。

安装MongoDB。

sudo pkg install -y mongodb36

检查版本。

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

启用并启动MongoDB。

sudo sysrc mongod_enable=yes
sudo service mongod start

安装Acme.sh并获取“让我们加密”证书（可选）

不需要使用HTTPS保护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 [email protected]
cd ~

检查acme.sh版本。

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

获得RSA和ECDSA证书wiki.example.com。

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.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来利用它们。

安装和配置Nginx

Wiki.js可以在没有任何实际Web服务器的情况下运行，但是强烈建议在其前面放置一个标准Web服务器。这样可以确保您可以使用SSL，多个网站，缓存等功能。在本教程中，我们将使用Nginx，但是任何其他服务器都可以使用，您只需要正确配置它即可。

安装Nginx。

sudo pkg install -y nginx

检查版本。

nginx -v
# nginx version: nginx/1.14.0

启用并启动Nginx。

sudo sysrc nginx_enable=yes
sudo service nginx start

将Nginx配置为Wiki.js应用程序的HTTPS（如果使用SSL）反向代理。

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

server {

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

  server_name wiki.example.com;

  charset utf-8;
  client_max_body_size 50M;

  # 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;
  }

}

在上面的配置中，您唯一需要更改的就是server_name指令，proxy_pass如果决定配置除以外的其他端口，则可能是指令3000。Wiki.js 3000默认使用端口。保存文件并使用:+ W+ 退出Q

现在我们需要wiki.js.conf在主nginx.conf文件中包含该文件。

运行sudo vim /usr/local/etc/nginx/nginx.conf并将以下行添加到http {}块中。

include wiki.js.conf;

检查配置。

sudo nginx -t

重新加载Nginx。

sudo service nginx reload

安装Wiki.js

创建一个将安装Wiki.js的空文档根文件夹。

sudo mkdir -p /usr/local/www/wiki.example.com

导航到文档根文件夹。

cd /usr/local/www/wiki.example.com

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

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

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

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

VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml

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

node wiki --version
# 1.0.102

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

通过运行启动配置向导。

node wiki configure

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

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

安装和设置PM2流程管理器

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

通过全局安装PM2 npm。

sudo npm install -g pm2

检查版本。

pm2 -v
# 3.2.2

导航到您的文档根文件夹（如果尚未存在），然后停止Wiki.js。

cd /usr/local/www/wiki.example.com
node wiki stop

通过PM2启动Wiki.js。

pm2 start server/index.js --name "Wiki.js"

列出由PM2管理的流程。

pm2 list

告诉PM2通过运行以下命令将其自身配置为启动服务：

pm2 startup

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

pm2 save

现在，您的Wiki.js实例使用PM2作为其进程管理器，作为后台进程运行。