คู่มือนี้ให้คำแนะนำทีละขั้นตอนสำหรับการติดตั้งโซลูชันโฮสต์ด้วยตนเองของ Forward Email บนระบบ Ubuntu คู่มือนี้ออกแบบมาโดยเฉพาะสำหรับ Ubuntu เวอร์ชัน 20.04, 22.04 และ 24.04 LTS

ก่อนจะเริ่มการติดตั้ง ให้แน่ใจว่าคุณมี:

• เซิร์ฟเวอร์ Ubuntu: 20.04, 22.04 หรือ 24.04 LTS
• การเข้าถึงรูท: คุณต้องสามารถรันคำสั่งในฐานะ root ได้ (การเข้าถึง sudo)
• ชื่อโดเมน:โดเมนที่คุณควบคุมด้วยการเข้าถึงการจัดการ DNS
• เซิร์ฟเวอร์ที่สะอาด:ขอแนะนำให้ใช้การติดตั้ง Ubuntu ใหม่
• การเชื่อมต่ออินเตอร์เน็ต: จำเป็นสำหรับการดาวน์โหลดแพ็คเกจและภาพ Docker

• RAM: ขั้นต่ำ 2GB (แนะนำ 4GB สำหรับการผลิต)
• พื้นที่จัดเก็บ: พื้นที่ว่างขั้นต่ำ 20GB (แนะนำ 50GB+ สำหรับการผลิต)
• CPU: ขั้นต่ำ 1 vCPU (แนะนำ 2+ vCPU สำหรับการผลิต)
• เครือข่าย:ที่อยู่ 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: ติดตั้งระบบที่ขึ้นอยู่กับระบบ

ติดตั้งแพ็กเกจที่จำเป็นสำหรับการส่งต่ออีเมล:

# Update package list
apt-get update -y
Install basic dependencies
apt-get install -y 

ca-certificates 

curl 

gnupg 

git 

openssl 

docker-compose 

snapd

ขั้นตอนที่ 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

ขั้นตอนที่ 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

ขั้นตอนที่ 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

ขั้นตอนที่ 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

ขั้นตอนที่ 8: โคลนที่เก็บข้อมูลอีเมลไปข้างหน้า

ดาวน์โหลดซอร์สโค้ดการส่งต่ออีเมล:

# 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

ขั้นตอนที่ 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"

ขั้นตอนที่ 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

ตัวเลือก A: การท้าทาย DNS ด้วยตนเอง (แนะนำสำหรับผู้ใช้ส่วนใหญ่)

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

สำคัญเมื่อได้รับแจ้ง คุณจะต้องสร้างระเบียน TXT ใน DNS ของคุณ คุณอาจพบปัญหาหลายอย่างสำหรับโดเมนเดียวกัน สร้างทั้งหมดของพวกเขาอย่าลบรายการ TXT แรกเมื่อเพิ่มรายการที่สอง

ตัวเลือก B: 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/"

ขั้นตอนที่ 12: สร้างคีย์การเข้ารหัส

สร้างคีย์การเข้ารหัสต่างๆ ที่จำเป็นสำหรับการดำเนินการที่ปลอดภัย:

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

ขั้นตอนที่ 13: อัปเดตเส้นทาง 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"

ขั้นตอนที่ 14: ตั้งค่าการตรวจสอบสิทธิ์พื้นฐาน

สร้างข้อมูลประจำตัวการตรวจสอบพื้นฐานชั่วคราว:

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

ขั้นตอนที่ 15: ปรับใช้ด้วย Docker Compose

เริ่มต้นบริการส่งต่ออีเมล์ทั้งหมด:

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

ขั้นตอนที่ 16: ตรวจสอบการติดตั้ง

ตรวจสอบว่าบริการทั้งหมดทำงานอย่างถูกต้อง:

# Check Docker containers
docker ps
Check service logs for any errors
docker compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50
Test web interface connectivity
curl -I https://$DOMAIN
Check if ports are listening
netstat -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

สร้างบันทึก DNS DKIM:

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:

# 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

ตั้งค่าการอัปเดตอัตโนมัติสำหรับการติดตั้ง Forward Email ของคุณ:

# Create auto-update command
DOCKER_UPDATE_CMD="docker compose -f $DOCKER_COMPOSE_FILE pull && docker compose -f $DOCKER_COMPOSE_FILE up -d"
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

ตำแหน่งการบันทึก

• บันทึกการเขียน Docker: 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. การต่ออายุใบรับรอง:ใบรับรองจะต่ออายุอัตโนมัติ แต่ตรวจสอบวันหมดอายุ

การต่ออายุใบรับรอง

ใบรับรองควรจะต่ออายุโดยอัตโนมัติ แต่คุณสามารถต่ออายุด้วยตนเองได้หากจำเป็น:

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

ปัญหาทั่วไป

1. บริการ Docker ไม่สามารถเริ่มต้นได้

# Check Docker status
systemctl status docker
Try alternative startup
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. คอยอัปเดตระบบอยู่เสมอ:อัปเดต Ubuntu และแพ็กเกจเป็นประจำ
2. บันทึกการตรวจสอบ: ตั้งค่าการตรวจสอบและแจ้งเตือนบันทึก
3. สำรองข้อมูลเป็นประจำ: ทดสอบขั้นตอนการสำรองข้อมูลและกู้คืน
4. ใช้รหัสผ่านที่แข็งแกร่ง: สร้างรหัสผ่านที่แข็งแกร่งสำหรับบัญชีทั้งหมด
5. เปิดใช้งาน Fail2Ban:ควรพิจารณาติดตั้ง fail2ban เพื่อความปลอดภัยเพิ่มเติม
6. การตรวจสอบความปลอดภัยเป็นประจำ:ตรวจสอบการกำหนดค่าของคุณเป็นระยะๆ

ตอนนี้การติดตั้ง Forward Email แบบโฮสต์เองของคุณควรจะเสร็จสมบูรณ์และทำงานบน Ubuntu แล้ว โปรดจำไว้ว่า:

1. กำหนดค่าระเบียน DNS ของคุณอย่างถูกต้อง
2. ทดสอบการส่งและรับอีเมล์
3. ตั้งค่าการสำรองข้อมูลเป็นประจำ
4. ตรวจสอบระบบของคุณเป็นประจำ
5. อัปเดตการติดตั้งของคุณอยู่เสมอ

สำหรับตัวเลือกการกำหนดค่าเพิ่มเติมและคุณลักษณะขั้นสูง โปรดดูเอกสารการส่งต่ออีเมลอย่างเป็นทางการที่ https://forwardemail.net/self-hosted#configuration.