آموزش نصب CouchDB

https://negarnovin.com/docs/how-to-deploy-couchdb/ · آخرین به‌روزرسانی: · نویسنده: نگارنوین · سایت: نگارنوین · 8 دقیقه مطالعه

📌 خلاصه (TL;DR)

آموزش نصب How to Deploy CouchDB یک پایگاه داده متن باز مبتنی بر سند است که داده ها را به صورت اسناد JSON ذخیره می کند

📊 حقایق کلیدی

URLhttps://negarnovin.com/docs/how-to-deploy-couchdb/
تاریخ انتشار2026-02-18
آخرین به‌روزرسانی2026-02-18
نویسندهنگارنوین
ناشرنگارنوین
زبانفارسی (fa-IR)
تعداد کلمات1404
نوع صفحهبرگه

📄 محتوای کامل

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

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

سرور مجازی فرانسه

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

پیش نیازها

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

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

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

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

  1. ساختار دایرکتوری برای CouchDB را ایجاد کنید. consoleCopy
    $ mkdir -p ~/couchdb-logging/couchdb-data

    این دایرکتوری فایل های پایگاه داده، نماها و تنظیمات پیکربندی را ذخیره می کند.

  2. به دایرکتوری couchdb-logging بروید. consoleCopy
    $ cd ~/couchdb-logging
  3. مالکیت صحیح را برای دایرکتوری داده های CouchDB تنظیم کنید. CouchDB به عنوان کاربر couchdb (UID 5984) درون کانتینر اجرا می شود. consoleCopy
    $ sudo chown -R 5984:5984 couchdb-data
  4. یک فایل .env ایجاد کنید. consoleCopy
    $ nano .env

    متغیرهای زیر را اضافه کنید:

    iniCopy
    DOMAIN=couchdb.example.com
    [email protected]
    
    COUCHDB_USER=admin
    COUCHDB_PASSWORD=changeme

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

    • couchdb.example.com با دامنه شما.
    • [email protected] با ایمیل شما.
    • changeme با یک رمز عبور قوی.

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

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

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

  1. یک مانیفست جدید Docker Compose ایجاد کنید. consoleCopy
    $ nano docker-compose.yaml
  2. محتوای زیر را اضافه کنید. yamlCopy
    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:

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

    این پیکربندی شامل موارد زیر است:

    • 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: تضمین می کند که کانتینرها پس از خرابی، به استثنای توقف های دستی، به طور خودکار به کار خود ادامه می دهند.
  3. سرویس ها را ایجاد و شروع کنید. consoleCopy
    $ docker compose up -d
  4. تأیید کنید که سرویس ها در حال اجرا هستند. consoleCopy
    $ docker compose ps

    خروجی:

    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

    هر دو کانتینر عملیاتی هستند. CouchDB درخواست های پایگاه داده را می پذیرد در حالی که Traefik اتصالات روی پورت های 80 و 443.را مدیریت می کند.

  5. مشاهده لاگ های سرویس ها consoleCopy
    $ docker compose logs

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

دسترسی به CouchDB

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

  1. رابط وب CouchDB را در مرورگر خود باز کنید.
    https://couchdb.example.com/_utils
  2. با استفاده از اطلاعات کاربری که در فایل .env پیکربندی کرده اید، وارد سیستم شوید:
    • Username: مقداری که برای COUCHDB_USER تنظیم کرده اید (پیش فرض: admin)
    • Password: مقداری که برای COUCHDB_PASSWORD تنظیم کرده اید
  3. رابط کاربری فاکستون نمایش داده می شود. این کنسول مدیریتی مبتنی بر وب به شما امکان می دهد پایگاه های داده، اسناد و تنظیمات تکثیر را مدیریت کنید.
  4. با استفاده از خط فرمان، تأیید کنید که CouchDB پاسخ می دهد. consoleCopy
    $ curl https://couchdb.example.com

    خروجی:

    {
     "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"
     }
    }
  5. یک پایگاه داده آزمایشی ایجاد کنید. consoleCopy
    $ curl -X PUT https://admin:[email protected]/logs

    به جای admin:changeme ، اطلاعات کاربری واقعی خود را وارد کنید..

    خروجی:

    {"ok":true}
  6. یک سند گزارش نمونه وارد کنید. consoleCopy
    $ curl -X POST https://admin:[email protected]/logs \
     -H "Content-Type: application/json" \
     -d '{
     "timestamp": "2025-12-01T20:47:23Z",
     "level": "INFO",
     "message": "Application started successfully",
     "service": "web-server"
     }'

    خروجی شامل شناسه سند و نسخه آن است:

    {"ok":true,"id":"f234689e3359a8a43434713cb20008a5","rev":"1-6a43114e6467b83a73137f1112b9db8e"}
  7. بازیابی تمام اسناد از پایگاه داده. consoleCopy
    $ curl https://admin:[email protected]/logs/_all_docs

    پاسخ تأیید می کند که سند شما با موفقیت ذخیره شده است.

سرور مجازی اتریش

نتیجه گیری

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

🏷️ کلمات کلیدی

آموزش نصب CouchDB، نحوه راه اندازی CouchDB – فروشگاه اسناد JSON، پیش نیازها، تنظیم ساختار دایرکتوری و متغیرهای محیطی، خرید آموزش نصب CouchDB، قیمت آموزش نصب CouchDB، بهترین آموزش نصب CouchDB

🧩 JSON-LD

{"@context":"https://schema.org","@type":"WebPage","headline":"آموزش نصب CouchDB","url":"https://negarnovin.com/docs/how-to-deploy-couchdb/","datePublished":"2026-02-18T11:56:09+03:30","dateModified":"2026-02-18T11:56:09+03:30","author":{"@type":"Person","name":"نگارنوین"},"publisher":{"@type":"Organization","name":"نگارنوین"},"inLanguage":"fa-IR","description":"آموزش نصب How to Deploy CouchDB یک پایگاه داده متن باز مبتنی بر سند است که داده ها را به صورت اسناد JSON ذخیره می کند"}

📈 آمار و ارقام قابل استناد

📄 نحوهٔ استناد به این صفحه

متن ساده:

آموزش نصب CouchDB — نگارنوین (https://negarnovin.com/docs/how-to-deploy-couchdb/)، آخرین به‌روزرسانی 2026-02-18

Markdown:

[آموزش نصب CouchDB](https://negarnovin.com/docs/how-to-deploy-couchdb/) — نگارنوین (به‌روزرسانی 2026-02-18)