SuporteSelf-Hosted Edge

Configure o Self-Hosted Edge: HTTPS e redirecionamentos nos seus próprios servidores

Resposta direta

Comece um teste do Pro com o complemento Self-Hosted Edge ou adicione-o ao Pro. Adicione seu domínio como “HTTPS para o meu próprio site”, execute o contêiner a partir da configuração dele em cada servidor e aponte os registros A ou AAAA do domínio para eles. A RedirHub emite o certificado assim que seus servidores respondem, renova-o a partir daí e avisa você por e-mail se seus servidores pararem de responder. Os links que você adicionar ao domínio também redirecionam nos seus servidores.

Com o Self-Hosted Edge, o HTTPS dos seus domínios termina nos seus próprios servidores, em um contêiner na frente da sua aplicação. A RedirHub emite o certificado de cada domínio, renova-o e o sincroniza com todos os servidores, então você não executa nenhum cliente ACME nem tarefa de renovação. Os visitantes vão direto para seus servidores e nunca passam pela RedirHub.

O mesmo contêiner serve todos os links que você adicionar ao domínio, como faz a própria rede da RedirHub: redirecionamentos, links curtos, QR codes, páginas HTML personalizadas e links protegidos por senha. Um link para um caminho redireciona antes de sua aplicação responder, uma regra coringa só assume os 404 da sua aplicação, e visitas e 404 aparecem no Analytics. Só HTTPS? Não adicione links, e todas as requisições vão para sua aplicação.

Antes de começar#

  • Um servidor com Docker, acessível pela internet na porta 443. A porta 80 fica com sua aplicação.
  • Sua aplicação, ou um proxy como Caddy ou nginx, respondendo em HTTP simples na porta 80 do servidor. Outra porta também funciona, com uma configuração.
  • A função de gestor no seu workspace: só os gestores veem o comando com o token de servidor do workspace.

Passo 1: Obtenha o complemento Self-Hosted Edge#

O Self-Hosted Edge é um complemento do Pro, $100/mês para até 100 servidores. No Enterprise, o contrato define.

  • Novo na RedirHub: comece um teste do Pro com o Self-Hosted Edge. É grátis por 14 dias. É preciso um cartão para começar, e nada é cobrado antes do fim do teste.
  • Já em um teste do Pro: adicione o complemento ao seu plano no painel. Seu teste continua, o complemento é grátis até o fim dele e depois é cobrado junto com o Pro.
  • No Pro pago: adicione-o ao seu plano no painel. As janelas Adicionar domínio e Conectar também o oferecem, com o preço, quando seu workspace ainda não o tem.

Passo 2: Adicione o domínio#

  1. Vá em Nomes dos servidores e clique em Adicionar domínio.
  2. Digite o domínio ou subdomínio, por exemplo app.example.com.
  3. Em “Para que você vai usá-lo?”, escolha “HTTPS para o meu próprio site” e clique em “Adicionar e configurar servidores”. A configuração dele abre em seguida.

Para um domínio que você já adicionou, abra Conectar e escolha “Usar meus próprios servidores” em “Nos meus próprios servidores”. Pela API ou pelo servidor MCP, crie o domínio com connection_mode definido como self_hosted. Com o provedor do Terraform (redirhub/redirhub 0.2.0 ou posterior), defina connection_mode em redirhub_domain; alterá-lo depois muda o modo do domínio sem recriá-lo:

hclresource "redirhub_domain" "shop" {
  host            = "shop.example.com"
  connection_mode = "self_hosted"
}

# Waits until your servers answer for it; its certificate follows.
resource "redirhub_domain_verification" "shop" {
  host = redirhub_domain.shop.host
}

Passo 3: Execute o contêiner em cada servidor#

Em “O que seus servidores fazem”, a configuração lista o que o contêiner faz e monta o comando de acordo: os links do seu domínio, os relatórios de 404 da sua aplicação, a porta 80 enviada para HTTPS e a porta em que sua aplicação escuta. Copie o comando, com seu token de servidor já preenchido, e execute-o em cada servidor:

bashdocker run -d --name redirhub-edge --restart unless-stopped --network host \
  -v redirhub-edge:/data \
  -e REDIRHUB_TOKEN=<your server token> \
  redirhub/edge

O contêiner assume a porta 443 e repassa cada requisição para sua aplicação na porta 80, que continua servindo como antes. Execute o mesmo comando, com o mesmo token, em cada servidor; cada um aparece em “Seus servidores” assim que o contêiner dele inicia. Mantenha o volume ao atualizar a imagem: ele guarda a identidade do servidor, os certificados e a última cópia dos seus links.

Configurações que o contêiner lê, como -e NAME=value. Só o token é obrigatório.
ConfiguraçãoPadrãoO que faz
REDIRHUB_TOKENNenhum (obrigatório)O token de servidor do seu workspace. Permite que o servidor busque os certificados e os links do seu workspace, e nada mais, e comprove cada um dos seus domínios.
UPSTREAMhttp://127.0.0.1:80Onde sua aplicação escuta. Para uma aplicação em outra porta: -e UPSTREAM=http://127.0.0.1:8080.
PORT_HTTPS443A porta que o contêiner assume para HTTPS. Altere-a só atrás de um balanceador de carga TCP que repasse a porta 443 para esta porta: o Let’s Encrypt e nossas verificações acessam seus domínios na 443.
PORT_HTTPoffUma porta para HTTP simples, por exemplo 80. off deixa a porta 80 para sua aplicação.
ALWAYS_HTTPSonO que o HTTP simples em PORT_HTTP recebe: on o envia para HTTPS (301), off o serve como HTTPS (seus links, depois sua aplicação).
LINKSonoff não serve nenhum link nesses servidores: só HTTPS, todas as requisições vão para sua aplicação.
REPORT_404onoff não relata nenhum 404 da sua aplicação a partir desses servidores.
PORT_HEALTHoffUma porta para a verificação de saúde de um balanceador de carga: GET /ready responde 200 assim que o servidor tem seus certificados.
PROXY_PROTOCOLoffAtrás de um balanceador de carga TCP que envia o protocolo PROXY: os endereços ou faixas dele, por exemplo 10.0.0.0/8, para que sua aplicação veja o endereço do visitante.

Para mudar como as requisições chegam à sua aplicação, monte seus próprios arquivos em /etc/edge/: proxy.conf substitui as configurações de proxy geradas, e os arquivos em http.d/ e server.d/ são adicionados ao bloco http e aos servidores dos seus domínios (por exemplo, um upstream com vários servidores de aplicação ou um cabeçalho HSTS). O contêiner os verifica antes de iniciar e indica a linha que não carrega.

Passo 4: Aponte o DNS para seus servidores#

  • No seu provedor de DNS, defina os registros A (e AAAA) do domínio com os endereços dos seus servidores.
  • Aponte também o www para os mesmos servidores, e o certificado passa a cobrir o www.
  • Para um curinga como *.example.com, adicione também o registro CNAME que a configuração mostra. Ele comprova que o curinga é seu e nos permite emitir o certificado dele. Curingas recebem só certificados, sem links.

Em seguida verificamos seus servidores. A resposta deles em /.well-known/host-verification por HTTPS comprova que o domínio é seu; o contêiner responde sozinho. Emitimos o certificado e o sincronizamos com todos os servidores, e a configuração mostra que seus servidores servem HTTPS com ele. Renovações e alterações de links chegam a eles sozinhas, em segundos.

Redirecionamentos e 404 nos seus servidores#

  • Um link para um caminho redireciona antes da sua aplicação, mesmo quando a página existe. Adicione um na RedirHub para tirar uma página do ar ou movê-la sem uma nova versão da sua aplicação.
  • Uma regra coringa só assume os 404 da sua aplicação: uma página que funciona nunca é substituída, e uma página que sua aplicação não tem mais vai para onde a regra coringa indicar.
  • Os 404 da sua aplicação são relatados e aparecem no Analytics, junto com as visitas dos seus links. Desative os relatórios de 404 do domínio na RedirHub, ou com REPORT_404=off nos servidores.
  • Todo tipo de link funciona nos seus servidores: o contêiner executa o mesmo redirecionador da rede da RedirHub, então páginas HTML personalizadas, redirecionamentos em frame e links protegidos por senha se comportam exatamente como no DNS da RedirHub. Um link que você adiciona, altera ou pausa chega a todos os servidores em segundos.

Se a RedirHub estiver inacessível, seus servidores continuam servindo com os certificados e links que têm.

Monitoramento#

Verificamos regularmente cada domínio nos seus servidores e enviamos um e-mail aos proprietários e gestores do workspace quando algo precisa de você:

  • Seus servidores pararam de responder: um e-mail quando nenhum dos seus servidores responde por um domínio há uma hora, com todos os domínios afetados. Se continuarem em silêncio por 7 dias, o domínio é liberado e você recebe mais um e-mail; inicie o contêiner de novo e ele se conecta sozinho.
  • Um certificado não pode ser renovado: a renovação começa semanas antes do vencimento e tenta de novo sozinha. Se o Let’s Encrypt ainda não conseguir alcançar o contêiner na porta 443 quando faltarem 14 dias para o certificado vencer, enviamos um e-mail, no máximo um por dia, com a data em que ele expira.

Estes são os e-mails de status do domínio: desative-os em Preferências de e-mail.

Se a configuração mostrar um problema#

MensagemO que significaSolução
Não foi possível alcançar a porta 443O domínio não chega a um contêiner em execução na porta 443.Verifique se os registros A ou AAAA dele apontam para seus servidores, se o contêiner está em execução (docker ps) e se seu firewall permite a porta 443.
A porta 443 respondeu, mas não com o token deste workspaceOutra coisa responde na porta 443, ou o contêiner foi iniciado com outro token.Pare o outro servidor HTTPS ou mova-o para a porta 80 atrás do contêiner, e inicie o contêiner com o token que a configuração mostra.
Ainda não vemos o registro CNAMEO registro CNAME do curinga está faltando ou ainda não se propagou.Adicione o registro exatamente como mostrado. Alterações de DNS podem levar alguns minutos para aparecer.
Seu workspace não inclui mais servidores própriosO complemento foi removido do plano.Adicione o Self-Hosted Edge ao seu plano novamente em até uma semana; depois disso, o domínio é liberado.

Substituir o token#

Se o token vazou, clique em Substituir token na configuração do domínio e inicie o contêiner de novo com o novo token em todos os servidores. Servidores que mantêm o token antigo deixam de receber certificados e alterações de links. Remova de “Seus servidores” um servidor que você não usa mais.

Experimente o Self-Hosted Edge grátis Comece o Pro com o Self-Hosted Edge: grátis por 14 dias, até 100 servidores, certificados emitidos e renovados para você e seus links servidos nos seus servidores.

Começar teste grátis

Perguntas frequentes

Não. O TLS termina no contêiner no seu servidor, que responde aos seus links e repassa todas as outras requisições para sua aplicação. A RedirHub emite e renova os certificados, sincroniza-os junto com seus links em todos os servidores e recebe as contagens de visitas e de 404.

Sim. Deixe-o servir HTTP simples na porta 80 e deixe a porta 443 para o contêiner, que repassa todas as requisições para ele. Desative os certificados próprios dele e o redirecionamento de HTTP para HTTPS desses domínios.

Sim, quando você começa o teste com ele ou o adiciona durante o teste. É grátis até o fim do teste e depois é cobrado a $100/mês junto com o Pro.

Seus servidores continuam servindo HTTPS e seus links com o que já têm. Os certificados são renovados com bastante antecedência, então uma interrupção curta nunca deixa um deles vencer.

Sim. Não adicione links ao domínio, ou inicie o contêiner com -e LINKS=off, e todas as requisições vão para sua aplicação. Desative os relatórios de 404 com -e REPORT_404=off.

Até 100 servidores por workspace, em qualquer região ou nuvem. Para mais, fale conosco sobre o Enterprise; o preço é definido por contrato.

Ajuda relacionada

Ver todos os artigos