Cara Memasang Wiki.js di FreeBSD 11

• Persyaratan
• Sebelum kamu memulai
• Instal Node.js
• Instal MongoDB
• Instal Acme.sh dan dapatkan sertifikat Let's Encrypt (opsional)
• Instal dan konfigurasikan Nginx
• Instal Wiki.js
• Instal dan setup manajer proses 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 FreeBSD 11 Vultr yang baru dengan menggunakan Node.js, MongoDB, PM2, Nginx, Git dan Acme.sh.

Persyaratan

Persyaratan untuk menjalankan Wiki.js adalah sebagai berikut:

• Node.js versi 6.11.1 atau lebih baru
• MongoDB versi 3.2 atau yang lebih baru
• Git versi 2.7.4 atau yang lebih baru
• Server web seperti Nginx, Apache, IIS, Caddy, atau H2O. Panduan ini akan menggunakan Nginx.
• Repositori yang sesuai dengan Git (publik atau pribadi) Ini adalah opsional
• Minimal RAM 512MB. Sangat disarankan untuk menggunakan mesin dengan setidaknya 1GB RAM.
• Nama domain dengan A/ AAAAcatatan diatur. Dalam panduan ini kita akan menggunakan wiki.example.comsebagai contoh domain.

Sebelum kamu memulai

Periksa versi FreeBSD.

uname -ro
# FreeBSD 11.2-RELEASE

Pastikan sistem FreeBSD Anda mutakhir.

freebsd-update fetch install
pkg update && pkg upgrade -y

Instal sudo, vim, unzip, wget, git, bashdan socatpaket jika mereka tidak hadir pada sistem Anda.

pkg install -y sudo vim unzip wget git bash socat

Buat akun pengguna baru dengan nama pengguna pilihan Anda (kami akan gunakan johndoe).

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Jalankan visudoperintah dan batalkan komentar pada %wheel ALL=(ALL) ALLbaris, untuk memungkinkan anggota wheelgrup untuk mengeksekusi perintah apa pun.

# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

Sekarang, beralihlah ke pengguna Anda yang baru dibuat.

su - johndoe

CATATAN: Ganti johndoedengan nama pengguna Anda.

Siapkan zona waktu.

sudo tzsetup

Instal Node.js

Wiki.js membutuhkan Node.js 6.11.1 atau yang lebih baru, jadi pertama-tama kita perlu menginstal versi Node.js. yang sesuai.

Instal Node.js dan NPM.

sudo pkg install -y node8 npm-node8

Periksa versinya.

node -v && npm -v
# v8.12.0
# 6.4.1

Instal MongoDB

Wiki.js menggunakan MongoDB sebagai mesin basis data.

Instal MongoDB.

sudo pkg install -y mongodb36

Periksa versinya.

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

Aktifkan dan mulai MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

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

Mengamankan wiki Anda dengan HTTPS tidak diperlukan, 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 perangkat lunak unix shell 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.

Unduh dan instal 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 acme.shversinya.

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

Dapatkan sertifikat RSA dan ECDSA untuk wiki.example.com.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength ec-256

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

• RSA: /etc/letsencrypt/wiki.example.com
• 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.

Instal dan konfigurasikan Nginx

Wiki.js dapat berjalan tanpa server web yang sebenarnya, namun sangat disarankan untuk meletakkan server web standar di depannya. Ini memastikan Anda dapat menggunakan fitur seperti SSL, banyak situs web, caching dan lainnya. Kami akan menggunakan Nginx dalam tutorial ini, tetapi server lain akan melakukannya, Anda hanya perlu mengkonfigurasinya dengan benar.

Instal Nginx.

sudo pkg install -y nginx

Periksa versinya.

nginx -v
# nginx version: nginx/1.14.0

Aktifkan dan mulai Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Konfigurasikan Nginx sebagai HTTPS (jika Anda menggunakan SSL) proksi balik untuk aplikasi Wiki.js.

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

server {

  listen [::]:443 ssl http2;
  listen 443 ssl http2;
  listen [::]:80;
  listen 80;

  server_name wiki.example.com;

  charset utf-8;
  client_max_body_size 50M;

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

}

Satu-satunya hal yang perlu Anda ubah dalam konfigurasi di atas adalah server_namedirektif, dan berpotensi proxy_passarahan jika Anda memutuskan untuk mengkonfigurasi beberapa port selain 3000. Wiki.js menggunakan port 3000secara default. Simpan file dan keluar dengan :+ W+Q

Sekarang kita perlu memasukkan wiki.js.conffile ke file utama nginx.conf.

Jalankan sudo vim /usr/local/etc/nginx/nginx.confdan tambahkan baris berikut ke http {}blok.

include wiki.js.conf;

Periksa konfigurasi.

sudo nginx -t

Muat ulang Nginx.

sudo service nginx reload

Instal Wiki.js

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

sudo mkdir -p /usr/local/www/wiki.example.com

Arahkan ke folder root dokumen.

cd /usr/local/www/wiki.example.com

Ubah kepemilikan /usr/local/www/wiki.example.comfolder menjadi pengguna johndoe.

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

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

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

VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml

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

node wiki --version
# 1.0.102

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

Mulai panduan konfigurasi dengan menjalankan.

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, itu berarti Anda dapat membuka nama domain Anda (mis. 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 dan setup manajer proses PM2

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

Instal PM2 secara global melalui npm.

sudo npm install -g pm2

Periksa versinya.

pm2 -v
# 3.2.2

Arahkan ke folder root dokumen Anda jika Anda belum berada di sana dan hentikan Wiki.js.

cd /usr/local/www/wiki.example.com
node wiki stop

Mulai Wiki.js melalui PM2.

pm2 start server/index.js --name "Wiki.js"

Proses daftar dikelola oleh PM2.

pm2 list

Beri tahu PM2 untuk mengonfigurasikan dirinya sebagai layanan startup dengan menjalankan:

pm2 startup

Akhirnya, simpan konfigurasi PM2 saat ini dengan menjalankan perintah:

pm2 save

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