Como instalar o Wiki.js no FreeBSD 11

• Exigências
• Antes de você começar
• Instale o Node.js
• Instale o MongoDB
• Instale o Acme.sh e obtenha um certificado Let's Encrypt (opcional)
• Instale e configure o Nginx
• Instale o Wiki.js
• Instale e configure o gerenciador de processos do 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 nova instância do FreeBSD 11 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.11.1 ou posterior
• MongoDB versão 3.2 ou posterior
• Git versão 2.7.4 ou posterior
• Um servidor da web como Nginx, Apache, IIS, Caddy ou H2O. Este guia usará o Nginx.
• Um repositório compatível com Git (público ou privado) Isso é opcional
• Um mínimo de 512 MB de RAM. É altamente recomendável usar uma máquina com pelo menos 1 GB de RAM.
• Nome de domínio com A/ AAAAregistros configurados. Neste guia, usaremos wiki.example.comcomo um domínio de exemplo.

Antes de você começar

Verifique a versão do FreeBSD.

uname -ro
# FreeBSD 11.2-RELEASE

Verifique se o seu sistema FreeBSD está atualizado.

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

Instalar sudo, vim, unzip, wget, git, bashe socatpacotes se eles não estão presentes em seu sistema.

pkg install -y sudo vim unzip wget git bash socat

Crie uma nova conta de usuário com seu nome de usuário preferido (nós usaremos 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!

Execute o visudocomando e remova o comentário da %wheel ALL=(ALL) ALLlinha, para permitir que os membros do wheelgrupo executem qualquer comando.

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

Agora, mude para o usuário recém-criado.

su - johndoe

NOTA: Substitua johndoepelo seu nome de usuário.

Configure o fuso horário.

sudo tzsetup

Instale o Node.js

O Wiki.js requer o Node.js. 6.11.1 ou posterior, portanto, primeiro precisamos instalar a versão apropriada do Node.js.

Instale o Node.js e o NPM.

sudo pkg install -y node8 npm-node8

Verifique as versões.

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

Instale o MongoDB

O Wiki.js usa o MongoDB como um mecanismo de banco de dados.

Instale o MongoDB.

sudo pkg install -y mongodb36

Verifique a versão.

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

Habilite e inicie o MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

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

Proteger seu wiki com HTTPS não é necessário, mas é uma boa prática para proteger o tráfego do site. Para obter um certificado SSL do Let's Encrypt, usaremos o cliente Acme.sh. O Acme.sh é um software 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 o 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 acme.shversão.

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

Obtenha certificados RSA e ECDSA para 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

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

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

Instale e configure o Nginx

O Wiki.js pode ser executado sem nenhum servidor da Web real, no entanto, é altamente recomendável colocar um servidor da Web padrão na frente dele. Isso garante que você possa usar recursos como SSL, vários sites, cache e outros. Usaremos o Nginx neste tutorial, mas qualquer outro servidor o fará, você só precisará configurá-lo corretamente.

Instale o Nginx.

sudo pkg install -y nginx

Verifique a versão.

nginx -v
# nginx version: nginx/1.14.0

Habilite e inicie o Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Configure o Nginx como um proxy reverso HTTPS (se você usar SSL) para o aplicativo Wiki.js.

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

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

}

A única coisa que você precisa alterar na configuração acima é a server_namediretiva e, potencialmente, a proxy_passdiretiva se você decidir configurar outra porta que não seja 3000. O Wiki.js usa porta 3000por padrão. Salve o arquivo e saia com :+ W+Q

Agora precisamos incluir o wiki.js.confarquivo no nginx.confarquivo principal .

Execute sudo vim /usr/local/etc/nginx/nginx.confe adicione a seguinte linha ao http {}bloco.

include wiki.js.conf;

Verifique a configuração.

sudo nginx -t

Recarregue o Nginx.

sudo service nginx reload

Instale o Wiki.js

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

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

Navegue para a pasta raiz do documento.

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

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

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

Na /usr/local/www/wiki.example.compasta, execute os seguintes comandos para baixar e instalar o 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

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

node wiki --version
# 1.0.102

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

Inicie o assistente de configuração executando.

node wiki configure

Isso o notificará para navegar http://localhost:3000para configurar o Wiki.js. Se você tem o Nginx na frente do Wiki.js, significa que você pode abrir o seu nome de domínio (por exemplo http://wiki.example.com) em vez de ir para o host local.

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 são salvas no config.ymlarquivo. O assistente de configuração iniciará automaticamente o Wiki.js para você.

Instale e configure o gerenciador de processos do 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 instalar e configurar o gerenciador de processos do PM2.

Instale o PM2 globalmente via npm.

sudo npm install -g pm2

Verifique a versão.

pm2 -v
# 3.2.2

Navegue para a pasta raiz do documento se você ainda não estiver lá e pare o Wiki.js.

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

Inicie o Wiki.js via PM2.

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

Listar processo gerenciado pelo PM2.

pm2 list

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

pm2 startup

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

pm2 save

Sua instância do Wiki.js agora é executada como um processo em segundo plano, usando o PM2 como seu gerenciador de processos.