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

- پیوند: https://negarnovin.com/docs/how-to-deploy-nats/
- منتشرشده: 2026-02-18T16:22:45+00:00
- نویسنده: نگارنوین

# نحوه استقرار 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.  دایرکتوری پروژه را ایجاد کنید.
 2.  console
 3.      ```
         $ mkdir -p ~/nats-stack/{data,config}
         ```
     
 4.  به دایرکتوری پروژه بروید.
 5.  console
 6.      ```
         $ cd ~/nats-stack
         ```
     
 7.  فایل  `.env`  را ایجاد و ویرایش کنید.
 8.  console
 9.      ```
         $ nano .env
         ```
     
 10. متغیرهای زیر را اضافه کنید:
 11. ini
 12.     ```
         NATS_CLIENT_PORT=4222
         NATS_CLUSTER_PORT=6222
         ```
     
 13. جایگزین کنید:
 14.  * `NATS_CLIENT_PORT` با پورت اتصال کلاینت.
      * `NATS_CLUSTER_PORT` با پورت ارتباطی خوشه.
 15. فایل را ذخیره کنید و ببندید.

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

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

 1.  فایل باینری NATS CLI را دانلود کنید.
 2.  console
 3.      ```
         $ curl -sf https://binaries.nats.dev/nats-io/natscli/nats@latest | sh
         ```
     
 4.  فایل باینری را به PATH سیستم خود منتقل کنید.
 5.  console
 6.      ```
         $ sudo mv nats /usr/local/bin/
         ```
     
 7.  نصب را تأیید کنید.
 8.  console
 9.      ```
         $ nats --version
         ```
     
 10. یک هش رمز عبور برای کاربر سیستم یا برنامه ایجاد کنید.
 11. console
 12.     ```
         $ nats server passwd
         ```
     
 13. رمز عبور را دو بار وارد کنید و هش تولید شده را کپی کنید.
 14. خروجی شما باید مشابه زیر باشد:
 15.     ```
         $2a$11$C6sj6xxxxx....
         ```
     
 16. این مرحله را برای هر کاربری که می خواهید تعریف کنید، تکرار کنید.
 17. فایل پیکربندی NATS را ایجاد کنید.
 18. console
 19.     ```
         $ nano config/nats.conf
         ```
     
 20. پیکربندی زیر را اضافه کنید:
 21. ini
 22.     ```
         # 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}
          ]
         }
         ```
     
 23. در پیکربندی بالا:
 24.  * `server_name` سرور NATS را در لاگ ها، خروجی مانیتورینگ و رویدادهای سیستم شناسایی
        می کند.
      * `system_account` ویژگی های سیستم داخلی مورد نیاز برای نظارت و مدیریت JetStream
        را فعال می کند.
      * `accounts` مرزهای احراز هویت را برای کاربران سیستم و برنامه تعریف می کند
      * `authorization` کنترل دسترسی در سطح موضوع را اعمال می کند، با مجموعه ای از 
        مجوزهای مدیریتی که دسترسی کامل به انتشار و اشتراک را اعطا می کند.
      * **JetStream** امکان ماندگاری پیام را با محدودیت های حافظه و دیسک تعریف شده 
        فراهم می کند.
 25. قبل از شروع سرویس، مقادیر زیر را جایگزین کنید:
 26.  * `NATS_SERVER_NAME` با نام سرور توصیفی
      * `SYSTEM_PASSWORD_HASH` با هش bcrypt تولید شده برای کاربر سیستم.
      * `USERNAME` با نام کاربری برنامه شما.
      * `USER_PASSWORD_HASH` با هش bcrypt تولید شده برای کاربر برنامه.
 27. فایل را ذخیره کنید و ببندید.

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

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

 1.  مانیفست Docker Compose را ایجاد کنید.
 2.  console
 3.      ```
         $ nano docker-compose.yaml
         ```
     
 4.  محتوای زیر را اضافه کنید:
 5.  yaml
 6.      ```
         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
         ```
     
 7.  فایل را ذخیره کنید و ببندید.
 8.  در این مانیفست:
 9.   * **image**: از تصویر رسمی NATS ۲.۱۲ استفاده می کند.
      * **command**: پیکربندی سفارشی NATS را در هنگام راه اندازی بارگذاری می کند.
      * **ports**:
         - `4222`: اتصالات کلاینت.
         - `8222`: نقطه پایانی مانیتورینگ (فقط میزبان محلی).
         - `6222`: ارتباط خوشه ای.
      * **volumes**:
         - `./data`: پیام های JetStream همچنان باقی می مانند..
         - `./config/nats.conf`: پیکربندی سرور را تزریق می کند..
      * **healthcheck**: تأیید می کند که سرور به پینگ ها پاسخ می دهد.
      * **restart: unless-stopped**:سرویس را به صورت خودکار مجدداً راه اندازی می کند.
 10. سرویس NATS را شروع کنید.
 11. console
 12.     ```
         $ docker compose up -d
         ```
     
 13. تأیید کنید که سرویس NATS در حال اجرا است.
 14. console
 15.     ```
         $ docker compose ps
         ```
     
 16. مطمئن شوید که خروجی نشان می دهد کانتینر NATS سالم و در حال اجرا است.
 17. در صورت نیاز، لاگ ها را مشاهده کنید.
 18. console
 19.     ```
         $ docker compose logs
         ```
     
 20. برای اطلاعات بیشتر در مورد مدیریت پشته 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 تأیید کردید.
