SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor

Como instalar e proteger o Webmin no Ubuntu 24.04

Instale o Webmin no Ubuntu 24.04 e proteja a porta 10000 com túnel SSH ou lista de IPs, certificado Let's Encrypt, 2FA e Fail2ban.

O que você está a configurar

O Webmin é um painel de controlo web que disponibiliza uma interface de navegador para todo o servidor Linux: utilizadores, pacotes, tarefas cron, a firewall, Apache, BIND, discos e centenas de outros módulos. Fica acessível por HTTPS na porta 10000. A instalação consiste em três comandos e demora cerca de um minuto. Este guia dedica a maior parte do texto à segunda metade porque o Webmin é executado como root e pode fazer tudo o que root pode fazer. Um Webmin exposto sem restrições ou sem autenticação não é apenas "um risco a gerir"; representa o comprometimento completo do servidor, com uma página de início de sessão à sua frente. Por isso, instale-o em dez minutos e dedique o resto da hora a garantir que só você consegue aceder-lhe.

Pré-requisitos e um aviso importante

Um VPS KVM Ubuntu 24.04 novo, com root ou um utilizador sudo. O Webmin é baseado em Perl e é leve. Escuta na porta TCP 10000 através do seu próprio servidor Web integrado (miniserv.pl), e não do Apache ou nginx. Por isso, não é necessário instalar mais nada primeiro.

Há duas decisões a tomar antes de começar. Primeiro, a conta usada para iniciar sessão: o Webmin autentica através do PAM usando as contas Unix. Por isso, deve iniciar sessão como root ou como um utilizador do grupo sudo, usando a palavra-passe Unix dessa conta. As imagens cloud normalmente permitem apenas autenticação por chave e não têm uma palavra-passe definida para o utilizador predefinido. O Webmin não consegue iniciar sessão numa conta sem palavra-passe. Defina primeiro uma palavra-passe com sudo passwd youruser. Caso contrário, o início de sessão falhará, independentemente do que escrever.

Segundo, e este é o aviso: não abra simplesmente a porta 10000 para a Internet e deixe o serviço sem supervisão. Decida agora se vai aceder ao Webmin através de um túnel SSH (recomendado, sem expor a porta) ou se vai restringir o acesso ao seu próprio IP. Essa decisão única determina todos os passos seguintes. Leia as duas opções antes de alterar a firewall.

Instalar o Webmin a partir do repositório oficial

O Webmin disponibiliza um repositório apt assinado. O script de configuração adiciona o repositório e a respetiva chave de assinatura GPG, para que futuras execuções de apt upgrade instalem o Webmin como qualquer outro pacote. Assim, recebe atualizações autenticadas em vez de um .deb transferido que nunca é atualizado.

curl -o webmin-setup-repo.sh https://raw.githubusercontent.com/webmin/webmin/master/webmin-setup-repo.sh
sudo sh webmin-setup-repo.sh

O script apresenta as ações que vai executar e pede Setup Webmin stable repository? (y/N). Responda y. Quando terminar, instale o pacote. A opção --install-recommends instala as dependências comuns dos módulos Perl e SSL, para que os módulos individuais não falhem mais tarde devido a bibliotecas em falta.

sudo apt-get install --install-recommends webmin

O Webmin já mudou o nome deste script, e guias antigos referem setup-repos.sh. Se o URL direto devolver 404, obtenha o comando atual diretamente de webmin.com/download, em vez de fixar um nome. Depois da instalação, o Webmin fica disponível em https://YOUR_SERVER_IP:10000/. Inicie sessão com a palavra-passe Unix do seu utilizador sudo. O Ubuntu desativa por predefinição o início de sessão do root com palavra-passe. Por isso, iniciar sessão como root exige uma palavra-passe root utilizável. A instalação do Webmin não cria essa palavra-passe. O serviço fica ativado e em execução, a configuração fica em /etc/webmin, os pedidos são registados em /var/webmin/miniserv.log e os inícios de sessão falhados vão para o syslog ou, no Ubuntu 24.04, para o journal do systemd.

Confirme que o serviço está efetivamente ativo e a escutar antes de abrir um navegador:

sudo systemctl status webmin --no-pager
sudo ss -tlnp | grep 10000

Deve obter um estado active (running) e uma linha que mostre miniserv.pl associado a 0.0.0.0:10000. Esse endereço muda para 127.0.0.1:10000 quando utilizar o túnel descrito abaixo. Se ss não mostrar nada na porta 10000, o Webmin não iniciou. Consulte journalctl -u webmin -n 50 antes de continuar.

Primeiro login e o aviso do certificado

Aponte o navegador para https://YOUR_SERVER_IP:10000. Numa instalação nova, acontecem duas coisas.

Se o ufw estiver ativo, a página não carregará. A imagem de servidor do Ubuntu inclui-o desativado, mas muitos fornecedores ativam-no previamente. Este caso é abordado abaixo, na secção sobre modos de falha. Se a porta estiver aberta, o navegador apresenta um bloqueio de página inteira: "A sua ligação não é privada", com o código NET::ERR_CERT_AUTHORITY_INVALID no Chrome, ou SEC_ERROR_UNKNOWN_ISSUER / "Aviso: possível risco de segurança" no Firefox. Isto é esperado e não indica uma intrusão. O Webmin gerou um certificado autoassinado durante a instalação (/etc/webmin/miniserv.pem). Como nenhuma autoridade de certificação o valida, o navegador recusa-se a confiar nele automaticamente. A ligação continua encriptada; simplesmente não é validada por uma autoridade. Clique em Advanced e depois em Proceed por agora. O certificado será substituído corretamente mais abaixo.

Inicie sessão com o seu utilizador sudo e a respetiva palavra-passe Unix, ou com root se este tiver uma palavra-passe Unix utilizável. Será encaminhado para o painel System Information. Um erro comum é introduzir http:// em vez de https://. O miniserv responde com HTTP simples nessa porta e apresenta exatamente o texto "This web server is running in SSL mode. Try the URL https://...". Para corrigir, basta alterar http para https na barra de endereços.

A decisão de segurança: como vai aceder ao Webmin?

Agora vem a parte importante. Um painel com privilégios equivalentes aos de root não deve ficar exposto à Internet pública, a responder a tentativas de início de sessão de todos os scanners existentes. Existem duas opções defensáveis, por ordem de preferência. Todas as interfaces de administração auto-hospedadas acabam por colocar esta mesma questão. É por isso que a segurança do Vaultwarden depende do seu endpoint de administração e do ficheiro de backup, e não da sua encriptação.

O túnel SSH da Opção B é a melhor opção, porque não expõe absolutamente nada. A lista de permissões de IP da Opção A é aceitável se o seu endereço for estático. Não fazer nenhuma das duas coisas é exatamente o erro que este guia pretende evitar. Se preferir aceder ao Webmin através de uma rede privada, em vez de usar qualquer uma destas opções, coloque o servidor atrás de uma VPN WireGuard auto-hospedada e faça o Webmin escutar no endereço do túnel, em vez do endereço público.

Opção A: restringir o Webmin ao seu IP

No painel, abra Webmin, depois Webmin Configuration e depois IP Access Control. Selecione "Only allow from listed addresses" e introduza o seu IP público, que pode obter executando curl ifconfig.me no seu portátil. Guarde as alterações. O Webmin escreve este valor na linha allow= de /etc/webmin/miniserv.conf e reinicia-se.

O problema é o seguinte: se o IP da sua rede doméstica for dinâmico e mudar, ou se introduzir o endereço incorretamente, ficará sem acesso. O navegador apresenta então "Access denied for <your IP>", sem formulário de início de sessão, e não existe um caminho de acesso pela interface web. Corrija a configuração a partir da consola do servidor, através de SSH ou do VNC do seu fornecedor:

sudo nano /etc/webmin/miniserv.conf
# find the line that begins  allow=
# correct your IP, or delete the whole line to allow all again
sudo systemctl restart webmin

Eliminar a linha allow= restaura o acesso totalmente aberto. Faça isto apenas para recuperar o acesso e, em seguida, defina imediatamente um valor correto.

Opção B: associar a localhost e criar um túnel através de SSH (recomendado)

Melhor do que qualquer lista de permissões é não escutar na interface pública. Configure o miniserv para associar-se apenas ao loopback e aceda a ele através de um túnel SSH encriptado em que já confia.

Edite /etc/webmin/miniserv.conf e adicione ou altere uma linha:

bind=127.0.0.1

Reinicie com sudo systemctl restart webmin. O Webmin deixa de estar acessível pela Internet, uma verificação das portas 10000 não encontra nada e a verificação ss apresentada anteriormente mostra agora que está associado a 127.0.0.1:10000. No seu portátil, abra um túnel:

ssh -L 10000:localhost:10000 youruser@YOUR_SERVER_IP

Mantenha essa sessão aberta e aceda a https://localhost:10000. O tráfego passa dentro do SSH, que já é autenticado pela sua chave e encriptado. Por isso, pode aceitar com segurança o certificado autoassinado neste caso; a camada SSH fornece a proteção efetiva. Feche a sessão SSH e o Webmin deixa de estar acessível. Não há nada para incluir numa lista de permissões, nada exposto e nenhum serviço adicional para proteger.

Se definir bind=127.0.0.1 e se esquecer do túnel, o acesso remoto simplesmente deixa de funcionar. Essa é a funcionalidade a operar, não uma falha. Recupere da mesma forma que na Opção A: a partir da consola, remova a linha bind ou defina bind=0.0.0.0 e reinicie. Este é o mesmo procedimento de tunelização usado para aceder a um ambiente de desenvolvimento remoto com Claude Code em tmux: uma sessão SSH, tudo privado e nada adicional a escutar na interface pública.

Substituir o certificado autoassinado por um certificado válido

Se expuser o Webmin através da Opção A, elimine o aviso do navegador com um certificado Let's Encrypt válido. Precisa de um nome para o certificado e de um método de validação suportado: HTTP-01 requer que a porta 80 esteja acessível, enquanto a validação DNS para nomes de host não requer uma porta acessível. Normalmente, o nome é um nome DNS, por exemplo panel.example.com, com um registo A a apontar para o servidor. Desde o Webmin 2.650 (lançado no final de junho de 2026), também pode ser o endereço IP público do servidor, desde que o Certbot 5.3 ou posterior esteja instalado. A Let's Encrypt emite certificados para IP apenas no seu perfil de curta duração, válido durante cerca de seis dias. Por isso, defina o intervalo de renovação automática do Webmin para cinco dias ou menos; o Webmin rejeita intervalos maiores para um certificado de IP.

O Webmin já inclui esta funcionalidade: Webmin, depois Webmin Configuration, depois SSL Encryption e depois o separador Let's Encrypt. Introduza o nome de host ou o endereço IP, escolha um método de validação e faça o pedido. O Webmin obtém o certificado, atualiza as linhas certfile= e keyfile= em miniserv.conf e renova-o automaticamente antes de expirar. Recarregue a página e o aviso do certificado desaparece.

A única limitação importante é que o servidor do próprio Webmin usa a porta 10000, não a 80. Por isso, algo tem de responder ao desafio http-01 na porta 80. Existem três formas de validar o certificado. Se o Apache ou o nginx já servir o nome na porta 80, indique o diretório de documentos desse site como destino da validação (para um endereço IP, isto requer o Certbot 5.4 ou posterior). Se não existir nada na porta 80, escolha o servidor Web integrado do Certbot, o modo standalone que o Webmin adicionou na versão 2.110: o Certbot executa temporariamente o seu próprio servidor Web na porta 80. Nesse caso, o Certbot tem de estar instalado e a porta 80 tem de estar livre e aberta na firewall. Também pode usar a validação DNS do Webmin para nomes de host cuja zona DNS seja gerida pelo Webmin através do BIND ou do Virtualmin. Este método não requer a abertura da porta 80 e não funciona para endereços IP. O pacote certbot do Ubuntu 24.04 é a versão 2.9, suficiente para a validação standalone de um nome de host, mas demasiado antigo para certificados de IP. Para estes certificados, instale um Certbot atual, como o snap, que está na versão 5.9 em 1 de novembro de 2026. Sem uma destas opções, o pedido falha com um erro de validação. O processo, os registos DNS, o desafio na porta 80 e a renovação são iguais aos de uma emissão de certificado para qualquer site. Para consultar os detalhes, o guia de certificados TLS Let's Encrypt com Certbot e nginx explica o fluxo de validação e a configuração DNS. Se escolheu a opção do túnel SSH, pode ignorar esta secção: o certificado autoassinado é suficiente atrás do SSH e um certificado válido emitido para panel.example.com continuaria a gerar um aviso de incompatibilidade de nome ao visitar https://localhost:10000.

Ative a autenticação de dois fatores

Uma senha sozinha oferece pouca proteção para um painel root, portanto, adicione um segundo fator. Abra Webmin, depois Webmin Configuration, depois Two-Factor Authentication. Selecione o provedor TOTP Authenticator (as versões do Webmin anteriores à 2.300 e a documentação antiga o chamam de Google Authenticator). Esse provedor usa TOTP padrão e funciona com Authy, 1Password ou qualquer aplicativo autenticador. Salve a configuração. As versões atuais do Webmin incluem o código Perl necessário para TOTP e para gerar o código QR, portanto, não é necessário instalar nada adicional. Salvar a configuração ativa o recurso, mas essa etapa sozinha ainda não protege nenhuma conta.

Cada conta precisa cadastrar seu próprio dispositivo. Com o 2FA ativado, abra Webmin, depois Webmin Users, selecione a conta, escolha Enable Two-Factor For User, e o Webmin exibirá um código QR. Escaneie o código com o aplicativo e informe um código gerado para confirmar. A partir desse momento, o login solicitará o token de seis dígitos depois da senha. Faça o cadastro antes de sair. Se o 2FA for obrigatório, mas sua conta ainda não tiver escaneado um código, você poderá remover a exigência pelo console, mas é muito mais simples fazer o cadastro primeiro.

Adicionar o Fail2ban para bloquear tentativas de login por força bruta

Mesmo um endpoint de login restrito deve penalizar falhas repetidas. Com o registo no syslog ativado, o Webmin regista os logins falhados no formato webmin[12345]: Invalid login as root from 10.0.0.9, ou Non-existent login as ... para um login não reconhecido; no Ubuntu 24.04, consulte estes registos no journal do systemd. O Fail2ban inclui um filtro webmin-auth predefinido que corresponde exatamente a estas duas linhas, e a jail abaixo define o backend = systemd por si própria. Por isso, não precisa de uma expressão regular personalizada nem de um caminho de log.

Crie /etc/fail2ban/jail.d/webmin.local:

[webmin-auth]
enabled  = true
port     = 10000
filter   = webmin-auth
backend  = systemd
maxretry = 4
bantime  = 1h

Recarregue com sudo systemctl restart fail2ban e confirme que a jail está ativa:

sudo fail2ban-client status webmin-auth

Deve ver a jail na lista com um contador de bloqueios inicial igual a zero (no backend do journal, não existe uma linha File list:). Para validar todo o funcionamento, provoque algumas falhas de login a partir de outra rede e execute novamente o comando de estado para observar o contador Currently banned aumentar. Se isso nunca acontecer, confirme que não está a testar a partir de um endereço incluído na ignoreip do Fail2ban e execute journalctl SYSLOG_IDENTIFIER=webmin no servidor para confirmar que as linhas Invalid login estão realmente a ser escritas. Se o Fail2ban ainda não estiver instalado neste servidor, o guia do Fail2ban no Ubuntu 24.04 para SSH explica a instalação e a jail SSH que deve executar juntamente com esta.

Restrinja o que cada utilizador do Webmin pode gerir

Nem todas as pessoas que precisam do painel precisam de acesso root a tudo. Em Webmin, depois Webmin Users, crie logins adicionais do Webmin e conceda a cada um apenas os módulos necessários; por exemplo, um operador de cópias de segurança que veja apenas os módulos cron e sistema de ficheiros. Ao editar um utilizador, é apresentada uma lista de verificação com todos os módulos. Desmarcar um módulo remove-o do menu desse utilizador e bloqueia os URLs correspondentes. As permissões dos módulos também precisam de restrições dentro de cada módulo concedido: o acesso a tarefas cron ou a ficheiros arbitrários ainda pode dar a um utilizador controlo root, mesmo sem o módulo Users.

Mantenha o Webmin atualizado

Como você instalou o Webmin pelo repositório apt, sudo apt update && sudo apt upgrade baixa as novas versões do Webmin junto com o restante do sistema. Instale as atualizações rapidamente. Painéis de controle são alvos frequentes. O Webmin também pode ser atualizado em Webmin, depois Webmin Configuration, depois Upgrade Webmin, mas o caminho pelo apt é mais simples no Ubuntu porque mantém as versões consistentes com o restante do gerenciamento de pacotes. Não trate isso como opcional: várias CVEs anteriores do Webmin eram vulnerabilidades de execução remota de código, e a única diferença entre estar "atualizado" e estar "comprometido" era a rapidez com que o administrador executava a atualização. Até as proteções de login são corrigidas dessa forma: o Webmin 2.640 (maio de 2026) corrigiu uma forma de contornar a autenticação de dois fatores em solicitações RPC. Portanto, um servidor sem correções e com 2FA ativado está menos protegido do que parece.

Modos de falha e as mensagens apresentadas

"Your connection is not private" / NET::ERR_CERT_AUTHORITY_INVALID. É apresentada no primeiro acesso. Causa: o certificado autoassinado que o Webmin gerou durante a instalação não tem uma autoridade emissora confiável. Não é um ataque; o canal está encriptado, mas o certificado não é validado por uma autoridade confiável. Solução: prossiga através do aviso por agora. Depois, emita um certificado Let's Encrypt válido ou aceite-o permanentemente se aceder ao Webmin através de um túnel SSH.

"This web server is running in SSL mode. Try the URL https://..." Introduziu http://server:10000. O miniserv só disponibiliza TLS nessa porta e está a indicar isso em texto simples. Solução: altere http para https na barra de endereços.

A página excede o tempo limite, ERR_CONNECTION_TIMED_OUT / "This site can't be reached". O pedido nunca chega ao Webmin. No Ubuntu, é frequente o ufw descartar a porta 10000, mas confirme antes de assumir essa causa. Execute sudo ufw status. Se indicar Status: inactive, o ufw não está a bloquear nada (o Ubuntu é distribuído com o ufw desativado, e adicionar uma regra allow não o ativa). Nesse caso, procure mais acima na cadeia, por exemplo, numa firewall do painel de controlo do fornecedor. Se indicar Status: active, execute sudo ufw status verbose para consultar a política predefinida de tráfego de entrada e quaisquer regras abrangentes. Se o tráfego de entrada for negado e a porta 10000 não estiver listada, abra-a com sudo ufw allow 10000/tcp ou, preferencialmente, mantenha-a fechada e use o túnel SSH da Opção B. Tenha em atenção a distinção: um timeout significa que uma firewall está a descartar pacotes silenciosamente, enquanto ERR_CONNECTION_REFUSED significa que a porta está acessível, mas o Webmin não está em execução. Verifique sudo systemctl status webmin.

"Access denied for <your IP>." Configurou o controlo de acesso por IP na Opção A, mas o endereço atual não está na lista de permissões. Também pode tratar-se de um IP dinâmico que mudou ou de um erro de introdução. Não existe um caminho de recuperação pelo navegador. Corrija o problema na consola: edite a linha allow= em /etc/webmin/miniserv.conf, corrija-a ou elimine-a e execute sudo systemctl restart webmin.

"Login failed. Please try again." com credenciais que sabe estarem corretas. A conta não tem uma palavra-passe Unix. Isto é normal em imagens cloud que usam apenas chaves. O Webmin autentica através do PAM contra a palavra-passe Unix, mas essa palavra-passe não existe para o utilizador. Solução: execute sudo passwd youruser no servidor e inicie sessão. Consulte journalctl SYSLOG_IDENTIFIER=webmin para ver mensagens de início de sessão falhado. Non-existent login as ... significa que o Webmin não reconheceu a conta usada no início de sessão.

Para mais do que alguns servidores, a automatização escala melhor do que instalar um painel de controlo em cada servidor: o seu primeiro playbook Ansible é o ponto de partida.

FAQ

É seguro expor o Webmin na Internet pública?

Trate um Webmin exposto à Internet como um shell root com uma página de login, porque é exatamente isso que ele é. Só é seguro o suficiente quando protegido por várias camadas: um certificado válido, autenticação de dois fatores, Fail2ban e uma lista de permissões de IP restritiva ou, melhor ainda, nenhuma exposição pública. A configuração com menor risco associa o Webmin a 127.0.0.1 e permite o acesso por um túnel SSH, para que a porta 10000 não responda a ninguém na Internet pública.

Como removo o aviso de certificado do Webmin?

O aviso (NET::ERR_CERT_AUTHORITY_INVALID) aparece porque o Webmin inclui um certificado autoassinado. Emita um certificado válido no Webmin, Webmin Configuration, SSL Encryption, Let's Encrypt. Use um nome DNS que aponte para o servidor ou o endereço IP público do servidor se o Certbot 5.3 ou posterior estiver instalado. Para HTTP-01, a porta 80 tem de estar acessível e ser atendida por um servidor Web existente ou pelo servidor standalone do próprio Certbot. Os certificados para nomes de host também podem usar validação DNS sem abrir a porta 80; o método DNS incorporado do Webmin requer uma zona gerida através do BIND ou do Virtualmin. Se só aceder ao Webmin através de um túnel SSH para localhost, o aviso não representa um risco: o SSH já cifra e autentica a ligação, e pode aceitar o certificado autoassinado com segurança.

Como restrinjo o Webmin apenas ao meu endereço IP?

Aceda a Webmin, Webmin Configuration, IP Access Control, selecione "Only allow from listed addresses" e introduza o seu IP público a partir de curl ifconfig.me. O Webmin armazena esta configuração na linha allow= de /etc/webmin/miniserv.conf. Tenha atenção aos endereços IP domésticos dinâmicos: se o endereço mudar, ficará sem acesso e terá de corrigir a linha allow= a partir da consola do servidor. Na prática, um endereço estático ou o método do túnel SSH é mais fiável.

Por que motivo o login falha mesmo com a palavra-passe correta?

O Webmin autentica através do PAM usando a sua palavra-passe Unix. As imagens cloud normalmente permitem apenas autenticação por chave e não têm uma palavra-passe definida na conta predefinida. Por isso, não existe uma palavra-passe para o PAM validar e o login é rejeitado. Execute sudo passwd youruser no servidor para definir uma palavra-passe e, em seguida, inicie sessão. Uma linha Non-existent login as ... em journalctl SYSLOG_IDENTIFIER=webmin significa que o Webmin não reconheceu a conta usada no login.

Para que serve o Webmin em comparação com o SSH simples?

O Webmin é uma camada de descoberta e conveniência. É útil para consultar ficheiros de log, gerir utilizadores e cron, editar regras de firewall e verificar o estado dos discos e dos serviços sem memorizar todos os comandos. Isso é conveniente para administradores ocasionais ou equipas com diferentes níveis de experiência. O SSH simples é mais rápido, permite criar scripts e expõe uma superfície de ataque muito menor nas tarefas habituais. Muitos administradores usam ambos: SSH no trabalho diário e Webmin associado a localhost atrás de um túnel para tarefas ocasionais feitas com a interface. Se a sua dúvida real for qual painel escolher, em vez de painel contra shell, vale a pena comparar primeiro Cockpit e Webmin, porque os dois diferem na quantidade de componentes do sistema que podem alterar e na forma como autenticam o utilizador.

Este artigo foi útil?