Sådan installeres Wiki.js på Ubuntu 18.04

Wiki.js er en gratis og open source, moderne wiki-app bygget på Node.js , Git og Markdown . Wiki.js kildekode er offentligt hostet på Github . Denne vejledning viser dig, hvordan du installerer Wiki.js på en frisk Ubuntu 18.04 LTS Vultr-instans ved hjælp af Node.js, MongoDB, PM2, Nginx, Git og Acme.sh.

Krav

Kravene til at køre Wiki.js og afslutte denne vejledning er som følger:

• Node.js version 6.9.0 eller nyere
• MongoDB version 3.2 eller nyere
• Nginx
• Git version 2.7.4 eller nyere
• Minimum 768 MB RAM
• Domænenavn med A/ AAAArecords opsat

Tjek Ubuntu-versionen.

lsb_release -ds
# Ubuntu 18.04.4 LTS

Opret en ny non-rootbrugerkonto med sudoadgang og skift til den.

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

BEMÆRK : Erstat johndoemed dit brugernavn.

Indstil tidszonen.

sudo dpkg-reconfigure tzdata

Sørg for, at dit system er opdateret.

sudo apt update && sudo apt upgrade -y

Installer nødvendige pakker.

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

Installer Git

Git 2.7.4 kommer forudinstalleret på Ubuntu server edition, så vi behøver ikke at installere det. Hvis du vil installere en nyere version, kan du bruge tredjeparts PPA'er eller kompilere den seneste udgivelse af Git fra kilden.

Du kan bekræfte den aktuelt installerede version af Git ved at køre:

git --version
# git version 2.7.4

Hvis du vil installere en nyere version af Git-softwaren, kan du bruge følgende.

# 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

Bekræft Git-versionen.

git --version
# git version 2.17.0

Installer Node.js

Installer Node.js ved at bruge NodeSource APT-lageret til Node.js.

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

Tjek Node.js- og NPM-versionerne.

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

Installer MongoDB

Vi vil bruge de officielle MongoDB-depoter , som holdes ajour med de seneste større og mindre MongoDB-udgivelser.

Installer MongoDB Community Edition.

sudo apt install -y mongodb

Tjek versionen.

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

Installer og konfigurer Nginx

Installer 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

Tjek versionen.

sudo nginx -v
# nginx version: nginx/1.15.0

Aktiver og start Nginx.

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

Konfigurer Nginx som en omvendt proxy for Wiki.js-applikationen.

Kør sudo vim /etc/nginx/conf.d/wiki.js.confog udfyld den med den grundlæggende reverse proxy-konfiguration nedenfor.

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

}

Det eneste du skal ændre i ovenstående konfiguration er server_namedirektivet og potentielt proxy_passdirektivet hvis du beslutter dig for at konfigurere en hvilken som helst anden port udover 3000. Wiki.js bruger port 3000som standard.

Tjek konfigurationen.

sudo nginx -t

Genindlæs Nginx.

sudo systemctl reload nginx.service

Installer Acme.sh-klient og få et Let's Encrypt-certifikat (valgfrit)

Det HTTPSer ikke nødvendigt at sikre din wiki , men det vil sikre dit websteds trafik. Acme.sh er en ren unix shell-software til at opnå SSL-certifikater fra Let's Encrypt med nul afhængigheder.

Hent og installer 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 ~

Tjek versionen.

/etc/letsencrypt/acme.sh --version

Få RSA- og ECDSA-certifikater for wiki.example.comdomæne/værtsnavn.

# 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 

Efter at have kørt ovenstående kommandoer, vil dine certifikater og nøgler være i:

• For RSA: /etc/letsencrypt/wiki.example.combiblioteket.
• For ECC/ECDSA: /etc/letsencrypt/wiki.example.com_eccbiblioteket.

Efter at have fået certifikater fra Let's Encrypt, skal vi konfigurere Nginx til at bruge dem.

Kør sudo vim /etc/nginx/conf.d/wiki.js.configen og konfigurer Nginx som en HTTPSomvendt proxy.

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

}

Tjek konfigurationen.

sudo nginx -t

Genindlæs Nginx.

sudo systemctl reload nginx.service

Installer Wiki.js

Opret en tom dokumentrodmappe, hvor Wiki.js skal installeres.

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

Naviger til dokumentets rodmapp.

cd /var/www/wiki.example.com

Skift ejerskab af /var/www/wiki.example.commappen til brugeren johndoe.

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

/var/www/wiki.example.comKør følgende kommando fra mappen for at downloade og installere Wiki.js.

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

For at se den aktuelt installerede version af Wiki.js kan du køre følgende kommando.

node wiki --version
# 1.0.78

Når installationen er fuldført, bliver du bedt om at køre konfigurationsguiden.

Start konfigurationsguiden.

node wiki configure

Dette giver dig besked om at gå til for http://localhost:3000at konfigurere Wiki.js. Hvis du har Nginx foran Wiki.js, kan du åbne dit domænenavn (f.eks. http://wiki.example.com) i stedet for at gå til localhost.

Brug din webbrowser til at navigere til http://wiki.example.comog følge instruktionerne på skærmen. Alle indstillinger, der er indtastet under konfigurationsguiden, gemmes i config.ymlfilen. Konfigurationsguiden starter automatisk Wiki.js for dig.

Installer PM2

Som standard starter Wiki.js ikke automatisk efter en systemgenstart. For at få det til at starte ved opstart, skal vi konfigurere PM2. PM2 leveres sammen med Wiki.js som et lokalt NPM-modul, så vi behøver ikke at installere PM2 globalt.

Bed PM2 om at konfigurere sig selv som en opstartstjeneste.

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

Gem endelig den aktuelle PM2-konfiguration.

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

Wiki.js kører som en baggrundsproces og bruger PM2 som sin procesmanager.