Instalação ISPConfig · 10 min read · Nov 07, 2025

Instalação Automatizada do ISPConfig 3 no Servidor Perfeito no Debian 11 e Debian 12, Ubuntu 22.04 e Ubuntu 24.04

Este tutorial ajudará a instalar sua configuração de servidor único ISPConfig 3 usando o instalador automático do ISPConfig. Este instalador segue os antigos guias do Servidor Perfeito, mas é mais modular e fácil de seguir. Se você deseja configurar uma configuração multiserver com servidores dedicados para cada serviço, consulte o guia de Multiserver Perfeito.

Este guia funciona para Debian 11 e 12, Ubuntu 22.04 e Ubuntu 24.04. Ele atualmente suporta as arquiteturas de CPU x86_64 (também conhecido como AMD64) e ARM (ARM64). Usaremos o nome do host server1.example.com. Substitua onde necessário. O guia requer um sistema operacional base recém-instalado e vazio; não tente usá-lo em um sistema onde você já configurou outros serviços.

Pré-requisitos

  • Sistema Operacional: Debian 11 e Debian 12, Ubuntu 22.04 ou Ubuntu 24.04.
  • Arquitetura de CPU Intel ou AMD de 64 bits (x86_64, também conhecido como AMD64) ou arquitetura de CPU ARM (ARM64).
  • O sistema deve ter acesso à internet para baixar e instalar software com apt.
  • Comece a partir de uma instalação limpa e vazia do sistema operacional base. O sistema deve ser totalmente acessível pela internet; não bloqueie o acesso com um firewall, especialmente a porta 80 para emissão de certificados LE e a porta 8080 para acesso ao ISPConfig, além das portas para todos os serviços que você usa nesse sistema. O servidor também deve ter acesso à internet para baixar e instalar software durante a instalação e resolver nomes de domínio via DNS.

1. Faça login no servidor

Faça login como root ou execute

su --login

no Debian para se tornar o usuário root em seu servidor antes de prosseguir. IMPORTANTE: Você deve usar ‘su –login’ ou ‘su -‘ e não apenas ‘su’. Caso contrário, o Debian definirá sua variável PATH incorretamente.

No Ubuntu, use o comando:

sudo -s

para se tornar o usuário root.

2. Configure o nome do host e os hosts

O nome do host do seu servidor deve ser um subdomínio como “server1.example.com”. Não use um nome de domínio sem uma parte de subdomínio como “example.com” como nome do host, pois isso causará problemas mais tarde com sua configuração. Primeiro, você deve verificar o nome do host em /etc/hosts e alterá-lo quando necessário. A linha deve ser: “Endereço IP - espaço - nome do host completo incl. domínio - espaço - parte do subdomínio”. Para nosso nome do host server1.example.com, o arquivo deve parecer com isso (algumas linhas podem ser diferentes; pode variar por provedor de hospedagem):

nano /etc/hosts
127.0.0.1 localhost.localdomain   localhost  
# Esta linha deve ser alterada para o nome do servidor correto:  
127.0.1.1 server1.example.com server1  

# As seguintes linhas são desejáveis para hosts compatíveis com IPv6
::1     localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

Em seguida, edite o arquivo /etc/hostname:

nano /etc/hostname

Deve conter apenas a parte do subdomínio, no nosso caso:

server1

Finalmente, reinicie o servidor para aplicar a alteração:

systemctl reboot

Faça login novamente e verifique se o nome do host está correto agora com estes comandos:

hostname  
hostname -f

A saída deve ser assim:

root@server1:~$ hostname  
server1  
root@server1:~$ hostname -f  
server1.example.com

Você também precisará configurar um registro DNS com seu provedor de DNS que aponte para seu servidor. Deve haver um registro A (e/ou AAAA) para o subdomínio que aponte para seu IP público.

3. Atualize o sistema

Para atualizar os pacotes do sistema, execute o comando:

apt update && apt upgrade

4. Execute o autoinstalador

Agora podemos executar o instalador automático. A configuração básica contém os seguintes pacotes de software (mais suas dependências, é claro): Apache2, PHP (versões 5.6 - 8.3), MariaDB, Postfix, Dovecot, Rspamd, BIND, Jailkit, Roundcube, PHPMyAdmin, Mailman, Webalizer, AWStats e GoAccess. Você pode facilmente optar por não usar certas funções ou instalar serviços extras passando argumentos para o instalador. Consulte o Capítulo 6 para opções de linha de comando disponíveis.

Instalar ISPConfig com servidor web Apache

Agora você pode executar o script com argumentos. Por exemplo, se você quiser uma instalação normal com servidor web Apache e um intervalo de portas para FTP Passivo + atualizações não supervisionadas, execute:

wget -O - https://get.ispconfig.org | sh -s -- `--use-ftp-ports=40110-40210` --unattended-upgrades

Os seguintes passos são descritos no capítulo “Executando o instalador automático”.

Instalar ISPConfig com servidor web Nginx

Agora você pode executar o script com argumentos. Por exemplo, se você quiser uma instalação normal com servidor web Nginx e um intervalo de portas para FTP Passivo + atualizações não supervisionadas, execute:

wget -O - https://get.ispconfig.org | sh -s -- --use-nginx `--use-ftp-ports=40110-40210` --unattended-upgrades

Executando o autoinstalador

Após algum tempo, você verá:

WARNING! Este script reconfigurará seu servidor completo!  
Deve ser executado em um servidor recém-instalado e toda a configuração atual que você fez provavelmente será perdida!  
Digite 'sim' se você realmente deseja continuar:

Responda “sim” e pressione enter. O instalador agora começará.

Quando o instalador terminar, ele mostrará a senha do administrador do ISPConfig e a senha root do MySQL assim:

[INFO] Sua senha de administrador do ISPConfig é: 5GvfSSSYsdfdYC  
[INFO] Sua senha root do MySQL é: kkAkft82d!kafMwqxdtYs

Certifique-se de anotar essas informações, pois você precisará delas mais tarde.

5. Configurando o firewall

A última coisa a fazer é configurar nosso firewall.

Faça login na interface do ISPConfig e vá para Sistema -> Firewall. Em seguida, clique em “Adicionar novo registro de firewall”.

Para uma configuração normal, ficaria assim:

TCP:

20,21,22,25,80,443,40110:40210,110,143,465,587,993,995,53,8080,8081

UDP:

53

As portas necessárias para cada serviço são:

Web: 20, 21, 22, 80, 443 e 40110:40210 (Todas TCP, sem UDP)

Email: 25, 110, 143, 465, 587, 993 e 995 (Todas TCP, sem UDP)

DNS: 53 (TCP e UDP)

Painel: 8080 e 8081 (Todas TCP, sem UDP)

Seu servidor agora está configurado e pronto para uso. Você pode fazer login em https://server1.example.com:8080

6. Opções Avançadas

O autoinstalador possui várias opções de linha de comando para ajustar a configuração.

Você pode visualizar todos os argumentos com:

wget -O - https://get.ispconfig.org | sh -s -- --help

Você pode, por exemplo, escolher entre servidor web Apache e Nginx e quais serviços devem ser instalados no sistema. Os argumentos de linha de comando são:

Uso: ispc3-ai.sh [] [...]  

Este script instala automaticamente todos os pacotes necessários para uma configuração do ISPConfig 3 usando as diretrizes dos "Perfect Server Setup" howtos em www.howtoforge.com.

Os argumentos possíveis são:  
    --help          Mostra esta página de ajuda.  
    --debug         Habilita o registro detalhado (registra cada comando com o código de saída).  
    --channel       Escolha o canal a ser usado para ISPConfig: --channel=  
                    "stable" é a versão mais recente do ISPConfig disponível em www.ispconfig.org  
                    "dev" é o último branch de desenvolvimento do repositório git do ISPConfig: https://git.ispconfig.org/ispconfig/ispconfig3/tree/develop  
                    O canal dev pode conter bugs e recursos menos testados e deve ser usado em produção apenas por usuários muito experientes.  
    --lang          Use o idioma para a instalação do ISPConfig. Especifique com --lang=en|de (apenas en (Inglês) e de (Alemão) suportados atualmente).  
    --interactive   Não instale o ISPConfig em modo não interativo.  
                    Isso é necessário se você quiser usar o modo especialista, por exemplo, para instalar um servidor escravo que deve ser integrado a uma configuração multiserver existente.  
    --use-nginx     Use o servidor web nginx em vez do apache2.  
    --use-amavis    Use amavis em vez de rspamd para filtragem de email.  
    --use-unbound   Use unbound em vez de bind9 para resolução local. Permitido apenas se --no-dns estiver definido.  
    --use-php       Use versões específicas do PHP, separadas por vírgula, em vez de instalar múltiplos PHP, por exemplo, --use-php=7.4,8.0 (5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2 e 8.3 disponíveis).  
                    --use-php=system desabilita o repositório sury e apenas instala a versão padrão do PHP do sistema.  
                    --use-php omitindo o argumento, usa todas as versões.  
    --use-ftp-ports Esta opção define o intervalo de portas passivas para pure-ftpd. Você deve especificar o intervalo de portas separado por hífen, por exemplo, --use-ftp-ports=40110-40210.  
                    Se não fornecido, o intervalo de portas passivas não será configurado.  
    --use-certbot   Use Certbot em vez de acme.sh para emissão de certificados Let's Encrypt. Não é aconselhável, a menos que você esteja migrando de um servidor antigo que usa Certbot.  
    --no-web        Não use o ISPConfig neste servidor para gerenciar configurações do servidor web e não instale nginx/apache ou pureftpd.  
                    Isso também impedirá a instalação de uma interface do ISPConfig e implica --no-roundcube, bem como --no-pma.  
    --no-mail       Não use o ISPConfig neste servidor para gerenciar configurações do servidor de email.  
                    Isso instalará o postfix para enviar emails do sistema, mas não o dovecot e não configurará nenhuma configuração para o email do ISPConfig. Implica --no-mailman.  
    --no-dns        Não use o ISPConfig neste servidor para gerenciar entradas DNS. O Bind será instalado apenas para cache/resolução DNS local.  
    --no-local-dns  Não instale cache/resolução DNS local via bind.  
    --no-firewall   Não instale ufw e diga ao ISPConfig para não gerenciar configurações de firewall neste servidor.  
    --no-roundcube  Não instale o roundcube webmail.  
    --roundcube     Instale o Roundcube mesmo quando --no-mail for usado. Configuração manual do config do Roundcube é necessária.  
    --no-pma        Não instale o PHPMyAdmin neste servidor.  
    --no-mailman    Não instale o gerenciador de listas de discussão Mailman.  
    --no-quota      Desabilite a cota do sistema de arquivos.  
    --no-ntp        Desabilite a configuração do NTP.  
    --no-jailkit    Não instale jailkit.  
    --no-ftp        Não instale o servidor pure-ftpd.  
    --monit         Instale o Monit e configure-o para monitorar os serviços instalados. Serviços suportados: Apache2, NGINX, MariaDB, pure-ftpd-mysql, php-fpm, ssh, named, Postfix, Dovecot, rspamd.  
    --monit-alert-email  
                    Configure alertas para o Monit serem enviados para o endereço de e-mail fornecido. por exemplo, [email protected].  
    --ssh-port      Configure o servidor SSH para escutar em uma porta não padrão. O número da porta deve estar entre 1 e 65535 e não pode estar em uso por outros serviços. por exemplo, --ssh-port=64.  
    --ssh-permit-root  
                    Configure o servidor SSH se deve ou não permitir login root: --ssh-permit-root=, por exemplo, --ssh-permit-root=sem-senha.  
    --ssh-password-authentication  
                    Configure o servidor SSH se deve ou não permitir autenticação por senha: --ssh-password-authentication=, por exemplo, -ssh-password-authentication=não.  
    --ssh-harden    Configure o servidor SSH para ter uma configuração de segurança mais forte.  
    --unattended-upgrades  
                    Instale o UnattendedUpgrades. Você pode adicionar argumentos extras para limpeza automática e reinicializações automáticas quando necessário: --unattended-upgrades=autoclean,reboot (ou apenas um deles).  
    --i-know-what-i-am-doing  
                    Impede que o autoinstalador pergunte por confirmação antes de continuar a reconfigurar o servidor.

Por exemplo, para instalar uma configuração semelhante a um ‘Servidor Perfeito’ com Nginx em vez de Apache, use este comando:

wget -O - https://get.ispconfig.org | sh -s -- --use-nginx `--use-ftp-ports=40110-40210` --unattended-upgrades

Ou para instalar um servidor web Nginx sem serviços de Email e DNS:

wget -O - https://get.ispconfig.org | sh -s -- --use-nginx --no-dns --no-mail `--use-ftp-ports=40110-40210` --unattended-upgrades

7. Finalizando

Sua configuração agora está concluída!

Você pode apoiar o ISPConfig comprando nosso manual: https://www.ispconfig.org/documentation/

Os seguintes links são alguns tutoriais/pontes valiosos para configuração adicional:

Se você tiver alguma dúvida, pergunte no fórum.

8. Depuração em caso de erro

Se algo der errado durante a instalação, você pode depurar o processo adicionando a opção de linha de comando –debug ao comando de instalação. Isso escreverá um arquivo de log

/tmp/ispconfig-ai/var/log/ispconfig.log

Além disso, a opção de linha de comando –interactive pode ajudar a revelar a razão para um erro de instalação.

9. Baixar como uma máquina virtual

Esta configuração está disponível como um download de máquina virtual no formato ova/ovf (compatível com VMWare e Virtualbox) para assinantes do howtoforge. A máquina virtual é baseada no Debian 12 e usa Apache como servidor web.

Detalhes de login para a VM

  • A senha root é: howtoforge
  • A senha do usuário “admin” do ISPConfig é: howtoforge
  • Há outro usuário shell com o nome “administrator” e senha: howtoforge
  • A senha root do MySQL é: 7s8EtDL1QhorSaeHhnRh

Por favor, altere todas as senhas no primeiro login.

  • O endereço IP da VM é 192.168.0.100
Share: X/Twitter LinkedIn
#Instalação ISPConfig

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.