Cara Memasang Wiki.js di CentOS 7

• Persyaratan
• Instal Git
• Instal Node.js
• Instal MongoDB
• Instal dan konfigurasikan Nginx
• Instal klien Acme.sh dan dapatkan sertifikat Let's Encrypt (opsional)
• Instal Wiki.js
• Pengaturan PM2

Wiki.js adalah aplikasi wiki modern gratis dan open source yang dibangun di atas Node.js, MongoDB, Git, dan Markdown. Kode sumber Wiki.js di-host secara publik di Github . Panduan ini akan menunjukkan kepada Anda bagaimana menginstal Wiki.js pada instance CentOS 7 Vultr yang baru menggunakan Node.js, MongoDB, PM2, Nginx, Git dan Acme.sh.

Persyaratan

Persyaratan untuk menjalankan Wiki.js adalah sebagai berikut:

• Node.js versi 6.9.0 atau lebih baru
• MongoDB versi 3.2 atau yang lebih baru
• Nginx
• Git versi 2.7.4 atau yang lebih baru
• Repositori yang sesuai dengan Git (publik atau pribadi) ( opsional )
• Minimal RAM 768MB
• Nama domain dengan A/ AAAAcatatan diatur

Periksa versi CentOS.

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

Buat non-rootakun pengguna baru dengan sudoakses dan alihkan ke sana.

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

CATATAN : Ganti johndoedengan nama pengguna Anda .

Siapkan zona waktu.

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

Pastikan sistem Anda mutakhir.

sudo yum update -y

Instal paket yang diperlukan untuk menyelesaikan tutorial ini.

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

Nonaktifkan SELinux dan Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Aktifkan repositori EPEL.

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

Instal Git

Repositori CentOS menyediakan versi Git yang sangat usang, jadi kita perlu membangun Git dari sumber.

Instal Git dengan membangunnya dari kode sumber.

# 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

Verifikasikan versinya.

git --version
# git version 2.17.1

Instal Node.js

Wiki.js membutuhkan Node.js 6.9.0 atau yang lebih baru, jadi kita perlu menginstal Node.js.

Instal Node.js dengan menggunakan repositori NodeSource YUM untuk Node.js.

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum install -y nodejs

Periksa versi Node.js dan NPM.

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

Instal MongoDB

Wiki.js menggunakan MongoDB sebagai mesin basis data. Kami akan menggunakan repositori MongoDB resmi , yang berisi rilis MongoDB utama dan minor terbaru.

Instal 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

Periksa versinya.

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

Aktifkan dan mulai MongoDB.

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

Instal dan konfigurasikan Nginx

Sangat disarankan untuk meletakkan server web standar di depan Wiki.js. Ini memastikan Anda dapat menggunakan fitur seperti SSL, beberapa situs web, caching dan banyak lagi.

Instal 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

Periksa versinya.

nginx -v
# nginx version: nginx/1.15.0

Aktifkan dan mulai Nginx.

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

Konfigurasikan Nginx sebagai HTTPatau HTTPSmembalikkan proxy untuk Wiki.js.

Jalankan sudo vim /etc/nginx/conf.d/wiki.js.confdan isi dengan konfigurasi proxy terbalik dasar di bawah ini.

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

}

Satu-satunya hal yang perlu Anda ubah dalam konfigurasi di atas adalah server_namedirektif, dan berpotensi proxy_passdirektif jika Anda memutuskan untuk mengkonfigurasi port lain selain 3000. Wiki.js menggunakan port 3000secara default.

Periksa konfigurasi.

sudo nginx -t

Muat ulang Nginx.

sudo systemctl reload nginx.service

Instal klien Acme.sh dan dapatkan sertifikat Let's Encrypt (opsional)

Mengamankan wiki dengan Anda HTTPStidak perlu, tetapi itu adalah praktik yang baik untuk mengamankan lalu lintas situs Anda. Untuk mendapatkan sertifikat SSL dari Let's Encrypt, kami akan menggunakan klien Acme.sh. Acme.sh adalah skrip shell UNIX murni untuk mendapatkan sertifikat SSL dari Let's Encrypt dengan nol dependensi. Itu membuatnya sangat ringan dibandingkan dengan beberapa klien protokol Acme lain yang membutuhkan banyak ketergantungan untuk berjalan dengan sukses.

Download dan install 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 ~

Periksa versinya.

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

Dapatkan sertifikat RSA dan ECDSA untuk domain / nama host Anda.

# 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 

Setelah menjalankan perintah di atas, sertifikat dan kunci Anda akan berada di direktori berikut:

• Untuk RSA: /etc/letsencrypt/wiki.example.com
• Untuk ECC / ECDSA: /etc/letsencrypt/wiki.example.com_ecc

CATATAN : Jangan lupa ganti wiki.example.comdengan nama domain Anda.

Setelah mendapatkan sertifikat dari Let's Encrypt, kita perlu mengkonfigurasi Nginx untuk memanfaatkannya.

Jalankan sudo vim /etc/nginx/conf.d/wiki.js.conflagi dan konfigurasikan Nginx sebagai HTTPSproxy terbalik.

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

}

Periksa konfigurasi.

sudo nginx -t

Muat ulang Nginx.

sudo systemctl reload nginx.service

Instal Wiki.js

Buat folder root dokumen kosong tempat Wiki.js harus diinstal.

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

Arahkan ke folder root dokumen.

cd /var/www/wiki.example.com

Ubah kepemilikan /var/www/wiki.example.comfolder menjadi pengguna johndoe.

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

Dari /var/www/wiki.example.comfolder, jalankan perintah berikut untuk mengunduh dan menginstal Wiki.js.

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

Anda dapat menjalankan perintah berikut untuk melihat versi Wiki.js. yang saat ini diinstal

node wiki --version
# 1.0.78

Setelah instalasi selesai, Anda akan diminta untuk menjalankan wizard konfigurasi.

Mulai panduan konfigurasi.

node wiki configure

Ini akan memberi tahu Anda untuk menavigasi ke http://localhost:3000untuk mengkonfigurasi Wiki.js. Jika Anda memiliki Nginx di depan Wiki.js, Anda dapat membuka nama domain Anda (misalnya http://wiki.example.com) alih-alih pergi ke localhost.

Dengan menggunakan browser web Anda, navigasikan ke http://wiki.example.comdan ikuti instruksi di layar. Semua pengaturan yang dimasukkan selama wizard konfigurasi telah disimpan dalam config.ymlfile. Panduan konfigurasi akan secara otomatis memulai Wiki.js untuk Anda.

Pengaturan PM2

Secara default, Wiki.js tidak akan mulai secara otomatis setelah sistem reboot. Untuk membuatnya mulai saat boot, kita perlu mengatur manajer proses PM2.

Katakan pada PM2 untuk mengkonfigurasikan dirinya sebagai layanan startup.

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

Akhirnya, simpan konfigurasi PM2 saat ini dengan menjalankan perintah.

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

Contoh Wiki.js Anda berjalan sebagai proses latar belakang, menggunakan PM2 sebagai manajer prosesnya. Anda dapat mem-boot ulang OS Anda dengan sudo rebootdan memastikan bahwa Wiki.js dimulai setelah reboot.