Ubuntu 18.04에 Wiki.js를 설치하는 방법

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

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

요구 사항

Wiki.js를 실행하고이 가이드를 완료하기위한 요구 사항은 다음과 같습니다.

• Node.js 버전 6.9.0 이상
• MongoDB 버전 3.2 이상
• 니 진스
• 힘내 버전 2.7.4 이상
• 최소 768MB RAM
• A/ AAAA레코드가 설정된 도메인 이름

우분투 버전을 확인하십시오.

lsb_release -ds
# Ubuntu 18.04.4 LTS

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

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

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

시간대를 설정하십시오.

sudo dpkg-reconfigure tzdata

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

sudo apt update && sudo apt upgrade -y

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

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

힘내 설치

Git 2.7.4는 Ubuntu Server Edition에 사전 설치되어 있으므로 설치할 필요가 없습니다. 최신 버전을 설치하려는 경우 타사 PPA를 사용하거나 소스에서 최신 Git 릴리스를 컴파일 할 수 있습니다.

다음을 실행하여 현재 설치된 버전의 Git을 확인할 수 있습니다.

git --version
# git version 2.7.4

최신 버전의 Git 소프트웨어를 설치하려면 다음을 사용할 수 있습니다.

# Remove existing git package
sudo apt remove -y git
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:git-core/ppa
sudo apt update && sudo apt upgrade -y
sudo apt install -y git

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

git --version
# git version 2.17.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 설치

최신 MongoDB 릴리스와 함께 최신 MongoDB 리포지토리를 사용합니다 .

MongoDB Community Edition을 설치하십시오.

sudo apt install -y mongodb

버전을 확인하십시오.

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

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/ubuntu/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/ubuntu/ $(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 애플리케이션의 리버스 프록시로 구성하십시오.

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필요는 없지만 사이트의 트래픽을 보호합니다. Acme.sh는 의존성이없는 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

wiki.example.com도메인 / 호스트 이름에 대한 RSA 및 ECDSA 인증서를 얻습니다 .

# 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 

위의 명령을 실행하면 인증서와 키가 다음 위치에있게됩니다.

• 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/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;
    }

}

구성을 확인하십시오.

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