FreeBSD 11에 Wiki.js를 설치하는 방법

• 요구 사항
• 시작하기 전에
• Node.js 설치
• MongoDB 설치
• Acme.sh를 설치하고 Let 's Encrypt 인증서를 얻습니다 (선택 사항)
• Nginx 설치 및 구성
• Wiki.js 설치
• PM2 프로세스 관리자 설치 및 설정

Wiki.js 는 Node.js, MongoDB, Git 및 Markdown을 기반으로하는 무료 오픈 소스 현대 위키 앱입니다. 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 이상
• 힘내 버전 2.7.4 이상
• Nginx, Apache, IIS, Caddy 또는 H2O와 같은 웹 서버 이 가이드는 Nginx를 사용합니다.
• Git 호환 저장소 (공개 또는 개인) 이것은 선택적입니다
• 최소 512MB RAM. 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를 설치하고 Let 's Encrypt 인증서를 얻습니다 ( 선택 사항 ).

HTTPS로 위키를 보호 할 필요는 없지만 사이트 트래픽을 보호하는 것이 좋습니다. Let 's Encrypt에서 SSL 인증서를 얻기 위해 Acme.sh 클라이언트를 사용합니다. Acme.sh는 의존성이없는 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는 실제 웹 서버없이 실행될 수 있지만 표준 웹 서버를 앞에 두는 것이 좋습니다. 이를 통해 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

Wiki.js 애플리케이션에 대해 Nginx를 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폴더의 소유권 을 사용자로 변경하십시오 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:3000Wiki.js 구성 으로 이동 하라는 메시지가 표시됩니다. Wiki.js 앞에 Nginx가 있다면 http://wiki.example.comlocalhost 대신 도메인 이름을 열 수 있습니다 (예 :) .

웹 브라우저를 사용하여 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를 프로세스 관리자로 사용하여 백그라운드 프로세스로 실행됩니다.