Independent testing Updated April 2026 387 self-hosting guides 5 VPS providers tested

guide

Como Auto-Hospedar Authelia em um VPS (Guia Completo)

Aprenda como auto-hospedar Authelia em um VPS usando Docker com nosso guia completo. Instruções passo a passo incluídas.

Authelia é um servidor de autenticação e autorização de código aberto, ideal para desenvolvedores que desejam proteger suas aplicações web. Este guia irá orientar você pelo processo de auto-hospedagem do Authelia em um VPS usando Docker, garantindo que seus aplicativos tenham um controle de acesso seguro.

Pré-requisitos

  1. Seleção de VPS - Escolha um provedor de VPS confiável. Aqui está uma comparação de algumas opções principais:
ProvedorPreço (Mensal)Opções de LocalizaçãoRecursos Principais
Contabo VPS5,99 EUREuropaÓtimo desempenho, opções escaláveis
Hetzner Cloud4,15 EUREuropaArmazenamento SSD, excelente suporte
DigitalOcean6 USDMundialFácil de usar, comunidade forte
Vultr6 USDMundialAlto desempenho, opções variadas
Linode (Akamai Cloud)5 USDMundialDesempenho sólido, uptime confiável

Para mais opções, confira nossa comparação completa de VPS.

  1. Conhecimentos básicos de Docker e comandos de terminal.
  2. Um nome de domínio para configurar o Authelia (opcional, mas recomendado).

Etapa 1: Configurar seu VPS

  1. Criar uma instância de VPS: Escolha seu provedor preferido e configure sua instância. Por exemplo, com Hetzner, você pode começar por apenas 4,15 EUR/mês.
  2. Acessar seu VPS: Conecte via SSH:
    ssh root@seu_ip_vps
  3. Atualizar seu sistema: Certifique-se de que os pacotes do sistema estão atualizados.
    apt update && apt upgrade -y

Etapa 2: Instalar Docker

  1. Instalar pacotes necessários:
    apt install apt-transport-https ca-certificates curl software-properties-common -y
  2. Adicionar a chave GPG oficial do Docker:
    curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
  3. Configurar o repositório estável:
    add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
  4. Instalar o Docker:
    apt update && apt install docker-ce docker-ce-cli containerd.io -y
  5. Verificar instalação:
    docker --version

Etapa 3: Instalar Authelia

  1. Criar uma rede Docker:
    docker network create authelia_network
  2. Criar arquivos de configuração: Prepare os seus arquivos de configuração criando uma pasta.
    mkdir -p ~/authelia/config
  3. Configuração de exemplo (configuration.yml): Crie e edite o arquivo configuration.yml na pasta de configuração.
    host: "0.0.0.0"
    port: 9091
    ...
    Observação: Substitua ... por outras configurações necessárias. Consulte a documentação do Authelia para instruções detalhadas.
  4. Criar arquivo Docker Compose: Na mesma pasta, crie um arquivo docker-compose.yml.
    version: '3.8'
    services:
      authelia:
        image: authelia/authelia:latest
        restart: always
        networks:
          - authelia_network
        volumes:
          - ./config:/config
        ports:
          - "9091:9091"
  5. Iniciar o Authelia:
    docker-compose up -d
  6. Verificar status:
    docker ps

Etapa 4: Configurar um Proxy Reverso

Use um proxy reverso como Nginx para gerenciar desafios ACME para certificados SSL e direcionar o tráfego para sua instância do Authelia.

  1. Instalar Nginx:
    apt install nginx -y
  2. Exemplo de configuração do Nginx: Edite /etc/nginx/sites-available/authelia:
    server {
        listen 80;
        server_name seu_dominio.com;
    
        location / {
            proxy_pass http://localhost:9091;
            # Outras configurações necessárias
        }
    }
  3. Habilitar configuração:
    ln -s /etc/nginx/sites-available/authelia /etc/nginx/sites-enabled/
    systemctl restart nginx

Etapa 5: Finalizando a configuração

  1. Proteger o Authelia com HTTPS: Use o Let’s Encrypt para certificados SSL.
  2. Testar o Authelia: Acesse seu domínio pelo navegador. Você deverá ver a página de login do Authelia.
  3. Configurar Authelia com suas aplicações: Integre e configure o Authelia com os serviços que deseja proteger.

FAQs

O que é Authelia e por que devo usá-lo?

Authelia é um servidor de autenticação e autorização de código aberto, projetado para desenvolvedores. Ele fornece controle de acesso seguro para suas aplicações sem a necessidade de criar sistemas de gerenciamento de usuários individuais. Isso é especialmente útil para desenvolvedores que auto-hospedam múltiplos serviços em um homelab ou ambiente VPS.

Posso instalar Authelia sem Docker?

Sim, o Authelia pode ser instalado sem Docker, mas usar Docker simplifica o processo. Docker fornece ambientes isolados, garantindo que as dependências da sua aplicação não interfiram no sistema ou em outras aplicações. Se preferir uma instalação manual, siga a documentação oficial do Authelia para orientações.

Como solucionar problemas comuns com o Authelia?

Problemas comuns geralmente envolvem configurações incorretas, especialmente no arquivo configuration.yml ou .env. Certifique-se de que todos os campos necessários estão presentes e corretamente formatados. Verifique os logs do Docker para seu container do Authelia usando:

docker logs authelia

Além disso, confirme se a configuração de rede está correta e se o proxy reverso está roteando o tráfego adequadamente.

Seguindo os passos acima, você poderá hospedar o Authelia em seu VPS com sucesso, aumentando a segurança de suas aplicações. Lembre-se de atualizar regularmente suas configurações e imagens Docker para garantir segurança e performance otimizadas.