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#
- Vá em Nomes dos servidores e clique em Adicionar domínio.
- Digite o domínio ou subdomínio, por exemplo app.example.com.
- 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/edgeO 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ção | Padrão | O que faz |
|---|---|---|
| REDIRHUB_TOKEN | Nenhum (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. |
| UPSTREAM | http://127.0.0.1:80 | Onde sua aplicação escuta. Para uma aplicação em outra porta: -e UPSTREAM=http://127.0.0.1:8080. |
| PORT_HTTPS | 443 | A 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_HTTP | off | Uma porta para HTTP simples, por exemplo 80. off deixa a porta 80 para sua aplicação. |
| ALWAYS_HTTPS | on | O 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). |
| LINKS | on | off não serve nenhum link nesses servidores: só HTTPS, todas as requisições vão para sua aplicação. |
| REPORT_404 | on | off não relata nenhum 404 da sua aplicação a partir desses servidores. |
| PORT_HEALTH | off | Uma 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_PROTOCOL | off | Atrá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#
| Mensagem | O que significa | Solução |
|---|---|---|
| Não foi possível alcançar a porta 443 | O 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 workspace | Outra 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 CNAME | O 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óprios | O 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átisPerguntas 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.
