corda/enterprise-cli

Corda Enterprise Linux 官方镜像文档

1. 镜像概述和主要用途

Corda Enterprise Linux 官方镜像是由 Corda 官方提供的容器化解决方案，基于 Linux 操作系统构建，用于简化 Corda Enterprise 分布式账本平台的部署、运行与管理。该镜像封装了 Corda Enterprise 运行所需的依赖环境，支持快速搭建企业级 Corda 节点，适用于开发、测试及生产环境的分布式账本应用部署。

2. 核心功能和特性

• 官方认证与支持：由 Corda 官方维护，确保与 Corda Enterprise 版本的兼容性，提供企业级技术支持服务。
• 企业级安全加固：集成安全最佳实践，包括容器镜像漏洞扫描、最小权限原则配置及敏感信息保护机制。
• 多版本兼容：支持 Corda Enterprise 各稳定版本（具体版本可通过镜像标签指定，如 corda/enterprise:4.10）。
• 轻量级部署：基于精简 Linux 基础镜像，减少资源占用，支持快速启动与扩展。
• 灵活配置：通过环境变量、配置文件挂载等方式自定义节点参数，适配不同业务场景需求。
• 标准化运行环境：统一依赖版本，避免“环境不一致”问题，简化跨环境迁移。

3. 使用场景和适用范围

• 企业级分布式应用开发：作为 Corda 节点运行环境，支持开发基于 Corda 的智能合约与分布式应用。
• 交易系统：构建安全合规的跨机构交易平台，如支付结算、跨境汇款等。
• 供应链*平台**：实现上下游企业间的透明化协作，优化贸易融资流程。
• 数字资产管理：支持数字资产的发行、流转与结算，满足监管合规要求。
• 跨组织协作系统：为多参与方提供可信数据共享与业务协同能力，如物流追踪、知识产权管理等。

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker 19.03+ 环境，支持 Linux/Windows/macOS 系统。
• （生产环境）建议配置持久化存储、网络隔离及资源限制。

4.2 获取镜像

通过 Docker Hub 拉取官方镜像（需替换 <version> 为目标 Corda Enterprise 版本，如 4.10）：

bash
docker pull docker.xuanyuan.run/corda/enterprise:<version>

查看本地镜像：

bash
docker images | grep corda/enterprise

4.3 基本运行示例

4.3.1 快速启动 Corda 节点

使用默认配置启动 Corda 节点（适用于测试环境，不建议生产使用）：

bash
docker run -d \
  --name corda-enterprise-node \
  -p 10002:10002 \  # P2P 通信端口
  -p 10003:10003 \  # RPC 端口
  corda/enterprise:<version>

4.3.2 自定义配置启动（推荐）

通过环境变量和数据卷挂载自定义节点配置（生产环境示例）：

bash
docker run -d \
  --name corda-enterprise-node \
  -p 10002:10002 \  # P2P 端口（节点间通信）
  -p 10003:10003 \  # RPC 端口（客户端连接）
  -p 10004:10004 \  # SSH 端口（可选，用于节点管理）
  -e CORDA_NODE_NAME="MyEnterpriseNode" \  # 节点名称
  -e CORDA_P2P_PORT=10002 \               # P2P 端口（需与 -p 映射一致）
  -e CORDA_RPC_PORT=10003 \               # RPC 端口
  -e CORDA_DB_TYPE="postgresql" \         # 数据库类型（支持 postgresql/oracle/h2 等）
  -e CORDA_DB_URL="jdbc:postgresql://db-host:5432/corda_db" \  # 数据库连接 URL
  -e CORDA_DB_USER="corda_user" \          # 数据库用户名
  -e CORDA_DB_PASSWORD="secure_password" \ # 数据库密码
  -v /host/path/to/node.conf:/etc/corda/node.conf \  # 挂载自定义节点配置文件
  -v corda-data:/opt/corda/data \          # 持久化节点数据（使用命名卷）
  corda/enterprise:<version>

4.4 Docker Compose 配置示例

使用 docker-compose.yml 管理节点与依赖服务（如 PostgreSQL 数据库）：

yaml
version: '3.8'

services:
  corda-node:
    image: docker.xuanyuan.run/corda/enterprise:<version>
    container_name: corda-enterprise-node
    ports:
      - "10002:10002"  # P2P 端口
      - "10003:10003"  # RPC 端口
    environment:
      - CORDA_NODE_NAME="MyEnterpriseNode"
      - CORDA_P2P_PORT=10002
      - CORDA_RPC_PORT=10003
      - CORDA_DB_TYPE="postgresql"
      - CORDA_DB_URL="jdbc:postgresql://postgres:5432/corda_db"
      - CORDA_DB_USER="corda_user"
      - CORDA_DB_PASSWORD="secure_password"
    volumes:
      - ./node.conf:/etc/corda/node.conf  # 本地节点配置文件
      - corda-data:/opt/corda/data        # 持久化数据卷
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: docker.xuanyuan.run/postgres:13
    container_name: corda-postgres
    environment:
      - POSTGRES_DB=corda_db
      - POSTGRES_USER=corda_user
      - POSTGRES_PASSWORD=secure_password
    volumes:
      - postgres-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    restart: unless-stopped

volumes:
  corda-data:
  postgres-data:

启动服务：

bash
docker-compose up -d

4.5 核心配置参数（环境变量）

4.6 数据持久化

Corda 节点数据（如账本数据、证书、配置文件）需持久化存储，避免容器重启后数据丢失。推荐通过 Docker 数据卷挂载实现：

• 核心数据目录：/opt/corda/data（包含账本数据、P2P 证书等）
• 配置文件目录：/etc/corda（可挂载自定义 node.conf）

示例（挂载本地目录）：

bash
docker run -d \
  --name corda-enterprise-node \
  -v /local/corda/data:/opt/corda/data \  # 本地目录挂载（生产环境推荐）
  -v /local/corda/config:/etc/corda \     # 挂载自定义配置
  corda/enterprise:<version>

5. 注意事项

• 版本兼容性：镜像标签需与 Corda Enterprise 版本匹配，避免版本不兼容问题。
• 安全配置：生产环境中需通过环境变量或配置文件设置强密码，禁用默认凭证，限制端口暴露范围。
• 资源限制：建议通过 --memory 和 --cpus 参数限制容器资源，避免过度占用主机资源。
• 备份策略：定期备份持久化数据卷，防止数据丢失。
• 网络隔离：生产环境需配置 Docker 网络隔离，仅开放必要端口（如 P2P/RPC）。