Docker Compose — deploy WordPress + MySQL + NGINX 1 lệnh

Vì sao cần Docker Compose ngay? — Quản lý multi-container app chưa bao giờ dễ đến thế

Việc deploy một ứng dụng phức tạp với nhiều thành phần (như WordPress với database và web server riêng) thủ công tốn rất nhiều thời gian và công sức. Mỗi lần thay đổi cấu hình hay di chuyển môi trường là một cơn ác mộng. Docker Compose ra đời để giải quyết triệt để vấn đề này.

😩 Thiết lập thủ công tốn thời gian: Cài đặt, cấu hình từng service riêng lẻ.
📦 Quản lý dependency phức tạp: Đảm bảo các service hoạt động đúng với nhau.
🔄 Khó khăn khi di chuyển môi trường: Cấu hình khác nhau giữa dev, staging, prod.
🐛 Debug lỗi liên quan đến kết nối: Tìm nguyên nhân khi các service không “nói chuyện” được.
🚀 Triển khai chậm: Mỗi lần update là một quy trình dài.

Tóm gọn: Docker Compose là gì? — Công cụ định nghĩa và chạy ứng dụng multi-container

Docker Compose là một công cụ giúp bạn định nghĩa và quản lý các ứng dụng Docker multi-container. Bạn sử dụng một file docker-compose.yml để cấu hình tất cả các dịch vụ của ứng dụng, sau đó chỉ với một lệnh duy nhất, bạn có thể khởi tạo, chạy, dừng và xây dựng lại tất cả các dịch vụ đó.

File `docker-compose.yml` — Ngôn ngữ của Docker Compose

File docker-compose.yml là trái tim của Docker Compose. Nó sử dụng cú pháp YAML để mô tả các dịch vụ, mạng và volume cần thiết cho ứng dụng của bạn.

version: '3.8'

services:
  db:
    image: mysql:8.0
    container_name: mysql_db
    volumes:
      - db_data:/var/lib/mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: your_strong_root_password
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress_user
      MYSQL_PASSWORD: your_wordpress_password
    networks:
      - app_network

  wordpress:
    depends_on:
      - db
    image: wordpress:latest
    container_name: wordpress_app
    ports:
      - "8080:80"
    restart: always
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress_user
      WORDPRESS_DB_PASSWORD: your_wordpress_password
      WORDPRESS_DB_NAME: wordpress
    networks:
      - app_network

networks:
  app_network:
    driver: bridge

volumes:
  db_data:

version: Chỉ định phiên bản của cú pháp Docker Compose. 3.8 là phiên bản phổ biến và hỗ trợ nhiều tính năng mới.
services: Định nghĩa các container (dịch vụ) của ứng dụng.
- db: Tên của dịch vụ database (MySQL).
  - image: Sử dụng image mysql:8.0 từ Docker Hub.
  - container_name: Đặt tên cố định cho container.
  - volumes: Mount một volume tên là db_data để lưu trữ dữ liệu database.
  - restart: always: Tự động khởi động lại container khi nó bị dừng hoặc khi Docker daemon khởi động.
  - environment: Thiết lập các biến môi trường cần thiết cho MySQL (root password, database name, user, password).
  - networks: Kết nối service này vào network app_network.
- wordpress: Tên của dịch vụ WordPress.
  - depends_on: Đảm bảo dịch vụ db được khởi động trước dịch vụ wordpress.
  - image: Sử dụng image wordpress:latest từ Docker Hub.
  - container_name: Đặt tên cố định cho container.
  - ports: Map port 8080 trên máy host tới port 80 trong container WordPress.
  - restart: always: Tự động khởi động lại.
  - environment: Thiết lập các biến môi trường cho WordPress để kết nối tới database.
  - networks: Kết nối service này vào network app_network.
networks: Định nghĩa các network mà các service sẽ sử dụng. app_network là một network bridge tùy chỉnh, giúp các container giao tiếp với nhau.
volumes: Định nghĩa các volume để lưu trữ dữ liệu. db_data sẽ được Docker quản lý.

💡 Mẹo: Luôn sử dụng mật khẩu mạnh cho database và các biến môi trường nhạy cảm khác. Bạn có thể cân nhắc sử dụng file .env để quản lý các biến này.

Tóm gọn: Cài đặt Docker và Docker Compose — Chuẩn bị môi trường

Trước khi sử dụng Docker Compose, bạn cần cài đặt Docker Engine và Docker Compose trên hệ thống của mình. Hướng dẫn này giả định bạn đang sử dụng Ubuntu 22.04/24.04.

Cài đặt Docker Engine

Cập nhật danh sách gói:
bash sudo apt update sudo apt upgrade -y
Cài đặt các gói cần thiết:
bash sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
Thêm GPG key chính thức của Docker:
bash curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
Thêm kho lưu trữ Docker:
bash echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Cài đặt Docker Engine:
bash sudo apt update sudo apt install docker-ce docker-ce-cli containerd.io -y
Kiểm tra cài đặt Docker:
bash sudo systemctl status docker
Bạn sẽ thấy active (running).
Cho phép người dùng không phải root chạy lệnh Docker (tùy chọn):
bash sudo usermod -aG docker $USER newgrp docker
Sau lệnh newgrp docker, bạn cần mở một terminal mới hoặc chạy bash để áp dụng thay đổi.

Cài đặt Docker Compose

Docker Compose đã được tích hợp vào Docker Desktop trên Windows/macOS. Tuy nhiên, trên Linux, bạn thường cần cài đặt nó riêng.

Tải xuống phiên bản Docker Compose mới nhất:
bash sudo curl -L "https://github.com/docker/compose/releases/download/v2.27.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
(Lưu ý: Thay v2.27.0 bằng phiên bản mới nhất nếu có)
Áp dụng quyền thực thi:
bash sudo chmod +x /usr/local/bin/docker-compose
Kiểm tra phiên bản Docker Compose:
bash docker-compose --version
Output mẫu:
Docker Compose version v2.27.0

⚠️ Cảnh báo: Đảm bảo bạn tải đúng phiên bản Docker Compose cho kiến trúc hệ thống của mình. Nếu không, lệnh docker-compose có thể không hoạt động.

Tóm gọn: Deploy WordPress + MySQL + NGINX với 1 lệnh duy nhất

Sau khi đã chuẩn bị xong môi trường, việc deploy ứng dụng WordPress chỉ còn là vấn đề của một vài bước đơn giản.

Tạo thư mục dự án:
bash mkdir my-wordpress-app cd my-wordpress-app
Tạo file docker-compose.yml:
Tạo một file tên là docker-compose.yml trong thư mục my-wordpress-app và dán nội dung đã cung cấp ở phần trước vào đó.
bash nano docker-compose.yml
(Dán nội dung YAML vào và lưu file)
Khởi tạo và chạy các dịch vụ:
Trong thư mục chứa file docker-compose.yml, chạy lệnh sau:
bash docker-compose up -d
- up: Lệnh này sẽ tạo và khởi động các container dựa trên file docker-compose.yml.
- -d: Chạy các container ở chế độ nền (detached mode), không chiếm giữ terminal.
Docker sẽ tải về các image cần thiết (nếu chưa có) và khởi tạo các container. Quá trình này có thể mất vài phút tùy thuộc vào tốc độ mạng của bạn.
Kiểm tra trạng thái các container:
bash docker ps
Output mẫu:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES a1b2c3d4e5f6 wordpress:latest "docker-entrypoint.s…" 5 seconds ago Up 4 seconds 0.0.0.0:8080->80/tcp wordpress_app f7e6d5c4b3a2 mysql:8.0 "docker-entrypoint.s…" 10 seconds ago Up 9 seconds 3306/tcp, 33060/tcp mysql_db
Bạn sẽ thấy cả hai container (wordpress_app và mysql_db) đang chạy (Up).
Truy cập WordPress:
Mở trình duyệt web và truy cập vào địa chỉ http://localhost:8080 (hoặc http://<IP_CUA_MAY_CHUT>/:8080 nếu bạn chạy trên VPS). Bạn sẽ thấy màn hình cài đặt WordPress.

💡 Mẹo: Nếu bạn muốn xem log của các container, bạn có thể dùng lệnh docker-compose logs -f. Dấu -f sẽ theo dõi log theo thời gian thực.

Tóm gọn: Cấu hình NGINX làm Reverse Proxy (Nâng cao)

Mặc dù WordPress có thể chạy trực tiếp trên port 80, việc sử dụng NGINX làm reverse proxy mang lại nhiều lợi ích như SSL termination, caching, load balancing và bảo mật tốt hơn.

Thêm NGINX vào `docker-compose.yml`

Chúng ta sẽ thêm một dịch vụ NGINX vào file docker-compose.yml và cấu hình nó để chuyển tiếp request tới container WordPress.

version: '3.8'

services:
  db:
    image: mysql:8.0
    container_name: mysql_db
    volumes:
      - db_data:/var/lib/mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: your_strong_root_password
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress_user
      MYSQL_PASSWORD: your_wordpress_password
    networks:
      - app_network

  wordpress:
    depends_on:
      - db
    image: wordpress:latest
    container_name: wordpress_app
    # Bỏ port mapping ở đây vì NGINX sẽ expose port 80
    # ports:
    #   - "8080:80"
    restart: always
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress_user
      WORDPRESS_DB_PASSWORD: your_wordpress_password
      WORDPRESS_DB_NAME: wordpress
    networks:
      - app_network

  nginx:
    image: nginx:latest
    container_name: nginx_proxy
    ports:
      - "80:80" # Map port 80 của host tới port 80 của NGINX
      - "443:443" # Map port 443 của host tới port 443 của NGINX
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d # Mount thư mục cấu hình NGINX
      # - ./nginx/ssl:/etc/nginx/ssl # Mount thư mục chứa SSL certificate (nếu có)
    depends_on:
      - wordpress
    restart: always
    networks:
      - app_network

networks:
  app_network:
    driver: bridge

volumes:
  db_data:

Tạo file cấu hình NGINX

Tạo thư mục cấu hình NGINX:
bash mkdir -p nginx/conf.d

Tạo file cấu hình NGINX (nginx/conf.d/default.conf):
bash nano nginx/conf.d/default.conf
Dán nội dung sau vào file:
“`nginx
server {
listen 80;
server_name your_domain.com www.your_domain.com; # Thay bằng domain của bạn hoặc IP

location / {
    proxy_pass http://wordpress:80; # Chuyển tiếp request tới container wordpress
    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;
}

# Cấu hình cho SSL (nếu có)
# listen 443 ssl;
# ssl_certificate /etc/nginx/ssl/your_domain.com.crt;
# ssl_certificate_key /etc/nginx/ssl/your_domain.com.key;
# include /etc/nginx/options-ssl-nginx.conf;
# ssl_dhparam /etc/nginx/ssl/ssl-dhparams.pem;

# location / {
#     proxy_pass http://wordpress:80;
#     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;
# }

}
`` *listen 80;: NGINX lắng nghe trên port 80. *server_name your_domain.com www.your_domain.com;: Thay thế bằng tên miền hoặc địa chỉ IP của VPS của bạn. *location /: Định nghĩa cách xử lý các request tới gốc (/). *proxy_pass http://wordpress:80;: Chuyển tiếp request tới dịch vụwordpresstrên port 80. Docker Compose sẽ tự động phân giải tênwordpressthành IP nội bộ của container. *proxy_set_header …`: Chuyển tiếp thông tin quan trọng của request gốc tới backend (WordPress).

Chạy lại Docker Compose:
bash docker-compose up -d
Docker Compose sẽ xây dựng lại image NGINX (nếu cần) và khởi động container NGINX.
Truy cập WordPress qua NGINX:
Bây giờ, bạn truy cập http://<IP_CUA_MAY_CHUT> hoặc http://your_domain.com (thay thế bằng tên miền/IP thực tế của bạn).

💡 Mẹo: Để cấu hình SSL, bạn cần tạo hoặc tải chứng chỉ SSL lên server và mount vào thư mục /etc/nginx/ssl trong container NGINX, sau đó bỏ comment và cập nhật các dòng cấu hình SSL trong default.conf.

Tóm gọn: Quản lý ứng dụng với các lệnh Docker Compose

Docker Compose cung cấp một bộ lệnh mạnh mẽ để quản lý toàn bộ vòng đời của ứng dụng multi-container.

Khởi động ứng dụng

Chạy ở chế độ nền:
bash docker-compose up -d
Chạy ở chế độ foreground (xem log trực tiếp):
bash docker-compose up
Nhấn Ctrl+C để dừng.

Dừng và xóa ứng dụng

Dừng tất cả các container, mạng, volume và image:
bash docker-compose down
Dừng container nhưng giữ lại mạng và volume:
bash docker-compose stop
Xóa container và mạng (giữ lại volume):
bash docker-compose rm
Lệnh này sẽ hỏi xác nhận trước khi xóa. Thêm cờ -f để xóa không cần xác nhận.

Xem trạng thái và log

Liệt kê các container đang chạy:
bash docker-compose ps
Xem log của tất cả các dịch vụ:
bash docker-compose logs
Theo dõi log theo thời gian thực:
bash docker-compose logs -f
Xem log của một dịch vụ cụ thể (ví dụ: wordpress):
bash docker-compose logs wordpress

Xây dựng lại image

Xây dựng lại image từ Dockerfile (nếu có):
bash docker-compose build
Xây dựng lại image và bỏ qua cache:
bash docker-compose build --no-cache

Các lệnh hữu ích khác

Kiểm tra cấu hình file docker-compose.yml:
bash docker-compose config
Chạy một lệnh trong container:
bash docker-compose exec wordpress bash
Lệnh này sẽ mở một shell bash bên trong container wordpress.

⚠️ Cảnh báo: Lệnh docker-compose down sẽ xóa các container và mạng. Nếu bạn muốn giữ lại dữ liệu của database, hãy đảm bảo volume db_data không bị xóa hoặc bạn đã sao lưu dữ liệu trước đó.

Pitfalls & lỗi thường gặp

Lỗi kết nối database (Error establishing a database connection)
- Nguyên nhân: Biến môi trường WORDPRESS_DB_HOST, WORDPRESS_DB_USER, WORDPRESS_DB_PASSWORD, WORDPRESS_DB_NAME trong docker-compose.yml bị sai, hoặc dịch vụ db chưa chạy khi wordpress khởi động.
- Cách fix:
  - Kiểm tra kỹ các biến môi trường.
  - Đảm bảo depends_on: - db được thiết lập đúng cho dịch vụ wordpress.
  - Chạy docker-compose up -d lại để khởi động lại các dịch vụ.
  - Kiểm tra log của cả hai container (docker-compose logs db và docker-compose logs wordpress).
WordPress không truy cập được (404, 502, 503)
- Nguyên nhân: Cấu hình NGINX sai, port mapping không đúng, hoặc container WordPress bị lỗi.
- Cách fix:
  - Kiểm tra port mapping trong docker-compose.yml (host port và container port).
  - Kiểm tra file cấu hình NGINX (nginx/conf.d/default.conf), đảm bảo proxy_pass trỏ đúng tới tên dịch vụ wordpress và port của nó.
  - Kiểm tra log của container NGINX (docker-compose logs nginx) và WordPress.
Lỗi “Cannot connect to the Docker daemon”
- Nguyên nhân: Docker daemon không chạy, hoặc người dùng hiện tại không có quyền truy cập Docker.
- Cách fix:
  - Khởi động Docker daemon: sudo systemctl start docker.
  - Kiểm tra trạng thái: sudo systemctl status docker.
  - Nếu bạn chưa thêm người dùng vào nhóm docker, hãy chạy lại lệnh sudo usermod -aG docker $USER và mở lại terminal hoặc chạy newgrp docker.
Lỗi phiên bản Docker Compose (command not found: docker-compose)
- Nguyên nhân: Docker Compose chưa được cài đặt hoặc không nằm trong PATH của hệ thống.
- Cách fix:
  - Kiểm tra lại các bước cài đặt Docker Compose.
  - Đảm bảo bạn đã thực thi sudo chmod +x /usr/local/bin/docker-compose.
  - Thử chạy bằng docker compose (với khoảng trắng) thay vì docker-compose (nếu bạn cài phiên bản mới hơn được tích hợp vào CLI Docker).

Key takeaways

Docker Compose đơn giản hóa việc quản lý các ứng dụng multi-container bằng cách sử dụng file docker-compose.yml.
Một file docker-compose.yml có thể định nghĩa các dịch vụ, mạng, volume và cấu hình liên quan.
Lệnh docker-compose up -d là “cứu cánh” để khởi động toàn bộ ứng dụng chỉ với một thao tác.
NGINX có thể dễ dàng được tích hợp làm reverse proxy, cung cấp các tính năng nâng cao như SSL và caching.
Các lệnh như down, ps, logs giúp quản lý và gỡ lỗi ứng dụng một cách hiệu quả.

FAQ

### Docker Compose có cần cài đặt riêng không?

Trên Linux, bạn cần cài đặt Docker Compose riêng. Tuy nhiên, trên Docker Desktop (Windows/macOS), nó thường đi kèm sẵn.

### Tôi có thể chạy nhiều trang WordPress trên cùng một server bằng Docker Compose không?

Có, bạn có thể tạo nhiều thư mục dự án, mỗi thư mục có file docker-compose.yml riêng, và cấu hình port mapping khác nhau để chạy nhiều trang WordPress độc lập.

### Làm thế nào để backup dữ liệu WordPress và MySQL?

Đối với MySQL, bạn có thể sử dụng volume. Để backup, bạn có thể truy cập vào container MySQL và chạy lệnh mysqldump hoặc sao chép dữ liệu từ volume db_data trên host. Đối với file uploads của WordPress, bạn cần backup thư mục /var/www/html/wp-content bên trong container WordPress hoặc mount một volume riêng cho nó.

### Tôi có thể dùng image Docker khác cho MySQL hoặc WordPress không?

Chắc chắn rồi. Bạn chỉ cần thay đổi tên image trong docker-compose.yml sang image bạn muốn sử dụng (ví dụ: mariadb:latest thay vì mysql:8.0).

### Cờ `-d` trong `docker-compose up -d` có ý nghĩa gì?

Cờ -d viết tắt của “detached mode”, có nghĩa là các container sẽ chạy ở chế độ nền, không chiếm giữ terminal của bạn. Điều này cho phép bạn tiếp tục sử dụng terminal cho các lệnh khác.

### Làm sao để cập nhật WordPress lên phiên bản mới nhất?

Dừng ứng dụng: docker-compose down
Cập nhật tag image trong docker-compose.yml (ví dụ: từ wordpress:latest lên wordpress:6.5.3 hoặc tag mới nhất).
Chạy lại ứng dụng: docker-compose up -d
WordPress có thể yêu cầu cập nhật database khi bạn truy cập lần đầu.

Cần VPS chạy Docker Compose?

Để triển khai các ứng dụng Docker phức tạp như WordPress với NGINX và MySQL, bạn cần một môi trường máy chủ ổn định và hiệu năng cao. VPS tại VSIS.NET cung cấp cho bạn toàn quyền kiểm soát, tài nguyên mạnh mẽ và độ tin cậy cần thiết để chạy Docker và Docker Compose mượt mà.

Hãy trải nghiệm sự linh hoạt và sức mạnh của Docker Compose trên hạ tầng VPS chất lượng cao của chúng tôi.

Khám phá ngay các gói VPS tại: vsis.net/vps

Docker Compose — deploy WordPress + MySQL + NGINX 1 lệnh

Vì sao cần Docker Compose ngay? — Quản lý multi-container app chưa bao giờ dễ đến thế

Tóm gọn: Docker Compose là gì? — Công cụ định nghĩa và chạy ứng dụng multi-container

File `docker-compose.yml` — Ngôn ngữ của Docker Compose

Tóm gọn: Cài đặt Docker và Docker Compose — Chuẩn bị môi trường

Cài đặt Docker Engine

Cài đặt Docker Compose

Tóm gọn: Deploy WordPress + MySQL + NGINX với 1 lệnh duy nhất

Tóm gọn: Cấu hình NGINX làm Reverse Proxy (Nâng cao)

Thêm NGINX vào `docker-compose.yml`

Tạo file cấu hình NGINX

Tóm gọn: Quản lý ứng dụng với các lệnh Docker Compose

Khởi động ứng dụng

Dừng và xóa ứng dụng

Xem trạng thái và log

Xây dựng lại image

Các lệnh hữu ích khác

Pitfalls & lỗi thường gặp

Key takeaways

FAQ

### Docker Compose có cần cài đặt riêng không?

### Tôi có thể chạy nhiều trang WordPress trên cùng một server bằng Docker Compose không?

### Làm thế nào để backup dữ liệu WordPress và MySQL?

### Tôi có thể dùng image Docker khác cho MySQL hoặc WordPress không?

### Cờ `-d` trong `docker-compose up -d` có ý nghĩa gì?

### Làm sao để cập nhật WordPress lên phiên bản mới nhất?

Cần VPS chạy Docker Compose?

Bài viết mới nhât

Docker Compose — deploy WordPress + MySQL + NGINX 1 lệnh

Docker từ con số 0 — cài và chạy container đầu tiên trên Ubuntu

SSH key thay vì password — setup 2 phút, bảo mật 10 lần

find + grep + sed — 3 lệnh search-replace mạnh nhất Linux

tmux + screen — SSH disconnect không mất session

Bạn cần tư vấn?

Docker Compose — deploy WordPress + MySQL + NGINX 1 lệnh

Vì sao cần Docker Compose ngay? — Quản lý multi-container app chưa bao giờ dễ đến thế

Tóm gọn: Docker Compose là gì? — Công cụ định nghĩa và chạy ứng dụng multi-container

File docker-compose.yml — Ngôn ngữ của Docker Compose

Tóm gọn: Cài đặt Docker và Docker Compose — Chuẩn bị môi trường

Cài đặt Docker Engine

Cài đặt Docker Compose

Tóm gọn: Deploy WordPress + MySQL + NGINX với 1 lệnh duy nhất

Tóm gọn: Cấu hình NGINX làm Reverse Proxy (Nâng cao)

Thêm NGINX vào docker-compose.yml

Tạo file cấu hình NGINX

Tóm gọn: Quản lý ứng dụng với các lệnh Docker Compose

Khởi động ứng dụng

Dừng và xóa ứng dụng

Xem trạng thái và log

Xây dựng lại image

Các lệnh hữu ích khác

Pitfalls & lỗi thường gặp

Key takeaways

FAQ

### Docker Compose có cần cài đặt riêng không?

### Tôi có thể chạy nhiều trang WordPress trên cùng một server bằng Docker Compose không?

### Làm thế nào để backup dữ liệu WordPress và MySQL?

### Tôi có thể dùng image Docker khác cho MySQL hoặc WordPress không?

### Cờ -d trong docker-compose up -d có ý nghĩa gì?

### Làm sao để cập nhật WordPress lên phiên bản mới nhất?

Cần VPS chạy Docker Compose?

Share your love

Bài viết liên quan

Bạn cần tư vấn?

File `docker-compose.yml` — Ngôn ngữ của Docker Compose

Thêm NGINX vào `docker-compose.yml`

### Cờ `-d` trong `docker-compose up -d` có ý nghĩa gì?