Halovisor Docker镜像文档

镜像概述和主要用途

Halovisor是一个Docker镜像，作为halo Docker镜像的直接替代品（drop-in replacement），集成了halo与cosmovisor功能。它旨在简化需要同时使用halo和cosmovisor的部署流程，提供与原版halo镜像兼容的接口，同时具备cosmovisor的进程管理与自动升级能力。

核心功能和特性

• 直接替代能力：可无缝替换现有基于halo的Docker部署，无需修改原有配置结构。
• 集成cosmovisor：内置cosmovisor工具，支持进程管理与自动升级功能，减少手动干预节点运维流程。
• 兼容性保障：保持与原版halo镜像一致的配置接口和数据目录结构，降低迁移成本。
• 简化部署流程：合并halo与cosmovisor的部署步骤，减少容器配置复杂度。

使用场景和适用范围

• 需要运行halo服务且需集成cosmovisor功能的环境。
• 适用于需要自动升级能力的halo节点部署场景，如***节点管理、分布式服务运维等。
• 适合希望简化多工具集成流程的技术团队，尤其适用于基于容器化部署的halo服务环境。

详细使用方法和配置说明

基本部署命令（Docker Run）

使用以下命令启动Halovisor容器，可直接替换原有halo镜像部署：

docker run -d \
  --name halovisor \
  -v /path/to/local/data:/root/.halo \  # 挂载数据目录（持久化节点数据）
  -p 26657:26657 \  # 按需映射必要端口（示例：RPC端口）
  -p 26656:26656 \  # 按需映射必要端口（示例：P2P端口）
  -e CHAIN_ID="your***-id" \  # 目标网络标识符
  -e DAEMON_NAME="halo" \  # 进程名称（通常为"halo"）
  -e DAEMON_HOME="/root/.halo" \  # 节点数据目录
  halovisor:latest

关键配置说明

环境变量

数据卷挂载

为避免容器重启后数据丢失，需挂载halo数据目录：

-v /host/machine/path/to/halo/data:/root/.halo

替换现有halo部署

若原部署使用halo镜像，可直接将镜像名称替换为halovisor:latest，保持原有端口映射、环境变量及数据卷配置不变，实现无缝迁移。