Fedora 28에 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를 사용하여 새로운 Fedora 28 Vultr 인스턴스에 Wiki.js를 설치하는 방법을 보여줍니다.

요구 사항

Wiki.js를 실행하기위한 요구 사항은 다음과 같습니다.

• Node.js 버전 6.9.0 이상
• MongoDB 버전 3.2 이상
• Nginx, Apache, IIS, Caddy 또는 H2O와 같은 웹 서버 이 가이드는 Nginx를 사용합니다
• 힘내 버전 2.7.4 이상
• Git 호환 저장소 (공개 또는 개인) 이것은 선택적입니다
• 최소 768MB RAM
• A/ AAAA레코드가 설정된 도메인 이름

시작하기 전에

OS 버전을 확인하십시오.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

sudo 액세스 권한이있는 새 비 루트 사용자 계정을 작성하고 전환하십시오.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

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

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

sudo dnf check-upgrade || sudo dnf upgrade -y

시간대를 설정하십시오.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

필수적이고 유용한 패키지를 설치하십시오.

sudo dnf install -y wget vim unzip bash-completion git

간단하게하기 위해 SELinux 및 방화벽을 비활성화하십시오.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Node.js 설치

Wiki.js에는 Node.js 6.9.0 이상이 필요하므로 Node.js를 먼저 설치해야합니다.

Node.js를 설치하십시오.

sudo dnf install -y nodejs

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

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

MongoDB 설치

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

MongoDB를 설치하십시오.

sudo dnf install -y mongodb mongodb-server

MongoDB 버전을 확인하십시오.

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

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

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

Nginx 설치 및 구성

Wiki.js는 실제 웹 서버 (예 : Nginx 또는 Apache)없이 실행될 수 있습니다. 그러나 Wiki.js 앞에 표준 웹 서버를 설치하는 것이 좋습니다. 이를 통해 SSL, 여러 웹 사이트, 캐싱 등과 같은 기능을 사용할 수 있습니다. 이 튜토리얼에서는 Nginx를 사용하지만 다른 서버도 사용하므로 제대로 구성하면됩니다.

Nginx를 설치하십시오.

sudo dnf install -y nginx

버전을 확인하십시오.

nginx -v
# nginx version: nginx/1.12.1

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

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

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

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 ~

acme.sh버전을 확인하십시오 .

/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 

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

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

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

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