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

요구 사항

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

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

CentOS 버전을 확인하십시오.

cat /etc/centos-release
# CentOS Linux release 7.5.1804 (Core)

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

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

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

시간대를 설정하십시오.

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

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

sudo yum update -y

이 자습서를 마치려면 필요한 패키지를 설치하십시오.

sudo yum install -y wget curl vim zip unzip bash-completion

SELinux 및 방화벽을 비활성화하십시오.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

EPEL 저장소를 활성화하십시오.

sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

힘내 설치

CentOS 리포지토리는 매우 오래된 Git 버전을 제공하므로 소스에서 Git을 빌드해야합니다.

소스 코드에서 빌드하여 Git을 설치하십시오.

# Remove existing git package if installed: 
sudo yum remove -y git
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gettext-devel openssl-devel perl-CPAN perl-devel zlib-devel curl-devel
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.17.1.tar.gz && tar zxvf git-2.17.1.tar.gz
rm git-2.17.1.tar.gz
cd git-2.17.1
make configure
./configure
make prefix=/usr/local all
sudo make prefix=/usr/local install
cd ~

# Confirm this command returns /usr/local/bin/git:
which git

버전을 확인하십시오.

git --version
# git version 2.17.1

Node.js 설치

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

Node.js 용 NodeSource YUM 저장소를 사용하여 Node.js를 설치하십시오.

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum 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 vim /etc/yum.repos.d/mongodb-org-3.6.repo

# Copy/paste this
[mongodb-org-3.6]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc

sudo yum 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를 설치하십시오.

sudo vim /etc/yum.repos.d/nginx_mainline.repo

# Copy/paste this
[nginx]
name=nginx repo
baseurl=https://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=1
enabled=1

wget https://nginx.org/keys/nginx_signing.key
sudo rpm --import nginx_signing.key
rm nginx_signing.key

sudo yum install -y nginx

버전을 확인하십시오.

nginx -v
# nginx version: nginx/1.15.0

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

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

AS를 구성 Nginx에 HTTP또는 HTTPSWiki.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을 유지할 필요는 없지만 사이트 트래픽을 보호하는 것이 좋습니다. Let 's Encrypt에서 SSL 인증서를 얻기 위해 Acme.sh 클라이언트를 사용합니다. Acme.sh는 Let 's Encrypt에서 종속 관계없이 SSL 인증서를 얻기위한 순수 UNIX 쉘 스크립트입니다. 따라서 성공적으로 실행하려면 많은 종속성이 필요한 다른 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 인증서를 얻습니다.

# 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폴더의 소유권 을 user로 변경하십시오 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에게 시작 서비스로 구성하도록 지시하십시오.

/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가 시작되도록 할 수 있습니다 .