Cara Memasang Wiki.js di Ubuntu 18.04

• 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
• Instal PM2

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

Persyaratan

Persyaratan untuk menjalankan Wiki.js dan menyelesaikan panduan ini 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
• Minimal RAM 768MB
• Nama domain dengan A/ AAAAcatatan diatur

Periksa versi Ubuntu.

lsb_release -ds
# Ubuntu 18.04.4 LTS

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

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

CATATAN : Ganti johndoedengan nama pengguna Anda.

Siapkan zona waktu.

sudo dpkg-reconfigure tzdata

Pastikan sistem Anda mutakhir.

sudo apt update && sudo apt upgrade -y

Instal paket yang diperlukan.

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

Instal Git

Git 2.7.4 sudah diinstal sebelumnya pada edisi server Ubuntu, jadi kita tidak perlu menginstalnya. Jika Anda ingin menginstal versi yang lebih baru, Anda dapat menggunakan PPA pihak ketiga atau mengkompilasi rilis terbaru Git dari sumber.

Anda dapat memverifikasi versi Git yang saat ini diinstal dengan menjalankan:

git --version
# git version 2.7.4

Jika Anda ingin menginstal versi perangkat lunak Git yang lebih baru, Anda dapat menggunakan yang berikut ini.

# 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

Verifikasi versi Git.

git --version
# git version 2.17.0

Instal Node.js

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

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

Periksa versi Node.js dan NPM.

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

Instal MongoDB

Kami akan menggunakan repositori resmi MongoDB , yang terus diperbarui dengan rilis MongoDB utama dan minor terbaru.

Instal MongoDB Community Edition.

sudo apt install -y mongodb

Periksa versinya.

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

Instal dan konfigurasikan Nginx

Instal 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

Periksa versinya.

sudo 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 proxy terbalik untuk aplikasi 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 di konfigurasi di atas adalah server_namedirektif dan berpotensi proxy_passarahan jika Anda memutuskan untuk mengkonfigurasi port lain selain itu 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 akan mengamankan lalu lintas situs Anda. Acme.sh adalah perangkat lunak unix shell murni untuk mendapatkan sertifikat SSL dari Let's Encrypt dengan nol dependensi.

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

Dapatkan sertifikat RSA dan ECDSA untuk wiki.example.comdomain / nama host.

# 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:

• Untuk RSA: /etc/letsencrypt/wiki.example.comdirektori.
• Untuk ECC / ECDSA: /etc/letsencrypt/wiki.example.com_eccdirektori.

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

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 ke 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

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

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 menelusuri 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 disimpan dalam config.ymlfile. Panduan konfigurasi akan secara otomatis memulai Wiki.js untuk Anda.

Instal PM2

Secara default, Wiki.js tidak akan mulai secara otomatis setelah sistem reboot. Untuk membuatnya mulai saat boot, kita perlu mengatur PM2. PM2 dibundel dengan Wiki.js sebagai modul NPM lokal, jadi kita tidak perlu menginstal PM2 secara global.

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.

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

Wiki.js berjalan sebagai proses latar belakang, menggunakan PM2 sebagai manajer prosesnya.