---
title: نحوه استفاده از داکر کامپوز
description: یاد بگیرید که چگونه برنامه‌های چند کانتینری را با Docker Compose با استفاده از compose.yaml، پروفایل‌های سرویس و دستورات ضروری CLI مدیریت کنید.
url: "https://negarnovin.com/docs/how-to-use-docker-compose/"
updated: "2025-09-13"
category: تحقیق و توسعه / داکر
tags:
  - compose.yam
  - Docker Compose آموزش سریع
  - Docker Compose چیست
  - How To Use Docker Compose
  - آموزش ابزار compose در داکر
  - آموزش استفاده از Docker Compose
---

# نحوه استفاده از داکر کامپوز

# نحوه استفاده از داکر کامپوز

 یاد بگیرید که چگونه برنامه های چند کانتینری را با Docker Compose با استفاده از compose.yaml، پروفایل های سرویس و دستورات ضروری CLI مدیریت کنید.

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

این مقاله نحوه استفاده از Docker Compose برای ایجاد و مدیریت کانتینرها را توضیح می دهد. اصول اولیه دستور `docker compose`و نحوه ایجاد `compose.yaml`مانیفست را پوشش می دهد. همچنین پروفایل Docker Compose را برای اجرای کانتینرها بسته به محیط شما بررسی می کند.

## توضیحات کوتاه

در زیر چند دستور اساسی Docker Compose که روی یک فایل `compose.yaml`or عمل می کنند، آورده شده است.`docker-compose.yaml`

```
# Create/build and start all services in the background.
$ docker compose up -d

# Stop and remove all service containers, networks, and volumes.
$ docker compose down

# Stop all services.
$ docker compose stop

# Start and run stopped services.
$ docker compose start

# View the status of running services.
$ docker compose ps

# Check the logs of all services.
$ docker compose logs
```

## یک فایل Docker Compose ایجاد کنید

این بخش به ایجاد یک فایل نمونه Docker Compose `compose.yaml`برای یک برنامه نمونه flask می پردازد.

1. نمونه برنامه را دانلود کنید.  console
   ```
   $ git clone https://github.com/ndlrfz/flask-redis-postgresql
   ```
2. به `flask-redis-postgresql`دایرکتوری پروژه بروید.  console
   ```
   $ cd flask-redis-postgresql
   ```
3. این دایرکتوری حاوی فایلی `compose.yaml`با محتوای زیر است.  console
   ```
   $ cat compose.yml
   ```

   مانیفست Docker Compose زیر را مشاهده خواهید کرد:
     yaml
   ```
   name: myproject
   
   services:
    redis:
    image: "redis:alpine"
    restart: always
    ports:
    - 6379:6379
    volumes:
    - redis:/data
   
    postgresql:
    image: "postgres:16-alpine"
    ports:
    - "5432:5432"
    volumes:
    - pgdata:/var/lib/postgresql/data
    environment:
    POSTGRES_USER: ${DATABASE_USER}
    POSTGRES_PASSWORD: ${DATABASE_PASSWORD}
    POSTGRES_DB: ${DATABASE_NAME}
   
    flask:
    build: .
    restart: always
    env_file:
    - ".env"
    depends_on:
    - redis
    - postgresql
    ports:
    - "8000:5000"
    volumes:
    - ./:/code
   
   volumes:
    redis:
    driver: "local"
    pgdata:
    driver: "local"
   ```

   در این فایل،

   - `name`: نام پروژه را روی تنظیم می کند `myproject`.
   - `services`: کانتینرهای منفردی را که برنامه شما را تشکیل می دهند، تعریف می کند.
   - `redis`سرویس را با این جزئیات تعریف کنید :
     - `image`: سرویس را از روی `redis:alpine`تصویر ایجاد می کند.
     - `restart: always`: سیاستی را تنظیم می کند که در صورت توقف، این کانتینر همیشه مجدداً راه اندازی شود.
     - `ports`پورت `6379`روی میزبان را به پورت `6379`داخل کانتینر نگاشت می کند.
     - `volumes`: برای داده های ماندگار، والیوم نامگذاری شده را `redis`به `/data`دایرکتوری داخل کانتینر متصل می کند.
   - `postgresql`سرویس را با موارد زیر تعریف کنید :
     - `image`: سرویس را از روی `postgres:16-alpine`تصویر ایجاد می کند.
     - `ports`پورت `5432`روی میزبان را به پورت `5432`داخل کانتینر نگاشت می کند.
     - `volumes`: برای داده های ماندگار، والیوم نامگذاری شده را `pgdata`در دایرکتوری نصب می کند.`/var/lib/postgresql/data`
     - `environment`متغیرهای محیطی داخل کانتینر را تنظیم می کند. مقادیر مربوط به `${DATABASE_USER}`، `${DATABASE_PASSWORD}`، و `${DATABASE_NAME}`از محیط پوسته شما جایگزین می شوند (که اغلب از یک `.env`فایل بارگذاری می شود).
   - سرویس برنامه را `flask`با موارد زیر تعریف کنید:
     - `build: .`: یک تصویر داکر در دایرکتوری فعلی از فایل `Dockerfile`. می سازد.
     - `restart: always`: سیاستی را تنظیم می کند که در صورت توقف، این کانتینر همیشه مجدداً راه اندازی شود.
     - `env_file`متغیرهای محیطی سرویس را مستقیماً از یک `.env`فایل بارگذاری می کند.
     - `depends_on`: ترتیب راه اندازی را کنترل می کند. `flask`سرویس فقط پس از شروع سرویس های `redis`و شروع می شود.`postgresql`
     - `ports`پورت `8000`روی میزبان را به پورت `5000`داخل کانتینر نگاشت می کند.
     - `volumes`: دایرکتوری پروژه فعلی روی میزبان را به `/code`دایرکتوری داخل کانتینر متصل می کند.
   - `volumes`: دو volume نامگذاری شده تعریف می کند، `redis`و `pgdata`، با استفاده از `local`درایور. اینها توسط Docker مدیریت شده و در دستگاه میزبان ذخیره می شوند.
4. یک فایل ایجاد کنید `.env`.  console
   ```
   $ nano .env
   ```

   متغیرهای محیطی زیر را برای اعتبارنامه های PostgreSQL اضافه کنید. می توانید جزئیات زیر را با اعتبارنامه های خود جایگزین کنید.
     ini
   ```
   DATABASE_USER=app_user
   DATABASE_PASSWORD=app_password
   DATABASE_NAME=appdb
   DATABASE_HOST=postgresql
   DATABASE_PORT=5432
   ```

   فایل را ذخیره کرده و از آن خارج شوید.
5. خدمات خود را بسازید و شروع کنید.  console
   ```
   $ docker compose up -d
   ```

   این گزینه `-d`به شما امکان می دهد کانتینرها را در پس زمینه اجرا کنید.
6. دستور زیر را اجرا کنید تا کانتینرها یا سرویس های در حال اجرا را بررسی کنید.  console
   ```
   $ docker compose ps
   ```

   خروجی:

   ```
   NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
   myproject_flask-1 myproject_flask "flask run --debug" flask About a minute ago Up About a minute 0.0.0.0:8000->5000/tcp, [::]:8000->5000/tcp
   myproject_postgresql-1 postgres:16-alpine "docker-entrypoint.s…" postgresql About a minute ago Up About a minute 0.0.0.0:5432->5432/tcp, [::]:5432->5432/tcp
   myproject_redis-1 redis:alpine "docker-entrypoint.s…" redis About a minute ago Up 32 seconds 0.0.0.0:6379->6379/tcp, [::]:6379->6379/tcp
   ```

   توضیح خروجی:

   - `flask`سرویس روی پورت `8000`روی دستگاه میزبان اجرا می شود که بر اساس تصویر داکر است `myproject_flask`.
   - `postgresql``5432`سرویسی که بر اساس تصویر داکر روی پورت اجرا می شود `postgres:16-alpine`.
   - `redis``6379`سرویس بر اساس تصویر داکر روی پورت اجرا می شود `redis:alpine`.
7. لیست تصاویری که توسط سرویس های شما استفاده می شوند را بررسی کنید.  کنسول
   ```
   $ docker compose images
   ```

   خروجی:

   ```
   CONTAINER REPOSITORY TAG IMAGE ID SIZE
   myproject_flask-1 myproject_flask latest 1c3d151b6276 254MB
   myproject_postgresql-1 postgres 16-alpine b56133b65cd3 275MB
   myproject_redis-1 redis alpine d470ca4bc10c 60.5MB
   ```
8. یک مرورگر وب باز کنید و `http://<SERVER-IP>:8000/`برای تأیید اجرای برنامه خود، به این آدرس مراجعه کنید.
   ![نحوه استفاده از داکر کامپوز](https://negarnovin.com/wp-content/uploads/2025/09/79b822fb-4836-457f-ac9e-28a7e1279ec3_compressed.webp)

## مدیریت Docker Compose

جدول زیر `docker compose`دستورات رایج برای مدیریت پشته برنامه شما را شرح می دهد.

| فرمان | توضیحات | مثال |
| --- | --- | --- |
| `build` | ساخت یا بازسازی کانتینرها | `docker compose build` |
| `up` | ایجاد و شروع کانتینرها | `docker compose up -d` |
| `down` | ظروف را متوقف کرده و بردارید | `docker compose down` |
| `start` | شروع کانتینرهای موجود | `docker compose start app` |
| `stop` | ظروف را متوقف کنید | `docker compose stop app` |
| `kill` | ظروف توقف اجباری | `docker compose kill app` |
| `ps` | بررسی کانتینرهای در حال اجرا | `docker compose ps` |
| `logs` | لاگ ها را برای کانتینرها بررسی کنید | `docker compose logs app` |
| `exec` | اجرای دستور در کانتینر | `docker compose exec app bash` |
| `images` | فهرست کردن تصاویر استفاده شده توسط کانتینرها | `docker compose images` |
| `rm` | ظروف متوقف شده را بردارید | `docker compose rm` |

## استفاده از پروفایل های Docker Compose

پروفایل ها به برنامه ها یا سرویس های انتخابی اجازه می دهند تا بر اساس محیط یا موارد استفاده، مانند توسعه و تولید، اجرا شوند.

1. فایل را ویرایش کنید `compose.yml`.  console
   ```
   $ nano compose.yml
   ```
2. پیکربندی زیر را در زیر `flask`سرویس اضافه کنید.  yaml
   ```
   adminer:
    image: adminer
    restart: always
    depends_on: [postgresql]
    profiles: [dev]
    ports:
    - 8080:8080
    redis-insight:
    image: redis/redisinsight:latest
    restart: always
    profiles: [dev]
    depends_on: [redis]
    ports:
    - "8001:8001"
   ```

   فایل را ذخیره کنید و ببندید.

   در این پیکربندی:

   - `adminer`: سرویسی با نام را تعریف می کند `adminer`که از `adminer`تصویر داکر استفاده می کند.
     - `restart: always`: سیاستی را تنظیم می کند که در صورت توقف، کانتینر همیشه مجدداً راه اندازی شود.
     - `depends_on`: تضمین می کند که `adminer`سرویس فقط پس از `postgresql`شروع سرویس، شروع به کار کند.
     - `profiles`: `dev`نمایه را به سرویس اختصاص می دهد.
     - `ports`پورت `8080`روی میزبان را به پورت `8080`داخل کانتینر نگاشت می کند.
   - `redis-insight`: سرویسی با نام را تعریف می کند `redis-insight`که از `redis/redisinsight:latest`تصویر داکر استفاده می کند.
     - `restart: always`: سیاستی را تنظیم می کند که در صورت توقف، کانتینر همیشه مجدداً راه اندازی شود.
     - `depends_on`: تضمین می کند که `redis-insight`سرویس فقط پس از `redis`شروع سرویس، شروع به کار کند.
     - `profiles`: `dev`نمایه را به سرویس اختصاص می دهد.
     - `ports`پورت `8001`روی میزبان را به پورت `8001`داخل کانتینر نگاشت می کند.
3. سرویس را شروع کنید `adminer`.  console
   ```
   $ docker compose --profile dev up -d
   ```

   از این `--profile dev`گزینه برای فعال سازی و شروع سرویس های اختصاص داده شده به `dev`پروفایل استفاده کنید. این به Docker Compose می گوید که `adminer`سرویس را که به طور پیش فرض نادیده گرفته می شود، لحاظ کند.
4. با دستور زیر کانتینر در حال اجرا را بررسی کنید.  console
   ```
   $ docker compose ps
   ```

   خواهید دید که `adminer`سرویس در حال اجرا است.

   ```
   NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
   myproject-adminer-1 adminer "entrypoint.sh docke…" adminer 2 seconds ago Up 1 second 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp
   myproject-flask-1 myproject-flask "flask run --debug" flask 2 seconds ago Up 1 second 0.0.0.0:8000->5000/tcp, [::]:8000->5000/tcp
   myproject-postgresql-1 postgres:16-alpine "docker-entrypoint.s…" postgresql 3 seconds ago Up 2 seconds 0.0.0.0:5432->5432/tcp, [::]:5432->5432/tcp
   myproject-redis-1 redis:alpine "docker-entrypoint.s…" redis 3 seconds ago Up 2 seconds 0.0.0.0:6379->6379/tcp, [::]:6379->6379/tcp
   myproject-redis-insight-1 redis/redisinsight:latest "./docker-entry.sh n…" redis-insight 3 seconds ago Up 1 second 5540/tcp, 0.0.0.0:8001->8001/tcp, [::]:8001->8001/tcp
   ```
5. برای متوقف کردن یک سرویس، به عنوان مثال `adminer`، از  کنسول
   ```
   $ docker compose stop adminer
   ```
6. سرویس متوقف شده را حذف کنید `adminer`.  console
   ```
   $ docker compose rm adminer
   ```
7. تمام سرویس ها (از جمله `dev`پروفایل) را از بین ببرید.  console
   ```
   $ docker compose --profile dev down
   ```

## نتیجه گیری

در این مقاله، نحوه استفاده از Docker Compose برای مدیریت پشته های کانتینر را بررسی کردید. یاد گرفتید که چگونه کانتینرها را با استفاده از `docker compose`دستور شروع، متوقف، راه اندازی مجدد و از بین ببرید، چگونه فایل را برای پشته برنامه خود ایجاد کنید `compose.yaml`و کاربرد اولیه پروفایل های Docker Compose را برای اجرای انتخابی کانتینرها بسته به محیط خود بررسی کردید. برای اطلاعات بیشتر، [مستندات Docker Compose را](https://docs.docker.com/compose/) بررسی کنید .

  توضیحات کوتاهیک فایل Docker Compose ایجاد کنیدمدیریت Docker Composeخرید نحوه استفاده از داکر کامپوزقیمت نحوه استفاده از داکر کامپوزبهترین نحوه استفاده از داکر کامپوز
