Central de ajuda Dlesk

Manual operacional do painel

Este guia explica o Dlesk do zero: para que ele serve, qual ordem seguir, onde cada recurso fica, como criar um site completo e como investigar erros sem precisar adivinhar o que aconteceu no servidor.

Preparar servidor Ver logs
Comece aqui Ordem certa Prepare, configure, teste e publique Uso diário Criar site Domínio, FTP, e-mail, banco e SSL Quando falhar Diagnóstico Logs, requisitos, serviços e correções Operação Produção Rotina segura para servidor real

1. Visão geral

O Dlesk é um painel local para administrar hospedagem em Windows Server.

Leitura inicial
Ideia principal

O Dlesk não substitui o Windows Server. Ele organiza e automatiza tarefas que normalmente seriam feitas manualmente no IIS, FTP, firewall, MailEnable, SQL Server, MySQL, PostgreSQL, win-acme e permissões NTFS.

O que o Dlesk faz

Cria domínios, pastas de site, bindings IIS, contas FTP, caixas de e-mail, bancos de dados, backups e certificados.

O que o Dlesk registra

Ele guarda configurações do painel, inventário detectado, operações executadas e metadados dos domínios.

O que continua sendo do Windows

IIS, serviços, firewall, usuários locais, permissões, DNS, bancos e MailEnable continuam existindo no sistema operacional.

Onde investigar

Quase toda ação importante gera registro em Tarefas e logs. Esse é o primeiro lugar para entender falhas.

Como navegar sem se perder

Telas filtradas por domínio mostram atalho para voltar ao domínio de origem. Use esse caminho para alternar entre FTP, e-mail, banco, SSL, backups, arquivos e DNS.

  1. Prepare o servidor. Abra Requisitos, execute a preparação automática e resolva qualquer item ausente.
  2. Revise as configurações. Confira raiz dos sites, pasta web padrão, banco, e-mail ACME, acesso remoto e grupo Windows autorizado.
  3. Crie um domínio de teste. Antes de usar em produção, crie um domínio simples para validar Web, FTP, banco, e-mail e SSL.
  4. Use logs como fonte da verdade. Se algo parecer estranho, abra o log da operação e leia as etapas executadas na ordem.

2. Mapa do painel

Serviços de hospedagem

Use esta área para operar clientes, sites e recursos do dia a dia.

  • Dashboard: visão rápida do servidor, últimos domínios/subdomínios acessados, recursos detectados no Windows, certificados e atividades recentes.
  • Domínios: cria e edita sites hospedados. É o ponto de partida para um novo cliente ou site.
  • SSL/TLS: acompanha certificados e emissões pelo win-acme.
  • Bancos: cria e lista bancos SQL Server, MySQL e PostgreSQL.
  • PHP: mostra versão detectada, FastCGI e sites PHP.
  • Tarefas e logs: histórico das ações executadas pelo painel.
  • Backups: gera e restaura pacotes de arquivos e dumps de banco.
  • Arquivos: navega pela pasta do domínio e ajuda a conferir onde a aplicação foi publicada.
  • Estatísticas: resume consumo, domínios, certificados e dados operacionais.

Meu perfil e operação do servidor

Use esta área para cuidar da máquina onde o Dlesk roda.

  • Serviços: mostra serviços Windows importantes, como IIS, FTP, MailEnable e bancos.
  • Segurança: valida firewall e permissões NTFS.
  • Requisitos: instala e verifica recursos necessários para hospedar sites.
  • Diagnóstico: reúne verificações técnicas para investigar problemas.
  • Atualizações: mostra versão instalada, versão disponível e aplica pacote local.
  • Pesquisa: localiza domínios, contas, arquivos e itens do painel.
  • Configurações: define caminhos, banco, licença, acesso remoto e atualização.
  • Ajuda: manual operacional do painel, atualizado conforme os fluxos do produto evoluem.

3. Preparar servidor

Use esta etapa em um Windows Server novo ou quando algum recurso obrigatório estiver ausente.

Abrir requisitos
Execute como administrador

Instalação de IIS, FTP, firewall, DNS, bancos, PHP e serviços exige privilégio administrativo. Se a preparação falhar com permissão negada, reinicie o Dlesk como administrador.

Ordem recomendada
  1. Abra Requisitos.
  2. Confira os cards Prontos, Atenção e Ausentes.
  3. Marque apenas os recursos que deseja instalar.
  4. Clique em Preparar servidor.
  5. Acompanhe o progresso até o status final.
  6. Clique em Reverificar depois da instalação.
O que pode ser instalado
  1. IIS e FTP do Windows Server.
  2. Regras de firewall para HTTP, HTTPS, FTP, DNS, e-mail e painel.
  3. win-acme para certificados SSL.
  4. SQL Server Express, MySQL, PostgreSQL e PHP via winget.
  5. MailEnable para e-mail.
  6. DNS Server e ferramentas como dig.
Sobre winget

Alguns instaladores vêm pela internet via Windows Package Manager. Se o winget encontrar vários pacotes, o Dlesk tenta usar IDs específicos. Para PostgreSQL, por exemplo, ele prioriza PostgreSQL 17, depois 16 e 15.

4. Configurações essenciais

Revise estes campos antes de criar domínios reais.

Abrir configurações
Campo O que significa Exemplo seguro
Raiz dos sites Pasta onde cada domínio terá seu diretório. C:\sites
Pasta web padrão Subpasta pública dentro do domínio. httpdocs
Banco de dados Motor usado por padrão ao criar bancos. SQL Server, MySQL ou PostgreSQL
Servidor do banco Host ou instância usada pelo CLI do banco. .\SQLEXPRESS ou localhost
E-mail ACME E-mail usado pelo win-acme para certificados. certificados@seudominio.com.br
Grupo Windows autorizado Grupo que pode acessar o painel. Administrators
Atualizações Manifesto, pacote ZIP e SHA256 usados para atualizar o painel. Use o pacote local gerado em dist\release ou o portal público.
Backups Destino, conteúdo, agenda e retenção dos backups automáticos. C:\Sites\DleskPanel\data\backups, horário fixo e dias da semana.

5. Criar um site completo

Este é o fluxo principal para hospedar um domínio com recursos completos.

Abrir domínios
  1. Abra Domínios e clique em Adicionar domínio. Use um nome real, como cliente.com.br, ou um domínio de teste que você controle.
  2. Preencha a etapa Domínio. Informe o domínio permitido pelo servidor e revise se ele pertence à zona que você administra. O Dlesk pode trabalhar com o domínio principal e seus subdomínios conforme a política configurada.
  3. Configure Hospedagem e DNS local. Confirme a pasta raiz, a pasta web e os registros básicos da zona local, como @, www, app, mail, ns1 e ns2, quando fizer sentido para o domínio.
  4. Escolha os serviços. A etapa Serviços só pede o que você marcou. Se marcar FTP, aparece a etapa FTP. Se marcar E-mail, aparece a etapa E-mail. Se marcar Banco, aparece a etapa Banco com escolha entre SQL Server, MySQL ou PostgreSQL.
  5. Preencha credenciais separadas. FTP, e-mail e banco usam usuários e senhas diferentes. O painel valida somente os campos das etapas selecionadas, então um domínio sem FTP não deve exigir senha FTP.
  6. Revise antes de aplicar. A aba Revisão mostra o que será criado, preservado ou ajustado. Use Validar ambiente para conferir raiz dos sites, IIS, FTP, MailEnable, banco e win-acme antes de concluir.
  7. Crie o domínio e acompanhe o log. Depois de salvar, abra Tarefas e logs para conferir cada etapa executada na ordem.
Quando usar Web

Para qualquer site hospedado no IIS. Sem Web, o domínio pode existir para e-mail ou organização, mas não terá site publicado.

Quando usar FTP

Para permitir envio de arquivos por um usuário separado, sem dar acesso administrativo ao servidor.

Quando usar Banco

Para WordPress, sistemas próprios, lojas, CRMs e aplicações que precisam armazenar dados.

Quando usar SSL

Quando o DNS público já aponta para o servidor e as portas HTTP/HTTPS estão liberadas.

Sobre Registro.br e DNS autoritativo

Antes de trocar os servidores DNS no Registro.br, crie ou confirme a zona no DNS local do Dlesk. O Registro.br consulta os nameservers informados. Se ns1.seudominio e ns2.seudominio ainda não responderem como autoritativos para o domínio, ele pode recusar a alteração com mensagem de pesquisa recusada. Em geral, a sequência segura é: criar zona local, criar registros NS/A necessários, liberar porta 53, validar consulta externa e só então alterar os DNS no registrador.

6. Publicar arquivos do site

Publicar pelo gerenciador de arquivos
  1. Abra o domínio.
  2. Entre na área de arquivos ou no editor.
  3. Crie ou edite arquivos dentro de httpdocs.
  4. Verifique o arquivo inicial da aplicação, como index.html, default.aspx, index.php ou outro documento configurado no IIS.
  5. Teste pelo navegador.
Publicar por FTP
  1. Crie ou confira a conta FTP do domínio.
  2. Use host, usuário e senha configurados no Dlesk.
  3. Envie os arquivos para a pasta pública.
  4. Se autenticar mas não enviar, revise permissões em Segurança.
Evite publicar fora da pasta do domínio

A pasta pública padrão é C:\sites\dominio\httpdocs. Arquivos fora dela podem não aparecer no site ou podem ficar fora do controle de permissões que o painel configurou.

Aviso de publicação

O Dlesk não considera ausência de index.html como erro por si só. Aplicações ASP.NET, PHP, SPA ou sistemas com roteamento próprio podem usar outro arquivo inicial. O alerta aparece quando a pasta web está vazia ou quando há um redirecionamento externo claro em um documento inicial detectado.

7. Módulos em detalhes

Dashboard

Resume a operação do servidor e destaca o que merece atenção antes de criar ou publicar sites.

  • Mostra os últimos 3 domínios ou subdomínios acessados neste navegador.
  • Se houver menos de 3 recentes, completa os cards com outros domínios cadastrados em ordem alfabética.
  • Cada card abre o domínio selecionado e mostra uma miniatura em proporção de tela de computador, carregada pelo preview interno do Dlesk.
  • O preview usa a rota segura /SitePreview para evitar bloqueios comuns de iframe; scripts podem rodar em sandbox isolado para aproximar a miniatura da aparência real sem acessar cookies do painel.
  • Também mostra recursos residuais ou fora da política detectados no Windows/IIS, permitindo associar bancos existentes ou remover itens com confirmação.

Domínios

Centraliza o ciclo de vida de um site: criar, editar, revisar serviços e remover quando necessário.

  • Use a tela de edição para conferir Web, FTP, e-mail, banco, SSL e DNS do domínio.
  • Se algo estiver parcial, abra o histórico da operação que criou ou editou o domínio.
  • Antes de remover domínio em produção, crie backup de arquivos e banco.

Bancos de dados

Cria bancos e usuários dedicados em SQL Server, MySQL ou PostgreSQL.

  • SQL Server normalmente usa .\SQLEXPRESS.
  • MySQL e PostgreSQL dependem dos CLIs mysql.exe e psql.exe.
  • Ao criar um banco fora do assistente de domínio, selecione o domínio para manter o vínculo visível nas listas, backups e tela do domínio.
  • Se um banco estiver associado ao domínio, o botão de remoção pede confirmação para desvincular e apagar. Essa confirmação evita exclusão acidental.
  • Se o banco não aparecer, revise Requisitos, Configurações, motor selecionado, filtro de domínio e o log da criação.

E-mail

Gerencia MailEnable: domínio postal, mailbox, senha, aliases e serviços relacionados.

  • SMTP autenticado normalmente usa porta 587 com STARTTLS.
  • IMAP normalmente usa porta 143 ou 993, conforme configuração do servidor.
  • Se a conta não aparecer, confira serviços MailEnable e permissões da pasta de configuração.

SSL/TLS

Ajuda a emitir e acompanhar certificados, geralmente via win-acme.

  • DNS do domínio precisa apontar para o servidor antes da emissão.
  • Porta 80 deve responder para validação HTTP.
  • Depois de emitir, confira binding HTTPS no IIS.

Backups

Gera pacotes ZIP por domínio para proteger arquivos, configurações locais do Dlesk e bancos suportados.

  • Arquivos: inclui a pasta raiz do domínio, normalmente com httpdocs e demais pastas internas.
  • Configurações: inclui metadados locais do Dlesk, como vínculo de domínio, FTP, e-mail, banco, DNS e hospedagem.
  • Bancos: inclui dumps quando o banco está associado ao domínio ou é detectado por nome compatível.
  • Destino: por padrão usa data\backups da instalação do painel, mas pode ser alterado na política de backup.
  • Agenda: permite definir horário e dias da semana para o serviço criar backups automaticamente.
  • Retenção: remove backups antigos por idade ou por quantidade máxima por domínio.
  • Restauração: pode sobrescrever arquivos e bancos existentes quando essa opção for confirmada.
  • Crie backup antes de atualizar aplicação, remover domínio ou trocar banco, e teste restauração em ambiente controlado quando possível.

Listas em tabela ou cards

Telas como FTP, E-mail, Bancos, SSL e Arquivos permitem alternar entre lista e cards.

  • Use lista quando precisar comparar muitas colunas e executar ações rápidas.
  • Use cards quando estiver em tela menor ou quiser ler os dados de cada item com mais calma.
  • Se a tela estiver filtrada por domínio, use o botão Domínio para voltar ao painel completo daquele domínio.

Serviços

Mostra o estado de serviços Windows importantes para hospedagem.

  • Use para confirmar se IIS, FTP, MailEnable e bancos estão rodando.
  • Reinicie serviços após alterações de configuração quando necessário.
  • Se um item aparecer como CLI instalado, significa que a ferramenta existe, mas talvez não haja serviço Windows gerenciável.

8. Diagnóstico e erros comuns

Use esta seção quando uma ação falhar ou quando o painel mostrar atenção.

Ver tarefas e logs
Regra de investigação

Sempre comece pelo log da operação. Depois confira Requisitos, Serviços, Configurações e só então tente repetir a ação. Repetir sem ler o erro costuma apenas criar mais registros iguais.

Sintoma Causa provável Como resolver
PostgreSQL falha no winget Pacote genérico ambíguo, ID removido ou winget sem acesso ao instalador. Atualize o painel, rode Requisitos novamente e confira se ele tenta PostgreSQL.PostgreSQL.17, .16 ou .15.
Banco não foi criado Servidor incorreto, CLI ausente, senha inválida ou serviço parado. Confira Configurações, Serviços e teste sqlcmd, mysql ou psql no servidor.
Banco criado sem aparecer no domínio Banco foi criado sem vínculo com o domínio ou com nome que não permite associação automática. Edite o banco ou recrie informando o domínio correto. O vínculo é importante para backup, revisão e navegação contextual.
FTP autentica mas não envia Permissão NTFS insuficiente na pasta do domínio. Abra Segurança, revise permissões do usuário FTP e confirme a pasta web correta.
SSL não emite DNS não aponta para o servidor, porta 80 bloqueada ou win-acme ausente. Confira DNS público, firewall, IIS, win-acme e log da emissão.
E-mail não aparece MailEnable ausente, serviço parado ou arquivo TAB sem permissão. Abra Serviços, confirme MailEnable em execução e revise logs da criação da caixa.
Site abre conteúdo antigo Arquivo publicado em pasta errada, cache ou binding IIS apontando para outro caminho. Confira httpdocs, recicle o site no IIS e limpe cache do navegador.
Atualização mostra versão não consultada Portal público sem release ou manifesto fora do ar. O painel usa o release-info.json local como fallback quando o pacote está configurado.
Registro.br recusa nameserver O DNS local ainda não responde como autoritativo para o domínio ou a porta 53 não está acessível externamente. Crie a zona no Dlesk/DNS, confira registros NS/A, libere DNS no firewall e valide de fora antes de salvar a alteração no Registro.br.

9. Atualizações do Dlesk

Entenda a tela que mostra versão instalada, versão disponível e pacote usado.

Abrir atualizações
Instalada

É a versão do painel que está rodando agora no serviço Windows Dlesk.

Disponível

É a versão do portal público ou do pacote local configurado para atualização.

Pacote local

Indica que o painel leu o ZIP e o release-info.json no disco, mesmo se o portal público estiver indisponível.

SHA256

É a impressão digital do ZIP. Se o arquivo mudar, o SHA também muda. Isso evita aplicar pacote errado ou corrompido.

Release pública

O portal dlesk.app.br deve responder em /api/releases/latest. Se retornar 404, a publicação da release ainda não chegou ao portal.

Pacote de download

A rotina de atualização gera o ZIP, o SHA256 e o release-info.json, copia para o portal e preserva a pasta data da instalação.

  1. Confira a versão instalada. Se ela for menor que a disponível, existe atualização pronta para aplicar.
  2. Confira a origem da versão disponível. Portal Dlesk vem da internet. Pacote local vem do ZIP já salvo no servidor.
  3. Use Aplicar atualização com cuidado. O serviço Dlesk será reiniciado. A pasta data deve ser preservada.
  4. Depois de atualizar, force o refresh do navegador. Use Ctrl + F5 quando a tela parecer antiga, principalmente após mudanças de CSS ou JavaScript.

10. Checklist antes de produção

11. Segurança e boas práticas

  • Use uma senha diferente para cada FTP, caixa de e-mail, banco e administrador.Essencial
  • Restrinja acesso ao painel por grupo Windows em Configurações.Recomendado
  • Não use usuário administrador global dentro de aplicações hospedadas.Boa prática
  • Crie usuários dedicados por banco e por domínio sempre que possível.Isolamento
  • Antes de remover domínio, backup ou banco, confira se existe backup recente.Atenção
  • Revise Tarefas e logs após cada provisionamento importante.Auditoria
  • Mantenha Windows, IIS, MailEnable, bancos e PHP atualizados.Rotina

12. Primeiro uso sem surpresa

Sequência recomendada para um servidor novo ou para um operador usando o Dlesk pela primeira vez.

Roteiro seguro
  1. Entre em Requisitos e prepare o servidor. Instale apenas os recursos que você realmente vai usar: IIS, FTP, MailEnable, SQL Server, MySQL, PostgreSQL, PHP, DNS e win-acme.
  2. Revise Configurações antes de criar domínios. Defina raiz dos sites, pasta web, banco padrão, e-mail ACME, política de backup, pacote de atualização e grupo Windows autorizado.
  3. Configure DNS local antes do Registro.br. Para domínios próprios, crie a zona local, confirme registros básicos e valide se os nameservers respondem. Só depois altere os DNS no registrador.
  4. Crie um domínio de teste com poucos serviços. Comece com Web e FTP. Depois adicione e-mail, banco e SSL. Isso facilita identificar exatamente qual etapa falhou se algo não estiver pronto.
  5. Use a tela do domínio como central. Dentro do domínio, navegue para Arquivos, E-mail, FTP, Bancos, DNS & Hospedagem, SSL, Backups e Logs. Volte sempre pelo botão Domínio quando estiver numa lista filtrada.
  6. Faça backup antes de mudanças destrutivas. Antes de apagar banco, remover domínio, trocar aplicação ou restaurar arquivos, gere um backup e confira onde ele foi salvo.
  7. Leia o resultado final das operações. Ações como criar banco, apagar, desvincular, restaurar ou atualizar mostram processamento e mensagem final. Se falhar, abra o log daquela operação.