PostfixAdmin

PostfixAdmin ist eine Webschnittstelle für Postfix zur Verwaltung von Postfächern, virtuellen Domänen und Aliasnamen.

Beschreibung

Postfixadmin is a web interface to manage virtual users and domains for a Postfix mail transport agent. It supports Virtual mailboxes, aliases, forwarders and vacation.

Postfixadmin allows administrators to delegate account handling to domain administrators and allows users to login and change their own settings (e.g. forwarders, vacation, passwords etc).

It provides easy integration into dovecot, courier or cyrus.

Postfixadmin is written in PHP.

Installation

# apt install postfixadmin
Paketlisten werden gelesen… Fertig
Abhängigkeitsbaum wird aufgebaut… Fertig
Statusinformationen werden eingelesen… Fertig
Die folgenden zusätzlichen Pakete werden installiert:
  dbconfig-common libapache2-mod-php libapache2-mod-php8.1 libc-client2007e libonig5 mlock php-common php-imap
  php-mbstring php-mysql php8.1-cli php8.1-common php8.1-imap php8.1-mbstring php8.1-mysql php8.1-opcache
  php8.1-readline wwwconfig-common
Vorgeschlagene Pakete:
  dbconfig-mysql | dbconfig-pgsql | dbconfig-sqlite3 | dbconfig-no-thanks php-pear uw-mailutils mysql-client
  postgresql-client
Empfohlene Pakete:
  zendframework
Die folgenden NEUEN Pakete werden installiert:
  dbconfig-common libapache2-mod-php libapache2-mod-php8.1 libc-client2007e libonig5 mlock php-common php-imap
  php-mbstring php-mysql php8.1-cli php8.1-common php8.1-imap php8.1-mbstring php8.1-mysql php8.1-opcache
  php8.1-readline postfixadmin wwwconfig-common
0 aktualisiert, 19 neu installiert, 0 zu entfernen und 0 nicht aktualisiert.
Es müssen 8.147 kB an Archiven heruntergeladen werden.
Nach dieser Operation werden 33,2 MB Plattenplatz zusätzlich benutzt.
Möchten Sie fortfahren? [J/n]

Konfiguration

Dateien

/etc
 /etc/apache2
  /etc/apache2/conf-available
  /etc/apache2/conf-available/postfixadmin.conf
 /etc/lighttpd
  /etc/lighttpd/conf-available
  /etc/lighttpd/conf-available/90-postfixadmin.conf
 /etc/postfixadmin
  /etc/postfixadmin/config.inc.php
/usr
 /usr/bin/postfixadmin-cli

Testfragen

Testfrage 1

Antwort1

Testfrage 2

Antwort2

Testfrage 3

Antwort3

Testfrage 4

Antwort4

Testfrage 5

Antwort5

TMP

Installation

Um PostfixAdmin verwenden zu können, benötigen Sie ein funktionierendes Webserver- Setup. Sie können entweder einen Webserver wählen, der die Webanwendung direkt bedienen kann (z. B. Apache HTTP Server ), oder ein Setup, bei dem ein Webserver (z. B. Nginx ) Anfragen an einen Anwendungsserver (z. B. UWSGI oder php-fpm ) weiterleitet.

Informationen zur IMAP-Funktionalität finden Sie unter PHP#IMAP .

Als nächstes installieren das postfixadmin -Paket.

Hinweis

Auf Postfixadmin sollte nur über TLS zugegriffen werden (es sei denn, der Zugriff erfolgt direkt von der Maschine, auf der es ausgeführt wird), da sonst Passwörter und Benutzerdaten offengelegt werden.

Aufbau

Bearbeiten Sie die PostfixAdmin-Konfigurationsdatei, ändern Sie global alle Instanzen von change-this-to-your.domain.tld auf einen geeigneten Wert:

/etc/webapps/postfixadmin/config.local.php 

<?php
 $CONF['konfiguriert'] = true;
 // entspricht dem Maildir-Pfad von dovecot /home/vmail/%d/%u 
 $CONF['domain_path'] = 'YES';
 $CONF['domain_in_mailbox'] = 'NEIN';
 $CONF['database_type'] = 'mysqli';
 $CONF['database_host'] = 'localhost';
 $CONF['database_user'] = 'postfix_user';
 $CONF['database_password'] = 'hunter2';
 $CONF['Datenbankname'] = 'postfix_db';

 $CONF['default_aliases'] = array (
     'abuse' => 'abuse@change-this-to-your.domain.tld',
     'hostmaster' => 'hostmaster@change-this-to-your.domain.tld',
     'postmaster' => 'postmaster@change-this-to-your.domain.tld',
     'webmaster' => 'webmaster@change-this-to-your.domain.tld'
 );

 $CONF['vacation_domain'] = 'autoreply.change-this-to-your.domain.tld';

 $CONF['footer_text'] = 'Zurück zu change-this-to-your.domain.tld';
 $CONF['footer_link'] = 'http://change-this-to-your.domain.tld';

 

Wenn Sie dovecot installieren und das Passwortschema in dovecot geändert haben (z. B. in SHA512-CRYPT), geben Sie dies mit Postfix wieder

/etc/webapps/postfixadmin/config.local.php 

$CONF['encrypt'] = 'dovecot:SHA512-CRYPT';
 

Ab dovecot 2 ist dovecotpw veraltet. Sie sollten auch sicherstellen, dass Ihre Konfiguration den neuen Binärnamen widerspiegelt.

Hinweis: Ab postfixadmin 2.91 ist dies standardmäßig korrekt eingestellt.

/etc/webapps/postfixadmin/config.local.php 

$CONF['dovecotpw'] = "/usr/sbin/doveadm pw";
 

Hinweis

Damit dies funktioniert, reicht es nicht aus, dovecot installiert zu haben, es muss auch konfiguriert werden. Siehe Dovecot#Dovecot-Konfiguration .

Gastgeber

Hinweis

PostfixAdmin muss als eigener Benutzer und eigene Gruppe ausgeführt werden (z postfixadmin). Es nutzt /etc/webapps/postfixadmin, /var/lib/postfixadminund /run/postfixadminfür Konfigurationen, Template-Caches und (möglicherweise) Sockets (jeweils)!

Apache

Dieser Artikel oder Abschnitt muss erweitert werden.

Grund: Apache-Abschnitt benötigt ein uWSGI- Beispiel. (Diskutieren Sie im Talk:PostfixAdmin )

Der Apache -Webserver kann mit Hilfe von Modulen wie mod_proxy_fcgi oder mod_proxy_uwsgi .

php-fpm

Installieren und konfigurieren Apache HTTP Server mit php-fpm . Verwenden Sie einen Pool , der als Benutzer und Gruppe ausgeführt wird postfixadmin. Die Socket-Datei sollte für die zugänglich sein httpBenutzer und/oder Gruppe.

Fügen Sie die folgende Konfiguration in Ihre Apache HTTP Server- Konfiguration ein (dh /etc/httpd/conf/httpd.conf) und starten Sie den Webserver :

/etc/httpd/conf/postfixadmin.conf 

Alias ​​/postfixadmin "/usr/share/webapps/postfixadmin/public"
 <Verzeichnis "/usr/share/webapps/postfixadmin/public">
     Verzeichnisindex index.html index.php
     <FilesMatch \.php$>
         SetHandler "proxy:unix:/run/postfixadmin/postfixadmin.sock|fcgi://localhost/"
     </FilesMatch>
     AllowOverride All
     Optionen FollowSymlinks
     Erfordern alle gewährt
     SetEnv PHP_ADMIN_VALUE "open_basedir = /tmp/:/usr/share/webapps/postfixadmin:/etc/webapps/postfixadmin/:/var/cache/postfixadmin/templates_c"
 </Verzeichnis>
 

Erstellen Sie einen Pool für postfixadmin und starten Sie php-fpm.service neu:

/etc/php/php-fpm.d/postfixadmin.conf 

[postfixadmin]
 Benutzer = postfixadmin
 Gruppe = postfixadmin
 listen = /run/postfixadmin/postfixadmin.sock
 listen.owner = root
 listen.group = http
 listen.mode = 0660
 pm = auf Abruf
 pm.max_kinder = 4
 php_admin_value['date.timezone'] = Europa/Berlin
 php_admin_value['session.save_path'] = /tmp
 php_admin_value['open_basedir'] = /tmp/:/usr/share/webapps/postfixadmin/:/etc/webapps/postfixadmin/:/usr/bin/doveadm:/var/cache/postfixadmin
 

Um nur den localhost-Zugriff auf postfixadmin zu erlauben (für erhöhte Sicherheit), fügen Sie dies der vorherigen hinzu <Directory>Richtlinie:

Auftrag verweigern, zulassen
    Abgelehnt von allen
    Ab 127.0.0.1 zulassen
 

Nginx

Nginx kann Anwendungsserver wie php-fpm und uWSGI , die eine dynamische Webanwendung ausführen. Die folgenden Beispiele beschreiben eine ordnerbasierte Einrichtung über einen nicht standardmäßigen Port (der Einfachheit halber).

Notiz

• in nginx unter Nginx#Servereinträge .
• PostfixAdmin liefert eine Konfiguration für uWSGI .

php-fpm

Installieren Sie php-fpm und php-imap . Richten Sie nginx mit php-fpm ein und verwenden Sie einen Pool , der als Benutzer und Gruppe ausgeführt wird postfixadmin. Die Socket-Datei sollte für die zugänglich sein httpBenutzer und/oder Gruppe, muss sich aber darunter befinden /run/postfixadmin. Dies kann durch Hinzufügen der folgenden Zeilen erreicht werden.

/etc/php/php-fpm.d/postfixadmin.conf 

[postfixadmin]
 Benutzer = postfixadmin
 Gruppe = postfixadmin
 listen = /run/postfixadmin/postfixadmin.sock
 listen.owner = root
 listen.group = http
 listen.mode = 0660
 pm = auf Abruf
 pm.max_kinder = 4
 php_admin_value['date.timezone'] = Europa/Berlin
 php_admin_value['session.save_path'] = /tmp
 php_admin_value['open_basedir'] = /tmp/:/usr/share/webapps/postfixadmin/:/etc/webapps/postfixadmin/:/usr/bin/doveadm:/var/cache/postfixadmin
 

Sie müssen mindestens aktivieren imap, pdo_mysqlund mysqliErweiterungen ein /etc/php/php.ini. Stellen Sie sicher, dass Sie auch hinzufügen /var/cache/postfixadminzu open_basedir in Ihrer php.ini. Starten php-fpm neu , damit all dies wirksam wird.

Fügen Sie die folgende Konfiguration für nginx hinzu und starten Sie sie neu.

/etc/nginx/sites-available/postfixadmin.conf 

Server {
       höre 8081;
       server_name postfixadmin;
       root /usr/share/webapps/postfixadmin/public/;
       indexindex.php;
       Zeichensatz utf-8;
     
       access_log /var/log/nginx/postfixadmin-access.log;
       error_log /var/log/nginx/postfixadmin-error.log;
     
       Lage / {
         try_files $uri $uri/index.php;
       }
     
       Standort ~* \.php$ {
         fastcgi_split_path_info ^(.+\.php)(/.+)$;
         schließen Sie fastcgi_params ein;
         fastcgi_pass unix:/run/postfixadmin/postfixadmin.sock;
         fastcgi_index index.php;
         schließen Sie fastcgi_params ein;
         fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
         fastcgi_buffer_size 16k;
         fastcgi_buffers 4 16k;
       }
     }
 

uWSGI

Installieren Sie uwsgi-plugin-php , erstellen Sie einen Socket pro Anwendung für uWSGI (siehe UWSGI#Accessibility of uWSGI socket als Referenz) und aktivieren die uwsgi-secure@postfixadmin.socketEinheit.

Fügen Sie die folgende Konfiguration für nginx hinzu und starten nginx .

/etc/nginx/sites-available/postfixadmin.conf 

Server {
       höre 8081;
       server_name postfixadmin;
       root /usr/share/webapps/postfixadmin/public/;
       indexindex.php;
       Zeichensatz utf-8;
     
       access_log /var/log/nginx/postfixadmin-access.log;
       error_log /var/log/nginx/postfixadmin-error.log;
     
       Lage / {
         try_files $uri $uri/index.php;
       }

       # Übergeben Sie alle .php- oder .php/path-URLs an uWSGI
       Standort ~ ^(.+\.php)(.*)$ {
         uwsgi_params einschließen;
         uwsgi_modifier1 14;
         uwsgi_pass unix:/run/postfixadmin/postfixadmin.sock;
       }
     }
 

Aufstellen

Navigieren Sie schließlich zu http://127.0.0.1/postfixadmin/setup.php , wenn Sie Apache oder http://127.0.0.1:8081/setup.php für Nginx verwendet haben, um die Einrichtung abzuschließen. Generieren Sie Ihren Setup-Passwort-Hash unten auf der Seite, sobald dies abgeschlossen ist. Schreiben Sie den Hash in die Konfigurationsdatei

/etc/webapps/postfixadmin/config.local.php 

$CONF['setup_password'] = 'yourhashhere';
 

Jetzt können Sie ein Superadmin-Konto unter http://127.0.0.1/postfixadmin/setup.php wenn Sie Apache oder http://127.0.0.1:8081/setup.php für Nginx verwendet haben.

Tipps und Tricks

Pacman-Haken

Manchmal muss die Datenbank nach einem Versionsstoß aktualisiert werden. In diesem Fall wird auf der Anmeldeseite die Meldung „Das PostfixAdmin-Datenbanklayout ist veraltet“ angezeigt.

Sie können einen Hook einrichten, der das benötigte upgrade.php-Skript automatisch über einen Pacman-Hook ausführt:

/etc/pacman.d/hooks/postfixadmin.hook 

[Abzug]
 Vorgang = Installieren
 Betrieb = Upgrade
 Typ = Paket
 Ziel = postfixadmin

 [Aktion]
 Description = Führen Sie Postfixadmin upgrade.php aus, um sicherzustellen, dass die Datenbank auf dem neuesten Stand ist
 Wann = PostTransaktion
 Exec = /usr/bin/runuser -u postfixadmin -- /usr/bin/php /usr/share/webapps/postfixadmin/public/upgrade.php
 

Fehlerbehebung

Konfiguration nicht gefunden

Wenn Sie zu yourdomain/postfixadmin/setup.php gehen und die Anwendung angibt, dass sie config.inc.php nicht finden kann, fügen Sie hinzu /etc/webapps/postfixadminzum open_basedirZeile ein /etc/php/php.ini(siehe PHP#Configuration als Referenz).

Leere Seite beim Zugriff

Wenn Sie eine leere Seite erhalten, überprüfen Sie die Syntax der Konfiguration mit php -l /etc/webapps/postfixadmin/config.inc.php.