---
title: آموزش استفاده از Docker Compose
description: این مقاله توسط تیم نگارنوین تهیه شده است. برای دریافت سرور مجازی با پهنای باند نامحدود و اجرای پروژه‌های Docker، به نگارنوین مراجعه کنید.
url: "https://negarnovin.com/docs/learning-to-use-docker-compose/"
updated: "2026-07-29"
category: تحقیق و توسعه / داکر
---

# آموزش استفاده از Docker Compose

# آموزش جامع استفاده از Docker Compose

## راهنمای گام به گام و حرفه ای

[**سرور مجازی فرانسه**](https://negarnovin.com/%D8%B3%D8%B1%D9%88%D8%B1-%D9%85%D8%AC%D8%A7%D8%B2%DB%8C-%D9%81%D8%B1%D8%A7%D9%86%D8%B3%D9%87/)

---

```
 نگارنوین ارائه دهنده سرور مجازی نامحدود

> [سرور مجازی ترافیک نامحدود](https://negarnovin.com/unlimited-traffic-virtual-server/)

[“سرور مجازی ترافیک نامحدود” — نگارنوین](https://negarnovin.com/unlimited-traffic-virtual-server/embed/#?secret=wsBRPkPC6H#?secret=Cw7pmur9iS)

 ```

---

## مقدمه

Docker Compose یکی از قدرتمندترین ابزارهای مدیریت کانتینرهای Docker است که به توسعه دهندگان و مدیران سیستم اجازه می دهد چندین سرویس را به صورت همزمان تعریف، پیکربندی و اجرا کنند. با استفاده از یک فایل YAML ساده، می توانید کل محیط برنامه ی خود را از یک وب سرور گرفته تا پایگاه داده و کش تعریف کرده و با یک دستور راه اندازی کنید.

در این آموزش جامع، همه چیز را از نصب تا استقرار پروژه های واقعی یاد می گیرید.

---

## پیش نیازها

قبل از شروع، موارد زیر را آماده کنید:

- **سیستم عامل:** Ubuntu ۲۲.۰۴ یا بالاتر (یا هر توزیع لینوکسی)
 - **Docker Engine:** نسخه ۲۰.۱۰ یا بالاتر
 - **دسترسی Root یا Sudo**
 - **آشنایی پایه با خط فرمان لینوکس**

[![آموزش استفاده از Docker Compose](https://negarnovin.com/wp-content/uploads/2026/06/view_image-1-2-1024x683.png)](https://negarnovin.com/wp-content/uploads/2026/06/view_image-1-2.png)
آموزش استفاده از Docker Compose

> 💡 **توجه:** برای اجرای Docker و Docker Compose به یک سرور با منابع کافی نیاز دارید.

---

## گام اول: نصب Docker

### ۱.۱ به روزرسانی سیستم

```bash
 sudo apt update && sudo apt upgrade -y
 ```

### ۱.۲ نصب پیش نیازهای Docker

```bash
 sudo apt install -y
 ca-certificates
 curl
 gnupg
 lsb-release
 ```

### ۱.۳ اضافه کردن کلید GPG رسمی Docker

```bash
 sudo mkdir -p /etc/apt/keyrings
 curl -fsSL https://download.docker.com/linux/ubuntu/gpg |
 sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
 ```

### ۱.۴ اضافه کردن مخزن Docker

```bash
 echo
 "deb [arch=$(dpkg --print-architecture)
 signed-by=/etc/apt/keyrings/docker.gpg]
 https://download.docker.com/linux/ubuntu
 $(lsb_release -cs) stable" |
 sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 ```

### ۱.۵ نصب Docker Engine

```bash
 sudo apt update
 sudo apt install -y docker-ce docker-ce-cli containerd.io
 ```

### ۱.۶ بررسی نصب موفق Docker

```bash
 docker --version
 ```

خروجی مورد انتظار:

```
 Docker version 24.0.x, build xxxxxxx
 ```

### ۱.۷ اضافه کردن کاربر به گروه Docker (اختیاری اما توصیه می شود)

```bash
 sudo usermod -aG docker $USER
 newgrp docker
 ```

---

## گام دوم: نصب Docker Compose

Docker Compose از نسخه Docker Desktop به صورت پیش فرض همراه با Docker ارائه می شود، اما در سرورهای لینوکسی باید جداگانه نصب شود.

### ۲.۱ دانلود آخرین نسخه Docker Compose

```bash
 sudo curl -L
 "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)"
 -o /usr/local/bin/docker-compose
 ```

### ۲.۲ تنظیم مجوز اجرا

```bash
 sudo chmod +x /usr/local/bin/docker-compose
 ```

### ۲.۳ تأیید نصب موفق

```bash
 docker-compose --version
 ```

خروجی:

```
 Docker Compose version v2.x.x
 ```

> 🔔 **نکته:** در نسخه های جدید Docker، می توانید از دستور `docker compose` (بدون خط تیره) هم استفاده کنید.

---

## گام سوم: ساختار فایل docker-compose.yml

فایل `docker-compose.yml` قلب Docker Compose است. این فایل با فرمت YAML نوشته می شود و تمام سرویس ها، شبکه ها و والیوم ها را تعریف می کند.

### ساختار پایه ای

```yaml
 version: '3.8'

services:
 نام-سرویس:
 image: نام-ایمیج
 ports:
 - "پورت-هاست:پورت-کانتینر"
 volumes:
 - مسیر-هاست:مسیر-کانتینر
 environment:
 - VARIABLE=value
 networks:
 - نام-شبکه

networks:
 نام-شبکه:
 driver: bridge

volumes:
 نام-والیوم:
 ```

### توضیح بخش های اصلی

| بخش | توضیح |
 |-----|-------|
 | `version` | نسخه فرمت Compose |
 | `services` | تعریف کانتینرها و تنظیمات آن ها |
 | `networks` | شبکه های مجازی بین سرویس ها |
 | `volumes` | فضای ذخیره سازی پایدار |

---

## گام چهارم: پروژه عملی اول - وب سرور Nginx ساده

بیایید با یک مثال ساده شروع کنیم.

### ۴.۱ ایجاد پوشه پروژه

```bash
 mkdir ~/my-nginx-project
 cd ~/my-nginx-project
 ```

### ۴.۲ ایجاد فایل HTML

```bash
 mkdir html
 cat > html/index.html << 'EOF'

 

# 🚀 Docker Compose در حال اجراست!

این صفحه توسط Nginx در داخل Docker سرویس می دهد

EOF
 ```

### ۴.۳ ایجاد فایل docker-compose.yml

```bash
 cat > docker-compose.yml << 'EOF' version: '۳.۸' services: webserver: image: nginx:latest container_name: my-nginx ports: - "۸۰۸۰:۸۰" volumes: - ./html:/usr/share/nginx/html:ro restart: unless-stopped EOF ``` ### ۴.۴ اجرای پروژه ```bash docker-compose up -d ``` خروجی: ``` [+] Running ۲/۲ ✔ Network my-nginx-project_default Created ✔ Container my-nginx Started ``` ### ۴.۵ تست وب سرور ```bash curl http://localhost:۸۰۸۰ ``` یا در مرورگر آدرس `http://IP-سرور:۸۰۸۰` را باز کنید. --- ## گام پنجم: پروژه عملی دوم - وردپرس + MySQL این مثال واقعی ترین کاربرد Docker Compose را نشان می دهد. ### ۵.۱ ایجاد پوشه پروژه ```bash mkdir ~/wordpress-docker cd ~/wordpress-docker ``` ### ۵.۲ ایجاد فایل .env (متغیرهای محیطی) ```bash cat > .env << 'EOF' # MySQL Configuration MYSQL_ROOT_PASSWORD=RootPass@۲۰۲۴ MYSQL_DATABASE=wordpress_db MYSQL_USER=wp_user MYSQL_PASSWORD=WpPass@۲۰۲۴ # WordPress Configuration WORDPRESS_DB_HOST=db:۳۳۰۶ WORDPRESS_DB_NAME=wordpress_db WORDPRESS_DB_USER=wp_user WORDPRESS_DB_PASSWORD=WpPass@۲۰۲۴ WORDPRESS_TABLE_PREFIX=wp_ EOF ``` ### ۵.۳ ایجاد فایل docker-compose.yml ```bash cat > docker-compose.yml << 'EOF' version: '۳.۸' services: db: image: mysql:۸.۰ container_name: wordpress-mysql restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD} MYSQL_DATABASE: ${MYSQL_DATABASE} MYSQL_USER: ${MYSQL_USER} MYSQL_PASSWORD: ${MYSQL_PASSWORD} volumes: - db_data:/var/lib/mysql networks: - wordpress-network healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] timeout: 20s retries: ۱۰ wordpress: image: wordpress:latest container_name: wordpress-app restart: unless-stopped depends_on: db: condition: service_healthy ports: - "۸۰۸۰:۸۰" environment: WORDPRESS_DB_HOST: ${WORDPRESS_DB_HOST} WORDPRESS_DB_NAME: ${WORDPRESS_DB_NAME} WORDPRESS_DB_USER: ${WORDPRESS_DB_USER} WORDPRESS_DB_PASSWORD: ${WORDPRESS_DB_PASSWORD} WORDPRESS_TABLE_PREFIX: ${WORDPRESS_TABLE_PREFIX} volumes: - wordpress_data:/var/www/html networks: - wordpress-network phpmyadmin: image: phpmyadmin:latest container_name: wordpress-phpmyadmin restart: unless-stopped depends_on: - db ports: - "۸۰۸۱:۸۰" environment: PMA_HOST: db PMA_PORT: ۳۳۰۶ MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD} networks: - wordpress-network volumes: db_data: driver: local wordpress_data: driver: local networks: wordpress-network: driver: bridge EOF ``` ### ۵.۴ راه اندازی پروژه ```bash docker-compose up -d ``` ### ۵.۵ مشاهده وضعیت سرویس ها ```bash docker-compose ps ``` خروجی: ``` NAME IMAGE STATUS PORTS wordpress-mysql mysql:۸.۰ Up (healthy) ۳۳۰۶/tcp wordpress-app wordpress:latest Up ۰.۰.۰.۰:۸۰۸۰->۸۰/tcp
 wordpress-phpmyadmin phpmyadmin:latest Up 0.0.0.0:8081->80/tcp
 ```

---

```
 ✅ نگارنوین ارائه دهنده سرور مجازی نامحدود
 برای اجرای پروژه های Docker Compose به سرور پرقدرت نیاز دارید!
 👉 https://negarnovin.com/unlimited-traffic-virtual-server/
 ```

---

## گام ششم: پروژه عملی سوم - اپلیکیشن Node.js + Redis + Nginx

### ۶.۱ ساختار پروژه

```bash
 mkdir ~/node-redis-app
 cd ~/node-redis-app
 mkdir app nginx
 ```

### ۶.۲ ایجاد اپلیکیشن Node.js

```bash
 cat > app/package.json << 'EOF' { "name": "docker-compose-demo", "version": "1.0.0", "description": "Demo App with Redis", "main": "server.js", "scripts": { "start": "node server.js" }, "dependencies": { "express": "^4.18.0", "redis": "^4.6.0" } } EOF ``` ```bash cat > app/server.js << 'EOF' const express = require('express'); const redis = require('redis'); const app = express(); const PORT = 3000; const client = redis.createClient({ url: 'redis://redis:6379' }); client.connect().catch(console.error); app.get('/', async (req, res) => {
 try {
 const visits = await client.incr('visits');
 res.json({
 message: 'سلام از Docker Compose!',
 visits: visits,
 timestamp: new Date().toISOString()
 });
 } catch (error) {
 res.status(500).json({ error: error.message });
 }
 });

app.get('/health', (req, res) => {
 res.json({ status: 'OK', service: 'node-app' });
 });

app.listen(PORT, () => {
 console.log(`Server running on port ${PORT}`);
 });
 EOF
 ```

### ۶.۳ ایجاد Dockerfile برای اپلیکیشن

```bash
 cat > app/Dockerfile << 'EOF' FROM node:۱۸-alpine WORKDIR /usr/src/app COPY package*.json ./ RUN npm install --production COPY . . EXPOSE ۳۰۰۰ CMD ["npm", "start"] EOF ``` ### ۶.۴ پیکربندی Nginx به عنوان Reverse Proxy ```bash cat > nginx/nginx.conf << 'EOF' upstream node_app { server app:۳۰۰۰; } server { listen ۸۰; server_name localhost; location / { proxy_pass http://node_app; proxy_http_version ۱.۱; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection 'upgrade'; 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_cache_bypass $http_upgrade; } location /health { proxy_pass http://node_app/health; } } EOF ``` ### ۶.۵ ایجاد docker-compose.yml ```bash cat > docker-compose.yml << 'EOF'
 version: '3.8'

services:

app:
 build:
 context: ./app
 dockerfile: Dockerfile
 container_name: node-app
 restart: unless-stopped
 environment:
 - NODE_ENV=production
 networks:
 - app-network
 depends_on:
 - redis

redis:
 image: redis:7-alpine
 container_name: app-redis
 restart: unless-stopped
 volumes:
 - redis_data:/data
 networks:
 - app-network
 command: redis-server --appendonly yes

nginx:
 image: nginx:alpine
 container_name: app-nginx
 restart: unless-stopped
 ports:
 - "80:80"
 volumes:
 - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro
 networks:
 - app-network
 depends_on:
 - app

volumes:
 redis_data:
 driver: local

networks:
 app-network:
 driver: bridge

EOF
 ```

### ۶.۶ Build و اجرا

```bash
 docker-compose up -d --build
 ```

---

## گام هفتم: دستورات مهم Docker Compose

### ۷.۱ جدول کامل دستورات

| دستور | کاربرد |
 |-------|---------|
 | `docker-compose up -d` | راه اندازی تمام سرویس ها در پس زمینه |
 | `docker-compose up --build` | Build مجدد و راه اندازی |
 | `docker-compose down` | متوقف کردن و حذف کانتینرها |
 | `docker-compose down -v` | متوقف کردن + حذف والیوم ها |
 | `docker-compose ps` | نمایش وضعیت سرویس ها |
 | `docker-compose logs` | مشاهده لاگ های همه سرویس ها |
 | `docker-compose logs -f app` | لاگ زنده سرویس مشخص |
 | `docker-compose restart` | ری استارت همه سرویس ها |
 | `docker-compose restart app` | ری استارت سرویس مشخص |
 | `docker-compose stop` | توقف بدون حذف |
 | `docker-compose start` | شروع مجدد سرویس های متوقف |
 | `docker-compose pull` | دانلود آخرین ایمیج ها |
 | `docker-compose build` | Build کردن سرویس ها |
 | `docker-compose exec app sh` | ورود به shell کانتینر |
 | `docker-compose scale app=۳` | مقیاس گذاری سرویس |

### ۷.۲ مدیریت لاگ ها

```bash
 # مشاهده لاگ همه سرویس ها
 docker-compose logs

# لاگ زنده (Follow)
 docker-compose logs -f

# لاگ با تعداد خط مشخص
 docker-compose logs --tail=100

# لاگ یک سرویس خاص
 docker-compose logs -f wordpress

# لاگ با timestamp
 docker-compose logs -t
 ```

### ۷.۳ اجرای دستور داخل کانتینر

```bash
 # ورود به bash کانتینر
 docker-compose exec app bash

# اجرای دستور بدون ورود
 docker-compose exec db mysql -u root -p

# اجرای دستور در سرویس Nginx
 docker-compose exec nginx nginx -t
 ```

---

## گام هشتم: مدیریت والیوم ها و شبکه ها

### ۸.۱ انواع والیوم

```yaml
 volumes:
 # Named Volume (توصیه شده)
 my-data:
 driver: local

services:
 app:
 volumes:
 # Named Volume
 - my-data:/app/data

# Bind Mount (اتصال مستقیم به هاست)
 - ./config:/app/config:ro

# Anonymous Volume
 - /app/logs

# tmpfs (حافظه موقت)
 - type: tmpfs
 target: /tmp
 ```

### ۸.۲ انواع شبکه

```yaml
 networks:
 # شبکه Bridge (پیش فرض)
 frontend:
 driver: bridge

# شبکه Host
 host-network:
 driver: host

# شبکه Overlay (برای Swarm)
 overlay-network:
 driver: overlay

# شبکه خارجی از پیش ساخته شده
 existing-network:
 external: true
 name: my-existing-network
 ```

### ۸.۳ جداسازی شبکه ها برای امنیت بیشتر

```yaml
 version: '3.8'

services:
 nginx:
 image: nginx
 networks:
 - frontend # فقط به شبکه frontend دسترسی دارد

app:
 image: my-app
 networks:
 - frontend # ارتباط با nginx
 - backend # ارتباط با db

db:
 image: mysql
 networks:
 - backend # فقط به شبکه backend دسترسی دارد

networks:
 frontend:
 backend:
 ```

---

## گام نهم: متغیرهای محیطی و پیکربندی پیشرفته

### ۹.۱ روش های مختلف تعریف متغیر محیطی

```yaml
 services:
 app:
 environment:
 # روش اول: key=value مستقیم
 - DATABASE_URL=mysql://user:pass@db/mydb

# روش دوم: key:value
 NODE_ENV: production

# روش سوم: از فایل .env
 - API_KEY=${API_KEY}

# روش چهارم: env_file
 env_file:
 - .env
 - ./config/production.env
 ```

### ۹.۲ استفاده از چند فایل Compose

```bash
 # محیط توسعه
 docker-compose -f docker-compose.yml
 -f docker-compose.dev.yml
 up -d

# محیط تولید
 docker-compose -f docker-compose.yml
 -f docker-compose.prod.yml
 up -d
 ```

**docker-compose.dev.yml:**
 ```yaml
 version: '3.8'

services:
 app:
 build:
 target: development
 volumes:
 - .:/app
 - /app/node_modules
 environment:
 - NODE_ENV=development
 ports:
 - "9229:9229" # debug port
 ```

**docker-compose.prod.yml:**
 ```yaml
 version: '3.8'

services:
 app:
 build:
 target: production
 restart: always
 environment:
 - NODE_ENV=production
 deploy:
 resources:
 limits:
 cpus: '0.5'
 memory: 512M
 ```

---

## گام دهم: Healthcheck و وابستگی های سرویس

### ۱۰.۱ تعریف Healthcheck

```yaml
 services:
 db:
 image: mysql:8.0
 healthcheck:
 # دستور بررسی سلامت
 test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
 interval: 30s # فاصله بین بررسی ها
 timeout: 10s # حداکثر زمان انتظار
 retries: ۵ # تعداد تلاش مجدد
 start_period: 60s # زمان شروع اولیه

redis:
 image: redis:alpine
 healthcheck:
 test: ["CMD", "redis-cli", "ping"]
 interval: 10s
 timeout: 5s
 retries: 3

nginx:
 image: nginx
 healthcheck:
 test: ["CMD", "curl", "-f", "http://localhost/health"]
 interval: 30s
 timeout: 10s
 retries: 3
 ```

### ۱۰.۲ مدیریت وابستگی ها

```yaml
 services:
 app:
 depends_on:
 db:
 condition: service_healthy # منتظر سالم شدن DB
 redis:
 condition: service_healthy # منتظر سالم شدن Redis
 migrations:
 condition: service_completed_successfully # منتظر تکمیل

migrations:
 image: my-app
 command: npm run migrate
 depends_on:
 db:
 condition: service_healthy
 ```

---

```
 🌐 نگارنوین ارائه دهنده سرور مجازی نامحدود
 سرور مجازی قدرتمند برای اجرای پروژه های Docker با پهنای باند نامحدود
 👉 https://negarnovin.com/unlimited-traffic-virtual-server/
 ```

---

## گام یازدهم: بهینه سازی و نکات امنیتی

### ۱۱.۱ محدود کردن منابع

```yaml
 services:
 app:
 image: my-app
 deploy:
 resources:
 limits:
 cpus: '۱.۰' # حداکثر ۱ هسته CPU
 memory: 512M # حداکثر ۵۱۲ مگابایت RAM
 reservations:
 cpus: '۰.۲۵' # حداقل تضمین شده
 memory: 128M
 ```

### ۱۱.۲ سیاست ری استارت

```yaml
 services:
 app:
 restart: unless-stopped # توصیه شده برای production

# گزینه های دیگر:
 # restart: no - هرگز ری استارت نشود
 # restart: always - همیشه ری استارت شود
 # restart: on-failure - فقط در صورت خطا
 # restart: on-failure:۳ - حداکثر ۳ بار تلاش
 ```

### ۱۱.۳ اجرا با کاربر غیر Root

```yaml
 services:
 app:
 image: my-app
 user: "1000:1000" # UID:GID

nginx:
 image: nginx:alpine
 security_opt:
 - no-new-privileges:true
 read_only: true
 tmpfs:
 - /tmp
 - /var/run
 - /var/cache/nginx
 ```

### ۱۱.۴ بهینه سازی Dockerfile

```dockerfile
 # استفاده از Multi-Stage Build
 FROM node:18-alpine AS builder

WORKDIR /app
 COPY package*.json ./
 RUN npm ci --only=production

COPY . .
 RUN npm run build

# مرحله نهایی - کوچک ترین ایمیج
 FROM node:18-alpine AS production

RUN addgroup -S appgroup && adduser -S appuser -G appgroup

WORKDIR /app
 COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
 COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules

USER appuser
 EXPOSE 3000

CMD ["node", "dist/server.js"]
 ```

---

## گام دوازدهم: Scaling و Load Balancing

### ۱۲.۱ مقیاس گذاری سرویس ها

```bash
 # اجرای ۳ نمونه از سرویس app
 docker-compose up -d --scale app=3

# بررسی
 docker-compose ps
 ```

### ۱۲.۲ پیکربندی Load Balancer با Nginx

```yaml
 version: '3.8'

services:
 nginx:
 image: nginx:alpine
 ports:
 - "80:80"
 volumes:
 - ./nginx.conf:/etc/nginx/nginx.conf:ro
 depends_on:
 - app

app:
 build: .
 expose:
 - "3000"
 environment:
 - NODE_ENV=production

volumes:
 app_logs:
 ```

```nginx
 # nginx.conf
 upstream app_servers {
 least_conn; # الگوریتم Load Balancing
 server app_1:3000;
 server app_2:3000;
 server app_3:3000;
 }

server {
 listen 80;

location / {
 proxy_pass http://app_servers;
 }
 }
 ```

---

## گام سیزدهم: مانیتورینگ با Docker Compose

```yaml
 version: '3.8'

services:
 prometheus:
 image: prom/prometheus:latest
 container_name: prometheus
 volumes:
 - ./prometheus.yml:/etc/prometheus/prometheus.yml
 - prometheus_data:/prometheus
 ports:
 - "9090:9090"
 networks:
 - monitoring

grafana:
 image: grafana/grafana:latest
 container_name: grafana
 volumes:
 - grafana_data:/var/lib/grafana
 ports:
 - "3000:3000"
 environment:
 - GF_SECURITY_ADMIN_PASSWORD=admin@secure
 depends_on:
 - prometheus
 networks:
 - monitoring

cadvisor:
 image: gcr.io/cadvisor/cadvisor:latest
 container_name: cadvisor
 volumes:
 - /:/rootfs:ro
 - /var/run:/var/run:ro
 - /sys:/sys:ro
 - /var/lib/docker/:/var/lib/docker:ro
 ports:
 - "8080:8080"
 networks:
 - monitoring

volumes:
 prometheus_data:
 grafana_data:

networks:
 monitoring:
 driver: bridge
 ```

---

## گام چهاردهم: رفع اشکال و عیب یابی

### ۱۴.۱ دستورات دیباگ

```bash
 # مشاهده لاگ کامل یک سرویس
 docker-compose logs --tail=200 -f app

# بررسی کانفیگ نهایی
 docker-compose config

# اعتبارسنجی فایل docker-compose.yml
 docker-compose config --quiet
 echo $? # ۰ = صحیح

# مشاهده اطلاعات کانتینر
 docker inspect container-name

# مشاهده مصرف منابع
 docker stats

# بررسی شبکه ها
 docker network ls
 docker network inspect project_app-network

# بررسی والیوم ها
 docker volume ls
 docker volume inspect project_db_data
 ```

### ۱۴.۲ مشکلات رایج و راه حل

**مشکل ۱: Port already in use**
 ```bash
 # یافتن فرآیند استفاده کننده از پورت
 sudo lsof -i :8080
 # یا
 sudo netstat -tulpn | grep :8080

# کشتن فرآیند
 sudo kill -9 PID
 ```

**مشکل ۲: Permission denied در والیوم**
 ```bash
 # تنظیم مجوز صحیح
 sudo chown -R 1000:1000 ./data

# یا در docker-compose.yml
 volumes:
 - type: bind
 source: ./data
 target: /app/data
 ```

**مشکل ۳: سرویس ها نمی توانند یکدیگر را پیدا کنند**
 ```bash
 # بررسی شبکه
 docker-compose exec app ping db

# بررسی DNS داخلی
 docker-compose exec app nslookup db
 ```

**مشکل ۴: کمبود فضای دیسک**
 ```bash
 # پاکسازی کامل Docker
 docker system prune -a --volumes

# فقط کانتینرهای متوقف
 docker container prune

# فقط ایمیج های استفاده نشده
 docker image prune -a
 ```

---

## گام پانزدهم: بهترین شیوه ها (Best Practices)

### ✅ موارد توصیه شده

```yaml
 version: '3.8'

services:
 app:
 # ۱. همیشه نسخه دقیق ایمیج را مشخص کنید
 image: node:18.17.0-alpine

# ۲. نام container را مشخص کنید
 container_name: my-app

# ۳. متغیرهای محیطی را از فایل .env بخوانید
 env_file: .env

# ۴. محدودیت منابع تعریف کنید
 deploy:
 resources:
 limits:
 memory: 256M

# ۵. Healthcheck تعریف کنید
 healthcheck:
 test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
 interval: 30s
 timeout: 10s
 retries: 3

# ۶. سیاست ری استارت مناسب
 restart: unless-stopped

# ۷. لاگینگ را پیکربندی کنید
 logging:
 driver: "json-file"
 options:
 max-size: "10m"
 max-file: "3"
 ```

### ❌ موارد اجتناب شده

```yaml
 # ❌ اشتباه - استفاده از latest بدون نسخه
 image: node:latest

# ❌ اشتباه - رمزعبور مستقیم در فایل
 environment:
 - DB_PASSWORD=mypassword

# ❌ اشتباه - mount کامل /
 volumes:
 - /:/host

# ❌ اشتباه - اجرا با root
 user: root
 ```

---

## جمع بندی نهایی

### چک لیست استقرار در Production

- [ ] فایل `.env` در `.gitignore` قرار دارد
 - [ ] نسخه دقیق تمام ایمیج ها مشخص شده
 - [ ] Healthcheck برای همه سرویس ها تعریف شده
 - [ ] محدودیت منابع تنظیم شده
 - [ ] شبکه های جداگانه برای frontend/backend
 - [ ] والیوم های named برای داده های persistent
 - [ ] سیاست ری استارت مناسب
 - [ ] لاگینگ پیکربندی شده
 - [ ] کاربر غیر root برای کانتینرها
 - [ ] Backup از والیوم ها برنامه ریزی شده

---

## منابع بیشتر

- [مستندات رسمی Docker Compose](https://docs.docker.com/compose/)
 - [Docker Hub](https://hub.docker.com/)
 - [Docker Security Best Practices](https://docs.docker.com/develop/security-best-practices/)

---

```
 🚀 نگارنوین ارائه دهنده سرور مجازی نامحدود
 پروژه های Docker Compose خود را روی سرورهای قدرتمند نگارنوین با پهنای باند نامحدود اجرا کنید!
 👉 https://negarnovin.com/unlimited-traffic-virtual-server/
 ```

---

*این مقاله توسط تیم نگارنوین تهیه و ترجمه شده است. برای دریافت سرور مجازی با پهنای باند نامحدود و اجرای پروژه های Docker، به [نگارنوین](https://negarnovin.com/unlimited-traffic-virtual-server/) مراجعه کنید.*

---

حالا اینو برای ویرایشگر کلاسیک وردپرس اینجا میذارم:

---

# 📋 نسخه HTML برای ویرایشگر کلاسیک وردپرس

```html

## مقدمه

Docker Compose یکی از قدرتمندترین ابزارهای مدیریت کانتینرهای Docker است که به توسعه دهندگان و مدیران سیستم اجازه می دهد چندین سرویس را به صورت همزمان تعریف، پیکربندی و اجرا کنند. با استفاده از یک فایل YAML ساده، می توانید کل محیط برنامه ی خود را از یک وب سرور گرفته تا پایگاه داده و کش تعریف کرده و با یک دستور راه اندازی کنید.

 **🌐 نگارنوین ارائه دهنده [سرور مجازی نامحدود](https://negarnovin.com/unlimited-traffic-virtual-server/)**
 برای اجرای پروژه های Docker Compose به سرور پرقدرت با پهنای باند نامحدود نیاز دارید!

## پیش نیازها

- **سیستم عامل:** Ubuntu ۲۲.۰۴ یا بالاتر
- **Docker Engine:** نسخه ۲۰.۱۰ یا بالاتر
- **دسترسی Root یا Sudo**
- **آشنایی پایه با خط فرمان لینوکس**

## گام اول: نصب Docker

### ۱.۱ به روزرسانی سیستم

```
sudo apt update && sudo apt upgrade -y
```

### ۱.۲ نصب پیش نیازهای Docker

```
sudo apt install -y 
 ca-certificates 
 curl 
 gnupg 
 lsb-release
```

### ۱.۳ اضافه کردن کلید GPG رسمی Docker

```
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | 
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
```

### ۱.۴ اضافه کردن مخزن Docker

```
echo 
 "deb [arch=$(dpkg --print-architecture) 
 signed-by=/etc/apt/keyrings/docker.gpg] 
 https://download.docker.com/linux/ubuntu 
 $(lsb_release -cs) stable" | 
 sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

### ۱.۵ نصب Docker Engine

```
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
```

### ۱.۶ بررسی نصب موفق Docker

```
docker --version
```

### ۱.۷ اضافه کردن کاربر به گروه Docker

```
sudo usermod -aG docker $USER
newgrp docker
```

## گام دوم: نصب Docker Compose

### ۲.۱ دانلود آخرین نسخه

```
sudo curl -L 
"https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" 
-o /usr/local/bin/docker-compose
```

### ۲.۲ تنظیم مجوز اجرا

```
sudo chmod +x /usr/local/bin/docker-compose
```

### ۲.۳ تأیید نصب موفق

```
docker-compose --version
```

## گام سوم: ساختار فایل docker-compose.yml

```
version: '3.8'

services:
 نام-سرویس:
 image: نام-ایمیج
 ports:
 - "پورت-هاست:پورت-کانتینر"
 volumes:
 - مسیر-هاست:مسیر-کانتینر
 environment:
 - VARIABLE=value
 networks:
 - نام-شبکه

networks:
 نام-شبکه:
 driver: bridge

volumes:
 نام-والیوم:
```

| بخش | توضیح |
| --- | --- |
| `version` | نسخه فرمت Compose |
| `services` | تعریف کانتینرها و تنظیمات آن ها |
| `networks` | شبکه های مجازی بین سرویس ها |
| `volumes` | فضای ذخیره سازی پایدار |

## گام چهارم: پروژه عملی - وب سرور Nginx ساده

### ایجاد پوشه پروژه

```
mkdir ~/my-nginx-project
cd ~/my-nginx-project
```

### ایجاد فایل docker-compose.yml

```
version: '3.8'

services:
 webserver:
 image: nginx:latest
 container_name: my-nginx
 ports:
 - "8080:80"
 volumes:
 - ./html:/usr/share/nginx/html:ro
 restart: unless-stopped
```

### اجرای پروژه

```
docker-compose up -d
```

## گام پنجم: پروژه عملی - وردپرس + MySQL

### فایل .env

```
MYSQL_ROOT_PASSWORD=RootPass@2024
MYSQL_DATABASE=wordpress_db
MYSQL_USER=wp_user
MYSQL_PASSWORD=WpPass@2024

WORDPRESS_DB_HOST=db:3306
WORDPRESS_DB_NAME=wordpress_db
WORDPRESS_DB_USER=wp_user
WORDPRESS_DB_PASSWORD=WpPass@2024
```

### فایل docker-compose.yml

```
version: '3.8'

services:

 db:
 image: mysql:8.0
 container_name: wordpress-mysql
 restart: unless-stopped
 environment:
 MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
 MYSQL_DATABASE: ${MYSQL_DATABASE}
 MYSQL_USER: ${MYSQL_USER}
 MYSQL_PASSWORD: ${MYSQL_PASSWORD}
 volumes:
 - db_data:/var/lib/mysql
 networks:
 - wordpress-network
 healthcheck:
 test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
 timeout: 20s
 retries: 10

 wordpress:
 image: wordpress:latest
 container_name: wordpress-app
 restart: unless-stopped
 depends_on:
 db:
 condition: service_healthy
 ports:
 - "8080:80"
 environment:
 WORDPRESS_DB_HOST: ${WORDPRESS_DB_HOST}
 WORDPRESS_DB_NAME: ${WORDPRESS_DB_NAME}
 WORDPRESS_DB_USER: ${WORDPRESS_DB_USER}
 WORDPRESS_DB_PASSWORD: ${WORDPRESS_DB_PASSWORD}
 volumes:
 - wordpress_data:/var/www/html
 networks:
 - wordpress-network

 phpmyadmin:
 image: phpmyadmin:latest
 container_name: wordpress-phpmyadmin
 ports:
 - "8081:80"
 environment:
 PMA_HOST: db
 networks:
 - wordpress-network

volumes:
 db_data:
 wordpress_data:

networks:
 wordpress-network:
 driver: bridge
```

 **✅ نگارنوین ارائه دهنده [سرور مجازی نامحدود](https://negarnovin.com/unlimited-traffic-virtual-server/)**
 سرور مجازی قدرتمند با پهنای باند نامحدود برای میزبانی پروژه های Docker Compose

## گام ششم: دستورات مهم Docker Compose

| دستور | کاربرد |
| --- | --- |
| `docker-compose up -d` | راه اندازی در پس زمینه |
| `docker-compose down` | متوقف و حذف کانتینرها |
| `docker-compose ps` | نمایش وضعیت سرویس ها |
| `docker-compose logs -f` | مشاهده لاگ زنده |
| `docker-compose restart` | ری استارت همه سرویس ها |
| `docker-compose exec app sh` | ورود به shell کانتینر |
| `docker-compose pull` | دانلود آخرین ایمیج ها |
| `docker-compose build` | Build کردن سرویس ها |
| `docker-compose scale app=3` | مقیاس گذاری سرویس |

## گام هفتم: مدیریت والیوم ها

```
volumes:
 my-data:
 driver: local

services:
 app:
 volumes:
 # Named Volume
 - my-data:/app/data
 # Bind Mount
 - ./config:/app/config:ro
 # Anonymous Volume
 - /app/logs
```

## گام هشتم: Healthcheck و وابستگی ها

```
services:
 db:
 image: mysql:8.0
 healthcheck:
 test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
 interval: 30s
 timeout: 10s
 retries: 5
 start_period: 60s

 app:
 depends_on:
 db:
 condition: service_healthy
```

## گام نهم: بهینه سازی و امنیت

```
services:
 app:
 image: node:18.17.0-alpine
 container_name: my-app
 env_file: .env
 deploy:
 resources:
 limits:
 cpus: '1.0'
 memory: 512M
 healthcheck:
 test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
 interval: 30s
 timeout: 10s
 retries: 3
 restart: unless-stopped
 logging:
 driver: "json-file"
 options:
 max-size: "10m"
 max-file: "3"
```

## گام دهم: رفع اشکال و عیب یابی

```
# مشاهده لاگ کامل
docker-compose logs --tail=200 -f app

# بررسی کانفیگ
docker-compose config

# مشاهده مصرف منابع
docker stats

# پاکسازی کامل
docker system prune -a --volumes
```

## چک لیست استقرار در Production

- ☑ فایل `.env` در `.gitignore` قرار دارد
- ☑ نسخه دقیق تمام ایمیج ها مشخص شده
- ☑ Healthcheck برای همه سرویس ها تعریف شده
- ☑ محدودیت منابع تنظیم شده
- ☑ شبکه های جداگانه frontend/backend
- ☑ والیوم های named برای داده های persistent
- ☑ سیاست ری استارت مناسب
- ☑ لاگینگ پیکربندی شده
- ☑ کاربر غیر root برای کانتینرها
- ☑ Backup از والیوم ها برنامه ریزی شده

### 🚀 نگارنوین ارائه دهنده [سرور مجازی نامحدود](https://negarnovin.com/unlimited-traffic-virtual-server/)

پروژه های Docker Compose خود را روی سرورهای قدرتمند نگارنوین با پهنای باند نامحدود اجرا کنید!
 [👈 مشاهده سرور مجازی نامحدود](https://negarnovin.com/unlimited-traffic-virtual-server/)

*این مقاله توسط تیم **نگارنوین** تهیه شده است. برای دریافت سرور مجازی با پهنای باند نامحدود و اجرای پروژه های Docker، به [نگارنوین](https://negarnovin.com/unlimited-traffic-virtual-server/) مراجعه کنید.*

     🚀 Docker Compose در حال اجراست!راهنمای گام به گام و حرفه ایمقدمهخرید آموزش استفاده از Docker Composeقیمت آموزش استفاده از Docker Composeبهترین آموزش استفاده از Docker Compose
