웹사이트 검색

Ubuntu 18.04 LTS에 NodeBB 포럼을 설치하는 방법

이 튜토리얼은 다음 OS 버전에 대해 존재합니다.

  • Ubuntu 20.04(Focal Fossa)
  • Ubuntu 18.04(Bionic Beaver)

이 페이지에서

  1. 요구 사항\n
  2. 전제 조건
  3. 1단계: Node.js 및 npm 설치
  4. 2단계: MongoDB 설치 및 구성
  5. 3단계 - acme.sh 클라이언트 설치 및 Let">) 획득\n
  6. 4단계: Nginx 설치 및 구성
  7. 5단계: NodeBB 설치 및 설정
  8. 6단계: NodeBB를 시스템 서비스로 실행\n
  9. 링크

NodeBB는 최신 웹용으로 제작된 Node.js 기반 포럼 소프트웨어입니다. MongoDB 또는 Redis 데이터베이스를 기반으로 합니다. 즉각적인 상호 작용 및 실시간 알림을 위해 웹 소켓을 사용합니다. NodeBB에는 소셜 네트워크 통합 및 스트리밍 토론과 같은 즉시 사용할 수 있는 많은 최신 기능이 있습니다. 추가 기능은 타사 플러그인을 사용하여 활성화됩니다. NodeBB는 Github에서 찾을 수 있는 오픈 소스 프로젝트입니다. 이 가이드에서는 Nginx를 역방향 프록시로, MongoDB를 데이터베이스로, acme.sh 및 Lets Encrypt for HTTPS를 사용하여 Ubuntu 18.04 LTS 운영 체제에서 NodeBB 설치 프로세스를 단계별로 안내합니다.

요구 사항

NodeBB를 사용하려면 다음 소프트웨어를 설치해야 합니다.

  • Node.js 버전 6 이상
  • MongoDB 버전 2.6 이상 또는 Redis 버전 2.8.9 이상
  • Nginx 버전 1.3.13 이상
  • 힘내\n

참고: NodeBB 종속성을 설치하려면 512MB 이상의 시스템 메모리가 필요할 수 있습니다. Linux 시스템의 메모리가 부족한 경우 보상을 위해 스왑 파티션을 사용하는 것이 좋습니다.

전제 조건

  • 실행 중인 Ubuntu 18.04 시스템(최소 1GB 또는 RAM)\n
  • A/AAAA 레코드가 설정된 도메인 이름.
  • sudo 권한이 있는 루트가 아닌 사용자.\n

초기 단계

Ubuntu 버전 확인:

lsb_release -ds
# Ubuntu 18.04.1 LTS

시간대 설정:

sudo dpkg-reconfigure tzdata

운영 체제 패키지(소프트웨어)를 업데이트합니다. 이는 운영 체제 기본 소프트웨어 패키지에 대한 최신 업데이트 및 보안 수정 사항이 있는지 확인하기 때문에 중요한 첫 번째 단계입니다.

sudo apt update && sudo apt upgrade -y

Ubuntu 운영체제의 기본 관리에 필요한 몇 가지 필수 패키지를 설치합니다.

sudo apt install -y curl wget vim git unzip socat bash-completion

1단계: Node.js 및 npm 설치

NodeBB는 Node.js를 기반으로 합니다. 이 글을 쓰는 시점에서 버전 8 인 NodeBB의 권장 버전을 설치할 예정입니다. Linux에는 Linux 바이너리(x86/x64), 소스 코드 또는 패키지 관리자를 통한 몇 가지 Node.js 설치 옵션이 있습니다. Node.js를 쉽게 설치하고 업데이트할 수 있는 패키지 관리 옵션을 사용할 것입니다.

Nodesource 저장소에서 Node.js의 최신 장기 지원(LTS) 릴리스를 다운로드하고 설치합니다.

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

npm에서 기본 애드온을 컴파일하고 설치하려면 빌드 도구를 설치해야 할 수도 있습니다.

sudo apt install -y build-essential

참고: npm은 Node.js와 함께 배포됩니다. 즉, Node.js를 다운로드하면 자동으로 시스템에 npm이 설치됩니다.

Node.js 및 npm 버전을 확인합니다.

node -v && npm -v
# v10.15.1
# 6.4.1

Npm은 Node.js와 별개의 프로젝트이며 더 자주 업데이트되는 경향이 있습니다. 결과적으로 방금 Node.js(따라서 npm)를 다운로드한 경우에도 npm을 업데이트해야 할 수 있습니다. 운 좋게도 npm은 스스로 업데이트하는 방법을 알고 있습니다! npm을 업데이트하려면 터미널에 다음을 입력하세요.

sudo npm install -g

이 명령은 npm을 최신 안정 버전으로 업데이트합니다.

다음을 사용하여 npm 버전을 다시 확인합니다.

npm -v
# 6.7.0

그리고 최신 버전 번호를 반환해야 합니다.

2단계: MongoDB 설치 및 구성

NodeBB는 데이터를 저장할 데이터베이스가 필요하며 MongoDB와 Redis를 지원합니다. 이 가이드에서는 MongoDB를 데이터 저장소 엔진으로 선택했습니다. 따라서 다음 몇 단계에서는 공식 MongoDB rpm 저장소에서 MongoDB 데이터베이스를 다운로드하고 설치합니다.

안정적인 버전의 MongoDB 패키지를 설치하려면 다음 명령을 실행하십시오.

sudo apt install -y mongodb

MongoDB 버전을 확인합니다.

mongo --version | head -n 1 && mongod --version | head -n 1

MongoDB 서비스를 시작하고 활성화합니다(재부팅 시 시작하도록 설정).

sudo systemctl start mongodb.service
sudo systemctl enable mongodb.service

다음을 실행하여 MongoDB 데이터베이스 서버 상태를 확인합니다.

sudo systemctl status mongodb.service
# active (running)

다음으로 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" } ] } )

참고: 자리 표시자 <보안 암호 입력>을 자신이 선택한 암호로 바꾸십시오.

nodebb라는 새 데이터베이스를 추가합니다.

> use nodebb

데이터베이스가 생성되고 컨텍스트가 nodebb로 전환됩니다. 다음으로 적절한 권한을 가진 nodebb 사용자를 생성합니다.

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

참고: 자리 표시자를 자신이 선택한 암호로 바꾸십시오.

몽고 셸을 종료합니다.

> quit()

MongoDB를 다시 시작하고 이전에 만든 관리 사용자가 연결할 수 있는지 확인합니다.

sudo systemctl restart mongodb.service
mongo -u admin -p your_password --authenticationDatabase=admin

모두 잘 되었다면 MongoDB를 설치하고 NodeBB를 준비해야 합니다. 다음 단계에서는 웹 서버 설치 및 구성을 다룹니다.

3단계 - acme.sh 클라이언트 설치 및 Lets Encrypt 인증서 획득(선택 사항)

NodeBB 포럼을 HTTPS로 보호할 필요는 없지만 사이트 트래픽을 보호하는 것이 좋습니다. Lets Encrypt에서 TLS 인증서를 얻기 위해 acme.sh 클라이언트를 사용합니다. Acme.sh는 종속성이 없는 Lets Encrypt에서 TLS 인증서를 얻기 위한 순수 유닉스 셸 소프트웨어입니다.

acme.sh를 다운로드하고 설치합니다.

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
./acme.sh --install --accountemail 
source ~/.bashrc
cd ~

acme.sh 버전 확인:

acme.sh --version
# v2.8.0

도메인/호스트 이름에 대한 RSA 및 ECC/ECDSA 인증서 받기:<br>

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

테스트를 위해 가짜 인증서를 원하는 경우 위 명령에 --staging 플래그를 추가할 수 있습니다.

위 명령어를 실행하면 인증서 및 키가 다음 위치에 있게 됩니다.

  • RSA의 경우: /home/username/example.com 디렉토리.
  • ECC/ECDSA의 경우: /home/username/example.com_ecc 디렉터리.

발급된 인증서를 나열하려면 다음을 실행할 수 있습니다.

acme.sh --list

인증서를 저장할 디렉터리를 만듭니다. /etc/letsencrypt 디렉토리를 사용합니다.

mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

인증서를 /etc/letsencrypt 디렉터리에 설치/복사합니다.

# RSA
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

모든 인증서는 60일마다 자동으로 갱신됩니다.

인증서를 얻은 후 루트 사용자에서 종료하고 일반 sudo 사용자로 돌아갑니다.

exit

4단계: Nginx 설치 및 구성

NodeBB는 많은 웹 서버에서 잘 작동할 수 있습니다. 이 튜토리얼에서는 Nginx를 선택했습니다.

다음 명령을 실행하여 Nginx 패키지를 설치합니다.

sudo apt install -y nginx

설치 후 다음을 실행하여 Nginx 버전을 확인할 수 있습니다.

nginx -v

Nginx 서비스 시작 및 사용 설정(재부팅 시 시작되도록 설정):

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

다음을 실행하여 Nginx 웹 서버 상태를 확인합니다.

sudo systemctl status nginx.service
# active (running)

NodeBB는 기본적으로 포트 4567에서 실행됩니다. http://example.com:4567 입력을 피하기 위해 Nginx를 NodeBB 애플리케이션의 리버스 프록시로 구성합니다. 포트 80 또는 443(SSL이 사용되는 경우)의 모든 요청은 포트 4567로 전달됩니다.

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 example.com;
  
  client_max_body_size 50M;

  # RSA
  ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/example.com/private.key;
  # ECDSA
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.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"; 
  }

}

Nginx 구성을 확인합니다.

sudo nginx -t

마지막으로 변경사항을 적용하려면 Nginx를 다시 로드해야 합니다.

sudo systemctl reload nginx.service

5단계: NodeBB 설치 및 설정

NodeBB가 상주해야 하는 문서 루트 디렉터리를 만듭니다.

sudo mkdir -p /var/www/nodebb

문서 루트 디렉터리로 이동합니다.

cd /var/www/nodebb

/var/www/nodebb 디렉토리의 소유권을 your_user로 변경합니다.

sudo chown -R [your_user]:[your_user] /var/www/nodebb

참고: 위 명령에서 your_user를 이 자습서의 전제 조건으로 생성했어야 하는 루트가 아닌 사용자로 바꾸십시오.

최신 NodeBB 저장소를 문서 루트 폴더에 복제합니다.

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

setup 플래그로 앱을 실행하여 설정 스크립트를 시작합니다. 각 질문에 답하십시오.

./nodebb setup

NodeBB 설정이 완료되면 ./nodebb start를 실행하여 NodeBB 서버를 수동으로 시작합니다.

./nodebb start

이 명령을 실행한 후 웹 브라우저에서 새로운 포럼에 액세스할 수 있어야 합니다.

6단계: NodeBB를 시스템 서비스로 실행

./nodebb start를 통해 시작하면 시스템 재부팅 시 NodeBB가 자동으로 다시 시작되지 않습니다. 이를 방지하려면 NodeBB를 시스템 서비스로 설정해야 합니다.

실행 중인 경우 NodeBB를 중지합니다.

./nodebb stop

새 nodebb 사용자를 생성합니다.

sudo useradd nodebb

/var/www/nodebb 디렉토리의 소유권을 nodebb 사용자로 변경합니다.

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

nodebb.service 시스템 단위 구성 파일을 만듭니다. 이 유닛 파일은 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

축하합니다! Ubuntu 18.04 시스템에 NodeBB 토론 플랫폼을 성공적으로 설치하고 배포했습니다. 도메인에서 포럼에 액세스하고 포럼과 상호작용할 수 있어야 합니다.

연결

  • https://nodebb.org/
  • https://github.com/NodeBB/NodeBB