常见问题

按症状找答案；找不到再看最下面的「最小诊断流程」。

安装与启动

Linux 安装时提示缺少容器环境或网络组件 按提示执行安装器给出的那条命令，再重新运行安装命令即可续上；没有终端或你选了 n 时，安装器不会执行 sudo。已经装好后运行出错，manyoyo doctor 会查出原因并给出命令。

浏览器没有自动打开 终端会打印一次性登录地址，60 秒内访问即可；超时再执行一次 manyoyo。SSH 等无图形界面的机器见第一次使用。

忘记登录密码 在本机执行 manyoyo 会自动登录，不需要密码。要重设密码，运行 manyoyo setup，或直接修改 ~/.manyoyo/manyoyo.json 里的 serverPass。

升级后想回到上一版本manyoyo update --rollback，见日常使用。

manyoyo update 或安装时连接超时 先在终端设置代理 export https_proxy=http://127.0.0.1:7890 再重试（macOS 的系统代理会自动识别）；仍不行就按屏幕上列出的地址手动下载，见安装。

运行与镜像

permission denied Docker / Podman 权限不足。先确认 docker ps 能直接运行；详见权限问题。

pinging container registry failed / 镜像拉取失败 网络无法访问镜像仓库。检查代理，或改用本地构建，见镜像拉取失败。

环境变量未生效envFile 必须是绝对路径。用 manyoyo config show --ef /abs/path/example.env 核对，详见环境变量问题。

manyoyo build 失败 绝大多数用户不需要自己构建。确需构建时见镜像构建问题。

最小诊断流程

manyoyo doctor                  # 检查容器运行时、镜像、配置和端口
manyoyo doctor --fix            # 自动修复可修复的项
manyoyo config show -r claude   # 查看最终生效的配置
manyoyo config command -r claude  # 查看将执行的容器命令
manyoyo ps                      # 容器状态

获取帮助

到 GitHub Issues 提交，请附：复现步骤、错误日志、manyoyo -v 与系统信息、脱敏后的配置片段。更多运行时问题见运行时问题。