برای نصب وردپرس با 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 در فایل هست.





