Como Autohospedar Homer em um VPS (Guia Completo)

Homer é uma aplicação web estática leve que permite criar um painel personalizado para seus aplicativos autohospedados. Este guia cobrira os passos para autohospedar Homer em um Virtual Private Server (VPS). Vamos passar pela instalação do Docker, puxar a imagem do Homer e configurá-la para seu uso.

Escolhendo um Provedor de VPS

Antes de começarmos a instalação, é necessário escolher um provedor de VPS. Abaixo está uma comparação de algumas opções populares que você pode considerar:

Para este guia, recomendamos o Hetzner Cloud devido à sua acessibilidade e recursos. Confira a comparação completa de VPS para mais opções.

Pré-requisitos

1. Um VPS com pelo menos 1 GB de RAM e sistema operacional Ubuntu ou Debian.
2. Conhecimento básico de SSH e Docker.
3. Um nome de domínio apontando para seu VPS (opcional, mas recomendado para acessar seu painel Homer).

Passo 1: Atualizar seu VPS

Acesse seu VPS via SSH:

ssh usuário@seu_vps_ip

Certifique-se de que seu sistema esteja atualizado:

sudo apt update && sudo apt upgrade -y

Passo 2: Instalar Docker

Você precisa instalar o Docker para executar a aplicação Homer. Veja como:

Instalar Docker

Execute os comandos abaixo:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Verificar a Instalação do Docker

Verifique se o Docker foi instalado corretamente:

sudo systemctl start docker
sudo systemctl enable docker
sudo docker --version

Se a instalação foi bem-sucedida, a versão do Docker será exibida.

Passo 3: Implantar Homer

Agora é hora de implantar Homer. Crie um diretório para o Homer:

mkdir -p ~/homer
cd ~/homer

Puxar a Imagem Docker do Homer

Você pode puxar a última versão da imagem do Homer usando o comando:

sudo docker pull b4bz/homer:latest

Criar um Arquivo de Configuração

Crie um arquivo de configuração padrão:

curl -o config.yml https://ghproxy.com/https://raw.githubusercontent.com/b4bz/homer/master/config.yml

Edite o arquivo config.yml para personalizar seu painel:

nano config.yml

Faça as modificações necessárias, focando nos links e títulos de seus aplicativos autohospedados.

Executar o Container Docker do Homer

Agora, execute o container do Homer:

sudo docker run -d \
  --name homer \
  -p 8080:8080 \
  -v ~/homer/config.yml:/www/assets/config.yml \
  b4bz/homer:latest

O Homer estará acessível em http://seu_vps_ip:8080. Se estiver usando um domínio, utilize esse em seu lugar.

Passo 4: Configuração de Reverse Proxy (Opcional)

Para tornar o Homer acessível via uma URL mais amigável, configure um reverse proxy. Recomendamos o uso de Nginx ou Traefik para isso.

Instalar Nginx

sudo apt install nginx -y

Configurar Nginx

Crie um novo arquivo de configuração para o Homer:

sudo nano /etc/nginx/sites-available/homer

Adicione a seguinte configuração, trocando seu_dominio.com pelo seu domínio:

server {
    listen 80;
    server_name seu_dominio.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Habilite a configuração:

sudo ln -s /etc/nginx/sites-available/homer /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Agora, acesse o Homer pelo seu nome de domínio, sem precisar informar a porta.

FAQ

Posso personalizar o dashboard do Homer?

Sim, o dashboard do Homer é altamente personalizável. Você pode editar o arquivo config.yml para alterar o nome e o URL de cada link de aplicativo. Adicione logos ou ícones para representar visualmente cada serviço. Para configurações mais avançadas, consulte a documentação do Homer no GitHub.

O que faço se encontrar problemas ao instalar o Docker?

Se enfrentar dificuldades durante a instalação do Docker, verifique se seu servidor é compatível e se você possui as atualizações mais recentes do sistema Ubuntu ou Debian. Consulte o guia de solução de problemas oficial do Docker para erros comuns. Além disso, configurações de firewall personalizadas podem afetar a conectividade - garanta que o acesso de saída aos repositórios do Docker esteja permitido.

Quão seguro é hospedar aplicativos como Homer por conta própria?

Autohospedar aplicações requer medidas de segurança. Assegure-se de que seu VPS opere com um firewall - UFW é uma ótima escolha para Ubuntu. Atualize regularmente suas aplicações e o sistema operacional subjacente para prevenir vulnerabilidades. Se expor seu painel à internet, considere implementar HTTPS usando Let’s Encrypt para criptografar as transferências de dados.

Seguindo este guia, você poderá autohospedar Homer de forma eficaz em um VPS, tendo acesso rápido aos seus aplicativos favoritos em um painel conveniente. Feliz hospedagem!