Przewodnik instalacji Forward Email na własnym serwerze dla Ubuntu

Ten przewodnik opisuje krok po kroku instalację rozwiązania Forward Email na własnym serwerze z systemem Ubuntu 20.04, 22.04 oraz 24.04 LTS.

Przed rozpoczęciem instalacji upewnij się, że posiadasz:

  • Ubuntu Server: 20.04, 22.04 lub 24.04 LTS
  • Dostęp root: Musisz mieć możliwość uruchamiania poleceń jako root (dostęp sudo)
  • Nazwa domeny: Domenę, którą kontrolujesz z dostępem do zarządzania DNS
  • Czysty serwer: Zalecane jest użycie świeżej instalacji Ubuntu
  • Połączenie internetowe: Wymagane do pobierania pakietów i obrazów Dockera

  • RAM: Minimum 2GB (zalecane 4GB dla produkcji)
  • Pamięć: Minimum 20GB wolnego miejsca (zalecane 50GB+ dla produkcji)
  • CPU: Minimum 1 vCPU (zalecane 2+ vCPU dla produkcji)
  • Sieć: Publiczny adres IP z otwartymi następującymi portami:
    • 22 (SSH)
    • 25 (SMTP)
    • 80 (HTTP)
    • 443 (HTTPS)
    • 465 (SMTPS)
    • 993 (IMAPS)
    • 995 (POP3S)

Krok 1: Wstępna konfiguracja systemu

Najpierw upewnij się, że system jest aktualny i przełącz się na użytkownika root:

# Aktualizacja pakietów systemowych
sudo apt update && sudo apt upgrade -y

# Przełącz się na użytkownika root (wymagane do instalacji)
sudo su -

Krok 2: Konfiguracja resolverów DNS

Skonfiguruj system tak, aby korzystał z serwerów DNS Cloudflare dla niezawodnego generowania certyfikatów:

# Zatrzymaj i wyłącz systemd-resolved, jeśli działa
if systemctl is-active --quiet systemd-resolved; then
    rm /etc/resolv.conf
    systemctl stop systemd-resolved
    systemctl disable systemd-resolved
    systemctl mask systemd-resolved
fi

# Konfiguracja resolverów DNS Cloudflare
tee /etc/resolv.conf > /dev/null <<EOF
nameserver 1.1.1.1
nameserver 2606:4700:4700::1111
nameserver 1.0.0.1
nameserver 2606:4700:4700::1001
nameserver 8.8.8.8
nameserver 2001:4860:4860::8888
nameserver 8.8.4.4
nameserver 2001:4860:4860::8844
EOF

Krok 3: Zainstaluj zależności systemowe

Zainstaluj wymagane pakiety dla Forward Email:

# Aktualizuj listę pakietów
apt-get update -y

# Zainstaluj podstawowe zależności
apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    git \
    openssl \
    docker-compose \
    snapd

Krok 4: Zainstaluj pakiety Snap

Zainstaluj AWS CLI i Certbot za pomocą snap:

# Zainstaluj AWS CLI
snap install aws-cli --classic

# Zainstaluj Certbot i wtyczkę DNS
snap install certbot --classic
snap set certbot trust-plugin-with-root=ok
snap install certbot-dns-cloudflare

Krok 5: Zainstaluj Docker

Zainstaluj Docker CE i Docker Compose:

# Dodaj oficjalny klucz GPG Dockera
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | tee /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

# Dodaj repozytorium Dockera
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list

# Zaktualizuj indeks pakietów i zainstaluj Dockera
apt-get update -y
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Sprawdź instalację Dockera
docker --version
docker compose version

Krok 6: Skonfiguruj usługę Docker

Upewnij się, że Docker uruchamia się automatycznie i działa:

# Włącz i uruchom usługę Docker
systemctl unmask docker
systemctl enable docker
systemctl start docker

# Sprawdź, czy Docker działa
docker info

Jeśli Docker nie uruchamia się, spróbuj uruchomić go ręcznie:

# Alternatywna metoda uruchomienia, jeśli systemctl zawiedzie
nohup dockerd >/dev/null 2>/dev/null &
sleep 5
docker info

Krok 7: Skonfiguruj zaporę sieciową

Skonfiguruj zaporę UFW, aby zabezpieczyć serwer:

# Ustaw domyślne zasady
ufw default deny incoming
ufw default allow outgoing

# Zezwól na SSH (ważne - nie zablokuj sobie dostępu!)
ufw allow 22/tcp

# Zezwól na porty związane z pocztą
ufw allow 25/tcp    # SMTP
ufw allow 80/tcp    # HTTP (dla Let's Encrypt)
ufw allow 443/tcp   # HTTPS
ufw allow 465/tcp   # SMTPS
ufw allow 587/tcp   # Przesyłanie SMTP (STARTTLS)
ufw allow 993/tcp   # IMAPS
ufw allow 995/tcp   # POP3S
ufw allow 2993/tcp  # IMAP (alternatywny port)
ufw allow 2995/tcp  # POP3 (alternatywny port)
ufw allow 3456/tcp  # Niestandardowy port usługi
ufw allow 4000/tcp  # Niestandardowy port usługi
ufw allow 5000/tcp  # Niestandardowy port usługi

# Zezwól na lokalne połączenia z bazą danych
ufw allow from 127.0.0.1 to any port 27017  # MongoDB
ufw allow from 127.0.0.1 to any port 6379   # Redis

# Włącz zaporę
echo "y" | ufw enable

# Sprawdź status zapory
ufw status numbered

Krok 8: Sklonuj repozytorium Forward Email

Pobierz kod źródłowy Forward Email:

# Ustaw zmienne
REPO_FOLDER_NAME="forwardemail.net"
REPO_URL="https://github.com/forwardemail/forwardemail.net.git"
ROOT_DIR="/root/$REPO_FOLDER_NAME"

# Sklonuj repozytorium
git clone "$REPO_URL" "$ROOT_DIR"
cd "$ROOT_DIR"

# Sprawdź, czy klonowanie się powiodło
ls -la

Krok 9: Przygotuj konfigurację środowiska

Przygotuj konfigurację środowiska:

# Ustaw zmienne katalogów
SELF_HOST_DIR="$ROOT_DIR/self-hosting"
ENV_FILE_DEFAULTS=".env.defaults"
ENV_FILE=".env"

# Skopiuj domyślny plik środowiskowy
cp "$ROOT_DIR/$ENV_FILE_DEFAULTS" "$SELF_HOST_DIR/$ENV_FILE"

# Utwórz katalog SSL
mkdir -p "$SELF_HOST_DIR/ssl"

# Utwórz katalogi baz danych
mkdir -p "$SELF_HOST_DIR/sqlite-data"
mkdir -p "$SELF_HOST_DIR/mongo-backups"
mkdir -p "$SELF_HOST_DIR/redis-backups"

Krok 10: Skonfiguruj swoją domenę

Ustaw nazwę domeny i zaktualizuj zmienne środowiskowe:

# Zamień 'yourdomain.com' na swoją faktyczną domenę
DOMAIN="yourdomain.com"

# Funkcja do aktualizacji pliku środowiskowego
update_env_file() {
  local key="$1"
  local value="$2"

  if grep -qE "^${key}=" "$SELF_HOST_DIR/$ENV_FILE"; then
    sed -i -E "s|^${key}=.*|${key}=${value}|" "$SELF_HOST_DIR/$ENV_FILE"
  else
    echo "${key}=${value}" >> "$SELF_HOST_DIR/$ENV_FILE"
  fi
}

# Zaktualizuj zmienne środowiskowe związane z domeną
update_env_file "DOMAIN" "$DOMAIN"
update_env_file "NODE_ENV" "production"
update_env_file "HTTP_PROTOCOL" "https"
update_env_file "WEB_URL" "https://$DOMAIN"
update_env_file "WEB_HOST" "$DOMAIN"
# nginx (usługa sni-router) kończy TLS na porcie 443 i przekazuje ruch do
# aplikacji web na porcie 3000 (zobacz docker-compose-self-hosted.yml i nginx.conf).
# Pozostaw WEB_PORT na 3000; ustawienie go na 443 powoduje konflikt z nginx w
# sieci hosta i sprawia, że interfejs web jest nieosiągalny.
update_env_file "WEB_PORT" "3000"
update_env_file "SQLITE_HOST" "sqlite.$DOMAIN"
update_env_file "CALDAV_HOST" "caldav.$DOMAIN"
update_env_file "CARDDAV_HOST" "carddav.$DOMAIN"
update_env_file "API_HOST" "api.$DOMAIN"
update_env_file "APP_NAME" "$DOMAIN"
update_env_file "TRANSPORT_DEBUG" "true"
update_env_file "SEND_EMAIL" "true"
update_env_file "PREVIEW_EMAIL" "false"
update_env_file "MONGO_HOST" "127.0.0.1"
update_env_file "LOGS_HOST" "127.0.0.1"
update_env_file "REDIS_HOST" "127.0.0.1"
update_env_file "TURNSTILE_ENABLED" "false"
update_env_file "SMTP_HOST" "smtp.$DOMAIN"
update_env_file "SMTP_PORT" "465"
update_env_file "IMAP_HOST" "imap.$DOMAIN"
update_env_file "IMAP_PORT" "993"
update_env_file "POP3_HOST" "pop3.$DOMAIN"
update_env_file "POP3_PORT" "995"
update_env_file "MX_HOST" "mx.$DOMAIN"
update_env_file "MX_PORT" "25"
update_env_file "SMTP_EXCHANGE_DOMAINS" "mx.$DOMAIN"
update_env_file "SQLITE_STORAGE_PATH" "sqlite_storage"
update_env_file "SELF_HOSTED" "true"
update_env_file "ENABLE_MONITOR_SERVER" "false"
update_env_file "CACHE_RESPONSES" "true"
update_env_file "WEBSITE_URL" "$DOMAIN"
update_env_file "AUTH_BASIC_ENABLED" "true"

Krok 11: Generowanie certyfikatów SSL

# Generowanie certyfikatów za pomocą ręcznego wyzwania DNS
certbot certonly \
  --manual \
  --agree-tos \
  --preferred-challenges dns \
  -d "*.$DOMAIN" \
  -d "$DOMAIN"

Ważne: Po wyświetleniu monitu będziesz musiał utworzyć rekordy TXT w swojej DNS. Możesz zobaczyć wiele wyzwań dla tej samej domeny: utwórz WSZYSTKIE z nich. Nie usuwaj pierwszego rekordu TXT podczas dodawania drugiego.

Opcja B: Cloudflare DNS (jeśli używasz Cloudflare)

Jeśli Twoja domena korzysta z Cloudflare dla DNS, możesz zautomatyzować generowanie certyfikatów:

# Utwórz plik poświadczeń Cloudflare
cat > /root/.cloudflare.ini <<EOF
dns_cloudflare_email = "your-email@example.com"
dns_cloudflare_api_key = "your-cloudflare-global-api-key"
EOF

# Ustaw odpowiednie uprawnienia
chmod 600 /root/.cloudflare.ini

# Automatyczne generowanie certyfikatów
certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials /root/.cloudflare.ini \
  -d "$DOMAIN" \
  -d "*.$DOMAIN" \
  --non-interactive \
  --agree-tos \
  --email "your-email@example.com"

Kopiowanie certyfikatów

Po wygenerowaniu certyfikatów skopiuj je do katalogu aplikacji:

# Skopiuj certyfikaty do katalogu SSL aplikacji
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"

# Sprawdź, czy certyfikaty zostały skopiowane
ls -la "$SELF_HOST_DIR/ssl/"

Krok 12: Generowanie kluczy szyfrowania

Utwórz różne klucze szyfrowania wymagane do bezpiecznego działania:

# Generuj pomocniczy klucz szyfrowania
helper_encryption_key=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "HELPER_ENCRYPTION_KEY" "$helper_encryption_key"

# Generuj sekret SRS do przekazywania e-maili
srs_secret=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "SRS_SECRET" "$srs_secret"

# Generuj klucz szyfrowania TXT
txt_encryption_key=$(openssl rand -hex 16)
update_env_file "TXT_ENCRYPTION_KEY" "$txt_encryption_key"

# Generuj prywatny klucz DKIM do podpisywania e-maili
openssl genrsa -f4 -out "$SELF_HOST_DIR/ssl/dkim.key" 2048
update_env_file "DKIM_PRIVATE_KEY_PATH" "/app/ssl/dkim.key"

# Generuj klucz podpisu webhooka
webhook_signature_key=$(openssl rand -hex 16)
update_env_file "WEBHOOK_SIGNATURE_KEY" "$webhook_signature_key"

# Ustaw hasło transportu SMTP
update_env_file "SMTP_TRANSPORT_PASS" "$(openssl rand -base64 32)"

echo "✅ Wszystkie klucze szyfrowania zostały pomyślnie wygenerowane"

Krok 13: Aktualizacja ścieżek SSL w konfiguracji

Skonfiguruj ścieżki do certyfikatów SSL w pliku środowiskowym:

# Zaktualizuj ścieżki SSL, aby wskazywały na poprawne pliki certyfikatów
sed -i -E \
  -e 's|^(.*_)?SSL_KEY_PATH=.*|\1SSL_KEY_PATH=/app/ssl/privkey.pem|' \
  -e 's|^(.*_)?SSL_CERT_PATH=.*|\1SSL_CERT_PATH=/app/ssl/fullchain.pem|' \
  -e 's|^(.*_)?SSL_CA_PATH=.*|\1SSL_CA_PATH=/app/ssl/chain.pem|' \
  "$SELF_HOST_DIR/$ENV_FILE"

Krok 14: Konfiguracja podstawowej autoryzacji

Utwórz tymczasowe dane uwierzytelniające podstawowej autoryzacji:

# Wygeneruj bezpieczne losowe hasło
PASSWORD=$(openssl rand -base64 16)

# Zaktualizuj plik środowiskowy danymi uwierzytelniającymi podstawowej autoryzacji
update_env_file "AUTH_BASIC_USERNAME" "admin"
update_env_file "AUTH_BASIC_PASSWORD" "$PASSWORD"

# Wyświetl dane uwierzytelniające (zapisz je!)
echo ""
echo "🔐 WAŻNE: Zapisz te dane logowania!"
echo "=================================="
echo "Nazwa użytkownika: admin"
echo "Hasło: $PASSWORD"
echo "=================================="
echo ""
echo "Będziesz ich potrzebować, aby uzyskać dostęp do interfejsu webowego po instalacji."
echo ""

Krok 15: Wdrażanie za pomocą Docker Compose

Uruchom wszystkie usługi Forward Email:

# Ustaw ścieżkę do pliku Docker Compose
DOCKER_COMPOSE_FILE="$SELF_HOST_DIR/docker-compose-self-hosted.yml"

# Zatrzymaj istniejące kontenery
docker compose -f "$DOCKER_COMPOSE_FILE" down

# Pobierz najnowsze obrazy
docker compose -f "$DOCKER_COMPOSE_FILE" pull

# Uruchom wszystkie usługi w trybie odłączonym
docker compose -f "$DOCKER_COMPOSE_FILE" up -d

# Odczekaj chwilę na uruchomienie usług
sleep 10

# Sprawdź status usług
docker compose -f "$DOCKER_COMPOSE_FILE" ps

Krok 16: Weryfikacja instalacji

Sprawdź, czy wszystkie usługi działają poprawnie:

# Sprawdź kontenery Dockera
docker ps

# Sprawdź logi usług pod kątem błędów
docker compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50

# Przetestuj łączność z interfejsem webowym
curl -I https://$DOMAIN

# Sprawdź, czy porty nasłuchują
netstat -tlnp | grep -E ':(25|80|443|465|587|993|995)'

Konfiguracja rekordów DNS

Musisz skonfigurować następujące rekordy DNS dla swojej domeny:

Rekord MX

@ MX 10 mx.yourdomain.com

Rekordy A

@ A YOUR_SERVER_IP
mx A YOUR_SERVER_IP
smtp A YOUR_SERVER_IP
imap A YOUR_SERVER_IP
pop3 A YOUR_SERVER_IP
api A YOUR_SERVER_IP
caldav A YOUR_SERVER_IP
carddav A YOUR_SERVER_IP

Rekord SPF

@ TXT "v=spf1 mx ~all"

Rekord DKIM

Pobierz swój publiczny klucz DKIM:

# Wyodrębnij publiczny klucz DKIM
openssl rsa -in "$SELF_HOST_DIR/ssl/dkim.key" -pubout -outform DER | openssl base64 -A

Utwórz rekord DKIM w DNS:

default._domainkey TXT "v=DKIM1; k=rsa; p=YOUR_DKIM_PUBLIC_KEY"

Rekord DMARC

_dmarc TXT "v=DMARC1; p=quarantine; rua=mailto:dmarc@yourdomain.com"

Pierwsze logowanie

  1. Otwórz przeglądarkę i przejdź do https://yourdomain.com
  2. Wprowadź wcześniej zapisane dane uwierzytelniające podstawowej autoryzacji
  3. Ukończ kreatora początkowej konfiguracji
  4. Utwórz swoje pierwsze konto e-mail

Konfiguracja kopii zapasowej zgodnej z S3

Skonfiguruj automatyczne kopie zapasowe do magazynu zgodnego z S3:

# Utwórz katalog z poświadczeniami AWS
mkdir -p ~/.aws

# Skonfiguruj poświadczenia AWS
cat > ~/.aws/credentials <<EOF
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
EOF

# Skonfiguruj ustawienia AWS
cat > ~/.aws/config <<EOF
[default]
region = auto
output = json
EOF

# Dla S3 niebędącego AWS (np. Cloudflare R2), dodaj URL endpointu
echo "endpoint_url = YOUR_S3_ENDPOINT_URL" >> ~/.aws/config

Konfiguracja zadań cron dla kopii zapasowej

# Nadaj skryptom kopii zapasowej prawa do wykonania
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-mongo.sh"
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-redis.sh"

# Dodaj zadanie cron dla kopii zapasowej MongoDB (uruchamiane codziennie o północy)
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-mongo.sh >> /var/log/mongo-backup.log 2>&1") | crontab -

# Dodaj zadanie cron kopii zapasowej Redis (uruchamiane codziennie o 00:30,
# przesunięte o 30 minut po kopii MongoDB, aby oba przesyłania nie rywalizowały o to samo pasmo)
(crontab -l 2>/dev/null; echo "30 0 * * * $ROOT_DIR/self-hosting/scripts/backup-redis.sh >> /var/log/redis-backup.log 2>&1") | crontab -

# Zweryfikuj, czy zadania cron zostały dodane
crontab -l

Skonfiguruj automatyczne aktualizacje instalacji Forward Email:

# Utwórz polecenie aktualizacji
DOCKER_UPDATE_CMD="docker compose -f $DOCKER_COMPOSE_FILE pull && docker compose -f $DOCKER_COMPOSE_FILE up -d"

# Dodaj zadanie cron do automatycznej aktualizacji (uruchamiane codziennie o 1 w nocy)
(crontab -l 2>/dev/null; echo "0 1 * * * $DOCKER_UPDATE_CMD >> /var/log/autoupdate.log 2>&1") | crontab -

# Zweryfikuj, czy zadanie cron zostało dodane
crontab -l

Lokalizacje logów

  • Logi Docker Compose: docker compose -f $DOCKER_COMPOSE_FILE logs
  • Logi systemowe: /var/log/syslog
  • Logi kopii zapasowej: /var/log/mongo-backup.log, /var/log/redis-backup.log
  • Logi automatycznych aktualizacji: /var/log/autoupdate.log

Regularne zadania konserwacyjne

  1. Monitoruj miejsce na dysku: df -h
  2. Sprawdź status usług: docker compose -f $DOCKER_COMPOSE_FILE ps
  3. Przejrzyj logi: docker compose -f $DOCKER_COMPOSE_FILE logs --tail=100
  4. Aktualizuj pakiety systemowe: apt update && apt upgrade
  5. Odnawiaj certyfikaty: Certyfikaty odnawiają się automatycznie, ale monitoruj datę wygaśnięcia

Odnawianie certyfikatów

Certyfikaty powinny odnawiać się automatycznie, ale możesz je odnowić ręcznie, jeśli zajdzie taka potrzeba:

# Ręczne odnowienie certyfikatów
certbot renew

# Skopiuj odnowione certyfikaty
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"

# Zrestartuj usługi, aby używały nowych certyfikatów
docker compose -f "$DOCKER_COMPOSE_FILE" restart

Częste problemy

1. Usługa Docker nie chce się uruchomić

# Sprawdź status Dockera
systemctl status docker

# Spróbuj alternatywnego uruchomienia
nohup dockerd >/dev/null 2>/dev/null &

2. Generowanie certyfikatu nie powiodło się

  • Upewnij się, że porty 80 i 443 są dostępne
  • Zweryfikuj, czy rekordy DNS wskazują na Twój serwer
  • Sprawdź ustawienia zapory sieciowej

3. Problemy z dostarczaniem e-maili

  • Zweryfikuj poprawność rekordów MX
  • Sprawdź rekordy SPF, DKIM i DMARC
  • Upewnij się, że port 25 nie jest zablokowany przez dostawcę hostingu

4. Interfejs webowy jest niedostępny

  • Sprawdź ustawienia zapory: ufw status
  • Zweryfikuj certyfikaty SSL: openssl x509 -in $SELF_HOST_DIR/ssl/fullchain.pem -text -noout
  • Sprawdź dane uwierzytelniające basic auth

Uzyskiwanie pomocy

  1. Utrzymuj system zaktualizowany: Regularnie aktualizuj Ubuntu i pakiety
  2. Monitoruj logi: Skonfiguruj monitorowanie logów i alerty
  3. Regularnie twórz kopie zapasowe: Testuj procedury tworzenia i przywracania kopii zapasowych
  4. Używaj silnych haseł: Generuj silne hasła dla wszystkich kont
  5. Włącz Fail2Ban: Rozważ instalację fail2ban dla dodatkowego zabezpieczenia
  6. Regularne audyty bezpieczeństwa: Okresowo przeglądaj swoją konfigurację

Twoja instalacja Forward Email w trybie self-hosted powinna być teraz kompletna i działać na Ubuntu. Pamiętaj, aby:

  1. Poprawnie skonfigurować rekordy DNS
  2. Przetestować wysyłanie i odbieranie e-maili
  3. Skonfigurować regularne kopie zapasowe
  4. Regularnie monitorować system
  5. Utrzymywać instalację na bieżąco

Aby uzyskać dodatkowe opcje konfiguracji i zaawansowane funkcje, zapoznaj się z oficjalną dokumentacją Forward Email pod adresem https://forwardemail.net/self-hosted#configuration.