corda/enterprise-cliCorda Enterprise Linux 官方镜像是由 Corda 官方提供的容器化解决方案,基于 Linux 操作系统构建,用于简化 Corda Enterprise 分布式账本平台的部署、运行与管理。该镜像封装了 Corda Enterprise 运行所需的依赖环境,支持快速搭建企业级 Corda 节点,适用于开发、测试及生产环境的分布式账本应用部署。
corda/enterprise:4.10)。通过 Docker Hub 拉取官方镜像(需替换 <version> 为目标 Corda Enterprise 版本,如 4.10):
bashdocker pull corda/enterprise:<version>
查看本地镜像:
bashdocker images | grep corda/enterprise
使用默认配置启动 Corda 节点(适用于测试环境,不建议生产使用):
bashdocker run -d \ --name corda-enterprise-node \ -p ***:*** \ # P2P 通信端口 -p ***:*** \ # RPC 端口 corda/enterprise:<version>
通过环境变量和数据卷挂载自定义节点配置(生产环境示例):
bashdocker run -d \ --name corda-enterprise-node \ -p ***:*** \ # P2P 端口(节点间通信) -p ***:*** \ # RPC 端口(客户端连接) -p ***:*** \ # SSH 端口(可选,用于节点管理) -e CORDA_NODE_NAME="MyEnterpriseNode" \ # 节点名称 -e CORDA_P2P_PORT=*** \ # P2P 端口(需与 -p 映射一致) -e CORDA_RPC_PORT=*** \ # 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>
使用 docker-compose.yml 管理节点与依赖服务(如 PostgreSQL 数据库):
yamlversion: '3.8' services: corda-node: image: corda/enterprise:<version> container_name: corda-enterprise-node ports: - "***:***" # P2P 端口 - "***:***" # RPC 端口 environment: - CORDA_NODE_NAME="MyEnterpriseNode" - CORDA_P2P_PORT=*** - CORDA_RPC_PORT=*** - 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: 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:
启动服务:
bashdocker-compose up -d
| 环境变量名 | 描述 | 默认值 | 示例值 |
|---|---|---|---|
CORDA_NODE_NAME | 节点名称(需唯一) | CordaNode | MyBankNode |
CORDA_P2P_PORT | P2P 通信端口(节点间连接) | *** | *** |
CORDA_RPC_PORT | RPC 端口(客户端连接) | *** | *** |
CORDA_SSH_PORT | SSH 端口(节点管理,可选) | 2222 | *** |
CORDA_DB_TYPE | 数据库类型(支持 h2/postgresql/oracle) | h2 | postgresql |
CORDA_DB_URL | 数据库连接 URL | jdbc:h2:file:/opt/corda/data/node | jdbc:postgresql://postgres:5432/corda_db |
CORDA_DB_USER | 数据库用户名 | sa | corda_user |
CORDA_DB_PASSWORD | 数据库密码 | 空 | SecurePassw0rd! |
CORDA_LOG_LEVEL | 日志级别(DEBUG/INFO/WARN/ERROR) | INFO | DEBUG (开发环境) |
Corda 节点数据(如账本数据、证书、配置文件)需持久化存储,避免容器重启后数据丢失。推荐通过 Docker 数据卷挂载实现:
/opt/corda/data(包含账本数据、P2P 证书等)/etc/corda(可挂载自定义 node.conf)示例(挂载本地目录):
bashdocker run -d \ --name corda-enterprise-node \ -v /local/corda/data:/opt/corda/data \ # 本地目录挂载(生产环境推荐) -v /local/corda/config:/etc/corda \ # 挂载自定义配置 corda/enterprise:<version>
--memory 和 --cpus 参数限制容器资源,避免过度占用主机资源。manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务