מדריך התקנת Forward Email Self-Hosting עבור אובונטו

מדריך זה מספק הוראות שלב אחר שלב להתקנת פתרון ה-Self-Hosting של Forward Email על מערכות אובונטו. מדריך זה מותאם במיוחד לגרסאות אובונטו 20.04, 22.04 ו-24.04 LTS.

לפני תחילת ההתקנה, ודא שיש לך:

• שרת אובונטו: 20.04, 22.04, או 24.04 LTS
• גישה כ-root: עליך להיות מסוגל להריץ פקודות כ-root (גישה עם sudo)
• שם דומיין: דומיין שבבעלותך עם גישה לניהול DNS
• שרת נקי: מומלץ להשתמש בהתקנה חדשה של אובונטו
• חיבור אינטרנט: נדרש להורדת חבילות ותמונות Docker

• זיכרון RAM: מינימום 2GB (מומלץ 4GB לייצור)
• אחסון: מינימום 20GB שטח פנוי (מומלץ 50GB+ לייצור)
• מעבד CPU: מינימום 1 vCPU (מומלץ 2+ vCPUs לייצור)
• רשת: כתובת IP ציבורית עם הפורטים הבאים פתוחים:
  • 22 (SSH)
  • 25 (SMTP)
  • 80 (HTTP)
  • 443 (HTTPS)
  • 465 (SMTPS)
  • 993 (IMAPS)
  • 995 (POP3S)

שלב 1: הגדרת מערכת ראשונית

ראשית, ודא שהמערכת שלך מעודכנת והחלף למשתמש root:

# Update system packages
sudo apt update && sudo apt upgrade -y

# Switch to root user (required for the installation)
sudo su -

שלב 2: הגדרת מפענחי DNS

הגדר את המערכת שלך להשתמש בשרתי ה-DNS של Cloudflare לצורך יצירת תעודות אמינה:

# Stop and disable systemd-resolved if running
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

# Configure Cloudflare DNS resolvers
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

Step 3: התקן תלות מערכת

התקן את החבילות הנדרשות עבור Forward Email:

# Update package list
apt-get update -y

# Install basic dependencies
apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    git \
    openssl \
    docker-compose \
    snapd

Step 4: התקן חבילות Snap

התקן את AWS CLI ו-Certbot דרך snap:

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

# Install Certbot and DNS plugin
snap install certbot --classic
snap set certbot trust-plugin-with-root=ok
snap install certbot-dns-cloudflare

Step 5: התקן Docker

התקן את Docker CE ו-Docker Compose:

# Add Docker's official GPG key
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

# Add Docker repository
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

# Update package index and install Docker
apt-get update -y
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Verify Docker installation
docker --version
docker compose version

Step 6: הגדר את שירות Docker

ודא ש-Docker יתחיל אוטומטית ופועל:

# Enable and start Docker service
systemctl unmask docker
systemctl enable docker
systemctl start docker

# Verify Docker is running
docker info

אם Docker נכשל בהפעלה, נסה להפעילו ידנית:

# Alternative startup method if systemctl fails
nohup dockerd >/dev/null 2>/dev/null &
sleep 5
docker info

Step 7: הגדר חומת אש

הגדר את חומת האש UFW כדי לאבטח את השרת שלך:

# Set default policies
ufw default deny incoming
ufw default allow outgoing

# Allow SSH (important - don't lock yourself out!)
ufw allow 22/tcp

# Allow email-related ports
ufw allow 25/tcp    # SMTP
ufw allow 80/tcp    # HTTP (for Let's Encrypt)
ufw allow 443/tcp   # HTTPS
ufw allow 465/tcp   # SMTPS
ufw allow 993/tcp   # IMAPS
ufw allow 995/tcp   # POP3S
ufw allow 2993/tcp  # IMAP (alternative port)
ufw allow 2995/tcp  # POP3 (alternative port)
ufw allow 3456/tcp  # Custom service port
ufw allow 4000/tcp  # Custom service port
ufw allow 5000/tcp  # Custom service port

# Allow local database connections
ufw allow from 127.0.0.1 to any port 27017  # MongoDB
ufw allow from 127.0.0.1 to any port 6379   # Redis

# Enable firewall
echo "y" | ufw enable

# Check firewall status
ufw status numbered

Step 8: שכפל את מאגר Forward Email

הורד את קוד המקור של Forward Email:

# Set up variables
REPO_FOLDER_NAME="forwardemail.net"
REPO_URL="https://github.com/forwardemail/forwardemail.net.git"
ROOT_DIR="/root/$REPO_FOLDER_NAME"

# Clone the repository
git clone "$REPO_URL" "$ROOT_DIR"
cd "$ROOT_DIR"

# Verify the clone was successful
ls -la

Step 9: הגדר את קונפיגורציית הסביבה

הכן את קונפיגורציית הסביבה:

# Set up directory variables
SELF_HOST_DIR="$ROOT_DIR/self-hosting"
ENV_FILE_DEFAULTS=".env.defaults"
ENV_FILE=".env"

# Copy default environment file
cp "$ROOT_DIR/$ENV_FILE_DEFAULTS" "$SELF_HOST_DIR/$ENV_FILE"

# Create SSL directory
mkdir -p "$SELF_HOST_DIR/ssl"

# Create database directories
mkdir -p "$SELF_HOST_DIR/sqlite-data"
mkdir -p "$SELF_HOST_DIR/mongo-backups"
mkdir -p "$SELF_HOST_DIR/redis-backups"

Step 10: הגדר את הדומיין שלך

הגדר את שם הדומיין שלך ועדכן את משתני הסביבה:

# Replace 'yourdomain.com' with your actual domain
DOMAIN="yourdomain.com"

# Function to update environment file
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
}

# Update domain-related environment variables
update_env_file "DOMAIN" "$DOMAIN"
update_env_file "NODE_ENV" "production"
update_env_file "HTTP_PROTOCOL" "https"
update_env_file "WEB_HOST" "$DOMAIN"
update_env_file "WEB_PORT" "443"
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 "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 "SMTP_EXCHANGE_DOMAINS" "mx.$DOMAIN"
update_env_file "SELF_HOSTED" "true"
update_env_file "WEBSITE_URL" "$DOMAIN"
update_env_file "AUTH_BASIC_ENABLED" "true"

שלב 11: יצירת תעודות SSL

אפשרות א: אתגר DNS ידני (מומלץ לרוב המשתמשים)

# יצירת תעודות באמצעות אתגר DNS ידני
certbot certonly \
  --manual \
  --agree-tos \
  --preferred-challenges dns \
  -d "*.$DOMAIN" \
  -d "$DOMAIN"

חשוב: כאשר תתבקש, תצטרך ליצור רשומות TXT ב-DNS שלך. ייתכן שתראה מספר אתגרים לאותו דומיין - צור את כולם. אל תסיר את רשומת ה-TXT הראשונה כשאתה מוסיף את השנייה.

אפשרות ב: DNS של Cloudflare (אם אתה משתמש ב-Cloudflare)

אם הדומיין שלך משתמש ב-Cloudflare עבור DNS, תוכל לאוטומט את יצירת התעודות:

# יצירת קובץ אישורי Cloudflare
cat > /root/.cloudflare.ini <<EOF
dns_cloudflare_email = "your-email@example.com"
dns_cloudflare_api_key = "your-cloudflare-global-api-key"
EOF

# הגדרת הרשאות נכונות
chmod 600 /root/.cloudflare.ini

# יצירת תעודות אוטומטית
certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials /root/.cloudflare.ini \
  -d "$DOMAIN" \
  -d "*.$DOMAIN" \
  --non-interactive \
  --agree-tos \
  --email "your-email@example.com"

העתקת תעודות

לאחר יצירת התעודות, העתק אותן לתיקיית האפליקציה:

# העתקת תעודות לתיקיית SSL של האפליקציה
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"

# בדיקת העתקת התעודות
ls -la "$SELF_HOST_DIR/ssl/"

שלב 12: יצירת מפתחות הצפנה

צור את מפתחות ההצפנה השונים הנדרשים להפעלה מאובטחת:

# יצירת מפתח הצפנה עזר
helper_encryption_key=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "HELPER_ENCRYPTION_KEY" "$helper_encryption_key"

# יצירת סוד SRS להעברת מיילים
srs_secret=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "SRS_SECRET" "$srs_secret"

# יצירת מפתח הצפנת TXT
txt_encryption_key=$(openssl rand -hex 16)
update_env_file "TXT_ENCRYPTION_KEY" "$txt_encryption_key"

# יצירת מפתח פרטי DKIM לחתימת מיילים
openssl genrsa -f4 -out "$SELF_HOST_DIR/ssl/dkim.key" 2048
update_env_file "DKIM_PRIVATE_KEY_PATH" "/app/ssl/dkim.key"

# יצירת מפתח חתימת webhook
webhook_signature_key=$(openssl rand -hex 16)
update_env_file "WEBHOOK_SIGNATURE_KEY" "$webhook_signature_key"

# הגדרת סיסמת SMTP transport
update_env_file "SMTP_TRANSPORT_PASS" "$(openssl rand -base64 32)"

echo "✅ כל מפתחות ההצפנה נוצרו בהצלחה"

שלב 13: עדכון נתיבי SSL בקונפיגורציה

הגדר את נתיבי תעודות ה-SSL בקובץ הסביבה:

# עדכון נתיבי SSL כדי להצביע על קבצי התעודה הנכונים
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"

שלב 14: הגדרת אימות בסיסי

צור אישורי אימות בסיסיים זמניים:

# יצירת סיסמה אקראית מאובטחת
PASSWORD=$(openssl rand -base64 16)

# עדכון קובץ הסביבה עם אישורי האימות הבסיסיים
update_env_file "AUTH_BASIC_USERNAME" "admin"
update_env_file "AUTH_BASIC_PASSWORD" "$PASSWORD"

# הצגת האישורים (שמור אותם!)
echo ""
echo "🔐 חשוב: שמור את אישורי הכניסה האלה!"
echo "=================================="
echo "שם משתמש: admin"
echo "סיסמה: $PASSWORD"
echo "=================================="
echo ""
echo "תזדקק להם כדי לגשת לממשק האינטרנט לאחר ההתקנה."
echo ""

שלב 15: פריסה עם Docker Compose

הפעל את כל שירותי Forward Email:

# הגדרת נתיב קובץ Docker Compose
DOCKER_COMPOSE_FILE="$SELF_HOST_DIR/docker-compose-self-hosted.yml"

# עצירת כל המכולות הקיימות
docker compose -f "$DOCKER_COMPOSE_FILE" down

# הורדת התמונה העדכנית ביותר
docker compose -f "$DOCKER_COMPOSE_FILE" pull

# הפעלת כל השירותים במצב מנותק
docker compose -f "$DOCKER_COMPOSE_FILE" up -d

# המתן רגע להתחלת השירותים
sleep 10

# בדיקת מצב השירותים
docker compose -f "$DOCKER_COMPOSE_FILE" ps

שלב 16: אימות התקנה

בדוק שכל השירותים פועלים כראוי:

# בדוק מכולות Docker
docker ps

# בדוק יומני שירותים עבור שגיאות
docker compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50

# בדוק חיבור לממשק האינטרנט
curl -I https://$DOMAIN

# בדוק אם הפורטים מאזינים
netstat -tlnp | grep -E ':(25|80|443|465|587|993|995)'

הגדרת רשומות DNS

עליך להגדיר את רשומות ה-DNS הבאות עבור הדומיין שלך:

רשומת MX

@ MX 10 mx.yourdomain.com

רשומות 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

רשומת SPF

@ TXT "v=spf1 mx ~all"

רשומת DKIM

קבל את מפתח ה-DKIM הציבורי שלך:

# חילוץ מפתח DKIM ציבורי
openssl rsa -in "$SELF_HOST_DIR/ssl/dkim.key" -pubout -outform DER | openssl base64 -A

צור רשומת DKIM ב-DNS:

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

רשומת DMARC

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

כניסה ראשונה

1. פתח את דפדפן האינטרנט שלך וגש ל-https://yourdomain.com
2. הזן את פרטי האימות הבסיסיים ששמרת קודם
3. השלם את אשף ההגדרה הראשוני
4. צור את חשבון האימייל הראשון שלך

הגדרת גיבוי תואם S3

הגדר גיבויים אוטומטיים לאחסון תואם S3:

# צור תיקיית אישורי AWS
mkdir -p ~/.aws

# הגדר אישורי AWS
cat > ~/.aws/credentials <<EOF
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
EOF

# הגדר הגדרות AWS
cat > ~/.aws/config <<EOF
[default]
region = auto
output = json
EOF

# עבור S3 שאינו AWS (כמו Cloudflare R2), הוסף כתובת נקודת קצה
echo "endpoint_url = YOUR_S3_ENDPOINT_URL" >> ~/.aws/config

הגדרת משימות קרון לגיבוי

# הפוך את סקריפטי הגיבוי להרצה
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-mongo.sh"
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-redis.sh"

# הוסף משימת קרון לגיבוי MongoDB (רץ מדי יום בחצות)
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-mongo.sh >> /var/log/mongo-backup.log 2>&1") | crontab -

# הוסף משימת קרון לגיבוי Redis (רץ מדי יום בחצות)
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-redis.sh >> /var/log/redis-backup.log 2>&1") | crontab -

# אמת שהמשימות נוספו
crontab -l

הגדר עדכונים אוטומטיים להתקנת Forward Email שלך:

# צור פקודת עדכון אוטומטי
DOCKER_UPDATE_CMD="docker compose -f $DOCKER_COMPOSE_FILE pull && docker compose -f $DOCKER_COMPOSE_FILE up -d"

# הוסף משימת קרון לעדכון אוטומטי (רץ מדי יום בשעה 1 בלילה)
(crontab -l 2>/dev/null; echo "0 1 * * * $DOCKER_UPDATE_CMD >> /var/log/autoupdate.log 2>&1") | crontab -

# אמת שהמשימה נוספה
crontab -l

מיקומי יומנים

• יומני Docker Compose: docker compose -f $DOCKER_COMPOSE_FILE logs
• יומני מערכת: /var/log/syslog
• יומני גיבוי: /var/log/mongo-backup.log, /var/log/redis-backup.log
• יומני עדכון אוטומטי: /var/log/autoupdate.log

משימות תחזוקה שוטפות

1. נטר את שטח הדיסק: df -h
2. בדוק מצב שירותים: docker compose -f $DOCKER_COMPOSE_FILE ps
3. סקור יומנים: docker compose -f $DOCKER_COMPOSE_FILE logs --tail=100
4. עדכן חבילות מערכת: apt update && apt upgrade
5. חדש תעודות: התעודות מתחדשות אוטומטית, אך יש לעקוב אחרי תוקפן

חידוש תעודה

התעודות אמורות להתחדש אוטומטית, אך ניתן לחדש ידנית במידת הצורך:

# חידוש תעודה ידני
certbot renew

# העתקת תעודות מחודשות
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"

# הפעל מחדש שירותים לשימוש בתעודות החדשות
docker compose -f "$DOCKER_COMPOSE_FILE" restart

בעיות נפוצות

1. שירות Docker לא מתחיל

# בדוק את מצב Docker
systemctl status docker

# נסה הפעלה חלופית
nohup dockerd >/dev/null 2>/dev/null &

2. יצירת תעודה נכשלת

• ודא שפורט 80 ו-443 נגישים
• אמת שרשומות ה-DNS מפנות לשרת שלך
• בדוק את הגדרות חומת האש

3. בעיות במסירת דואר אלקטרוני

• אמת שרשומות MX נכונות
• בדוק את רשומות SPF, DKIM ו-DMARC
• ודא שפורט 25 לא חסום על ידי ספק האירוח שלך

4. ממשק רשת לא נגיש

• בדוק את הגדרות חומת האש: ufw status
• אמת תעודות SSL: openssl x509 -in $SELF_HOST_DIR/ssl/fullchain.pem -text -noout
• בדוק את אישורי האימות הבסיסיים

קבלת עזרה

• תיעוד: https://forwardemail.net/self-hosted
• בעיות ב-GitHub: https://github.com/forwardemail/forwardemail.net/issues
• תמיכה קהילתית: בדוק את הדיונים בפרויקט ב-GitHub

1. שמור על המערכת מעודכנת: עדכן באופן קבוע את אובונטו והחבילות
2. נטר יומנים: הגדר ניטור והתראות ליומנים
3. גבה באופן קבוע: בדוק נהלי גיבוי ושחזור
4. השתמש בסיסמאות חזקות: צור סיסמאות חזקות לכל החשבונות
5. הפעל Fail2Ban: שקול להתקין fail2ban לאבטחה נוספת
6. בצע ביקורות אבטחה תקופתיות: סקור את ההגדרות שלך מעת לעת

התקנת Forward Email עצמאית שלך אמורה להיות כעת מלאה ופועלת על אובונטו. זכור:

1. הגדר את רשומות ה-DNS שלך כראוי
2. בדוק שליחת וקבלת דואר אלקטרוני
3. הגדר גיבויים קבועים
4. נטר את המערכת שלך באופן קבוע
5. שמור על ההתקנה שלך מעודכנת

לאפשרויות תצורה נוספות ותכונות מתקדמות, עיין בתיעוד הרשמי של Forward Email בכתובת https://forwardemail.net/self-hosted#configuration.