Como instalar o Wiki.js no CentOS 7

• Exigências
• Instale o Git
• Instale o Node.js
• Instale o MongoDB
• Instale e configure o Nginx
• Instale o cliente Acme.sh e obtenha um certificado Let's Encrypt (opcional)
• Instale o Wiki.js
• Configuração PM2

O Wiki.js é um aplicativo wiki moderno, de código aberto e gratuito, construído em Node.js, MongoDB, Git e Markdown. O código-fonte do Wiki.js está hospedado publicamente no Github . Este guia mostra como instalar o Wiki.js em uma instância nova do CentOS 7 Vultr usando Node.js, MongoDB, PM2, Nginx, Git e Acme.sh.

Exigências

Os requisitos para executar o Wiki.js são os seguintes:

• Node.js versão 6.9.0 ou posterior
• MongoDB versão 3.2 ou posterior
• Nginx
• Git versão 2.7.4 ou posterior
• Um repositório compatível com Git (público ou privado) ( opcional )
• Mínimo de 768MB de RAM
• Nome de domínio com A/ AAAAregistros configurados

Verifique a versão do CentOS.

cat /etc/centos-release
# CentOS Linux release 7.5.1804 (Core)

Crie uma nova non-rootconta de usuário com sudoacesso e mude para ela.

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

NOTA : Substitua johndoepelo seu nome de usuário .

Configure o fuso horário.

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

Verifique se o seu sistema está atualizado.

sudo yum update -y

Instale os pacotes necessários para concluir este tutorial.

sudo yum install -y wget curl vim zip unzip bash-completion

Desative o SELinux e o Firewall.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

Ative o repositório EPEL.

sudo rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

Instale o Git

Os repositórios do CentOS fornecem uma versão muito desatualizada do Git, portanto, precisaremos compilar o Git a partir da fonte.

Instale o Git construindo-o a partir do código fonte.

# Remove existing git package if installed: 
sudo yum remove -y git
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gettext-devel openssl-devel perl-CPAN perl-devel zlib-devel curl-devel
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.17.1.tar.gz && tar zxvf git-2.17.1.tar.gz
rm git-2.17.1.tar.gz
cd git-2.17.1
make configure
./configure
make prefix=/usr/local all
sudo make prefix=/usr/local install
cd ~

# Confirm this command returns /usr/local/bin/git:
which git

Verifique a versão.

git --version
# git version 2.17.1

Instale o Node.js

O Wiki.js requer o Node.js. 6.9.0 ou posterior, portanto, primeiro precisamos instalar o Node.js.

Instale o Node.js utilizando o repositório NodeSource YUM para o Node.js.

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum install -y nodejs

Verifique as versões do Node.js e do NPM.

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

Instale o MongoDB

O Wiki.js usa o MongoDB como um mecanismo de banco de dados. Usaremos os repositórios oficiais do MongoDB , que contêm as versões principais e secundárias mais recentes do MongoDB.

Instale o MongoDB Community Edition.

sudo vim /etc/yum.repos.d/mongodb-org-3.6.repo

# Copy/paste this
[mongodb-org-3.6]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.6.asc

sudo yum install -y mongodb-org

Verifique a versão.

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

Habilite e inicie o MongoDB.

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

Instale e configure o Nginx

É altamente recomendável colocar um servidor web padrão na frente do Wiki.js. Isso garante que você possa usar recursos como SSL, vários sites, cache e muito mais.

Instale o Nginx.

sudo vim /etc/yum.repos.d/nginx_mainline.repo

# Copy/paste this
[nginx]
name=nginx repo
baseurl=https://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=1
enabled=1

wget https://nginx.org/keys/nginx_signing.key
sudo rpm --import nginx_signing.key
rm nginx_signing.key

sudo yum install -y nginx

Verifique a versão.

nginx -v
# nginx version: nginx/1.15.0

Habilite e inicie o Nginx.

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

Configure o Nginx como um proxy reverso HTTPou HTTPSpara o Wiki.js.

Execute sudo vim /etc/nginx/conf.d/wiki.js.confe preencha-o com a configuração básica de proxy reverso abaixo.

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

}

A única coisa que você precisa alterar na configuração acima é server_namediretiva, e potencialmente proxy_passdiretiva, se você decidir configurar qualquer outra porta que não seja 3000. O Wiki.js usa porta 3000por padrão.

Verifique a configuração.

sudo nginx -t

Recarregue o Nginx.

sudo systemctl reload nginx.service

Instale o cliente Acme.sh e obtenha um certificado Let's Encrypt (opcional)

Proteger seu wiki HTTPSnão é necessário, mas é uma boa prática proteger o tráfego do site. Para obter um certificado SSL do Let's Encrypt, usaremos o cliente Acme.sh. O Acme.sh é um script de shell UNIX puro para obter certificados SSL do Let's Encrypt com zero dependências. Isso o torna muito leve em comparação com outros clientes do protocolo Acme que exigem muitas dependências para serem executadas com êxito.

Baixe e instale 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 ~

Verifique a versão.

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

Obtenha certificados RSA e ECDSA para o seu domínio / nome de 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 

Depois de executar os comandos acima, seus certificados e chaves estarão nos seguintes diretórios:

• Para RSA: /etc/letsencrypt/wiki.example.com
• Para ECC / ECDSA: /etc/letsencrypt/wiki.example.com_ecc

NOTA : Não se esqueça de substituir wiki.example.compelo seu nome de domínio.

Após obter os certificados do Let's Encrypt, precisamos configurar o Nginx para tirar proveito deles.

Execute sudo vim /etc/nginx/conf.d/wiki.js.confnovamente e configure o Nginx como um HTTPSproxy reverso.

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

}

Verifique a configuração.

sudo nginx -t

Recarregue o Nginx.

sudo systemctl reload nginx.service

Instale o Wiki.js

Crie uma pasta raiz do documento vazia onde o Wiki.js deve ser instalado.

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

Navegue para a pasta raiz do documento.

cd /var/www/wiki.example.com

Altere a propriedade da /var/www/wiki.example.compasta para usuário johndoe.

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

Na /var/www/wiki.example.compasta, execute o seguinte comando para baixar e instalar o Wiki.js.

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

Você pode executar o seguinte comando para visualizar a versão atualmente instalada do Wiki.js.

node wiki --version
# 1.0.78

Quando a instalação estiver concluída, você será solicitado a executar o assistente de configuração.

Inicie o assistente de configuração.

node wiki configure

Isso o notificará para navegar http://localhost:3000para configurar o Wiki.js. Se você tiver o Nginx na frente do Wiki.js, poderá abrir seu nome de domínio (por exemplo http://wiki.example.com) em vez de acessar localhost.

Usando seu navegador da web, navegue http://wiki.example.come siga as instruções na tela. Todas as configurações inseridas durante o assistente de configuração foram salvas no config.ymlarquivo. O assistente de configuração iniciará automaticamente o Wiki.js para você.

Configuração PM2

Por padrão, o Wiki.js não será iniciado automaticamente após a reinicialização do sistema. Para iniciar na inicialização, precisamos configurar o gerenciador de processos do PM2.

Diga ao PM2 para se configurar como um serviço de inicialização.

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

Por fim, salve a configuração atual do PM2 executando o comando

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

Sua instância do Wiki.js é executada como um processo em segundo plano, usando o PM2 como seu gerenciador de processos. Você pode reiniciar seu sistema operacional sudo reboote garantir que o Wiki.js seja iniciado após uma reinicialização.