Servidor de Email · 5 min read · Sep 26, 2025

Como Configurar um Servidor de Email com PostfixAdmin no Debian 11

PostfixAdmin é uma interface gratuita, de código aberto e baseada na web usada para gerenciar o servidor de email Postfix a partir do navegador. Ele permite que você adicione usuários, aliases, defina uma cota de disco, adicione e remova domínios a partir da interface baseada na web. Suporta vários backends de banco de dados, incluindo PostgreSQL, MySQL, MariaDB e SQLite. Pode ser integrado com Squirrelmail e Roundcube via plugins.

Neste artigo, explicarei como instalar o PostfixAdmin no Debian 11.

Pré-requisitos

  • Um servidor rodando Debian 11 com postfix instalado.
  • Um nome de domínio válido apontado para o endereço IP do seu servidor.
  • Um registro MX válido apontado para o endereço IP do seu servidor.

Começando

Primeiro, atualize os pacotes do seu sistema com a versão mais recente usando o seguinte comando:

apt-get update -y

Uma vez que seu sistema esteja atualizado, defina o nome do host totalmente qualificado do seu servidor.

hostnamectl set-hostname mail.dominio.com

Em seguida, execute o seguinte comando para aplicar as alterações.

hostname -f

Uma vez que você tenha terminado, pode prosseguir para o próximo passo.

Instalar Nginx, MariaDB e PHP

Em seguida, você precisará instalar o servidor web Nginx, MariaDB, PHP e outras extensões PHP necessárias para o seu servidor. Você pode instalar todos eles com o seguinte comando:

apt-get install nginx mariadb-server php-fpm php-cli php-imap php-json php-mysql php-opcache php-mbstring php-readline unzip sudo -y

Uma vez que todos os pacotes estejam instalados, você pode prosseguir para o próximo passo.

Criar um Banco de Dados PostfixAdmin

Em seguida, você precisará criar um banco de dados e um usuário para o PostfixAdmin. Primeiro, faça login no console do MariaDB com o seguinte comando:

mysql

Uma vez conectado, crie um banco de dados e um usuário com o seguinte comando:

MariaDB [(none)]> CREATE DATABASE postfixadmin;  
MariaDB [(none)]> GRANT ALL ON postfixadmin.* TO 'postfixadmin'@'localhost' IDENTIFIED BY 'senhasegura';

Em seguida, limpe os privilégios e saia do shell do MariaDB com o seguinte comando:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Neste ponto, o banco de dados MariaDB foi criado para o PostfixAdmin. Você pode agora prosseguir para o próximo passo.

Instalar PostfixAdmin

Primeiro, você precisará baixar a versão mais recente do PostfixAdmin do site Sourceforge. Você pode baixá-lo com o seguinte comando:

wget https://webwerks.dl.sourceforge.net/project/postfixadmin/postfixadmin-3.3.8/PostfixAdmin%203.3.8.tar.gz

Uma vez que o download esteja completo, extraia o arquivo baixado com o seguinte comando:

tar -xvzf PostfixAdmin\ 3.3.8.tar.gz

Em seguida, mova o diretório extraído para o diretório raiz do Nginx:

mv postfixadmin-postfixadmin-7d04685 /var/www/html/postfixadmin

Em seguida, crie um diretório necessário para instalar o PostfixAdmin:

mkdir /var/www/html/postfixadmin/templates_c

Em seguida, defina a propriedade adequada para o diretório do PostfixAdmin:

chown -R www-data: /var/www/html/postfixadmin/

Em seguida, crie um arquivo config.local.php:

nano /var/www/html/postfixadmin/config.local.php

Adicione as seguintes linhas:

 '[email protected]',
 'hostmaster' => '[email protected]',
 'postmaster' => '[email protected]',
 'webmaster' => '[email protected]'
);
 
$CONF['fetchmail'] = 'NO';
$CONF['show_footer_text'] = 'NO';
 
$CONF['quota'] = 'YES';
$CONF['domain_quota'] = 'YES';
$CONF['quota_multiplier'] = '1024000';
$CONF['used_quotas'] = 'YES';
$CONF['new_quota_table'] = 'YES';
 
$CONF['aliases'] = '0';
$CONF['mailboxes'] = '0';
$CONF['maxquota'] = '0';
$CONF['domain_quota_default'] = '0';
?>

Salve e feche o arquivo, então crie o esquema para o banco de dados PostfixAdmin com o seguinte comando:

sudo -u www-data php /var/www/html/postfixadmin/public/upgrade.php

Em seguida, você precisará criar uma conta de super administrador para o PostfixAdmin. Você pode criá-la com o seguinte comando:

bash /var/www/html/postfixadmin/scripts/postfixadmin-cli admin add

Forneça seu nome de usuário de administrador, senha e domínio como mostrado abaixo:

Welcome to Postfixadmin-CLI v0.3
---------------------------------------------------------------

Admin:  
> [email protected]

Password:  
> Secure@12345

Password (again):  
> Secure@12345

Super admin:
(Super admins have access to all domains, can manage domains and admin accounts.) (y/n) 
> y

Domain:  
> dominio.com

Active: (y/n) 
> y

The admin [email protected] has been added!

---------------------------------------------------------------

Configurar Nginx para PostfixAdmin

Em seguida, você precisará criar um arquivo de configuração de host virtual do Nginx para o PostfixAdmin. Você pode criá-lo com o seguinte comando:

nano /etc/nginx/conf.d/dominio.com.conf

Adicione as seguintes linhas:

server {
        listen 80;
        root /var/www/html/postfixadmin/public;
        index index.html index.htm index.php;
        server_name mail.dominio.com;

        location ~ \.php$ {
          fastcgi_split_path_info ^(.+\.php)(/.+)$;
          fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
          fastcgi_index index.php;
          include fastcgi_params;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          fastcgi_intercept_errors off;
          fastcgi_buffer_size 16k;
          fastcgi_buffers 4 16k;
          fastcgi_connect_timeout 600;
          fastcgi_send_timeout 600;
          fastcgi_read_timeout 600;
        }

   location / {
       try_files $uri $uri/ =404;
   }

}

Salve e feche o arquivo, então reinicie o serviço Nginx para aplicar as alterações:

systemctl restart nginx

Você também pode verificar o status do Nginx com o seguinte comando:

systemctl status nginx

Você deve obter a seguinte saída:

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2021-08-28 08:13:22 UTC; 7s ago
       Docs: man:nginx(8)
    Process: 74644 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 74645 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 74646 (nginx)
      Tasks: 2 (limit: 2341)
     Memory: 3.2M
        CPU: 57ms
     CGroup: /system.slice/nginx.service
             ??74646 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??74647 nginx: worker process

Aug 28 08:13:22 mail.dominio.com systemd[1]: Starting A high performance web server and a reverse proxy server...
Aug 28 08:13:22 mail.dominio.com systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Aug 28 08:13:22 mail.dominio.com systemd[1]: Started A high performance web server and a reverse proxy server.

Acessar PostfixAdmin

Neste ponto, o PostfixAdmin está instalado e configurado. Você pode agora acessá-lo usando a URL http://mail.dominio.com. Você será redirecionado para a página de login do PostfixAdmin:

PostfixAdmin

Forneça seu email de administrador, senha e clique no botão Login. Você deve ver o painel do PostfixAdmin na tela seguinte:

Painel do PostfixAdmin

Conclusão

Parabéns! você instalou com sucesso o PostfixAdmin no Debian 11. Agora você pode gerenciar facilmente seu servidor de email Postfix a partir do navegador. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.

Share: X/Twitter LinkedIn
#Servidor de Email

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.