Instalação ISPConfig · 9 min read · Sep 25, 2025

Instalação Automatizada do ISPConfig 3 no Servidor Perfeito em Debian 11 e 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. 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 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 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 não 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 terá que 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 escolher 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

Você pode agora 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

Você pode agora 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! This script will reconfigure your complete server!  
It should be run on a freshly installed server and all current configuration that you have done will most likely be lost!  
Type 'yes' if you really want to continue:

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] Your ISPConfig admin password is: 5GvfSSSYsdfdYC  
[INFO] Your MySQL root password is: 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, deve parecer 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:

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

This script automatically installs all needed packages for an ISPConfig 3 setup using the guidelines from the "Perfect Server Setup" howtos on www.howtoforge.com.

Possible arguments are:  
    --help          Show this help page.  
    --debug         Enable verbose logging (logs each command with the exit code).  
    --channel       Choose the channel to use for ISPConfig: --channel=  
                    "stable" is the latest ISPConfig release available on www.ispconfig.org  
                    "dev" is the latest dev-branch from the ISPConfig git repository: https://git.ispconfig.org/ispconfig/ispconfig3/tree/develop  
                    The dev channel might contain bugs and less-tested features and should only be used in production by very experienced users.  
    --lang          Use language for ISPConfig installation. Specify with --lang=en|de (only en (English) and de (German) supported currently).  
    --interactive   Don't install ISPConfig in non-interactive mode.  
                    This is needed if you want to use expert mode, e.g. to install a slave server that shall be integrated into an existing multiserver setup.  
    --use-nginx     Use nginx webserver instead of apache2.  
    --use-amavis    Use amavis instead of rspamd for mail filtering.  
    --use-unbound   Use unbound instead of bind9 for local resolving. Only allowed if --no-dns is set.  
    --use-php       Use specific PHP versions, comma separated, instead of installing multiple PHP, e.g. --use-php=7.4,8.0 (5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2 and 8.3 available).  
                    --use-php=system disables the sury repository and just installs the system's default PHP version.  
                    --use-php while omitting the argument, uses all versions.  
    --use-ftp-ports This option sets the passive port range for pure-ftpd. You have to specify the port range separated by hyphen, e.g. --use-ftp-ports=40110-40210.  
                    If not provided the passive port range will not be configured.  
    --use-certbot   Use Certbot instead of acme.sh for issuing Let's Encrypt certificates. Not advised unless you are migrating from an old server that uses Certbot.  
    --no-web        Do not use ISPConfig on this server to manage webserver setting and don't install nginx/apache or pureftpd.  
                    This will also prevent installing an ISPConfig UI and implies --no-roundcube as well as --no-pma.  
    --no-mail       Do not use ISPConfig on this server to manage mailserver settings.  
                    This will install postfix for sending system mails, but not dovecot and not configure any settings for ISPConfig mail. It implies --no-mailman.  
    --no-dns        Do not use ISPConfig on this server to manage DNS entries. Bind will be installed for local DNS caching / resolving only.  
    --no-local-dns  Do not install local DNS caching / resolving via bind.  
    --no-firewall   Do not install ufw and tell ISPConfig to not manage firewall settings on this server.  
    --no-roundcube  Do not install roundcube webmail.  
    --roundcube     Install Roundcube even when --no-mail is used. Manual configuration of Roundcube config is needed.  
    --no-pma        Do not install PHPMyAdmin on this server.  
    --no-mailman    Do not install Mailman mailing list manager.  
    --no-quota      Disable file system quota.  
    --no-ntp        Disable NTP setup.  
    --no-jailkit    Do not install jailkit.  
    --no-ftp        Do not install pure-ftpd server.  
    --monit         Install Monit and set it up to monitor installed services. Supported services: Apache2, NGINX, MariaDB, pure-ftpd-mysql, php-fpm, ssh, named, Postfix, Dovecot, rspamd.  
    --monit-alert-email  
                    Set up alerts for Monit to be sent to given e-mail address. e.g. [email protected].  
    --ssh-port      Configure the SSH server to listen on a non-default port. Port number must be between 1 and 65535 and can not be in use by other services. e.g. --ssh-port=64.  
    --ssh-permit-root  
                    Configure the SSH server whether or not to allow root login: --ssh-permit-root=, e.g. --ssh-permit-root=without-password.  
    --ssh-password-authentication  
                    Configure the SSH server whether or not to allow password authentication: --ssh-password-authentication=, e.g. -ssh-password-authentication=no.  
    --ssh-harden    Configure the SSH server to have a stronger security config.  
    --unattended-upgrades  
                    Install UnattendedUpgrades. You can add extra arguments for automatic cleanup and automatic reboots when necessary: --unattended-upgrades=autoclean,reboot (or only one  
                    of them).  
    --i-know-what-i-am-doing  
                    Prevent the autoinstaller to ask for confirmation before continuing to reconfigure the server.

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, mude 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.