eitumd/verge

Verge CLI（容器镜像）

Async Python CLI工具，用于与Verge API交互（VM与租户操作、电源编排、证书状态查询）。镜像内置Python 3.13、uv、certbot，并将verge控制台脚本作为入口点。

镜像信息

• 稳定标签：eitumd/verge:stable
• 入口点：verge
• 默认CMD：--help

交互式Keeper登录（可选）

当使用-it参数启动时，镜像可通过Keeper Commander提示输入Verge凭据。提供租户元数据（默认打包文件或通过VERGE_KEEPER_TENANT_FILE指定自定义文件），并省略VERGE_USERNAME/VERGE_PASSWORD即可触发交互式Keeper流程：

bash
docker run --rm -it \
  -e VERGE_URL="https://verge.example.org" \
  docker.xuanyuan.run/eitumd/verge:stable list

您将看到青色的“Verge Keeper Login Prompt”横幅，随后是Keeper Commander登录序列和Questionary租户选择器。认证成功后，Verge命令将使用检索到的凭据运行。

快速运行

推荐通过环境变量提供凭据：

bash
docker run --rm \
  -e VERGE_URL="https://verge.example.org" \
  -e VERGE_USERNAME="alice" \
  -e VERGE_PASSWORD="s3cret" \
  docker.xuanyuan.run/eitumd/verge:stable list

或显式传递参数：

bash
docker run --rm docker.xuanyuan.run/eitumd/verge:stable \
  list --url https://verge.example.org --username alice --password s3cret

关闭所有VM电源

安全关闭所有当前运行的VM（优先关闭非优先级VM，再关闭备注中含priority=1的VM）。无--force参数时需：

1. 确认提示
2. 输入YES

使用方法

verge power-off-all [OPTIONS]

选项：

示例

强制关闭并等待完成：

bash
docker run --rm \
  -e VERGE_URL="https://verge.example.org" \
  -e VERGE_USERNAME="alice" \
  -e VERGE_PASSWORD="s3cret" \
  docker.xuanyuan.run/eitumd/verge:stable \
  power-off-all --force --concurrency 15 --timeout 300 --interval 2.0

发送命令后立即退出：

bash
docker run --rm \
  -e VERGE_URL="https://verge.example.org" \
  -e VERGE_USERNAME="alice" \
  -e VERGE_PASSWORD="s3cret" \
  docker.xuanyuan.run/eitumd/verge:stable \
  power-off-all --force --no-wait

注意：

• 备注中含priority=1（不区分大小写）的VM最后关闭。
• 大型集群可使用--no-wait，由外部监控处理状态。
• 若VM超时（--no-wait除外），退出码非零。

常用命令

bash
# 列出VM
docker run --rm -e VERGE_URL=... -e VERGE_USERNAME=... -e VERGE_PASSWORD=... \
  docker.xuanyuan.run/eitumd/verge:stable list

# 启动所有停止的VM
docker run --rm -e VERGE_URL=... -e VERGE_USERNAME=... -e VERGE_PASSWORD=... \
  docker.xuanyuan.run/eitumd/verge:stable power-on-all --force

# 检查证书状态
docker run --rm -e VERGE_URL=... docker.xuanyuan.run/eitumd/verge:stable cert-status

配置

环境变量（或CLI参数）：

• VERGE_URL
• VERGE_USERNAME
• VERGE_PASSWORD

安全提示

请勿将凭据烘焙到镜像中。建议使用-e、Docker secrets或编排工具的密钥存储。