VIZ Ledger Documentation

中文

English
Русский

中文

English
Русский

Appearance

Docker 部署 ​

VIZ Ledger 提供四种 Docker 镜像，适用于不同的部署场景。所有镜像均采用两阶段构建：builder 阶段编译二进制文件；runtime 阶段仅包含二进制文件和配置。

可用镜像 ​

Dockerfile标签描述
Dockerfile-productionlatest完整主网节点（Release，全部插件）
Dockerfile-testnettestnet测试网节点（BUILD_TESTNET=ON）

快速开始 ​

bash
docker run -d \
  --name vizd \
  --restart unless-stopped \
  -p 2001:2001 \
  -p 8090:8090 \
  -p 8091:8091 \
  -v /data/vizd:/var/lib/vizd \
  vizblockchain/vizd:latest

查看日志：

bash
docker logs -f vizd

卷 ​

容器路径用途
/var/lib/vizd区块链数据、共享内存、block log
/etc/vizd配置文件

始终挂载 /var/lib/vizd 以在容器重启后保留状态。

使用自定义配置：

bash
docker run -d \
  -v /data/vizd:/var/lib/vizd \
  -v /my/config.ini:/etc/vizd/config.ini \
  vizblockchain/vizd:latest

环境变量 ​

入口脚本（vizd.sh）读取以下环境变量：

变量描述示例
VIZD_RPC_ENDPOINT覆盖 HTTP RPC 端点0.0.0.0:8090
VIZD_P2P_ENDPOINT覆盖 P2P 端点0.0.0.0:2001
VIZD_WITNESS验证者账户名（启用区块生产）alice
VIZD_PRIVATE_KEYWIF 格式的验证者签名密钥5J...

端口 ​

端口协议用途
2001TCPP2P 节点连接
8090TCPHTTP JSON-RPC
8091TCPWebSocket JSON-RPC

验证者节点（Docker） ​

bash
docker run -d \
  --name vizd-validator \
  --restart unless-stopped \
  -p 2001:2001 \
  -v /data/vizd:/var/lib/vizd \
  -e VIZD_WITNESS=myvalidator \
  -e VIZD_PRIVATE_KEY=5Jxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  vizblockchain/vizd:latest

对于验证者节点，不要公开暴露端口 8090/8091 — 仅绑定到 localhost：

bash
-e VIZD_RPC_ENDPOINT=127.0.0.1:8090

测试网节点 ​

bash
docker run -d \
  --name vizd-testnet \
  -p 2001:2001 \
  -p 8090:8090 \
  -v /data/vizd-testnet:/var/lib/vizd \
  vizblockchain/vizd:testnet

本地构建镜像 ​

bash
# Production
docker build \
  -f share/vizd/docker/Dockerfile-production \
  -t vizd:local \
  .

# Testnet
docker build \
  -f share/vizd/docker/Dockerfile-testnet \
  -t vizd:testnet \
  .

各镜像的 CMake 标志 ​

镜像LOW_MEMORY_NODEBUILD_TESTNET
productionOFFOFF
testnetOFFON

CI/CD（GitHub Actions） ​

仓库提供 .github/workflows/docker-main.yml，每次推送到 master 时自动构建并推送标记为 latest 的 production 镜像。

yaml
- name: Build and push
  uses: docker/build-push-action@v2
  with:
    file: share/vizd/docker/Dockerfile-production
    tags: vizblockchain/vizd:latest
    push: true

资源规划 ​

节点类型内存磁盘
完整节点（主网）8 GB+50 GB+
验证者节点4 GB20 GB
测试网4 GB10 GB

共享内存大小应能舒适地放入 RAM。在 config.ini 中：

ini
shared-file-size = 4G

故障排除 ​

症状原因解决方案
容器立即退出配置错误或缺少卷docker logs vizd — 检查启动错误
端口 8090 不可达RPC 绑定到 localhost删除 127.0.0.1: 前缀或使用反向代理
无对等节点防火墙阻止端口 2001开放 2001 TCP 入站
同步缓慢未加载快照首次启动前在卷中提供快照
/var/lib/vizd 权限拒绝卷所有权不匹配chown -R 1000:1000 /data/vizd

VIZ Ledger