دليل تثبيت استضافة البريد الإلكتروني الذاتية على أوبونتو

يوفر هذا الدليل تعليمات خطوة بخطوة لتثبيت حل Forward Email المستضاف ذاتيًا على أنظمة أوبونتو. هذا الدليل مخصص خصيصًا لإصدارات أوبونتو 20.04، 22.04، و24.04 LTS.

قبل بدء التثبيت، تأكد من أن لديك:

• خادم أوبونتو: 20.04، 22.04، أو 24.04 LTS
• وصول الجذر: يجب أن تكون قادرًا على تشغيل الأوامر كجذر (وصول sudo)
• اسم نطاق: نطاق تملكه مع إمكانية إدارة DNS
• خادم نظيف: يُنصح باستخدام تثبيت أوبونتو جديد
• اتصال بالإنترنت: مطلوب لتنزيل الحزم وصور Docker

• الذاكرة العشوائية (RAM): الحد الأدنى 2 جيجابايت (4 جيجابايت موصى بها للإنتاج)
• التخزين: مساحة متاحة لا تقل عن 20 جيجابايت (50 جيجابايت أو أكثر موصى بها للإنتاج)
• المعالج (CPU): 1 نواة افتراضية على الأقل (2 أو أكثر موصى بها للإنتاج)
• الشبكة: عنوان IP عام مع فتح المنافذ التالية:
  • 22 (SSH)
  • 25 (SMTP)
  • 80 (HTTP)
  • 443 (HTTPS)
  • 465 (SMTPS)
  • 993 (IMAPS)
  • 995 (POP3S)

الخطوة 1: الإعداد الأولي للنظام

أولاً، تأكد من تحديث نظامك وانتقل إلى مستخدم الجذر:

# تحديث حزم النظام
sudo apt update && sudo apt upgrade -y

# التبديل إلى مستخدم الجذر (مطلوب للتثبيت)
sudo su -

الخطوة 2: تكوين محللات DNS

قم بتكوين نظامك لاستخدام خوادم DNS الخاصة بـ Cloudflare لضمان توليد الشهادات بشكل موثوق:

# إيقاف وتعطيل systemd-resolved إذا كان يعمل
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

# تكوين محللات 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

الخطوة 3: تثبيت تبعيات النظام

قم بتثبيت الحزم المطلوبة لـ Forward Email:

# تحديث قائمة الحزم
apt-get update -y

# تثبيت التبعيات الأساسية
apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    git \
    openssl \
    docker-compose \
    snapd

الخطوة 4: تثبيت حزم Snap

قم بتثبيت AWS CLI و Certbot عبر snap:

# تثبيت AWS CLI
snap install aws-cli --classic

# تثبيت Certbot والإضافة الخاصة بـ DNS
snap install certbot --classic
snap set certbot trust-plugin-with-root=ok
snap install certbot-dns-cloudflare

الخطوة 5: تثبيت Docker

قم بتثبيت Docker CE و Docker Compose:

# إضافة مفتاح GPG الرسمي لـ Docker
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

# إضافة مستودع Docker
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

# تحديث فهرس الحزم وتثبيت Docker
apt-get update -y
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# التحقق من تثبيت Docker
docker --version
docker compose version

الخطوة 6: تكوين خدمة Docker

تأكد من أن Docker يبدأ تلقائيًا ويعمل:

# تمكين وبدء خدمة Docker
systemctl unmask docker
systemctl enable docker
systemctl start docker

# التحقق من تشغيل Docker
docker info

إذا فشل Docker في البدء، حاول تشغيله يدويًا:

# طريقة بدء بديلة إذا فشل systemctl
nohup dockerd >/dev/null 2>/dev/null &
sleep 5
docker info

الخطوة 7: تكوين جدار الحماية

قم بإعداد جدار الحماية UFW لتأمين الخادم الخاص بك:

# تعيين السياسات الافتراضية
ufw default deny incoming
ufw default allow outgoing

# السماح بالاتصال عبر SSH (مهم - لا تقفل نفسك!)
ufw allow 22/tcp

# السماح بالمنافذ المتعلقة بالبريد الإلكتروني
ufw allow 25/tcp    # SMTP
ufw allow 80/tcp    # HTTP (لـ 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 (منفذ بديل)
ufw allow 2995/tcp  # POP3 (منفذ بديل)
ufw allow 3456/tcp  # منفذ خدمة مخصص
ufw allow 4000/tcp  # منفذ خدمة مخصص
ufw allow 5000/tcp  # منفذ خدمة مخصص

# السماح بالاتصالات المحلية لقاعدة البيانات
ufw allow from 127.0.0.1 to any port 27017  # MongoDB
ufw allow from 127.0.0.1 to any port 6379   # Redis

# تفعيل جدار الحماية
echo "y" | ufw enable

# التحقق من حالة جدار الحماية
ufw status numbered

الخطوة 8: استنساخ مستودع Forward Email

قم بتنزيل شفرة مصدر Forward Email:

# إعداد المتغيرات
REPO_FOLDER_NAME="forwardemail.net"
REPO_URL="https://github.com/forwardemail/forwardemail.net.git"
ROOT_DIR="/root/$REPO_FOLDER_NAME"

# استنساخ المستودع
git clone "$REPO_URL" "$ROOT_DIR"
cd "$ROOT_DIR"

# التحقق من نجاح الاستنساخ
ls -la

الخطوة 9: إعداد تكوين البيئة

قم بتحضير تكوين البيئة:

# إعداد متغيرات الدليل
SELF_HOST_DIR="$ROOT_DIR/self-hosting"
ENV_FILE_DEFAULTS=".env.defaults"
ENV_FILE=".env"

# نسخ ملف البيئة الافتراضي
cp "$ROOT_DIR/$ENV_FILE_DEFAULTS" "$SELF_HOST_DIR/$ENV_FILE"

# إنشاء دليل SSL
mkdir -p "$SELF_HOST_DIR/ssl"

# إنشاء دلائل قواعد البيانات
mkdir -p "$SELF_HOST_DIR/sqlite-data"
mkdir -p "$SELF_HOST_DIR/mongo-backups"
mkdir -p "$SELF_HOST_DIR/redis-backups"

الخطوة 10: تكوين نطاقك

قم بتعيين اسم النطاق الخاص بك وتحديث متغيرات البيئة:

# استبدل 'yourdomain.com' بنطاقك الفعلي
DOMAIN="yourdomain.com"

# دالة لتحديث ملف البيئة
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_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
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.