如何在Debian 9上安装NodeBB论坛

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

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

要求

NodeBB要求安装以下软件：

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

在你开始之前

检查Debian版本。

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

确保您的系统是最新的。

apt update && apt upgrade -y

安装必要的软件包。

apt install -y sudo dirmngr git build-essential apt-transport-https

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

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

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

设置时区。

sudo dpkg-reconfigure tzdata

安装Node.js

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

从NodeSource存储库安装Node.js。

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs

验证Node.js和npm的安装。

node -v && npm -v
# v10.15.0
# 5.6.0

安装和配置MongoDB

MongoDB是NodeBB的默认数据库。

从官方的MongoDB存储库安装MongoDB。

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
echo "deb https://repo.mongodb.org/apt/debian stretch/mongodb-org/4.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list
sudo apt update
sudo apt install -y mongodb-org

检查版本。

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

启动并启用MongoDB。

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

为NodeBB创建MongoDB数据库和用户。

连接到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 systemctl restart mongod.service
mongo -u admin -p your_password --authenticationDatabase=admin

安装和配置Nginx

从官方Nginx存储库中安装最新版本的Nginx主线。

wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

检查版本。

sudo nginx -v
# nginx version: nginx/1.15.0

启用并启动Nginx。

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

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

运行sudo vim /etc/nginx/conf.d/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使用您的域名/主机名更新指令。

检查配置。

sudo nginx -t

重新加载Nginx。

sudo systemctl reload nginx.service

安装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 ~
source ~/.bashrc

检查版本。

acme.sh --version
# v2.7.9

获得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 systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --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 systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength ec-256

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

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

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

sudo vim /etc/nginx/conf.d/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 systemctl reload nginx.service

安装NodeBB

创建一个文档根目录。

sudo mkdir -p /var/www/nodebb

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

sudo chown -R johndoe:johndoe /var/www/nodebb

导航到文档根文件夹。

cd /var/www/nodebb

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

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

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

./nodebb setup

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

./nodebb start

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

将NodeBB作为系统服务运行

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

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

./nodebb stop

创建一个新nodebb用户：

sudo adduser nodebb

将/var/www/nodebb目录的所有权更改为nodebb。

sudo chown -R nodebb:nodebb /var/www/nodebb

创建一个nodebb.servicesystemd单元配置文件。该单元文件将处理NodeBB守护进程的启动。运行sudo vim /etc/systemd/system/nodebb.service并使用以下内容填充文件：

[Unit]
Description=NodeBB
Documentation=https://docs.nodebb.org
After=system.slice multi-user.target mongod.service

[Service]
Type=forking
User=nodebb

StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=nodebb

Environment=NODE_ENV=production
WorkingDirectory=/var/www/nodebb
PIDFile=/var/www/nodebb/pidfile
ExecStart=/usr/bin/env node loader.js
Restart=always

[Install]
WantedBy=multi-user.target

注意： 根据您选择的名称设置用户名和目录路径。

nodebb.service在重新启动时启用并立即启动nodebb.service。

sudo systemctl enable nodebb.service
sudo systemctl start nodebb.service

检查nodebb.service状态。

sudo systemctl status nodebb.service
sudo systemctl is-enabled nodebb.service

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