aschzero/hera

Hera镜像说明

镜像概述

Hera是一款自动化工具，通过Cloudflare Argo Tunnel为Docker容器创建安全隧道，实现本地服务向外部网络的安全暴露。相比传统的端口转发或动态DNS方式，Hera提供更安全的访问方案，无需暴露本地端口到公网。

核心功能

1. 自动化隧道管理：容器启动时自动创建Argo Tunnel，容器停止时优雅关闭隧道；
2. 状态监控：实时监控服务状态与隧道进程，若发生断开或 shutdown 则自动重启；
3. 自定义域名支持：使用自定义域名访问本地服务，无需依赖公网IP；
4. 持久连接保障：确保隧道连接稳定，异常时自动恢复。

使用场景

• 本地开发环境中向外部团队展示项目成果；
• 无公网IP的情况下对外提供小型服务（如个人博客、测试接口）；
• 替代不安全的端口转发方式，提升服务访问安全性。

配置说明

需提前准备：

1. Cloudflare账号及Argo Tunnel权限；
2. 有效的Cloudflare Tunnel Token（可通过cloudflared tunnel create命令生成）。

环境变量配置：

• CF_TOKEN：Cloudflare Tunnel Token（必填）；
• SERVICE_LABEL：需暴露的容器标签（可选，用于筛选目标容器）。

部署示例

Docker Run命令

bash
docker run -d \
  --name hera \
  -e CF_TOKEN="your_cloudflare_tunnel_token" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/aschzero/hera

Docker Compose示例

yaml
version: "3"
services:
  hera:
    image: docker.xuanyuan.run/aschzero/hera
    environment:
      - CF_TOKEN=your_cloudflare_tunnel_token
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always

更多详细配置请参考官方文档：https://github.com/aschzero/hera