Como instalar o Webmin no Ubuntu e Debian | Central de Ajuda da HypeHost

O Webmin é um dos painéis de controle open-source mais populares para administração de sistemas Linux. Com ele, você gerencia usuários, serviços do sistema (Apache, Nginx, MariaDB, SSH), discos, tarefas cron e regras de firewall diretamente pelo navegador, sem precisar depender exclusivamente da linha de comando.

Este guia ensina a instalar o Webmin em instâncias Ubuntu (20.04, 22.04, 24.04 ou superior) e Debian (11, 12 ou superior) utilizando o repositório oficial.

Requisitos

Um servidor VPS ou Bare Metal com Ubuntu ou Debian instalado;
Acesso de root ou usuário com privilégios sudo via terminal SSH;
Porta 10000/TCP liberada para acesso ao painel.

Passo 1: Atualizar o Sistema Operacional

Conecte-se ao terminal da sua máquina e atualize a lista de pacotes do sistema:

sudo apt update && sudo apt upgrade -y

Instale também utilitários básicos necessários para baixar scripts e gerenciar certificados:

sudo apt install curl wget apt-transport-https gpg -y

Passo 2: Configurar o Repositório Oficial do Webmin

A forma recomendada e suportada pelos desenvolvedores do Webmin é utilizar o script oficial de automação de repositório, que configura as chaves GPG e garante que seu Webmin receba atualizações automáticas via apt update:

Baixe o script de configuração oficial:

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

Execute o instalador do repositório:
```
sudo sh setup-repos.sh
```
O terminal solicitará confirmação (y/N). Digite y e pressione Enter para concluir a configuração das chaves e do repositório.

Passo 3: Instalar o Webmin

Com o repositório configurado, basta instalar o pacote com suas dependências recomendadas:

sudo apt install webmin --install-recommends -y

Ao final da instalação, certifique-se de que o serviço está ativo e configurado para iniciar automaticamente junto com o sistema operacional:

sudo systemctl enable --now webmin sudo systemctl status webmin

(Você deverá ver o status marcado como active (running)).

Passo 4: Liberar a Porta no Firewall (UFW)

O Webmin escuta por padrão na porta 10000/TCP. Se você estiver utilizando o firewall ufw ativo no servidor, libere a porta:

sudo ufw allow 10000/tcp sudo ufw reload

Passo 5: Como Acessar o Webmin pelo Navegador

Abra o seu navegador web e digite o endereço IP do seu servidor seguido da porta 10000 utilizando HTTPS:

https://IP_DO_SEU_SERVIDOR:10000

Aviso de Certificado SSL no Navegador:

Por padrão, o Webmin gera um certificado SSL autoassinado. Ao abrir a página pela primeira vez, navegadores como Chrome, Firefox ou Edge exibirão um alerta como "Sua conexão não é particular" ou "Risco de segurança à frente".

Isso é normal. Clique em Avançado (ou Advanced) e selecione Continuar para o site (inseguro) para abrir a tela de login.

Passo 6: Como Fazer Login

Na tela inicial do Webmin:

Usuário: root
Senha: A senha do seu VPS

Caso você acesse sua máquina exclusivamente por chave SSH e não tenha uma senha definida para o root, você pode definir uma senha para o Webmin diretamente pelo terminal executando:

sudo /usr/share/webmin/changepass.pl /etc/webmin root SUA_SENHA_AQUI

Comandos Úteis

Reiniciar o Webmin:
sudo systemctl restart webmin
Desligar o Webmin:
sudo systemctl stop webmin
Iniciar o Webmin:
sudo systemctl start webmin
Atualizar o Webmin no futuro:
Como configuramos o repositório oficial, o painel será atualizado junto com o restante dos pacotes da sua máquina executando apenas sudo apt update && sudo apt upgrade webmin -y.