---
title: نصب و راه اندازی NATS
description: "NATS یک سیستم پیام‌رسانی سبک و با کارایی بالا است که برای برنامه‌های توزیع‌شده و ابری طراحی شده است. این سیستم از انتشار-اشتراک، درخواست-پاسخ و بارهای کاری استریمینگ از طریق JetStream پشتیبانی می‌کند. NATS به طور گسترده برای ارتباطات میکروسرویس‌ها، سیستم‌های رویداد محور، پیام‌رسانی اینترنت اشیا و خطوط لوله داده بلادرنگ استفاده می‌شود."
url: "https://negarnovin.com/docs/how-to-deploy-nats/"
updated: "2026-02-18"
category: تحقیق و توسعه
---

# نصب و راه اندازی NATS

# نحوه استقرار NATS - پیام رسانی با کارایی بالا

NATS را با Docker Compose، JetStream persistence، احراز هویت امن و اتصال کلاینت تأیید شده مستقر کنید.

NATS یک سیستم پیام رسانی سبک و با کارایی بالا است که برای برنامه های توزیع شده و ابری طراحی شده است. این سیستم از انتشار-اشتراک، درخواست-پاسخ و بارهای کاری استریمینگ از طریق JetStream پشتیبانی می کند. NATS به طور گسترده برای ارتباطات میکروسرویس ها، سیستم های رویداد محور، پیام رسانی اینترنت اشیا و خطوط لوله داده بلادرنگ استفاده می شود.

[**سرور مجازی انگلیس**](https://negarnovin.com/%D8%B3%D8%B1%D9%88%D8%B1-%D9%85%D8%AC%D8%A7%D8%B2%DB%8C-%D8%A7%D9%86%DA%AF%D9%84%DB%8C%D8%B3/)

این مقاله نحوه استقرار NATS با استفاده از Docker Compose، فعال کردن JetStream persistence، پیکربندی احراز هویت و مجوز و تأیید اتصال کلاینت با استفاده از NATS CLI را توضیح می دهد.

## پیش نیازها

قبل از شروع نیاز دارید به:

- به عنوان یک کاربر غیر ریشه با امتیازات sudo به یک سرور مبتنی بر اوبونتو ۲۴.۰۴ دسترسی داشته باشید.
- داکر و داکر کامپوز را نصب کنید.

## تنظیم ساختار دایرکتوری و متغیرهای محیطی

در این بخش، ساختار دایرکتوری مورد نیاز برای NATS را ایجاد می کنید و متغیرهای محیطی را در یک فایل  `.env` تعریف می کنید که Docker Compose به طور خودکار آن را بارگذاری می کند.

1. دایرکتوری پروژه را ایجاد کنید.  console
   ```
   $ mkdir -p ~/nats-stack/{data,config}
   ```
2. به دایرکتوری پروژه بروید.  console
   ```
   $ cd ~/nats-stack
   ```
3. فایل  `.env`  را ایجاد و ویرایش کنید.  console
   ```
   $ nano .env
   ```

   متغیرهای زیر را اضافه کنید:
     ini
   ```
   NATS_CLIENT_PORT=4222
   NATS_CLUSTER_PORT=6222
   ```

   جایگزین کنید:

   - `NATS_CLIENT_PORT` با پورت اتصال کلاینت.
   - `NATS_CLUSTER_PORT` با پورت ارتباطی خوشه.

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

## نصب رابط خط فرمان NATS و ایجاد پیکربندی NATS

در این بخش، شما رابط خط فرمان NATS را نصب می کنید، اعتبارنامه های امن ایجاد می کنید و NATS را با JetStream، احراز هویت و مجوز پیکربندی می کنید.

1. فایل باینری NATS CLI را دانلود کنید.  console
   ```
   $ curl -sf https://binaries.nats.dev/nats-io/natscli/nats@latest | sh
   ```
2. فایل باینری را به PATH سیستم خود منتقل کنید.  console
   ```
   $ sudo mv nats /usr/local/bin/
   ```
3. نصب را تأیید کنید.  console
   ```
   $ nats --version
   ```
4. یک هش رمز عبور برای کاربر سیستم یا برنامه ایجاد کنید.  console
   ```
   $ nats server passwd
   ```

   رمز عبور را دو بار وارد کنید و هش تولید شده را کپی کنید.

   خروجی شما باید مشابه زیر باشد:

   ```
   $2a$11$C6sj6xxxxx....
   ```

   این مرحله را برای هر کاربری که می خواهید تعریف کنید، تکرار کنید.
5. فایل پیکربندی NATS را ایجاد کنید.  console
   ```
   $ nano config/nats.conf
   ```

   پیکربندی زیر را اضافه کنید:
     ini
   ```
   # Client port
   port: 4222
   monitor_port: 8222
   server_name: "NATS_SERVER_NAME"
   
   # System account
   system_account: SYS
   
   accounts {
    SYS {
    users = [
    { user: "sysadmin", password: "SYSTEM_PASSWORD_HASH" }
    ]
    }
   }
   
   # JetStream
   jetstream {
    store_dir: "/data/jetstream"
    max_mem_store: 1GB
    max_file_store: 5GB
   }
   
   authorization {
    default_permissions = {
    publish = "SANDBOX.*"
    subscribe = ["PUBLIC.>", "_INBOX.>"]
    }
    ADMIN = {
    publish = ">"
    subscribe = ">"
    }
    users = [
    {user: USERNAME, password: "USER_PASSWORD_HASH", permissions: $ADMIN}
    ]
   }
   ```

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

   - `server_name` سرور NATS را در لاگ ها، خروجی مانیتورینگ و رویدادهای سیستم شناسایی می کند.
   - `system_account` ویژگی های سیستم داخلی مورد نیاز برای نظارت و مدیریت JetStream را فعال می کند.
   - `accounts` مرزهای احراز هویت را برای کاربران سیستم و برنامه تعریف می کند
   - `authorization` کنترل دسترسی در سطح موضوع را اعمال می کند، با مجموعه ای از مجوزهای مدیریتی که دسترسی کامل به انتشار و اشتراک را اعطا می کند.
   - **JetStream** امکان ماندگاری پیام را با محدودیت های حافظه و دیسک تعریف شده فراهم می کند.

   قبل از شروع سرویس، مقادیر زیر را جایگزین کنید:

   - `NATS_SERVER_NAME` با نام سرور توصیفی
   - `SYSTEM_PASSWORD_HASH` با هش bcrypt تولید شده برای کاربر سیستم.
   - `USERNAME` با نام کاربری برنامه شما.
   - `USER_PASSWORD_HASH` با هش bcrypt تولید شده برای کاربر برنامه.

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

## راه اندازی با Docker Compose

در این بخش، شما مانیفست Docker Compose را ایجاد می کنید که NATS را با فعال بودن قابلیت تداوم و نظارت JetStream مستقر می کند.

1. مانیفست Docker Compose را ایجاد کنید.  console
   ```
   $ nano docker-compose.yaml
   ```

   محتوای زیر را اضافه کنید:
     yaml
   ```
   services:
    nats:
    image: nats:2.12
    container_name: nats
    command:
    - "-c"
    - "/etc/nats/nats.conf"
   
    ports:
    - "${NATS_CLIENT_PORT}:4222"
    - "${NATS_CLUSTER_PORT}:6222"
   
    volumes:
    - "./data:/data"
    - "./config/nats.conf:/etc/nats/nats.conf:ro"
   
    restart: unless-stopped
   
    healthcheck:
    test: ["CMD", "nats", "server", "ping"]
    interval: 10s
    timeout: 5s
    retries: 5
   ```

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

   در این مانیفست:

   - **image**: از تصویر رسمی NATS ۲.۱۲ استفاده می کند.
   - **command**: پیکربندی سفارشی NATS را در هنگام راه اندازی بارگذاری می کند.
   - **ports**:
     - `4222`: اتصالات کلاینت.
     - `8222`: نقطه پایانی مانیتورینگ (فقط میزبان محلی).
     - `6222`: ارتباط خوشه ای.
   - **volumes**:
     - `./data`: پیام های JetStream همچنان باقی می مانند..
     - `./config/nats.conf`: پیکربندی سرور را تزریق می کند..
   - **healthcheck**: تأیید می کند که سرور به پینگ ها پاسخ می دهد.
   - **restart: unless-stopped**:سرویس را به صورت خودکار مجدداً راه اندازی می کند.
2. سرویس NATS را شروع کنید.  console
   ```
   $ docker compose up -d
   ```
3. تأیید کنید که سرویس NATS در حال اجرا است.  console
   ```
   $ docker compose ps
   ```

   مطمئن شوید که خروجی نشان می دهد کانتینر NATS سالم و در حال اجرا است.
4. در صورت نیاز، لاگ ها را مشاهده کنید.  console
   ```
   $ docker compose logs
   ```

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

## اتصال NATS را تأیید کنید

در این بخش، تأیید می کنید که سرور NATS قابل دسترسی است و اتصالات کلاینت را می پذیرد.

اتصال را با استفاده از NATS CLI آزمایش کنید.

  console

```
$ nats --server nats://sysadmin:SYS_USER_PASSWORD@SERVER_IP:4222 server ping
```

به جای  `SYS_USER_PASSWORD`  و  `SERVER_IP`، رمز عبور کاربر سیستم و IP سرور را وارد کنید.

خروجی:

```
NATS_SERVER_NAME rtt=338.443125ms

---- ping statistics ----
1 replies max: 338.00 min: 338.00 avg: 338.00
```

خروجی موفقیت آمیز تأیید می کند که سرور NATS قابل دسترسی و به درستی احراز هویت شده است.

## نتیجه گیری

شما با موفقیت NATS را با استفاده از Docker Compose و با فعال بودن JetStream persistence مستقر کردید. احراز هویت و مجوز امن را پیکربندی کردید، ذخیره سازی پیام های پایدار را فعال کردید، پیام های مورد نیاز را نمایش دادید و اتصال کلاینت را با استفاده از NATS CLI تأیید کردید.

   نحوه استقرار NATS – پیام رسانی با کارایی بالاپیش نیازهاتنظیم ساختار دایرکتوری و متغیرهای محیطیخرید نصب و راه اندازی NATSقیمت نصب و راه اندازی NATSبهترین نصب و راه اندازی NATS
