Resposta direta
Inicie uma avaliação Pro com o complemento TLS auto-hospedado, ou adicione-o ao Pro. Depois, adicione o seu domínio como “Apenas HTTPS, nos meus próprios servidores”, execute o contêiner a partir da configuração dele em cada servidor e aponte os registos A ou AAAA do domínio para eles. O RedirHub emite o certificado assim que os seus servidores responderem pelo domínio e o renova daí em diante.
Com TLS auto-hospedado, o HTTPS para os seus domínios termina nos seus próprios servidores, num contêiner que fica à frente da sua aplicação. O RedirHub emite o certificado de cada domínio, renova-o e sincroniza-o com cada servidor, para que você não precise executar nenhum cliente ACME nem tarefa de renovação. As solicitações dos visitantes vão diretamente para os seus servidores e nunca passam pelo RedirHub.
Um domínio neste modo recebe apenas HTTPS: o RedirHub não serve redirecionamentos nem links curtos nele.
Antes de começar#
- Um servidor com Docker, acessível pela internet na porta 443. A porta 80 fica com a sua aplicação.
- A 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 na sua área de trabalho: apenas gestores veem o comando com o token da área de trabalho.
Passo 1: Obtenha o complemento TLS auto-hospedado#
TLS auto-hospedado é um complemento do Pro, US$100/mês para até 100 servidores. No Enterprise, o contrato define isso.
- Novo no RedirHub: inicie um teste Pro com TLS autogerenciado. Ele é gratuito por 14 dias. É necessário um cartão para começar, e nada é cobrado antes do fim do teste.
- Já está em um teste Pro: adicione o complemento ao seu plano no painel. Seu teste continua em execução, o complemento é gratuito até ele terminar e depois é cobrado junto com o Pro.
- No Pro pago: adicione-o ao seu plano no painel. As caixas de diálogo Adicionar domínio e Conectar também o oferecem, com o preço, quando seu workspace ainda não o tiver.
Etapa 2: Adicione o domínio#
- Vá para Hostnames 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 “Apenas HTTPS, em meus próprios servidores” e depois clique em “Adicionar e configurar servidores”. A configuração dele será aberta em seguida.
Para um domínio que você já adicionou, abra Conectar e escolha “Usar meus próprios servidores” em outras formas de conectar. Pela API ou pelo servidor MCP, crie o domínio com connection_mode definido como self_hosted. Com o provedor Terraform (redirhub/redirhub 0.2.0 ou posterior), defina connection_mode em redirhub_domain; alterá-lo depois muda o domínio no lugar:
hclresource "redirhub_domain" "shop" {
host = "shop.example.com"
connection_mode = "self_hosted"
}
# Espera até que seus servidores respondam por ele; o certificado segue depois.
resource "redirhub_domain_verification" "shop" {
host = redirhub_domain.shop.host
}Etapa 3: Execute o contêiner em cada servidor#
A configuração mostra o comando com o token do seu espaço de trabalho preenchido. Copie-o 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 workspace token> \
redirhub/edgeO contêiner usa a porta 443 e encaminha cada solicitação para o seu app na porta 80, que continua atendendo como antes. Execute o mesmo comando, com o mesmo token, em todos os servidores; cada um aparecerá em “Seus servidores” assim que o contêiner iniciar. Mantenha o volume quando atualizar a imagem: ele armazena a identidade e os certificados do servidor.
| Setting | Default | O que faz |
|---|---|---|
| REDIRHUB_TOKEN | Nenhum (obrigatório) | Seu token do espaço de trabalho. Ele permite que o servidor obtenha os certificados do seu espaço de trabalho, e nada mais, e comprove cada um dos seus domínios. |
| UPSTREAM | http://127.0.0.1:80 | Onde seu app escuta. Para um app em outra porta, adicione -e UPSTREAM=http://127.0.0.1:8080. |
| HTTPS_PORT | 443 | A porta que o contêiner usa para HTTPS. Altere-a apenas por trás de um balanceador de carga que encaminhe a porta 443 para esta porta: o Let's Encrypt e nossas verificações alcançam seus domínios na 443. |
| HTTP_PORT | off | Uma porta para HTTP simples. Desativado deixa a porta 80 para a sua aplicação. |
| HTTP_MODE | redirect | O que o HTTP simples em HTTP_PORT faz: redirecionar o envia para HTTPS; proxy o encaminha para a sua aplicação. |
Passo 4: Aponte o DNS para os seus servidores#
- No seu provedor de DNS, defina os registros A (e AAAA) do domínio para os endereços dos seus servidores.
- Aponte www para os mesmos servidores também, e o certificado dele cobre www igualmente.
- Para um wildcard como *.example.com, adicione também o registro CNAME mostrado pela configuração. Ele prova que o wildcard é seu e nos permite emitir o certificado dele.
Em seguida, verificamos os seus servidores. A primeira resposta deles em /.well-known/host-verification via HTTPS prova que o domínio é seu; o contêiner responde a isso sozinho. Emitimos o certificado e o sincronizamos com todos os servidores, e a configuração mostra que os seus servidores servem HTTPS com ele. As renovações chegam a eles sozinhas.
Se a configuração mostrar um problema#
| Message | O que isso significa | Fix |
|---|---|---|
| Não foi possível الوصول à porta 443 | O domínio não está alcançando um contêiner em execução na porta 443. | Verifique se os registros A ou AAAA apontam para seus servidores, se o contêiner está em execução e se o seu firewall permite a porta 443. |
| A porta 443 respondeu, mas não com o token deste workspace | Algo diferente está respondendo 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 mostrado na configuração. |
| Ainda não vemos o registro CNAME | O registro CNAME do wildcard está ausente ou ainda não propagou. | Adicione o registo exatamente como mostrado. As alterações de DNS podem demorar alguns minutos a aparecer. |
| O seu workspace já não inclui os seus próprios servidores | O complemento foi removido do plano. | Adicione novamente o Self-Hosted TLS ao seu plano no prazo de uma semana; depois disso, o domínio é libertado. |
Substituir o token#
Se o token tiver sido comprometido, clique em Substituir token na configuração do domínio e, em seguida, inicie novamente o contentor com o novo token em todos os servidores. Os servidores que mantiverem o token antigo deixam de receber certificados. Remova de “Os seus servidores” um servidor de que já não precise.
Experimente o Self-Hosted TLS gratuitamente Comece o Pro com Self-Hosted TLS: gratuito durante 14 dias, até 100 servidores, com certificados emitidos e renovados para si.
Iniciar uma avaliação gratuitaPerguntas frequentes
Não. O TLS termina no contêiner do seu servidor, que encaminha cada solicitação para o seu aplicativo. A RedirHub apenas emite e renova os certificados e mantém todos os servidores sincronizados.
Sim. Deixe-o servir HTTP puro na porta 80 e reserve a porta 443 para o contêiner, que encaminha todas as solicitações para ele. Desative os próprios certificados e o redirecionamento de HTTP para HTTPS para esses domínios.
Sim, quando você iniciar a avaliação com ele ou adicioná-lo durante a avaliação. Ele é gratuito até o fim da avaliação e, depois, cobrado em US$ 100/mês com o Pro.
Seus servidores continuam servindo HTTPS com os certificados que já possuem. Os certificados são renovados bem antes do vencimento, então uma interrupção curta nunca faz com que um expire.
Até 100 servidores por workspace, em qualquer região ou nuvem. Para mais, fale conosco sobre o Enterprise; o preço é definido por contrato.
