如何在FreeBSD 12上安装NodeBB论坛

• 要求
• 在你开始之前
• 安装Node.js
• 安装和配置MongoDB
• 安装和配置Nginx
• 安装Acme.sh客户端并获取Let's Encrypt证书（可选）
• 安装NodeBB
• 使用PM2运行NodeBB

NodeBB是基于Node.js的论坛软件。它利用Web套接字进行即时交互和实时通知。NodeBB源代码公开托管在Github上。本指南将通过使用Node.js，MongoDB作为数据库，Nginx作为反向代理以及Acme.sh获得SSL证书，在全新的FreeBSD 12 Vultr实例上引导您完成NodeBB的安装过程。

要求

NodeBB要求安装以下软件：

• Node.js版本6.9.0或更高版本
• MongoDB 2.6或更高版本
• Nginx的
• 吉特
• 最小1024MB RAM
• 带有A/ AAAA记录的域名

在你开始之前

检查FreeBSD版本。

uname -ro
# FreeBSD 12.0-RELEASE

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

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

如果系统上没有必要的软件包，请安装它们。

pkg install -y sudo vim unzip wget git bash socat gcc8 pkgconf vips

使用您的首选用户名创建一个新用户帐户（我们将使用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组的成员执行任何命令。

visudo

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

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

su - johndoe

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

设置时区。

sudo tzsetup

安装Node.js

NodeBB由Node.js驱动，因此需要安装。建议安装当前LTS版本的Node.js。

安装Node.js和npm。

sudo pkg install -y node10 npm-node10

检查版本。

node -v && npm -v
# v10.15.3
# 6.9.0

安装和配置MongoDB

MongoDB是NodeBB的默认数据库。

安装MongoDB。

sudo pkg install -y mongodb40

检查版本。

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v4.0.6
# db version v4.0.6

启用并启动MongoDB。

sudo sysrc mongod_enable=yes
sudo service mongod start

为NodeBB创建数据库和用户。

首先连接到MongoDB。

mongo

切换到内置admin数据库。

> use admin

创建一个管理用户。

> db.createUser( { user: "admin", pwd: "<Enter a secure password>", roles: [ { role: "readWriteAnyDatabase", db: "admin" }, { role: "userAdminAnyDatabase", db: "admin" } ] } )

注意： 用您自己选择的密码替换占位符<Enter a secure password>。

添加一个名为的新数据库nodebb。

> use nodebb

将创建数据库并将上下文切换到nodebb。接下来nodebb，使用适当的权限创建用户。

> db.createUser( { user: "nodebb", pwd: "<Enter a secure password>", roles: [ { role: "readWrite", db: "nodebb" }, { role: "clusterMonitor", db: "admin" } ] } )

注意： 同样，请<Enter a secure password>使用您自己选择的密码替换占位符。

退出Mongo Shell。

> quit()

重新启动MongoDB，并确保先前创建的管理用户可以连接。

sudo service mongod restart
mongo -u admin -p your_password --authenticationDatabase=admin

安装和配置Nginx

安装Nginx。

sudo pkg install -y nginx

检查版本。

nginx -v
# nginx version: nginx/1.14.2

启用并启动Nginx。

sudo sysrc nginx_enable=yes
sudo service nginx start

默认情况下，NodeBB在port上运行4567。为避免输入http://example.com:4567，我们将Nginx配置为NodeBB应用程序的反向代理。port 80或443（如果使用SSL）上的每个请求都将转发到port 4567。

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

server {

  listen [::]:80;
  listen 80;

  server_name forum.example.com;

  root /usr/share/nginx/html;

  client_max_body_size 50M;

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

  location / {
    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;
    proxy_set_header Host $http_host;
    proxy_hide_header X-Powered-By;
    proxy_set_header X-Nginx-Proxy true;

    proxy_pass http://127.0.0.1:4567;
    proxy_redirect off;

    # Socket.IO Support
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

}

在上述配置中，server_name使用您的域名/主机名更新指令。

保存文件并使用:+ W+ 退出Q。

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

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

include nodebb.conf;

检查配置。

sudo nginx -t

重新加载Nginx。

sudo service nginx reload

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

不需要使用HTTPS保护论坛安全，但这可以保护您网站的流量。Acme.sh是一个纯unix shell软件，用于以零依赖关系从Let's Encrypt获得SSL证书。

下载并安装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 ~

检查版本。

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

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

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d forum.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo service nginx reload" --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d forum.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo service nginx reload"  --keylength ec-256

运行上述命令后，您的证书和密钥将位于：

• RSA ：/etc/letsencrypt/forum.example.com。
• ECC / ECDSA ：/etc/letsencrypt/forum.example.com_ecc。

从“加密”获取证书后，我们需要配置Nginx来使用它们。

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

server {

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

  server_name forum.example.com;

  root /usr/share/nginx/html;

  client_max_body_size 50M;

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

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

  location / {
    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;
    proxy_set_header Host $http_host;
    proxy_set_header X-NginX-Proxy true;

    proxy_pass http://127.0.0.1:4567;
    proxy_redirect off;

    # Socket.IO Support
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

}

检查配置。

sudo nginx -t

重新加载Nginx。

sudo service nginx reload

安装NodeBB

创建一个文档根目录。

sudo mkdir -p /usr/local/www/nodebb

将/usr/local/www/nodebb目录的所有权更改为johndoe。

sudo chown -R johndoe:johndoe /usr/local/www/nodebb

导航到文档根文件夹。

cd /usr/local/www/nodebb

将最新的NodeBB克隆到文档根文件夹中。

git clone -b v1.11.x https://github.com/NodeBB/NodeBB.git .

运行NodeBB setup命令，并在出现提示时回答每个问题。

./nodebb setup

NodeBB设置完成后，运行./nodebb start以手动启动NodeBB服务器。

./nodebb start

执行此命令后，您将能够在Web浏览器中访问NodeBB论坛实例。

使用PM2运行NodeBB

当通过启动时./nodebb start，NodeBB将不会在系统重新启动时自动再次启动。为避免这种情况，我们需要将NodeBB设置为系统服务。

如果正在运行，请停止NodeBB。

./nodebb stop

全局安装PM2。

sudo npm install pm2 -g

检查版本。

pm2 -v
# 3.5.0

导航到NodeBB文档根目录。

cd /usr/local/www/nodebb

通过PM2启动NodeBB。

pm2 start app.js

列出NodeBB进程。

pm2 ls

检测可用的初始化系统。

pm2 startup

在CLI中复制并粘贴此命令的输出以设置启动挂钩。

保存您的进程列表。

pm2 save

而已。您的NodeBB实例现已启动并正在运行。