# آموزش نصب CouchDB

- پیوند: https://negarnovin.com/docs/how-to-deploy-couchdb/
- منتشرشده: 2026-02-18T15:26:09+00:00
- نویسنده: نگارنوین

# نحوه راه اندازی CouchDB – فروشگاه اسناد JSON

CouchDB یک پایگاه داده متن باز مبتنی بر سند است که داده ها را به صورت اسناد JSON
ذخیره می کند. این پایگاه داده یک API HTTP RESTful برای تمام عملیات پایگاه داده، 
تکثیر داخلی و کنترل همزمانی چند نسخه ای ارائه می دهد. طراحی بدون طرحواره CouchDB
آن را برای ذخیره سازی لاگ در جایی که ساختارهای سند ممکن است متفاوت باشند، ایده آل
می کند و رابط مبتنی بر HTTP آن، ادغام با ابزارهای جمع آوری لاگ را ساده می کند.

[**سرور مجازی فرانسه**](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/)

در این مقاله، شما CouchDB را با استفاده از Docker Compose مستقر خواهید کرد، ذخیره
سازی پایدار را برای فایل های پایگاه داده پیکربندی خواهید کرد و Traefik را به عنوان
یک پروکسی معکوس برای دسترسی ایمن به نمونه CouchDB خود تنظیم خواهید کرد.

 

## پیش نیازها

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

 * به عنوان یک کاربر غیر ریشه با امتیازات sudo به یک سرور مبتنی بر اوبونتو ۲۴.۰۴
   دسترسی داشته باشید.
 * داکر و داکر کامپوز را نصب کنید.
 * یک رکورد دامنه A که به آدرس IP سرور شما اشاره می کند پیکربندی کنید (برای مثال،`
   couchdb.example.com`).

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

در این بخش، ساختار دایرکتوری مورد نیاز برای CouchDB را آماده می کنید و متغیرهای 
محیطی را در یک فایل  `.env` تعریف می کنید.

 1.  ساختار دایرکتوری برای CouchDB را ایجاد کنید.
 2.  console
 3.      ```
         $ mkdir -p ~/couchdb-logging/couchdb-data
         ```
     
 4.  این دایرکتوری فایل های پایگاه داده، نماها و تنظیمات پیکربندی را ذخیره می کند.
 5.  به دایرکتوری  `couchdb-logging` بروید.
 6.  console
 7.      ```
         $ cd ~/couchdb-logging
         ```
     
 8.  مالکیت صحیح را برای دایرکتوری داده های CouchDB تنظیم کنید. CouchDB به عنوان کاربر
     [couchdb (UID 5984)](https://github.com/apache/couchdb-docker/blob/main/3.3.3/Dockerfile)
     درون کانتینر اجرا می شود.
 9.  console
 10.     ```
         $ sudo chown -R 5984:5984 couchdb-data
         ```
     
 11. یک فایل `.env`  ایجاد کنید.
 12. console
 13.     ```
         $ nano .env
         ```
     
 14. متغیرهای زیر را اضافه کنید:
 15. ini
 16.     ```
         DOMAIN=couchdb.example.com
         LETSENCRYPT_EMAIL=admin@example.com
     
         COUCHDB_USER=admin
         COUCHDB_PASSWORD=changeme
         ```
     
 17. جایگزین کردن:
 18.  * `couchdb.example.com` با دامنه شما.
      * `admin@example.com` با ایمیل شما.
      * `changeme` با یک رمز عبور قوی.
 19. فایل را ذخیره کنید و ببندید.

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

در این بخش، شما پشته Docker Compose را که CouchDB را پشت Traefik اجرا می کند، ایجاد
و مستقر می کنید. Docker Compose هر دو کانتینر را مدیریت می کند، متغیرهای محیطی را
از فایل `.env` شما اعمال می کند و به طور خودکار مسیریابی HTTPS را از طریق Traefik
پیکربندی می کند.

 1.  یک مانیفست جدید Docker Compose ایجاد کنید.
 2.  console
 3.      ```
         $ nano docker-compose.yaml
         ```
     
 4.  محتوای زیر را اضافه کنید.
 5.  yaml
 6.      ```
         services:
          traefik:
          image: traefik:v3.6
          container_name: traefik
          command:
          - "--providers.docker=true"
          - "--providers.docker.exposedbydefault=false"
          - "--entrypoints.web.address=:80"
          - "--entrypoints.websecure.address=:443"
          - "--entrypoints.web.http.redirections.entrypoint.to=websecure"
          - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
          - "--certificatesresolvers.letsencrypt.acme.httpchallenge=true"
          - "--certificatesresolvers.letsencrypt.acme.httpchallenge.entrypoint=web"
          - "--certificatesresolvers.letsencrypt.acme.email=${LETSENCRYPT_EMAIL}"
          - "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json"
          ports:
          - "80:80"
          - "443:443"
          volumes:
          - "letsencrypt:/letsencrypt"
          - "/var/run/docker.sock:/var/run/docker.sock:ro"
          restart: unless-stopped
     
          couchdb:
          image: couchdb:latest
          container_name: couchdb
          hostname: couchdb
          expose:
          - "5984"
          volumes:
          - "./couchdb-data:/opt/couchdb/data"
          environment:
          - COUCHDB_USER=${COUCHDB_USER}
          - COUCHDB_PASSWORD=${COUCHDB_PASSWORD}
          labels:
          - "traefik.enable=true"
          - "traefik.http.routers.couchdb.rule=Host(`${DOMAIN}`)"
          - "traefik.http.routers.couchdb.entrypoints=websecure"
          - "traefik.http.routers.couchdb.tls.certresolver=letsencrypt"
          - "traefik.http.services.couchdb.loadbalancer.server.port=5984"
          restart: unless-stopped
     
         volumes:
          letsencrypt:
         ```
     
 7.  فایل را ذخیره کنید و ببندید.
 8.  این پیکربندی شامل موارد زیر است:
 9.   * **services**: دو کانتینر برای ارائه پشته پایگاه داده با هم همکاری می کنند:
         - **traefik**: به عنوان روتر لبه عمل می کند، گواهینامه های SSL را دریافت می
           کند و ترافیک HTTPS را به پایگاه داده هدایت می کند.
         - **couchdb**: میزبان موتور پایگاه داده NoSQL است و به API و رابط وب RESTful
           سرویس می دهد.
      * **image**: تصاویر رسمی کانتینر را از ناشران تأیید شده Docker Hub دریافت می 
        کند.
      * **container_name**: از نام های استاتیک توصیفی برای عملیات ساده کانتینر استفاده
        می کند.
      * **command (Traefik)**: کشف سرویس مبتنی بر داکر را فعال می کند، شنونده های HTTP(
        ۸۰) و HTTPS (۴۴۳) را باز می کند، تمام HTTP را به طور خودکار به HTTPS هدایت 
        می کند و کلاینت Let’s Encrypt ACME را با روش چالش HTTP-۰۱ پیکربندی می کند.
      * **ports (Traefik)**: پورت های وب سرویس ۸۰ و ۴۴۳ را برای دسترسی عمومی در اختیار
        سیستم میزبان قرار می دهد.
      * **expose (CouchDB)**: پورت ۵۹۸۴ را فقط برای ارتباطات بین کانتینرها باز می کند
        و اتصالات مستقیم خارجی را مسدود می کند.
      * **volumes**:
         - دستور Bind mount  (`./couchdb-data`)  فایل ها و اسناد پایگاه داده را در 
           طول راه اندازی های مجدد حفظ می کند.
         - درایو نامگذاری شده  `letsencrypt`  به طور مستقل از ذخیره سازی گواهی SSL 
           پشتیبانی می کند.
         - دسترسی فقط خواندنی به سوکت داکر(`/var/run/docker.sock:ro`)  امکان تشخیص 
           پویای کانتینر را فراهم می کند.
      * **environment (CouchDB)**: اطلاعات احراز هویت مدیر را از فایل ‎.env‎ دریافت
        می کند.
      * **labels (CouchDB)**: حاشیه نویسی های پیکربندی که به Traefik دستور می دهند 
        درخواست ها را پروکسی کند، بر اساس نام دامنه مسیریابی کند، گواهی های SSL را 
        ضمیمه کند و پورت سرویس backend را مشخص کند.
      * **restart: unless-stopped**: تضمین می کند که کانتینرها پس از خرابی، به استثنای
        توقف های دستی، به طور خودکار به کار خود ادامه می دهند.
 10. سرویس ها را ایجاد و شروع کنید.
 11. console
 12.     ```
         $ docker compose up -d
         ```
     
 13. تأیید کنید که سرویس ها در حال اجرا هستند.
 14. console
 15.     ```
         $ docker compose ps
         ```
     
 16. خروجی:
 17.     ```
         NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
         couchdb couchdb:latest "tini -- /docker-ent…" couchdb 18 seconds ago Up 17 seconds 5984/tcp
         traefik traefik:v3.6 "/entrypoint.sh --pr…" traefik 18 seconds ago Up 17 seconds 0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:443->443/tcp, [::]:443->443/tcp
         ```
     
 18. هر دو کانتینر عملیاتی هستند. CouchDB درخواست های پایگاه داده را می پذیرد در حالی
     که Traefik اتصالات روی پورت های  `80` و  `443`.را مدیریت می کند.
 19. مشاهده لاگ های سرویس ها
 20. console
 21.     ```
         $ docker compose logs
         ```
     
 22. برای اطلاعات بیشتر در مورد مدیریت پشته Docker Compose، به مقاله نحوه استفاده از
     Docker Compose مراجعه کنید.

## دسترسی به CouchDB

این بخش نحوه تأیید نصب CouchDB خود را با دسترسی به کنسول وب Fauxton و اجرای عملیات
اساسی پایگاه داده از طریق رابط RESTful HTTP نشان می دهد.

 1.  رابط وب CouchDB را در مرورگر خود باز کنید.
 2.      ```
         https://couchdb.example.com/_utils
         ```
     
 3.  با استفاده از اطلاعات کاربری که در فایل  `.env` پیکربندی کرده اید، وارد سیستم 
     شوید:
 4.   * **Username**: مقداری که برای  `COUCHDB_USER`  تنظیم کرده اید (پیش فرض:  `admin`)
      * **Password**: مقداری که برای  `COUCHDB_PASSWORD` تنظیم کرده اید
 5.  رابط کاربری فاکستون نمایش داده می شود. این کنسول مدیریتی مبتنی بر وب به شما امکان
     می دهد پایگاه های داده، اسناد و تنظیمات تکثیر را مدیریت کنید.
 6.  با استفاده از خط فرمان، تأیید کنید که CouchDB پاسخ می دهد.
 7.  console
 8.      ```
         $ curl https://couchdb.example.com
         ```
     
 9.  خروجی:
 10.     ```
         {
          "couchdb": "Welcome",
          "version": "3.5.1",
          "git_sha": "44f6a43d8",
          "uuid": "92800b247a331df27afce9ad744a370b",
          "features": [
          "access-ready",
          "partitioned",
          "pluggable-storage-engines",
          "reshard",
          "scheduler"
          ],
          "vendor": {
          "name": "The Apache Software Foundation"
          }
         }
         ```
     
 11. یک پایگاه داده آزمایشی ایجاد کنید.
 12. console
 13.     ```
         $ curl -X PUT https://admin:changeme@couchdb.example.com/logs
         ```
     
 14. به جای  `admin:changeme` ، اطلاعات کاربری واقعی خود را وارد کنید..
 15. خروجی:
 16.     ```
         {"ok":true}
         ```
     
 17. یک سند گزارش نمونه وارد کنید.
 18. console
 19.     ```
         $ curl -X POST https://admin:changeme@couchdb.example.com/logs \
          -H "Content-Type: application/json" \
          -d '{
          "timestamp": "2025-12-01T20:47:23Z",
          "level": "INFO",
          "message": "Application started successfully",
          "service": "web-server"
          }'
         ```
     
 20. خروجی شامل شناسه سند و نسخه آن است:
 21.     ```
         {"ok":true,"id":"f234689e3359a8a43434713cb20008a5","rev":"1-6a43114e6467b83a73137f1112b9db8e"}
         ```
     
 22. بازیابی تمام اسناد از پایگاه داده.
 23. console
 24.     ```
         $ curl https://admin:changeme@couchdb.example.com/logs/_all_docs
         ```
     
 25. پاسخ تأیید می کند که سند شما با موفقیت ذخیره شده است.

[**سرور مجازی اتریش**](https://negarnovin.com/%D8%B3%D8%B1%D9%88%D8%B1-%D9%85%D8%AC%D8%A7%D8%B2%DB%8C-%D8%A7%D8%AA%D8%B1%DB%8C%D8%B4/)

## نتیجه گیری

شما با موفقیت CouchDB را برای مدیریت لاگ با رمزگذاری HTTPS مستقر کرده اید. معماری
کانتینر شده، پایگاه داده اسناد را با مدیریت خودکار گواهینامه جفت می کند و از پایداری
داده ها در طول راه اندازی مجدد سرویس از طریق والیوم های bind-mounted اطمینان حاصل
می کند. Traefik خاتمه SSL و مسیریابی درخواست را مدیریت می کند در حالی که Let’s Encrypt
گواهینامه های معتبر را فراهم می کند. استقرار CouchDB شما اکنون می تواند اسناد لاگ
JSON را از طریق رابط RESTful خود بپذیرد، از تکثیر بلادرنگ در سراسر گره ها پشتیبانی
کند و تجزیه و تحلیل پیشرفته لاگ را از طریق کوئری های MapReduce و کنسول وب Fauxton
فعال کند.
