데비안 9에 Wiki.js를 설치하는 방법

• 요구 사항
• 힘내 설치
• Node.js 설치
• MongoDB 설치
• Nginx 설치 및 구성
• Acme.sh를 설치하고 Let 's Encrypt 인증서를 얻습니다 (선택 사항)
• Wiki.js 설치
• PM2 설정

Wiki.js 는 Node.js, MongoDB, Git 및 Markdown을 기반으로하는 무료 오픈 소스 현대 위키 앱입니다. Wiki.js 소스 코드는 GitHub에 공개적으로 호스팅됩니다 . 이 가이드는 Node.js, MongoDB, PM2, Nginx, Git 및 Acme.sh를 사용하여 새로운 Debian 9 Vultr 인스턴스에 Wiki.js를 설치하는 방법을 보여줍니다.

요구 사항

• Node.js 6.9.0 이상
• MongoDB 3.2 이상
• 니 진스
• 힘내 2.7.4 이상
• Git 호환 저장소 (공개 또는 개인) ( 선택 사항 )
• 최소 768MB RAM
• A/ AAAA레코드가 설정된 도메인 이름

데비안 버전을 확인하십시오.

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

시스템이 최신인지 확인하십시오.

apt update && apt upgrade -y

필요한 패키지를 설치하십시오.

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

액세스 권한이 있는 새 non-root사용자 계정을 sudo만들고 전환하십시오.

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

참고 : 대체 johndoe사용자 이름과 함께.

시간대를 설정하십시오.

sudo dpkg-reconfigure tzdata

힘내 설치

데비안에 Git을 설치하십시오.

sudo apt install -y git

힘내 버전을 확인하십시오.

git --version
# git version 2.11.0

Node.js 설치

Node.js에 NodeSource APT 저장소를 활용하여 Node.js를 설치하십시오.

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

Node.js 및 npm 버전을 확인하십시오.

node -v && npm -v
# v8.11.2
# 5.6.0

MongoDB 설치

Wiki.js는 MongoDB를 데이터베이스 엔진으로 사용합니다. 이에 따르면 서버에 MongoDB를 설치해야합니다. 공식 MongoDB 저장소 를 사용하여 설치합니다.

MongoDB Community Edition을 설치하십시오.

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

버전을 확인하십시오.

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

MongoDB를 활성화하고 시작하십시오.

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

Nginx 설치 및 구성

표준 웹 서버를 Wiki.js 앞에 두는 것이 좋습니다. 이를 통해 SSL, 여러 웹 사이트, 캐싱 등과 같은 기능을 사용할 수 있습니다. 이 튜토리얼에서는 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

Nginx 를 Wiki.js 애플리케이션을위한 HTTP또는 HTTPS(SSL을 사용하는 경우) 리버스 프록시로 구성하십시오.

sudo vim /etc/nginx/conf.d/wiki.js.conf아래의 기본 리버스 프록시 구성으로이를 실행하십시오 .

server {

    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

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

    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기본적으로 포트 를 사용합니다 .

구성을 확인하십시오.

sudo nginx -t

Nginx를 다시로드하십시오.

sudo systemctl reload nginx.service

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 ~

버전을 확인하십시오.

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

에 대한 RSA 및 ECDSA 인증서를 얻습니다 wiki.example.com.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.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 wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail [email protected] --ocsp-must-staple --keylength ec-256 

참고 : 도메인 이름 으로 바꾸는 것을 잊지 마십시오 wiki.example.com.

위의 명령을 실행하면 인증서와 키가 다음 디렉토리에 있습니다.

• RSA의 경우 : /etc/letsencrypt/wiki.example.com디렉토리.
• ECC / ECDSA의 경우 : /etc/letsencrypt/wiki.example.com_ecc디렉토리.

Let 's Encrypt에서 인증서를 얻은 후에는이를 활용하도록 Nginx를 구성해야합니다.

sudo vim /etc/nginx/conf.d/wiki.js.conf다시 실행 하고 Nginx를 HTTPS리버스 프록시 로 구성 하십시오 .

server {

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

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

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

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

}

구성을 확인하십시오.

sudo nginx -t

Nginx를 다시로드하십시오.

sudo systemctl reload nginx.service

Wiki.js 설치

Wiki.js를 설치해야하는 빈 문서 루트 폴더를 만듭니다.

sudo mkdir -p /var/www/wiki.example.com

문서 루트 폴더로 이동하십시오.

cd /var/www/wiki.example.com

/var/www/wiki.example.com폴더의 소유권 을 사용자로 변경하십시오 johndoe.

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

로부터 /var/www/wiki.example.com폴더, Wiki.js.를 다운로드하려면 다음 명령을 실행하여 설치

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

현재 설치된 Wiki.js 버전을 보려면 다음 명령을 실행할 수 있습니다.

node wiki --version
# 1.0.78

설치가 완료되면 구성 마법사를 실행하라는 메시지가 표시됩니다.

실행하여 구성 마법사를 시작하십시오.

node wiki configure

http://localhost:3000Wiki.js 구성 으로 이동 하라는 메시지가 표시됩니다. Wiki.js 앞에 Nginx가 있다면 http://wiki.example.com으로 이동하는 대신 도메인 이름 (예 :)을 열 수 있습니다 localhost.

웹 브라우저를 사용하여 http://wiki.example.com화면 지시 사항을 탐색 하고 따르십시오. 구성 마법사 중에 입력 한 모든 설정이 config.yml파일에 저장 됩니다. 구성 마법사가 자동으로 Wiki.js를 시작합니다.

PM2 설정

기본적으로 Wiki.js는 시스템 재부팅 후 자동으로 시작되지 않습니다. 부팅시 시작하려면 PM2 프로세스 관리자를 설정해야합니다. PM2는 로컬 NPM 모듈로 Wiki.js와 번들로 제공되므로 PM2를 전체적으로 설치할 필요가 없습니다.

PM2에게 시작 서비스로 구성하도록 지시하십시오.

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup

마지막으로 현재 PM2 구성을 저장하십시오.

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

Wiki.js 인스턴스는 PM2를 프로세스 관리자로 사용하여 백그라운드 프로세스로 실행됩니다. OS를 sudo reboot재부팅하고 재부팅 후 Wiki.js가 시작되는지 확인할 수 있습니다 .