Table of Contents

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 mail 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:

  1. Prejdite na E-Mail → Mailboxes
  2. Kliknite na Add mailbox
  3. Zadajte používateľské meno (napr. info), nastavte heslo a kliknite na Pridať
  4. 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:

  1. Prejdite na Configuration → Mail Setup → Domains
  2. Kliknite na Add domain a zadajte názov novej domény
  3. Nastavte DNS záznamy pre novú doménu (MX, SPF, DKIM, DMARC) rovnako ako v kroku 2
  4. 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
Ubuntu24.04 LTS
Docker CENajnovšia
MailcowNajnovší (dockerizovaný)
PostfixSMTP server
DovecotServer IMAP / POP3
SOGoWebmailový klient
ClamAVAntivírus
RspamdAntispam
Fail2BanOchrana 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