故障排查指南

本页用于快速定位 MANYOYO 常见问题，并给出最短排查路径。

快速入口

• 构建失败：build-errors
• 运行异常：runtime-errors

常见问题速查

症状	可能原因	快速命令	详情
manyoyo build 失败	网络/磁盘/权限	df -h、manyoyo build --iv 1.8.0-common	构建问题
pinging container registry failed	本地镜像未构建	manyoyo build --iv 1.8.0-common	镜像拉取失败
permission denied	Docker/Podman 权限不足	groups、docker ps	权限问题
环境变量未生效	envFile 路径/格式错误	manyoyo config show --ef /abs/path/example.env	环境变量问题

最小诊断流程

1. 基础检查

manyoyo -v
node --version
docker --version   # 或 podman --version

2. 查看最终配置和命令

manyoyo config show
manyoyo config command
manyoyo config show -r claude

3. 检查镜像与容器状态

docker images | grep manyoyo   # 或 podman images
manyoyo ps

4. 验证环境文件加载（--ef 仅支持绝对路径）

manyoyo config show --ef /abs/path/anthropic_claudecode.env
manyoyo run --ef /abs/path/anthropic_claudecode.env -x env | grep ANTHROPIC

配置检查要点

• 运行配置位于 ~/.manyoyo/manyoyo.json 的 runs.<name>。
• manyoyo run -r <name> 只按名称读取 ~/.manyoyo/manyoyo.json 中的 runs.<name>。
• envFile 必须是绝对路径数组。

获取帮助

1. 收集信息

uname -a
manyoyo -v
manyoyo config show
manyoyo ps

2. 导出日志

manyoyo build --iv 1.8.0-common 2>&1 | tee build-error.log
docker logs <容器名> 2>&1 | tee runtime-error.log  # 或 podman logs

3. 提交 Issue

• 仓库地址：GitHub Issues
• 请附：复现步骤、错误日志、系统信息、脱敏后的配置片段。