Como Auto-Hospedar Wiki.js em uma VPS (Guia Completo)

Wiki.js é um software de wiki poderoso e flexível, de código aberto, construído em Node.js. É adequado tanto para uso pessoal quanto colaborativo, tornando-se uma escolha popular para desenvolvedores e entusiastas de homelab que desejam auto-hospedar uma plataforma de documentação ou gestão de conhecimento. Este guia irá guiá-lo pelo processo de auto-hospedagem do Wiki.js em um Virtual Private Server (VPS). Também exploraremos o uso do Docker para uma instalação mais simplificada.

Pré-requisitos

Para seguir este guia, você precisará de:

• Um provedor de VPS (recomendado: Contabo VPS, Hetzner Cloud, DigitalOcean, Vultr, ou Linode)
• Um nome de domínio (opcional, mas recomendado para acessar seu wiki)
• Conhecimento básico de linha de comando e Docker

Escolhendo a VPS Certa

Ao selecionar uma VPS para hospedar o Wiki.js, leve em consideração as seguintes especificações:

Para desempenho ideal, o Contabo oferece os melhores recursos pelo custo, tornando-se uma escolha excelente para hospedar o Wiki.js.

Passo 1: Configurando Sua VPS

1. Inicie sua VPS: Escolha um dos planos acima que atenda às suas necessidades e inicie o servidor.

2. Conecte-se à sua VPS: Use SSH para se conectar. Substitua seu_usuario e seu_ip pelas suas credenciais.

   ssh seu_usuario@seu_ip

3. Atualize o sistema:

   sudo apt update && sudo apt upgrade -y

4. Instale o Docker:

   sudo apt install docker.io -y
   sudo systemctl start docker
   sudo systemctl enable docker

5. Instale o Docker Compose:

   sudo apt install docker-compose -y

Passo 2: Implantando o Wiki.js

1. Crie um diretório para o Wiki.js:

   mkdir ~/wikijs && cd ~/wikijs

2. Crie um arquivo docker-compose.yml:

   Use um editor de texto para criar este arquivo:

   version: "3"
   
   services:
     wikijs:
       image: requarks/wiki:latest
       ports:
         - "3000:3000"
       environment:
         - DB_TYPE=postgres
         - DB_HOST=db
         - DB_PORT=5432
         - DB_USER=wikijs
         - DB_PASS=password
         - DB_NAME=wikijs
       depends_on:
         - db
   
     db:
       image: postgres:13
       environment:
         - POSTGRES_USER=wikijs
         - POSTGRES_PASSWORD=password
         - POSTGRES_DB=wikijs
       volumes:
         - pgdata:/var/lib/postgresql/data
   
   volumes:
     pgdata:

   Modifique as credenciais do banco de dados conforme necessário para sua configuração.

3. Inicie o serviço do Wiki.js:

   sudo docker-compose up -d

4. Acesse o Wiki.js:
   Abra seu navegador e navegue até http://seu_ip:3000. Siga as instruções na tela para concluir a configuração.

Passo 3: Configurando o Wiki.js

Depois de instalado, você pode configurar o Wiki.js de acordo com suas preferências. Pode conectar a um banco de dados externo, configurar autenticação de usuários e personalizar recursos. Para usuários iniciantes, o Wiki.js oferece uma interface que torna essas tarefas simples.

Perguntas Frequentes

1. Quais são os benefícios de auto-hospedar o Wiki.js?

Auto-hospedar o Wiki.js oferece controle total sobre seus dados e privacidade. Você pode personalizar a plataforma conforme suas necessidades, escalar recursos conforme necessário e evitar o lock-in de fornecedores. Permite que desenvolvedores e equipes mantenham uma base de conhecimento consistente sem as restrições de serviços de terceiros, além de ser uma solução econômica dependendo das suas escolhas de infraestrutura.

2. Posso usar o Wiki.js com um banco de dados PostgreSQL existente?

Sim, o Wiki.js suporta a conexão com bancos de dados PostgreSQL existentes. Durante a configuração, você deve especificar suas credenciais do banco de dados no arquivo docker-compose.yml. Certifique-se de que a versão do PostgreSQL seja compatível com os requisitos do Wiki.js. Também pode configurar opções adicionais para otimizar o desempenho com base nas especificações do seu banco.

3. O que acontece se minha VPS ficar fora do ar?

Se sua VPS ficar fora do ar, o Wiki.js ficará inacessível, e qualquer edição ou atualização feita offline pode não ser salva. Backups regulares são essenciais. Utilizar um serviço de backup ou configurar backups automáticos para seu banco de dados PostgreSQL pode proteger seus dados. Além disso, considere usar ferramentas de monitoramento para alertá-lo sobre o status da sua VPS, permitindo uma reação rápida.

Conclusão

Auto-hospedar o Wiki.js em uma VPS é uma abordagem prática para gerenciar documentação e colaboração em seus projetos. Seguindo este guia, você configurará uma plataforma de gestão de conhecimento confiável de forma eficiente. Para mais detalhes, confira nossa completíssima comparação de VPS e escolha o provedor ideal para suas necessidades. Boa hospedagem!