GCP存储传输服务Agent未在UI显示，容器正常却无法执行传输任务

开发者阿泽

2026-8-3

存储传输服务Agent容器运行正常但UI不显示的排查方案

从你提供的agent.INFO日志来看，Agent核心组件已完成初始化，但无任何与GCP服务注册相关的日志输出，这是Agent未在UI显示的关键线索。以下是针对性排查步骤：

检查Agent启动配置
确认容器启动时是否正确传入项目ID和Agent名称参数，这是Agent向GCP注册的必要条件。正确启动命令需包含以下关键参数：
```
docker run -d --name=storage-transfer-agent \
  -v /var/log/storage-transfer-agent:/var/log \
  gcr.io/cloud-storage-transfer-agent/storage-transfer-agent:latest \
  --project-id=你的项目ID \
  --agent-name=你的Agent名称
```
同时验证VM的服务账号是否拥有roles/storagetransfer.agent角色；若使用密钥文件挂载，需确认文件路径和权限配置正确。
验证网络连通性
确保VM能正常访问GCP存储传输服务API：
```
curl -v https://storagetransfer.googleapis.com/v1/agents
```
检查VM所属VPC的防火墙规则，确认允许出站HTTPS（443端口）流量到GCP的API端点。
排查错误日志
重点查看agent.WARNING和agent.ERROR文件，这些日志会记录注册失败的具体原因（如权限不足、网络超时等）：
```
grep -i error /var/log/storage-transfer-agent/agent.*
```
确认Agent注册状态
手动刷新GCP控制台的存储传输服务Agent列表，或通过gcloud命令行直接查询：
```
gcloud transfer agents list --project=你的项目ID
```
若命令返回Agent信息，说明UI可能存在延迟，等待几分钟再刷新即可；若无返回，说明注册流程未完成，回到前两步排查配置和网络问题。