Πώς να εγκαταστήσετε το Wiki.js στο Fedora 28

Το Wiki.js είναι μια δωρεάν και ανοιχτού κώδικα, σύγχρονη εφαρμογή wiki που βασίζεται σε Node.js, MongoDB, Git και Markdown. Ο πηγαίος κώδικας του Wiki.js φιλοξενείται δημόσια στο Github . Αυτός ο οδηγός θα σας δείξει πώς να εγκαταστήσετε το Wiki.js σε μια νέα παρουσία του Fedora 28 Vultr χρησιμοποιώντας τα Node.js, MongoDB, PM2, Nginx, Git και Acme.sh.

Απαιτήσεις

Οι απαιτήσεις για την εκτέλεση του Wiki.js είναι οι εξής:

• Node.js έκδοση 6.9.0 ή μεταγενέστερη
• MongoDB έκδοση 3.2 ή μεταγενέστερη
• Ένας διακομιστής ιστού όπως Nginx, Apache, IIS, Caddy ή H2O. Αυτός ο οδηγός θα χρησιμοποιεί το Nginx
• Έκδοση Git 2.7.4 ή μεταγενέστερη
• Ένα αποθετήριο συμβατό με το Git (δημόσιο ή ιδιωτικό) Αυτό είναι προαιρετικό
• Τουλάχιστον 768MB RAM
• Όνομα τομέα με ρύθμιση A/ AAAAεγγραφές

Πριν ξεκινήσεις

Ελέγξτε την έκδοση του λειτουργικού συστήματος.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

Δημιουργήστε έναν νέο λογαριασμό χρήστη που δεν είναι root με πρόσβαση sudo και μεταβείτε σε αυτόν.

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

ΣΗΜΕΙΩΣΗ: Αντικαταστήστε το johndoeμε το όνομα χρήστη σας.

Βεβαιωθείτε ότι το σύστημά σας είναι ενημερωμένο.

sudo dnf check-upgrade || sudo dnf upgrade -y

Ρυθμίστε τη ζώνη ώρας.

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

Εγκαταστήστε απαιτούμενα και χρήσιμα πακέτα.

sudo dnf install -y wget vim unzip bash-completion git

Για απλότητα, απενεργοποιήστε το SELinux και το Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Εγκαταστήστε το Node.js

Το Wiki.js απαιτεί Node.js 6.9.0 ή νεότερη έκδοση, επομένως θα χρειαστεί πρώτα να εγκαταστήσουμε το Node.js.

Εγκαταστήστε το Node.js.

sudo dnf install -y nodejs

Ελέγξτε τις εκδόσεις Node.js και npm.

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

Εγκαταστήστε το MongoDB

Το Wiki.js χρησιμοποιεί το MongoDB ως μηχανή βάσης δεδομένων. Σύμφωνα με αυτό, θα χρειαστεί να εγκαταστήσουμε το MongoDB στον διακομιστή μας.

Εγκαταστήστε το MongoDB.

sudo dnf install -y mongodb mongodb-server

Ελέγξτε την έκδοση MongoDB.

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

Ενεργοποιήστε και ξεκινήστε το MongoDB.

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

Εγκαταστήστε και ρυθμίστε το Nginx

Το Wiki.js μπορεί να εκτελεστεί χωρίς πραγματικό διακομιστή ιστού (όπως Nginx ή Apache). Ωστόσο, συνιστάται ιδιαίτερα να τοποθετήσετε έναν τυπικό διακομιστή ιστού μπροστά από το Wiki.js. Αυτό διασφαλίζει ότι μπορείτε να χρησιμοποιήσετε λειτουργίες όπως SSL, πολλαπλούς ιστότοπους, προσωρινή αποθήκευση και άλλα. Θα χρησιμοποιήσουμε το Nginx σε αυτό το σεμινάριο, αλλά οποιοσδήποτε άλλος διακομιστής θα το κάνει, απλά πρέπει να το ρυθμίσετε σωστά.

Εγκαταστήστε το Nginx.

sudo dnf install -y nginx

Ελέγξτε την έκδοση.

nginx -v
# nginx version: nginx/1.12.1

Ενεργοποιήστε και ξεκινήστε το Nginx.

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

Διαμορφώστε το Nginx ως αντίστροφο διακομιστή μεσολάβησης HTTPή HTTPS(εάν χρησιμοποιείτε SSL) για την εφαρμογή Wiki.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 (προαιρετικό)

Η ασφάλεια του wiki σας με HTTPSδεν είναι απαραίτητη, αλλά είναι μια καλή πρακτική για να εξασφαλίσετε την επισκεψιμότητα του ιστότοπού σας. Για να αποκτήσουμε ένα πιστοποιητικό SSL από το Let's Encrypt θα χρησιμοποιήσουμε το πρόγραμμα-πελάτη Acme.sh. Το Acme.sh είναι ένα καθαρό λογισμικό κελύφους unix για τη λήψη πιστοποιητικών SSL από την Let's Encrypt με μηδενικές εξαρτήσεις. Αυτό το καθιστά πολύ ελαφρύ σε σύγκριση με ορισμένους άλλους πελάτες πρωτοκόλλου 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 ~

Ελέγξτε την acme.shέκδοση.

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

Λάβετε πιστοποιητικά RSA και ECDSA για 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 

Αφού εκτελέσετε τις παραπάνω εντολές, τα πιστοποιητικά και τα κλειδιά σας θα βρίσκονται σε:

• Για 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φακέλου σε χρήστη 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:3000να διαμορφώσετε το Wiki.js. Εάν έχετε Nginx μπροστά από το Wiki.js, τότε σημαίνει ότι μπορείτε να ανοίξετε το όνομα τομέα σας (π.χ. http://wiki.example.com) αντί να μεταβείτε στο localhost.

Χρησιμοποιώντας το πρόγραμμα περιήγησής σας, μεταβείτε http://wiki.example.comκαι ακολουθήστε τις οδηγίες που εμφανίζονται στην οθόνη. Όλες οι ρυθμίσεις που εισάγονται κατά τη διάρκεια του οδηγού διαμόρφωσης αποθηκεύονται στο config.ymlαρχείο. Ο οδηγός διαμόρφωσης θα ξεκινήσει αυτόματα το Wiki.js για εσάς.

Ρύθμιση PM2

Από προεπιλογή, το Wiki.js δεν θα ξεκινήσει αυτόματα μετά την επανεκκίνηση του συστήματος. Για να το ξεκινήσουμε κατά την εκκίνηση, πρέπει να ρυθμίσουμε το PM2 process manager. Το PM2 συνοδεύεται από το Wiki.js ως τοπική μονάδα NPM, επομένως δεν χρειάζεται να εγκαταστήσουμε το 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 ως διαχειριστή διεργασιών.