دليل تثبيت استضافة البريد الإلكتروني الذاتية لنظام Debian

ملخص

يقدم هذا الدليل تعليمات خطوة بخطوة لتثبيت حل Forward Email المُستضاف ذاتيًا على أنظمة Debian. صُمم هذا الدليل خصيصًا لإصداري Debian 11 (Bullseye) وDebian 12 (Bookworm).

المتطلبات الأساسية

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

خادم ديبيان: الإصدار 11 (Bullseye) أو 12 (Bookworm)
الوصول إلى الجذر:يجب أن تكون قادرًا على تشغيل الأوامر كجذر (sudo access)
اسم النطاق:المجال الذي تتحكم فيه باستخدام إمكانية الوصول إلى إدارة DNS
خادم نظيف:يوصى باستخدام تثبيت Debian جديد
اتصال بالإنترنت:مطلوب لتنزيل الحزم وصور 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: الإعداد الأولي للنظام

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

# 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

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

قم بتثبيت الحزم المطلوبة لإعادة توجيه البريد الإلكتروني على Debian:

# Update package list
apt-get update -y
Install basic dependencies (Debian-specific package list)
apt-get install -y 

ca-certificates 

curl 

gnupg 

git 

openssl 

lsb-release 

apt-transport-https 

software-properties-common

الخطوة 4: تثبيت Snapd وتكوينه

لا يتضمن Debian برنامج snapd بشكل افتراضي، لذا نحتاج إلى تثبيته وتكوينه:

# Install snapd apt-get install -y snapd Enable and start snapd service systemctl enable snapd systemctl start snapd Create symlink for snap to work properly ln -sf /var/lib/snapd/snap /snap Wait for snapd to be ready sleep 10 Verify snapd is working

snap version

الخطوة 5: تثبيت حزم 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 Verify installations

aws --version certbot --version

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

تثبيت Docker CE وDocker Compose على Debian:

# Add Docker's official GPG key (Debian-specific)
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | tee /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
Add Docker repository (Debian-specific)
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(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
Install standalone docker-compose as fallback (if plugin doesn't work)
if ! command -v docker-compose &> /dev/null; then
apt-get install -y docker-compose
fi
Verify Docker installation
docker --version
docker compose version || docker-compose --version

الخطوة 7: تكوين خدمة 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

الخطوة 8: تثبيت وتكوين جدار حماية UFW

قد لا تتضمن تثبيتات Debian الدنيا UFW، لذا قم بتثبيتها أولاً:

# Install UFW if not present if ! command -v ufw &> /dev/null; then apt-get update -y apt-get install -y ufw fi 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

الخطوة 9: استنساخ مستودع البريد الإلكتروني الأمامي

تنزيل كود مصدر البريد الإلكتروني الأمامي:

# 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

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

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

# 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"

الخطوة 11: تكوين المجال الخاص بك

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

# 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"

الخطوة 12: إنشاء شهادات SSL

الخيار أ: تحدي DNS اليدوي (موصى به لمعظم المستخدمين)

# Generate certificates using manual DNS challenge
certbot certonly \
  --manual \
  --agree-tos \
  --preferred-challenges dns \
  -d "*.$DOMAIN" \
  -d "$DOMAIN"

مهمعند مطالبتك بذلك، ستحتاج إلى إنشاء سجلات TXT في نظام أسماء النطاقات (DNS). قد تواجه تحديات متعددة لنفس النطاق. إنشاء جميعهم. لا تقم بإزالة سجل TXT الأول عند إضافة السجل الثاني.

الخيار ب: Cloudflare DNS (إذا كنت تستخدم Cloudflare)

إذا كان نطاقك يستخدم Cloudflare لـ DNS، فيمكنك أتمتة إنشاء الشهادة:

# Create Cloudflare credentials file cat > /root/.cloudflare.ini <<EOF dns_cloudflare_email = "your-email@example.com" dns_cloudflare_api_key = "your-cloudflare-global-api-key" EOF Set proper permissions chmod 600 /root/.cloudflare.ini Generate certificates automatically

certbot certonly --dns-cloudflare --dns-cloudflare-credentials /root/.cloudflare.ini -d "$DOMAIN" -d "*.$DOMAIN" --non-interactive --agree-tos --email "your-email@example.com"

نسخ الشهادات

بعد إنشاء الشهادة، انسخها إلى دليل التطبيق:

# Copy certificates to application SSL directory cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/" Verify certificates were copied

ls -la "$SELF_HOST_DIR/ssl/"

الخطوة 13: إنشاء مفاتيح التشفير

إنشاء مفاتيح التشفير المختلفة المطلوبة للتشغيل الآمن:

# Generate helper encryption key
helper_encryption_key=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "HELPER_ENCRYPTION_KEY" "$helper_encryption_key"
Generate SRS secret for email forwarding
srs_secret=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "SRS_SECRET" "$srs_secret"
Generate TXT encryption key
txt_encryption_key=$(openssl rand -hex 16)
update_env_file "TXT_ENCRYPTION_KEY" "$txt_encryption_key"
Generate DKIM private key for email signing
openssl genrsa -f4 -out "$SELF_HOST_DIR/ssl/dkim.key" 2048
update_env_file "DKIM_PRIVATE_KEY_PATH" "/app/ssl/dkim.key"
Generate webhook signature key
webhook_signature_key=$(openssl rand -hex 16)
update_env_file "WEBHOOK_SIGNATURE_KEY" "$webhook_signature_key"
Set SMTP transport password
update_env_file "SMTP_TRANSPORT_PASS" "$(openssl rand -base64 32)"
echo "✅ All encryption keys generated successfully"

الخطوة 14: تحديث مسارات SSL في التكوين

قم بتكوين مسارات شهادة SSL في ملف البيئة:

# Update SSL paths to point to the correct certificate files
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"

الخطوة 15: إعداد المصادقة الأساسية

إنشاء بيانات اعتماد المصادقة الأساسية المؤقتة:

# Generate a secure random password
PASSWORD=$(openssl rand -base64 16)
Update environment file with basic auth credentials
update_env_file "AUTH_BASIC_USERNAME" "admin"
update_env_file "AUTH_BASIC_PASSWORD" "$PASSWORD"
Display credentials (save these!)
echo ""
echo "🔐 IMPORTANT: Save these login credentials!"
echo "=================================="
echo "Username: admin"
echo "Password: $PASSWORD"
echo "=================================="
echo ""
echo "You'll need these to access the web interface after installation."
echo ""

الخطوة 16: النشر باستخدام Docker Compose

ابدأ جميع خدمات إعادة توجيه البريد الإلكتروني:

# Set Docker Compose file path DOCKER_COMPOSE_FILE="$SELF_HOST_DIR/docker-compose-self-hosted.yml" Stop any existing containers if command -v docker-compose &> /dev/null; then docker-compose -f "$DOCKER_COMPOSE_FILE" down else docker compose -f "$DOCKER_COMPOSE_FILE" down fi Pull the latest images if command -v docker-compose &> /dev/null; then docker-compose -f "$DOCKER_COMPOSE_FILE" pull else docker compose -f "$DOCKER_COMPOSE_FILE" pull fi Start all services in detached mode if command -v docker-compose &> /dev/null; then docker-compose -f "$DOCKER_COMPOSE_FILE" up -d else docker compose -f "$DOCKER_COMPOSE_FILE" up -d fi Wait a moment for services to start sleep 10 Check service status

if command -v docker-compose &> /dev/null; then docker-compose -f "$DOCKER_COMPOSE_FILE" ps else docker compose -f "$DOCKER_COMPOSE_FILE" ps fi

الخطوة 17: التحقق من التثبيت

تأكد من تشغيل جميع الخدمات بشكل صحيح:

# Check Docker containers
docker ps
Check service logs for any errors
if command -v docker-compose &> /dev/null; then
docker-compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50
else
docker compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50
fi
Test web interface connectivity
curl -I https://$DOMAIN
Check if ports are listening
ss -tlnp | grep -E ':(25|80|443|465|587|993|995)'

تكوين ما بعد التثبيت

إعداد سجلات DNS

يجب عليك تكوين سجلات DNS التالية لنطاقك:

سجل MX

@ MX 10 mx.yourdomain.com

سجلات أ

@ 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 العام الخاص بك:

# Extract DKIM public key
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"

افتح متصفح الويب الخاص بك وانتقل إلى https://yourdomain.com
أدخل بيانات اعتماد المصادقة الأساسية التي قمت بحفظها مسبقًا
أكمل معالج الإعداد الأولي
إنشاء حساب البريد الإلكتروني الأول الخاص بك

تكوين النسخ الاحتياطي

إعداد النسخ الاحتياطي المتوافق مع S3

تكوين النسخ الاحتياطية التلقائية للتخزين المتوافق مع S3:

# Create AWS credentials directory
mkdir -p ~/.aws
Configure AWS credentials
cat > ~/.aws/credentials <<EOF
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
EOF
Configure AWS settings
cat > ~/.aws/config <<EOF
[default]
region = auto
output = json
EOF
For non-AWS S3 (like Cloudflare R2), add endpoint URL
echo "endpoint_url = YOUR_S3_ENDPOINT_URL" >> ~/.aws/config

إعداد مهام النسخ الاحتياطي Cron

# Make backup scripts executable
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-mongo.sh"
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-redis.sh"
Add MongoDB backup cron job (runs daily at midnight)
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-mongo.sh >> /var/log/mongo-backup.log 2>&1") | crontab -
Add Redis backup cron job (runs daily at midnight)
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-redis.sh >> /var/log/redis-backup.log 2>&1") | crontab -
Verify cron jobs were added
crontab -l

تكوين التحديث التلقائي

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

# Create auto-update command (use appropriate docker compose command)
if command -v docker-compose &> /dev/null; then
    DOCKER_UPDATE_CMD="docker-compose -f $DOCKER_COMPOSE_FILE pull && docker-compose -f $DOCKER_COMPOSE_FILE up -d"
else
    DOCKER_UPDATE_CMD="docker compose -f $DOCKER_COMPOSE_FILE pull && docker compose -f $DOCKER_COMPOSE_FILE up -d"
fi
Add auto-update cron job (runs daily at 1 AM)
(crontab -l 2>/dev/null; echo "0 1 * * * $DOCKER_UPDATE_CMD >> /var/log/autoupdate.log 2>&1") | crontab -
Verify the cron job was added
crontab -l

اعتبارات خاصة بدبيان

اختلافات إدارة الحزم

سناب:لم يتم تثبيته افتراضيًا على Debian، ويتطلب التثبيت اليدوي
عامل ميناء:يستخدم مستودعات خاصة بـ Debian ومفاتيح GPG
UFW:قد لا يتم تضمينها في تثبيتات Debian البسيطة
نظام:قد يختلف السلوك قليلاً عن Ubuntu

إدارة الخدمة

# Check service status (Debian-specific commands) systemctl status snapd systemctl status docker systemctl status ufw Restart services if needed

systemctl restart snapd systemctl restart docker

تكوين الشبكة

قد يكون لدى Debian أسماء أو تكوينات مختلفة لواجهة الشبكة:

# Check network interfaces ip addr show Check routing ip route show Check DNS resolution

nslookup google.com

الصيانة والمراقبة

مواقع السجلات

سجلات Docker Compose:استخدم أمر docker compose المناسب بناءً على التثبيت
سجلات النظام: /var/log/syslog
سجلات النسخ الاحتياطي: /var/log/mongo-backup.log, /var/log/redis-backup.log
سجلات التحديث التلقائي: /var/log/autoupdate.log
سجلات Snapd: journalctl -u snapd

مهام الصيانة الدورية

مراقبة مساحة القرص: df -h
التحقق من حالة الخدمة:استخدم أمر docker compose المناسب
سجلات المراجعة:تحقق من سجلات التطبيق والنظام
تحديث حزم النظام: apt update && apt upgrade
مراقبة snapd: snap list و snap refresh

تجديد الشهادة

يجب أن يتم تجديد الشهادات تلقائيًا، ولكن يمكنك تجديدها يدويًا إذا لزم الأمر:

# Manual certificate renewal certbot renew Copy renewed certificates cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/" Restart services to use new certificates

if command -v docker-compose &> /dev/null; then docker-compose -f "$DOCKER_COMPOSE_FILE" restart else docker compose -f "$DOCKER_COMPOSE_FILE" restart fi

استكشاف الأخطاء وإصلاحها

المشكلات الخاصة بـ Debian

1. Snapd لا يعمل

# Check snapd status
systemctl status snapd
Restart snapd
systemctl restart snapd
Check snap path
echo $PATH | grep snap
Add snap to PATH if missing
echo 'export PATH=$PATH:/snap/bin' >> ~/.bashrc
source ~/.bashrc

2. لم يتم العثور على أمر Docker Compose

# Check which docker compose command is available command -v docker-compose command -v docker Use the appropriate command in scripts

if command -v docker-compose &> /dev/null; then echo "Using docker-compose" else echo "Using docker compose" fi

3. مشاكل تثبيت الحزمة

# Update package cache
apt update
Fix broken packages
apt --fix-broken install
Check for held packages
apt-mark showhold

القضايا الشائعة

1. خدمة Docker لن تبدأ

# Check Docker status systemctl status docker Check Docker logs journalctl -u docker Try alternative startup

nohup dockerd >/dev/null 2>/dev/null &

2. فشل إنشاء الشهادة

تأكد من إمكانية الوصول إلى المنفذين 80 و443
التحقق من أن سجلات DNS تشير إلى الخادم الخاص بك
تحقق من إعدادات جدار الحماية باستخدام ufw status

3. مشاكل تسليم البريد الإلكتروني

التحقق من صحة سجلات MX
التحقق من سجلات SPF وDKIM وDMARC
تأكد من عدم حظر المنفذ 25 بواسطة مزود الاستضافة الخاص بك

الحصول على المساعدة

التوثيق: https://forwardemail.net/self-hosted
مشاكل GitHub: https://github.com/forwardemail/forwardemail.net/issues
وثائق ديبيان: https://www.debian.org/doc/

أفضل ممارسات الأمان

حافظ على تحديث النظام:تحديث ديبيان والحزم بشكل منتظم
سجلات المراقبة:إعداد مراقبة السجل والتنبيه
النسخ الاحتياطي بانتظام:اختبار إجراءات النسخ الاحتياطي والاستعادة
استخدم كلمات مرور قوية:إنشاء كلمات مرور قوية لجميع الحسابات
تمكين Fail2Ban:فكر في تثبيت fail2ban لمزيد من الأمان
عمليات تدقيق أمنية منتظمة:راجع تكوينك بشكل دوري
مراقبة Snapd:حافظ على تحديث حزم Snap مع snap refresh

خاتمة

يجب أن يكون تثبيت Forward Email المُستضاف ذاتيًا جاهزًا للعمل على Debian. تذكر:

قم بتكوين سجلات DNS الخاصة بك بشكل صحيح
اختبار إرسال واستقبال البريد الإلكتروني
إعداد النسخ الاحتياطية المنتظمة
راقب نظامك بانتظام
حافظ على تحديث التثبيت الخاص بك
مراقبة snapd وحزم snap

الفرق الرئيسي بين أوبونتو وأوبونتو هو تثبيت Snapd وتكوين مستودع Docker. بعد إعدادهما بشكل صحيح، يعمل تطبيق إعادة توجيه البريد الإلكتروني بشكل متطابق على كلا النظامين.

للحصول على خيارات تكوين إضافية وميزات متقدمة، راجع وثائق إعادة توجيه البريد الإلكتروني الرسمية على https://forwardemail.net/self-hosted#configuration.

دليل تثبيت استضافة البريد الإلكتروني الذاتية لنظام Debian

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

Switch to root user (required for the installation)

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

Configure Cloudflare DNS resolvers

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

Install basic dependencies (Debian-specific package list)

الخطوة 4: تثبيت Snapd وتكوينه

Enable and start snapd service

Create symlink for snap to work properly

Wait for snapd to be ready

Verify snapd is working

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

Install Certbot and DNS plugin

Verify installations

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

Add Docker repository (Debian-specific)

Update package index and install Docker

Install standalone docker-compose as fallback (if plugin doesn't work)

Verify Docker installation

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

Verify Docker is running

الخطوة 8: تثبيت وتكوين جدار حماية UFW

Set default policies

Allow SSH (important - don't lock yourself out!)

Allow email-related ports

Allow local database connections

Enable firewall

Check firewall status

الخطوة 9: استنساخ مستودع البريد الإلكتروني الأمامي

Clone the repository

Verify the clone was successful

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

Copy default environment file

Create SSL directory

Create database directories

الخطوة 11: تكوين المجال الخاص بك

Function to update environment file

Update domain-related environment variables

الخطوة 12: إنشاء شهادات SSL

الخيار أ: تحدي DNS اليدوي (موصى به لمعظم المستخدمين)

الخيار ب: Cloudflare DNS (إذا كنت تستخدم Cloudflare)

Set proper permissions

Generate certificates automatically

نسخ الشهادات

Verify certificates were copied

الخطوة 13: إنشاء مفاتيح التشفير

Generate SRS secret for email forwarding

Generate TXT encryption key

Generate DKIM private key for email signing

Generate webhook signature key

Set SMTP transport password

الخطوة 14: تحديث مسارات SSL في التكوين

الخطوة 15: إعداد المصادقة الأساسية

Update environment file with basic auth credentials

Display credentials (save these!)

الخطوة 16: النشر باستخدام Docker Compose

Stop any existing containers

Pull the latest images

Start all services in detached mode

Wait a moment for services to start

Check service status

الخطوة 17: التحقق من التثبيت

Check service logs for any errors

Test web interface connectivity

Check if ports are listening

إعداد سجلات DNS

سجل MX

سجلات أ

سجل SPF

سجلات DKIM

سجل DMARC

تسجيل الدخول الأول

إعداد النسخ الاحتياطي المتوافق مع S3

Configure AWS credentials

Configure AWS settings

For non-AWS S3 (like Cloudflare R2), add endpoint URL

إعداد مهام النسخ الاحتياطي Cron

Add MongoDB backup cron job (runs daily at midnight)

Add Redis backup cron job (runs daily at midnight)