¶ Procedimento operacional — Publicação de novo site no HestiaCP (UFOP)
Serviço: hospedagem web institucional
Painel: Hestia Control Panel (HestiaCP)
Ambiente informado: direstraits.ufop.br (confirmar URL e porta administrativa com a equipe)
Exemplo utilizado: labcam.ufop.br
Versão do procedimento: 1.0 — 13/10/2026
Escopo: criar e publicar um site no painel após a criação/delegação do domínio no DNS institucional. O procedimento também verifica se a resolução DNS está operacional; um domínio criado no cadastro institucional pode ainda não estar resolvendo corretamente.
Atenção: não publicar senhas, chaves privadas, certificados com dados sensíveis ou capturas contendo credenciais na wiki. O usuário do HestiaCP, o nome de domínio e o IP devem ser ajustados para cada solicitação. O IP
200.239.129.85foi observado no exemplo do chamado, mas não deve ser reutilizado sem confirmar o IP designado para o servidor e site.
¶ 1. Pré-requisitos
Antes de iniciar, confirmar no chamado:
- Domínio solicitado, por exemplo
labcam.ufop.br. - Nome e e-mail institucional do responsável.
- Conta HestiaCP associada à hospedagem (existente ou a criar).
- Endereço IP público correto do servidor de hospedagem.
- Registro DNS do domínio criado e respondendo publicamente.
- Serviços web e, para Let's Encrypt via HTTP, acesso externo à porta TCP 80.
- Tipo de publicação: HTML estático, WordPress ou outro sistema.
- Forma autorizada de envio dos arquivos: FTP com TLS (FTPS), SFTP ou gerenciador de arquivos.
Distinção importante: cadastrar labcam.ufop.br no DNS da UFOP não cria automaticamente uma hospedagem no HestiaCP. E criar o domínio no HestiaCP não configura necessariamente o DNS público institucional.
¶ 2. Verificar o DNS antes de solicitar SSL
No Windows, abrir Prompt de Comando (CMD) e executar:
nslookup labcam.ufop.br 8.8.8.8
nslookup -type=A labcam.ufop.br 1.1.1.1
nslookup -type=AAAA labcam.ufop.br 1.1.1.1
- O registro A deve retornar o IP IPv4 aprovado para a hospedagem.
- Um registro AAAA só é necessário quando o site usa IPv6; não ter AAAA é normal, mas o DNS deve responder à consulta sem expirar.
- Se houver
DNS request timed out, investigar os servidores DNS autoritativos, a delegação e o funcionamento da porta 53 (UDP/TCP). Não insistir na emissão do certificado enquanto a resolução estiver falhando.
Nota: a resposta obtida de um resolvedor DNS não garante que todos os resolvedores públicos consigam consultar o domínio. Se houver divergência, verificar diretamente os servidores autoritativos com a equipe de DNS.
¶ 3. Criar ou localizar a conta do responsável
- Entrar no HestiaCP com conta administrativa, usando o endereço interno/autorizado do painel.
- Acessar USERS / Usuários.
- Pesquisar se já existe uma conta adequada para o laboratório ou projeto.
- Se não existir, usar Add User / Adicionar usuário e preencher os campos exigidos pela política local (identificação, e-mail institucional, pacote, senha inicial).
- Guardar o nome de usuário da conta no registro do chamado — nunca a senha em texto puro.
- Para cadastrar o site na conta correta, usar Login as User / Entrar como usuário quando essa funcionalidade estiver disponível. Isso muda o contexto operacional, sem exigir conhecer a senha do usuário.
Por que isso é feito? O HestiaCP vincula os domínios web aos usuários, que determinam isolamento de arquivos, permissões e cotas. Administradores também podem provisionar recursos por CLI/API; não é requisito conhecer a senha do responsável.
[Captura a incluir pela equipe] Tela USERS mostrando a seleção de um usuário e a ação Login as User, com dados pessoais ocultados.
¶ 4. Cadastrar o domínio WEB (ainda que o DNS já exista)
- Dentro da conta correta, abrir a aba WEB.
- Clicar Add Web Domain / Adicionar domínio web.
- Informar o domínio completo:
labcam.ufop.br(substituir pelo domínio do chamado). - Confirmar o IP associado à hospedagem, quando houver campo para isso.
- Não ativar automaticamente a criação da zona DNS no HestiaCP quando o DNS for gerido pela infraestrutura institucional da UFOP. Isso evita uma zona duplicada ou não utilizada; seguir a política de DNS da equipe.
- Não habilitar serviço de e-mail apenas para hospedar um site HTML, salvo exigência específica.
- Salvar.
- Confirmar que o domínio consta na listagem WEB do usuário correto.
[Captura a incluir pela equipe] Tela WEB → Add Web Domain, destacando o campo Domain, o IP (se aplicável) e as opções de DNS e e-mail.
¶ 5. Preparar publicação dos arquivos
Em uma instalação padrão do HestiaCP, o diretório público costuma ser:
/home/USUARIO/web/DOMINIO/public_html/
Exemplo ilustrativo:
/home/laboratorio/web/labcam.ufop.br/public_html/
- Entrar no diretório
public_htmldo domínio correspondente. - Fazer backup ou preservar arquivos existentes antes de substituí-los.
- Para um teste inicial de site HTML, publicar um arquivo
index.htmlcomo este:
<!doctype html>
<html lang="pt-BR">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Laboratório — UFOP</title>
</head>
<body>
<h1>Site em implantação</h1>
<p>Hospedagem configurada para testes.</p>
</body>
</html>
- Acessar
http://labcam.ufop.bre confirmar a abertura da página antes de exigir HTTPS, respeitando as políticas de publicação e segurança do ambiente.
[Captura a incluir pela equipe] Gerenciador de arquivos na pasta
public_html, sem expor informações sensíveis.
¶ 6. Criar um acesso FTP exclusivo para o site (quando necessário)
O usuário principal do HestiaCP pode ter acesso de transferência de arquivos, de acordo com a configuração do servidor. Para fornecer acesso limitado aos arquivos de um único site, utilizar uma conta FTP adicional, se o serviço FTP estiver habilitado.
- Com o usuário proprietário selecionado, acessar WEB.
- Clicar no domínio e entrar em Edit / Editar.
- Abrir Advanced Options / Opções Avançadas.
- Marcar Additional FTP accounts / Contas FTP adicionais.
- Criar nome da conta, senha exclusiva e caminho de acesso ao site.
- Confirmar o caminho apresentado pela interface para que a conta fique restrita ao
public_htmldo site; não assumir que o campo aceita sempre um caminho absoluto, pois o formulário pode apresentar prefixos automáticos. - Salvar e testar no cliente FTP aprovado institucionalmente.
Exemplo: conta HestiaCP laboratorio, identificador FTP site → login FTP geralmente criado com o prefixo do usuário, como laboratorio_site.
No cliente FTP (ex.: FileZilla), registrar e confirmar:
| Item | Informação |
|---|---|
| Host | Nome do servidor FTP autorizado pela equipe, não presumir que é o próprio domínio do site |
| Protocolo | FTPS (FTP sobre TLS), se disponível; SFTP exige acesso SSH/SFTP próprio e não deve ser presumido para contas FTP adicionais |
| Porta | Definida pela configuração institucional (FTP geralmente 21; SFTP geralmente 22) |
| Usuário | Login FTP completo gerado no painel |
| Senha | Fornecida por canal seguro; não registrar na wiki |
| Diretório | Raiz permitida da conta FTP, configurada para os arquivos do site |
Atenção: caso Additional FTP accounts não apareça, confirmar se o servidor possui serviço FTP e se o pacote da conta permite esse recurso. Não habilitar serviços de forma improvisada no servidor sem autorização da equipe.
[Captura a incluir pela equipe] Tela WEB → Edit → Advanced Options → Additional FTP accounts, com os dados de credenciais ocultados.
¶ 7. Configurar o certificado SSL e o redirecionamento HTTPS
- Abrir WEB → domínio → Editar.
- Desmarcar Ativar redirecionamento de domínio se o objetivo for apenas direcionar HTTP para HTTPS. Esse item serve para redirecionamento de endereço canônico (por exemplo,
www), não é o mecanismo específico do HTTPS. - Marcar Ativar SSL para esse domínio.
- Marcar Usar Let's Encrypt para obter certificado SSL.
- Marcar Ativar redirecionamento HTTPS automático.
- Manter HSTS desativado na configuração inicial, até confirmar que HTTPS está funcional e que a política institucional permite ativá-lo.
- Salvar e aguardar o resultado da emissão.
O que não preencher quando usar Let's Encrypt: os campos Certificado SSL, Chave Privada SSL e Autoridade Certificadora SSL são usados na instalação manual de certificado. Não preencher com valores inventados ou gerados fora do processo aprovado.
Importante: somente solicitar Let's Encrypt após confirmar que o DNS público está resolvendo e que a validação HTTP poderá alcançar o servidor. Se a UFOP exigir certificado institucional, usar os arquivos aprovados fornecidos pela equipe responsável.
¶ 8. Solução de erros já observados
¶ 8.1. “O Campo 'ssl certificate, ssl key' não pode estar vazio”
Causa provável no caso observado: SSL ativado sem Let's Encrypt e sem certificado/chave manual cadastrados.
Ação: se for permitida a emissão pelo Let's Encrypt, marcar essa opção; se for obrigatório certificado institucional, solicitar o conjunto de certificado e chave pelos canais internos seguros.
¶ 8.2. “Let's Encrypt validation status 400 — DNS problem: query timed out looking up A / AAAA”
Interpretação: o serviço de validação não conseguiu obter resposta DNS dentro do prazo; não é um campo de certificado faltando no formulário.
Diagnóstico:
- Repetir consultas A/AAAA por resolvedores externos diferentes.
- Confirmar delegação e disponibilidade dos servidores DNS autoritativos da UFOP.
- Verificar se há firewall, DNSSEC ou problemas de rede afetando a resposta DNS.
- Após normalizar o DNS, confirmar que HTTP na porta 80 é acessível para a validação do desafio e repetir a emissão.
¶ 8.3. Site não abre embora conste na aba WEB
Verificar, nesta ordem: resolução DNS → IP de destino → portas 80/443 → domínio habilitado no HestiaCP → arquivos em public_html → logs do site. O painel permite consultar os logs de acesso/erro em WEB.
¶ 9. Validação final e encerramento do chamado
- Domínio responde pelo DNS público com IP correto.
- Domínio aparece no HestiaCP na conta do proprietário adequado.
- Página HTML abre no navegador.
- Conta de transferência de arquivos funciona e está restrita ao escopo aprovado.
- Certificado SSL válido foi emitido/instalado.
-
https://DOMINIOabre sem alerta de certificado. -
http://DOMINIOredireciona para HTTPS, se requerido. - Identificação do responsável, data, alterações e testes documentados no chamado.
- Credenciais entregues por canal seguro (sem registrar a senha no chamado/wiki).
¶ Modelo de registro para o chamado
Domínio: <DOMINIO>
Servidor/painel: direstraits.ufop.br (a confirmar)
Conta HestiaCP: <USUARIO>
Responsável institucional: <NOME / EMAIL>
DNS público: <IP VALIDADO>
Diretório do site: /home/<USUARIO>/web/<DOMINIO>/public_html/
Método de publicação: <FTPS / SFTP / outro>
SSL: <Let's Encrypt / institucional / pendente>
HTTPS automático: <sim / não>
Resultado dos testes: <descrever>
Data e executor: <preencher>
Pendências: <preencher>
¶ 10. Referências oficiais
- HestiaCP — Web Domains (criação, edição, FTP e SSL)
- HestiaCP — CLI Reference
- HestiaCP — documentação geral
Observação de manutenção da wiki: as três capturas incluídas são do chamado real fornecido pela equipe e mostram os campos SSL e mensagens de erro. As demais telas são indicadas como capturas pendentes, pois não foram fornecidas; adicionar imagens autenticadas do ambiente UFOP antes da publicação definitiva da versão ilustrada.