Poštový server Mailcow - príručka pre začiatočníkov
Server obsahuje Mailcow – plne dockerizovanú sadu poštového servera s odosielaním a prijímaním e-mailov, webmailom (SOGo), antispamom (Rspamd), antivírusom (ClamAV) a administračným panelom. Poštová doména a heslo administrátora sa nastavia automaticky podľa údajov, ktoré ste zadali pri objednávke.
Krok 1 – Overte, že Mailcow funguje
IP adresa a heslo root vášho servera sú uvedené na stránke Server Details v klientskom paneli. Otvorte https://your.server.ip v prehliadači. Prehliadač zobrazí bezpečnostné varovanie kvôli certifikátu podpísanému samým sebou – je to normálne, pokračujte na web.
Na prihlasovacej stránke kliknite dole na „Log in as administrator“ . Zadajte prihlasovacie údaje administrátora:
- Používateľské meno:
admin - Heslo: heslo administrátora, ktoré ste zadali pri objednávke
Dôležité: Predvolená prihlasovacia stránka je pre používateľov schránok (prihlásenie e-mailom). Administračný panel má samostatné prihlásenie – použite odkaz dole na stránke.
Ak vidíte administračnú nástenku Mailcow, všetko funguje správne.
Ak ste server umiestnili za router VyOS v privátnej sieti, nastavte presmerovanie portov 22 (SSH), 25 (SMTP), 80 (HTTP), 443 (HTTPS), 587 (Submission), 993 (IMAP) a 995 (POP3). Poštový server musí byť dostupný z internetu, aby mohol odosielať a prijímať e-maily.
Krok 2 – Nastavenie DNS záznamov
Správna konfigurácia DNS je pre doručovanie e-mailov kľúčová . Bez správnych záznamov budú vaše e-maily odmietnuté alebo označené ako spam. Prejdite do nastavení DNS u registrátora domény a pridajte tieto záznamy (nahraďte your.server.ip skutočnou IP servera a example.com svojou doménou):
| Typ | Názov | Hodnota |
|---|---|---|
| A | your.server.ip | |
| MX | @ | mail.example.com (priorita 10) |
| TXT | @ | v=spf1 mx a -all |
| TXT | _dmarc | v=DMARC1; p=quarantine; rua=mailto:postmaster@example.com |
| CNAME | autodiscover | mail.example.com |
| CNAME | autoconfig | mail.example.com |
Záznam DKIM: Po prihlásení do administračného panela prejdite do Configuration → ARC/DKIM keys a získajte kľúč DKIM. Potom pridajte:
| Typ | Názov | Hodnota |
|---|---|---|
| TXT | dkim._domainkey | (skopírujte z administračného panela Mailcow) |
Reverzné DNS (záznam PTR): Kontaktujte podporu a požiadajte o nastavenie záznamu PTR pre IP vášho servera na mail.example.com. Je to nutné pre spoľahlivé doručovanie e-mailov.
Zmeny DNS sa zvyčajne prejavia v priebehu niekoľkých minút, ale môže to trvať až 24 hodín. Stav môžete skontrolovať na dnschecker.org.
Krok 3 – Vytvorenie schránok
V administračnom paneli:
- Prejdite na E-Mail → Mailboxes
- Kliknite na Add mailbox
- Zadajte používateľské meno (napr.
info), nastavte heslo a kliknite na Pridať - Nová schránka (napr.
info@example.com) je pripravená na použitie
Používatelia majú prístup k webmailu (SOGo) na https://your.server.ip/SOGo – prihlásia sa celou e-mailovou adresou a heslom schránky.
Po inštalácii
SSL s Let’s Encrypt
Mailcow má vstavanú podporu Let’s Encrypt. Keď váš A záznam (mail.example.com) smeruje na server a DNS sa rozšírilo, uistite sa, že je SKIP_LETS_ENCRYPT=n v mailcow.conf, a reštartujte:
cd /opt/mailcow-dockerized
docker compose down && docker compose up -d
Mailcow automaticky získa a bude obnovovať certifikát.
Nastavenie e-mailového klienta
Na pripojenie e-mailového klienta (Outlook, Thunderbird, mobil) použite toto nastavenie:
| Protokol | Server | Port | Zabezpečenie |
|---|---|---|---|
| IMAP | mail.example.com | 993 | SSL/TLS |
| SMTP | mail.example.com | 587 | STARTTLS |
| POP3 | mail.example.com | 995 | SSL/TLS |
Používateľské meno je celá e-mailová adresa (napr. info@example.com). Ak ste nastavili DNS záznamy autodiscover a autoconfig , väčšina e-mailových klientov tieto nastavenia zistí automaticky.
Pridanie domén
Na jednom serveri Mailcow môžete hosťovať viac poštových domén:
- Prejdite na Configuration → Mail Setup → Domains
- Kliknite na Add domain a zadajte názov novej domény
- Nastavte DNS záznamy pre novú doménu (MX, SPF, DKIM, DMARC) rovnako ako v kroku 2
- Vytvorte schránky pre novú doménu
Fail2Ban – ochrana proti útokom hrubou silou
Váš server obsahuje Fail2Ban predkonfigurovaný na ochranu SSH proti útokom hrubou silou. Mailcow má aj vlastnú internú ochranu proti útokom hrubou silou pre SMTP, IMAP, POP3 a administračný panel – nastavíte ju v administrácii v System → Configuration → Fail2ban parameters.
| Pravidlo | Max. počet pokusov | Doba blokovania |
|---|---|---|
| SSH (host) | 5 neúspešných prihlásení | 10 minút |
Užitočné príkazy:
# Check banned IPs
fail2ban-client status sshd
# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4
Ak sa omylom zablokujete, pripojte sa cez konzolu VNC v klientskom paneli a odblokujte svoju IP.
Správa služieb
# Check status
cd /opt/mailcow-dockerized && docker compose ps
# Restart all services
docker compose down && docker compose up -d
# View logs
docker compose logs -f --tail=100
Zálohy
Mailcow obsahuje vstavaný zálohovací skript:
# Create a backup
cd /opt/mailcow-dockerized
./helper-scripts/backup_and_restore.sh backup all --delete-days 7
# Automated daily backups (add to crontab -e)
0 3 * * * cd /opt/mailcow-dockerized && ./helper-scripts/backup_and_restore.sh backup all --delete-days 7
Zálohy sa v predvolenom stave ukladajú do /var/backups/mailcow .
Aktualizácie
Aktualizácia Mailcow a systémových balíčkov:
# Update Mailcow
cd /opt/mailcow-dockerized && sudo ./update.sh
# Update system packages
apt update && apt upgrade -y
Zahrnutý softvér
| Komponent | Podrobnosti |
|---|---|
| Ubuntu | 24.04 LTS |
| Docker CE | Najnovšia |
| Mailcow | Najnovší (dockerizovaný) |
| Postfix | SMTP server |
| Dovecot | Server IMAP / POP3 |
| SOGo | Webmailový klient |
| ClamAV | Antivírus |
| Rspamd | Antispam |
| Fail2Ban | Ochrana proti útokom hrubou silou |
Riešenie problémov
| Problém | Riešenie |
|---|---|
| Nedá sa dostať do webového panela | Skontrolujte, či kontajnery bežia: cd /opt/mailcow-dockerized && docker compose ps. V prípade potreby reštartujte: docker compose down && docker compose up -d |
| Prihlasovacia stránka žiada e-mail | Predvolená stránka je pre používateľov schránok. Kliknite na „Log in as administrator“ dole na stránke a prejdite k prihláseniu administrátora |
| E-maily padajú do spamu | Overte DNS záznamy: SPF, DKIM a DMARC musia byť správne nastavené. Záznam PTR skontrolujte pomocou dig -x your.server.ip. Otestujte na mail-tester.com |
| Nedá sa odosielať ani prijímať e-maily | Kontrola MX záznamu: dig MX example.com. Overte, že port 25 neblokuje váš poskytovateľ. Kontrola logov: cd /opt/mailcow-dockerized && docker compose logs postfix-mailcow |
| Certifikát Let’s Encrypt nebol vydaný | Uistite sa, že MAILCOW_HOSTNAME v mailcow.conf zodpovedá vášmu DNS A záznamu a SKIP_LETS_ENCRYPT=n. Kontrola logov: docker compose logs acme-mailcow |
| ClamAV nie je pripravený / vysoké využitie pamäte | ClamAV pri prvom štarte sťahuje vírusové databázy (~300 MB). Môže to trvať niekoľko minút. Kontrola: docker compose logs clamd-mailcow |
| Zabudnuté heslo administrátora | Obnova cez SSH:cd /opt/mailcow-dockerized && docker compose exec -T mysql-mailcow mysql -umailcow -p$(grep DBPASS mailcow.conf | cut -d= -f2) mailcow -e "UPDATE admin SET password='{SSHA256}' WHERE username='admin';"Potom sa prihláste ľubovoľným heslom a zmeňte ho v administračnom paneli |
| Zablokované službou Fail2Ban | Odblokujte svoju IP cez konzolu VNC v klientskom paneli |
| Zabudnuté heslo root | Obnovte ho cez konzolu VNC v klientskom paneli |