---
title: آموزش نصب CouchDB
description: CouchDB یک پایگاه داده متن‌باز مبتنی بر سند است که داده‌ها را به صورت اسناد JSON ذخیره می‌کند. این پایگاه داده یک API HTTP RESTful برای تمام عملیات پایگاه داده، تکثیر داخلی و کنترل همزمانی چند نسخه‌ای ارائه می‌دهد. طراحی بدون طرحواره CouchDB آن را برای ذخیره‌سازی لاگ در جایی که ساختارهای سند ممکن است متفاوت باشند، ایده‌آل می‌کند و رابط مبتنی بر HTTP آن، ادغام با ابزارهای جمع‌آوری لاگ را ساده می‌کند.
url: "https://negarnovin.com/docs/how-to-deploy-couchdb/"
updated: "2026-02-18"
category: راهنماهای تنظیمات پیشرفته
---

# آموزش نصب CouchDB

# نحوه راه اندازی 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 را ایجاد کنید.  console
   ```
   $ mkdir -p ~/couchdb-logging/couchdb-data
   ```

   این دایرکتوری فایل های پایگاه داده، نماها و تنظیمات پیکربندی را ذخیره می کند.
2. به دایرکتوری  `couchdb-logging` بروید.  console
   ```
   $ cd ~/couchdb-logging
   ```
3. مالکیت صحیح را برای دایرکتوری داده های CouchDB تنظیم کنید. CouchDB به عنوان کاربر [couchdb (UID 5984)](https://github.com/apache/couchdb-docker/blob/main/3.3.3/Dockerfile) درون کانتینر اجرا می شود.  console
   ```
   $ sudo chown -R 5984:5984 couchdb-data
   ```
4. یک فایل `.env`  ایجاد کنید.  console
   ```
   $ nano .env
   ```

   متغیرهای زیر را اضافه کنید:
     ini
   ```
   DOMAIN=couchdb.example.com
   LETSENCRYPT_EMAIL=admin@example.com
   
   COUCHDB_USER=admin
   COUCHDB_PASSWORD=changeme
   ```

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

   - `couchdb.example.com` با دامنه شما.
   - `admin@example.com` با ایمیل شما.
   - `changeme` با یک رمز عبور قوی.

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

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

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

1. یک مانیفست جدید Docker Compose ایجاد کنید.  console
   ```
   $ nano docker-compose.yaml
   ```
2. محتوای زیر را اضافه کنید.  yaml
   ```
   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. سرویس ها را ایجاد و شروع کنید.  console
   ```
   $ docker compose up -d
   ```
4. تأیید کنید که سرویس ها در حال اجرا هستند.  console
   ```
   $ 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. مشاهده لاگ های سرویس ها  console
   ```
   $ 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 پاسخ می دهد.  console
   ```
   $ 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. یک پایگاه داده آزمایشی ایجاد کنید.  console
   ```
   $ curl -X PUT https://admin:changeme@couchdb.example.com/logs
   ```

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

   خروجی:

   ```
   {"ok":true}
   ```
6. یک سند گزارش نمونه وارد کنید.  console
   ```
   $ 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"
    }'
   ```

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

   ```
   {"ok":true,"id":"f234689e3359a8a43434713cb20008a5","rev":"1-6a43114e6467b83a73137f1112b9db8e"}
   ```
7. بازیابی تمام اسناد از پایگاه داده.  console
   ```
   $ curl https://admin:changeme@couchdb.example.com/logs/_all_docs
   ```

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

[**سرور مجازی اتریش**](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 فعال کند.

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