Cara Memasang Wiki.js pada Debian 9

• Keperluan
• Pasang Git
• Pasang Node.js
• Pasang MongoDB
• Pasang dan konfigurasikan Nginx
• Pasang Acme.sh dan dapatkan sijil Let's Encrypt (pilihan)
• Pasang Wiki.js
• Sediakan PM2

Wiki.js adalah aplikasi wiki moden dan sumber terbuka dan bebas yang dibina di atas Node.js, MongoDB, Git dan Markdown. Kod sumber Wiki.js dihoskan secara terbuka di GitHub . Panduan ini akan menunjukkan kepada anda cara memasang Wiki.js pada contoh Debian 9 Vultr baru dengan menggunakan Node.js, MongoDB, PM2, Nginx, Git dan Acme.sh.

Keperluan

• Node.js 6.9.0 atau lebih baru
• MongoDB 3.2 atau lebih baru
• Nginx
• Git 2.7.4 atau lebih baru
• Repositori yang mematuhi Git (awam atau peribadi) ( pilihan )
• Minimum dari 768MB RAM
• Nama domain dengan A/ AAAArekod disediakan

Semak versi Debian.

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

Pastikan sistem anda terkini.

apt update && apt upgrade -y

Pasang pakej yang diperlukan.

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

Buat non-rootakaun pengguna baru dengan sudoakses dan beralih kepadanya.

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

NOTA : Gantikan johndoedengan nama pengguna anda.

Sediakan zon waktu.

sudo dpkg-reconfigure tzdata

Pasang Git

Pasang Git pada Debian.

sudo apt install -y git

Sahkan versi Git.

git --version
# git version 2.11.0

Pasang Node.js

Pasang 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

Pasang MongoDB

Wiki.js menggunakan MongoDB sebagai mesin pangkalan data. Menurutnya, kita perlu memasang MongoDB pada pelayan kami. Kami akan menggunakan repositori MongoDB rasmi untuk pemasangan.

Pasang MongoDB Community Edition.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

Semak versi.

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

Dayakan dan mulakan MongoDB.

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

Pasang dan konfigurasikan Nginx

Sangat disyorkan untuk meletakkan pelayan web standard di depan Wiki.js. Ini memastikan anda dapat menggunakan ciri seperti SSL, beberapa laman web, cache dan banyak lagi. Kami akan menggunakan Nginx dalam tutorial ini, tetapi mana-mana pelayan lain akan lakukan, anda hanya perlu mengkonfigurasinya dengan betul.

Pasang 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/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

Semak versi.

sudo nginx -v
# nginx version: nginx/1.15.0

Dayakan dan mulailah Nginx.

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

Konfigurasikan Nginx sebagai proksi terbalik HTTPatau HTTPS(jika anda menggunakan SSL) untuk aplikasi Wiki.js.

Jalankan sudo vim /etc/nginx/conf.d/wiki.js.confdan isi dengan konfigurasi proksi terbalik asas di bawah.

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 perkara yang perlu anda ubah dalam konfigurasi di atas ialah server_namearahan, dan berpotensi proxy_passarahan jika anda memutuskan untuk mengkonfigurasi beberapa port lain daripada 3000. Wiki.js menggunakan port 3000secara lalai.

Periksa konfigurasi.

sudo nginx -t

Muat semula Nginx.

sudo systemctl reload nginx.service

Pasang Acme.sh dan dapatkan sijil Let's Encrypt (pilihan)

Mengamankan wiki anda dengan HTTPStidak diperlukan, tetapi amalan yang baik untuk menjamin trafik laman anda. Untuk mendapatkan sijil SSL dari Let's Encrypt kami akan menggunakan klien Acme.sh. Acme.sh adalah perisian shell unix murni untuk mendapatkan sijil SSL dari Let's Encrypt dengan kebergantungan sifar. Itu menjadikannya sangat ringan berbanding dengan beberapa klien protokol ACME lain yang memerlukan banyak dependensi untuk berjalan dengan jayanya.

Muat turun dan pasang 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 ~

Semak versi.

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

Dapatkan sijil RSA dan ECDSA untuk 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 

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

Setelah menjalankan perintah di atas, sijil dan kunci anda akan berada di direktori berikut.

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

Selepas mendapatkan sijil dari Let's Encrypt, kita perlu mengkonfigurasi Nginx untuk mengambil kesempatan daripada mereka.

Jalankan sudo vim /etc/nginx/conf.d/wiki.js.conflagi dan konfigurasikan Nginx sebagai HTTPSproksi 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/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/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 semula Nginx.

sudo systemctl reload nginx.service

Pasang Wiki.js

Buat folder akar dokumen kosong di mana Wiki.js perlu dipasang.

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

Navigasi ke folder root dokumen.

cd /var/www/wiki.example.com

Tukar pemilikan /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 arahan berikut untuk memuat turun dan memasang Wiki.js.

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

Anda boleh menjalankan perintah berikut untuk melihat versi Wiki.js. yang sedang dipasang

node wiki --version
# 1.0.78

Setelah pemasangan selesai, anda akan diminta untuk menjalankan wizard konfigurasi.

Mulakan wizard konfigurasi dengan menjalankan.

node wiki configure

Ini akan memberitahu anda untuk menavigasi ke http://localhost:3000untuk mengkonfigurasi Wiki.js. Jika anda mempunyai Nginx di hadapan Wiki.js, maka itu bermakna anda boleh membuka nama domain anda (contohnya http://wiki.example.com) dan bukannya pergi localhost.

Dengan menggunakan penyemak imbas web anda, arahkan ke http://wiki.example.comdan ikuti arahan di skrin. Semua tetapan yang dimasukkan semasa wizard konfigurasi disimpan dalam config.ymlfail. Wizard konfigurasi akan memulakan Wiki.js secara automatik untuk anda.

Sediakan PM2

Secara lalai, Wiki.js tidak akan dimulakan secara automatik selepas sistem reboot. Untuk menjadikannya bermula pada boot, kita perlu menyediakan pengurus proses PM2. PM2 dibundel dengan Wiki.js sebagai modul NPM tempatan, jadi kita tidak perlu memasang PM2 secara global.

Beritahu PM2 untuk mengkonfigurasi dirinya sebagai perkhidmatan permulaan.

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

Akhir sekali, simpan konfigurasi PM2 semasa.

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

Contoh Wiki.js anda berjalan sebagai proses latar belakang, menggunakan PM2 sebagai pengurus prosesnya. Anda boleh but semula OS anda sudo rebootdan periksa sama ada Wiki.js bermula selepas but semula.