Couchbase Server Docker 镜像文档

镜像概述和主要用途

Couchbase Server 是一个基于分布式架构的 NoSQL 文档数据库，专为企业级应用设计。它结合了内存优先架构、灵活的 JSON 数据模型和强大的查询能力，提供亚毫秒级延迟、99.999% 可用性和水平扩展能力，适用于支撑高并发、大规模的关键业务应用。

支持的标签及对应 Dockerfile 链接

企业版（Enterprise Edition）

• 7.6.7, enterprise, enterprise-7.6.7, latest (Dockerfile)
• 7.6.6, enterprise-7.6.6 (Dockerfile)
• 7.6.5, enterprise-7.6.5 (Dockerfile)
• 7.6.4, enterprise-7.6.4 (Dockerfile)
• 7.6.3, enterprise-7.6.3 (Dockerfile)
• 7.6.2, enterprise-7.6.2 (Dockerfile)
• 7.6.1, enterprise-7.6.1 (Dockerfile)
• 7.6.0, enterprise-7.6.0 (Dockerfile)
• 7.2.7, enterprise-7.2.7 (Dockerfile)
• 7.2.6, enterprise-7.2.6 (Dockerfile)
• 7.2.5, enterprise-7.2.5 (Dockerfile)
• 7.2.4, enterprise-7.2.4 (Dockerfile)
• 7.2.3, enterprise-7.2.3 (Dockerfile)
• 7.2.2, enterprise-7.2.2 (Dockerfile)
• 7.2.0, enterprise-7.2.0 (Dockerfile)

社区版（Community Edition）

• community, community-7.6.2 (Dockerfile)
• community-7.6.1 (Dockerfile)
• community-7.6.0 (Dockerfile)
• community-7.2.4 (Dockerfile)
• community-7.2.2 (Dockerfile)
• community-7.2.0 (Dockerfile)

核心功能与特性

卓越的灵活性与敏捷性

• 多数据访问模式：支持键值、N1QL查询（类SQL）、全文搜索等多种访问方式，满足不同应用场景需求。
• JSON数据模型：原生支持JSON文档，适应快速变化的业务需求，无需预定义 schema。
• 事件驱动工作负载：支持数据驱动的业务逻辑执行，实现集中化的数据处理流程。

极致的性能与可扩展性

• 内存优先架构：数据优先加载至内存，确保亚毫秒级响应延迟，支持高并发读写。
• 高性能索引：支持复杂连接、谓词和聚合操作的高性能索引，支持索引分区提升查询效率。
• 端到端数据压缩：减少网络、内存和存储开销，优化资源利用率。
• 水平扩展：支持集群动态扩展，轻松应对数据量和访问量增长。

简化的管理与高可用性

• 多环境部署：支持在任何云环境、混合云或本地部署，兼容 Kubernetes 等容器编排平台。
• 跨数据中心复制（XDCR）：内置active-active跨数据中心复制，支持多区域、多云部署，确保数据高可用。
• 自动化运维：减少人工干预，支持集群自动发现、故障转移和数据重平衡。

使用场景与适用范围

• 企业级关键业务应用：支撑高并发、低延迟的交易系统、用户画像平台等。
• 实时数据处理：日志分析、实时监控、物联网数据采集等场景。
• 分布式系统：需要跨区域部署、数据多副本冗余的分布式应用。
• 敏捷开发项目：快速迭代的应用，需要灵活的数据模型和快速适配业务变化。
• 云原生应用：基于容器和Kubernetes的微服务架构，需要可扩展的数据库支持。

使用方法与配置说明

快速启动单节点集群

步骤1：运行Couchbase容器

使用以下命令启动单节点Couchbase Server容器，映射必要端口并命名容器：

bash
docker run -d \
  --name couchbase-node1 \
  -p 8091-8097:8091-8097 \
  -p 9123:9123 \
  -p ***:*** \
  -p ***:*** \
  -p ***:*** \
  -p ***-***:***-*** \
  couchbase:latest

端口说明：
Couchbase Server需暴露多个端口，用于Web控制台（8091）、N1QL查询（8093）、数据访问（）等，完整端口说明参见文档。

步骤2：通过Web控制台完成配置

容器启动后，访问 http://localhost:8091 打开Web控制台，按向导完成初始化：

1. 接受许可协议，设置管理员账户（用户名/密码）。
2. 配置服务（如数据服务、查询服务等），根据需求调整内存分配。
3. 创建集群（单节点模式），可选加载示例数据（如beer-sample桶）。

步骤3：验证部署

通过命令行工具 cbq 执行N1QL查询验证服务可用性：

bash
# 进入容器并执行查询
docker exec -it couchbase-node1 cbq --user Administrator --password <your-password>
cbq> SELECT name FROM `beer-sample` WHERE brewery_id = "mishawaka_brewing";

数据持久化配置

为避免容器删除导致数据丢失，需将Couchbase数据目录挂载至宿主机：

bash
docker run -d \
  --name couchbase-node1 \
  -p 8091-8097:8091-8097 \
  -p 9123:9123 \
  -p ***:*** \
  -p ***:*** \
  -p ***:*** \
  -p ***-***:***-*** \
  -v /path/on/host:/opt/couchbase/var \  # 宿主机目录映射至容器数据目录
  couchbase:latest

SELinux环境注意：若宿主机启用SELinux，需先配置目录权限：
mkdir -p /path/on/host && chcon -Rt svirt_sandbox_file_t /path/on/host

Docker Compose部署示例

以下是单节点Couchbase Server的docker-compose.yml配置示例：

yaml
version: '3.8'
services:
  couchbase:
    image: couchbase:latest
    container_name: couchbase-node1
    ports:
      - "8091:8091"   # Web控制台
      - "8092:8092"   # XDCR
      - "8093:8093"   # N1QL查询
      - "8094:8094"   # 全文搜索
      - "8095:8095"   # 分析服务
      - "8096:8096"   # 事件服务
      - "8097:8097"   # 备份服务
      - "9123:9123"   # 索引服务
      - "***:***" # SSL键值访问
      - "***:***" # 非SSL键值访问
      - "***:***" # 内部节点通信
      - "***-***:***-***" # SSL端口（对应8091-8097）
    volumes:
      - ./couchbase-data:/opt/couchbase/var
    environment:
      - COUCHBASE_ADMIN_USER=Administrator
      - COUCHBASE_ADMIN_PASSWORD=password  # 建议通过环境变量注入，生产环境使用secret管理
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量配置

Couchbase容器支持通过环境变量配置部分参数（详细列表参见***文档）：

• COUCHBASE_ADMIN_USER：管理员用户名（默认：Administrator）。
• COUCHBASE_ADMIN_PASSWORD：管理员密码。
• COUCHBASE_BUCKET：自动创建的桶名称。
• COUCHBASE_BUCKET_RAMSIZE：桶内存分配大小（如1024表示1GB）。

容器要求与最佳实践

资源要求

• 开发/测试环境：至少2核CPU，4GB内存。
• 生产环境：建议4核及以上CPU，8GB及以上内存，具体参考系统资源要求。

最佳实践

避免单点故障

• 生产环境需部署多节点集群，节点分散在不同物理机/虚拟机，确保数据副本跨节点存储，避免因单物理机故障导致集群不可用。

合理规划容器规格

• 容器CPU/内存应独占分配，避免资源超配导致性能波动。生产环境建议每节点至少4核CPU，内存根据数据量调整（如每100GB数据分配8GB内存）。

网络配置优化

• 生产环境建议使用--net=host网络模式，避免Docker NAT带来的性能损耗和网络复杂性。
• 集群节点间需保证低延迟网络，避免跨NAT部署，确保节点间通信畅通。

调整系统限制（ulimit）

Couchbase需调整系统文件描述符和内存锁定限制，启动容器时添加--ulimit参数：

bash
docker run -d \
  --name couchbase-node1 \
  --ulimit nofile=40960:40960 \       # 文件描述符限制
  --ulimit core=***:*** \ # 核心文件大小（100GB）
  --ulimit memlock=***:*** \ # 内存锁定（100GB，根据实际内存调整）
  -p 8091-8097:8091-8097 \
  couchbase:latest

多节点集群部署拓扑

拓扑1：单物理机多容器（开发/测试）

所有容器部署在同一物理机，适用于开发、测试或模拟生产环境。注意：该模式存在单点故障风险，生产环境不推荐。

部署步骤：

1. 启动多个容器，指定不同名称和端口偏移：

bash
# 节点1（默认端口）
docker run -d --name node1 -p 8091-8097:8091-8097 couchbase:latest

# 节点2（端口偏移1000）
docker run -d --name node2 -p 9091-9