نصب وردپرس با Docker Compose و MariaDB

برای نصب وردپرس با Docker Compose یک فایل compose.yaml می‌نویسید که دو سرویس دارد: دیتابیس MariaDB و وردپرس. با docker compose up -d هر دو اجرا می‌شوند، داده‌ها در Volume نگه داشته می‌شوند و سایت روی یک پورت محلی در دسترس است. بعد کافی است Nginx یا Caddy را جلوی آن بگذارید و SSL فعال کنید. این روش برای محیط آزمایشی، چند سایت کوچک روی یک سرور و جابه‌جایی آسان سایت مناسب است.

برای اجرا باید Docker و افزونه Compose روی سرور نصب باشد؛ نصب رسمی در مستندات Docker آمده است و خدمات کانتینری ما در خدمات Docker توضیح داده شده. اگر ترجیح می‌دهید وردپرس را مستقیم روی سرور نصب کنید، راه کلاسیک آن را در هاست وردپرس ببینید.

پیش‌نیازهای نصب وردپرس با Docker Compose

  • سرور Ubuntu یا Debian با دسترسی sudo
  • Docker و Docker Compose Plugin (دستور docker compose version باید کار کند)
  • دست‌کم 1 گیگابایت RAM (برای سایت کوچک)
  • یک دامنه یا زیردامنه که به IP سرور اشاره کند (برای انتشار عمومی)

مرحله اول: ساخت پوشه و فایل متغیرها

mkdir -p ~/wp-site && cd ~/wp-site
nano .env

محتوای .env (رمزها را با مقدار قوی و یکتا عوض کنید):

MYSQL_DATABASE=wordpress
MYSQL_USER=wpuser
MYSQL_PASSWORD=رمز-قوی-کاربر
MYSQL_ROOT_PASSWORD=رمز-قوی-روت

دسترسی فایل را محدود کنید: chmod 600 .env. این فایل را در Git یا جای عمومی نگذارید.

مرحله دوم: نوشتن compose.yaml برای وردپرس با Docker Compose

services:
  db:
    image: mariadb:11
    restart: unless-stopped
    environment:
      MARIADB_DATABASE: ${MYSQL_DATABASE}
      MARIADB_USER: ${MYSQL_USER}
      MARIADB_PASSWORD: ${MYSQL_PASSWORD}
      MARIADB_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 10

  wordpress:
    image: wordpress:php8.3-apache
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "127.0.0.1:8080:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_NAME: ${MYSQL_DATABASE}
      WORDPRESS_DB_USER: ${MYSQL_USER}
      WORDPRESS_DB_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - wp_data:/var/www/html

volumes:
  db_data:
  wp_data:

نکته‌ها:

  • پورت روی 127.0.0.1 منتشر شده تا مستقیم از اینترنت در دسترس نباشد و فقط از طریق پراکسی دیده شود.
  • restart: unless-stopped سرویس‌ها را بعد از راه‌اندازی مجدد سرور بالا می‌آورد.
  • Volumeها داده را نگه می‌دارند و با حذف کانتینر از بین نمی‌روند.
  • برچسب‌های تصویر (mariadb:11 و wordpress:php8.3-apache) نمونه‌اند؛ نسخه‌ها را از Docker Hub بررسی و مشخص کنید و latest را برای محیط تولید نگذارید.

مرحله سوم: اجرای نصب وردپرس با Docker Compose

docker compose up -d
docker compose ps
docker compose logs -f wordpress

بعد از چند ثانیه آدرس http://127.0.0.1:8080 روی خود سرور پاسخ می‌دهد. برای دیدن از بیرون، باید پراکسی بگذارید. بسته به نیاز می‌توانید در حالت آزمایشی پورت را موقت روی همه آدرس‌ها باز کنید، ولی پیش از انتشار عمومی از HTTPS استفاده کنید.

مرحله چهارم: پراکسی Nginx و SSL

نمونه Server Block:

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        client_max_body_size 64m;
    }
}

سپس گواهی را با Certbot بگیرید. توضیح پراکسی در Reverse Proxy چیست و گواهی در نصب SSL رایگان آمده است. پشت پراکسی HTTPS، وردپرس باید هدر X-Forwarded-Proto را بشناسد. در wp-config.php (از طریق متغیر WORDPRESS_CONFIG_EXTRA یا ویرایش فایل در Volume) اضافه کنید:

if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
    $_SERVER['HTTPS'] = 'on';
}

بکاپ از Volumeها

داده در دو Volume است: دیتابیس و فایل‌های وردپرس. برای بکاپ دیتابیس:

docker compose exec db sh -c 'mariadb-dump -u root -p"$MARIADB_ROOT_PASSWORD" --all-databases' > backup-$(date +%F).sql

برای فایل‌ها، Volume را با یک کانتینر موقت فشرده کنید:

docker run --rm -v wp-site_wp_data:/data -v "$PWD":/backup alpine tar czf /backup/wp-files-$(date +%F).tar.gz -C /data .

نام Volume با پیشوند نام پوشه پروژه ساخته می‌شود؛ با docker volume ls نام دقیق را ببینید. بکاپ را خارج از همان سرور هم نگه دارید و بازیابی را آزمایش کنید. برنامه کلی در بکاپ و بازیابی بحران آمده است.

به‌روزرسانی

docker compose pull
docker compose up -d
docker image prune

پیش از به‌روزرسانی از Volumeها بکاپ بگیرید. افزونه‌ها و هسته وردپرس را می‌توان از پیشخوان به‌روز کرد، ولی نسخه PHP و پایگاه داده با تغییر تصویر عوض می‌شوند؛ مطمئن شوید افزونه‌ها با آن سازگارند.

نکات امنیتی

  • رمزها را از .env بخوانید و آن را در مخزن کد نگذارید.
  • پورت دیتابیس را به بیرون منتشر نکنید (در فایل بالا اصلاً ports ندارد).
  • در Docker، قانون‌های UFW ممکن است دور زده شوند، چون Docker مستقیم iptables را تغییر می‌دهد. پورت‌ها را روی 127.0.0.1 ببندید و فقط پراکسی را به بیرون بدهید.
  • تصاویر را به‌طور منظم به‌روز کنید.

خطاهای رایج

نشانهعلت و راه حل
Error establishing a database connectionدیتابیس هنوز آماده نیست یا رمز در دو سرویس فرق دارد؛ docker compose logs db
نصب‌کننده وردپرس با دامنه عوض‌شده خراب می‌شودsiteurl و home در دیتابیس با آدرس جدید هماهنگ نیست
حلقه ریدایرکت پشت پراکسی HTTPSهدر X-Forwarded-Proto تنظیم نشده
آپلود فایل بزرگ خطا می‌دهدclient_max_body_size در Nginx و upload_max_filesize در PHP
داده بعد از docker compose down -v رفتگزینه -v Volumeها را حذف می‌کند؛ بدون آن بزنید
خطای دسترسی نوشتن در Volumeمالکیت فایل‌ها (کاربر www-data در تصویر)

سوالات متداول

آیا Docker برای سایت پرترافیک مناسب است؟

می‌تواند باشد، ولی نیاز به منابع، کش، بهینه‌سازی دیتابیس و پایش دارد. برای سایت بزرگ، معماری را با ارزیابی بار طراحی کنید.

فرق این روش و نصب مستقیم چیست؟

محیط قابل تکرار و جابه‌جایی است و چند سایت جدا دارد، ولی لایه اضافه‌ای (Docker) برای عیب‌یابی و دانش می‌خواهد.

چطور چند سایت روی یک سرور اجرا کنم؟

برای هر سایت یک پوشه و فایل compose جدا بسازید، پورت محلی متفاوت بدهید و در Nginx برای هر دامنه یک Server Block بنویسید.

بعد از ریبوت سایت بالا نمی‌آید

مطمئن شوید سرویس Docker فعال است (systemctl enable docker) و restart: unless-stopped در فایل هست.

منابع

پاسخی بگذارید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *