Multica daemon 连不上服务（runtime 离线）怎么排查

Multica daemon 连不上服务runtime 离线怎么排查【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica在 Multica 里daemon 是跑在你电脑上的后台进程它连接服务器、检测本机安装的 AI 编码工具、领取 run 并回报结果每一个「一台电脑 一个工具」的组合在 Runtimes 页面注册为一个 runtime。当 Runtimes 页面里某台电脑或某个工具显示 offline、或者 run 一直排队/失败时就是 daemon 与服务器的连接或工具检测出了问题。本文按官方文档给出的顺序从 daemon 进程、登录态、网络到工具检测逐层定位目标是把 runtime 重新拉回 online 状态。适用于通过 CLI 启动 daemon 的环境Multica Desktop 会自动启动 daemon排查思路一致自托管实例比云端多一步服务端/health检查文中单独标出。先搞清楚「offline」的含义daemon 每 15 秒发一次心跳服务器结合心跳与连接状态判断 runtime 是否在线daemon 意外退出后runtime 通常最迟在 3 分钟左右显示为 offline。所以刚断开的几分钟内先确认进程是否还活着是合理的起点。runtime 离线期间已排队的 run 会等它恢复只有当停止心跳超过重连宽限期、且 run 自身排队也达到该时长时才会失败单纯忙碌的 runtime 不会丢积压任务进行中的 run 会失败符合条件的 issue 或 chat run 可以自动重试。daemon 再次启动时会重新注册 runtime并重新领取上次没有正常结束的 run。另外一个离线超过 7 天且没有绑定任何 agent包括已归档的的 runtime 会被自动清理。先确认问题在哪一层问题可能出在四层之一Multica 服务本身、daemon、runtime或 AI 编码工具。以下命令通常足以暴露第一个有意义的错误multica version multica auth status multica daemon status --output json multica daemon logs --lines 100自托管实例还可以直接检查服务文档示例中的api.example.com为占位地址替换为你自己的实例 API 地址curl -i https://api.example.com/health curl -i https://api.example.com/readyz注意两者的差别/health只说明 API 进程有响应/readyz还会检查数据库和迁移。如果这两个都正常而 daemon 仍连不上问题大概率在执行电脑这一侧登录态、网络、工具检测。按文档推荐顺序排查Daemon and runtimes 给出离线 runtime 的五步检查顺序运行multica daemon status确认 daemon 在运行。运行multica daemon logs -f跟踪日志寻找登录、网络或工具检测错误。在 daemon 所在的同一环境运行command -v tool-command确认 daemon 能找到工具命令。tool-command换成你要检测的工具命令名例如 Claude Code 是claude、Codex CLI 是codex、Cursor Agent 是cursor-agent完整对照表见 Install AI coding tools。打开 Multica 的Runtimes页面确认目标电脑和对应的 AI 编码工具都显示 online。如果是刚安装工具、改过路径或更新了自定义 runtime profile运行multica daemon restart让它重新检测。如果 runtime 列表里缺了某个期望的工具文档建议先确认该工具能在同一系统账号、同一PATH下正常运行且已完成登录再执行multica daemon restart。常见原因与对应修复Troubleshooting 列出的「daemon fails to connect」常见原因有五个按出现频率对照检查CLI 未登录或本机保存的 token 已过期。重新登录并重启 daemonmultica login multica daemon restart在无浏览器的机器上先在 web 设置里创建 personal access token然后用multica login --token交互粘贴避免 token 完整值留在 shell 历史里。daemon 连到了错误的 Multica 服务。查看当前 profile 的server_urlmultica config show地址不对时重新运行multica setup self-host更正。执行电脑到 API 的网络不通DNS、TLS 或防火墙拦截。自托管部署必须从执行电脑请求 API 的/health——在服务器本机测试暴露不了执行电脑侧的 DNS/TLS/防火墙问题。另外注意daemon 的长连接走的是/api/daemon/ws不是浏览器用的/ws反向代理需要同样转发它。如果这条路径握手失败daemon 会静默退化为轮询后端日志里该路径反复出现status400就是这个症状的表现。当前账号已不是目标 workspace 的成员。需要管理员重新邀请或确认账号。本机没有安装任何受支持的 AI 编码工具。daemon 在启动前必须至少检测到 1 个内置受支持的 CLI否则根本起不来自定义 runtime profile 在 daemon 起来之后才同步不能作为空机器上的唯一启动条件。这种情况先按 Install AI coding tools 安装并登录一个工具。终端能找到、daemon 找不到PATH 与版本问题这是「daemon 在线但工具没注册」的典型分支PATH 不一致。如果终端里能找到工具但 Desktop 或后台 daemon 找不到两者通常使用了不同的PATH值。文档给出的处理重启应用或通过对应的MULTICA_PROVIDER_PATH环境变量设置绝对路径。文档示例MULTICA_CLAUDE_PATH/opt/bin/claudePROVIDER换成对应工具的名称段变量在运行 daemon 的那台电脑上生效。工具版本低于最低要求。低于最低版本时daemon 不会注册对应的 runtime。文档明确列出的下限Claude Code 2.0.0、Codex 0.100.0、Copilot 1.0.0、Grok 0.2.89、Qwen Code 0.20.0、MiniMax Code 0.1.2。用claude --version之类的命令确认本机版本是否达标。刚安装或刚登录完工具。daemon 只在启动时检测工具装完或登录完要运行multica daemon restart重新检测。看日志别读错文件daemon 日志的位置摘自 Troubleshooting组件查看方式后台 daemonmultica daemon logs --lines 100实时跟踪multica daemon logs --follow默认 profile 的日志文件~/.multica/daemon.log默认 profile 的启动/崩溃日志~/.multica/daemon.err.log命名 profile~/.multica/profiles/name/下对应的日志哪份文件是当前生效的取决于 daemon 启动时用的 profile拿旧 daemon 的过期日志调试是常见坑。最稳的办法是直接跑multica daemon logs——它流式输出前会先打印解析到的绝对路径读命名 profile 的日志加--profile name。要直接观察 daemon 启动过程可以改为前台运行注意这会先停掉当前 daemon该机器上的任务会中断直到前台进程接管multica daemon stop multica daemon start --foreground一个已记录的坑不要在宿主 shell、Compose 服务或容器 entrypoint 里设置MULTICA_DAEMON_PORT。该变量由 daemon 自己注入到 agent 任务中0.4.22 与 0.4.23 版本会因此把宿主 shell 误判为受管任务而拒绝登录。如果历史启动环境里留了这个变量直接移除。恢复后的确认与后续影响排查到修复后回到Runtimes页面确认目标电脑和对应的 AI 编码工具显示为 online此时可以在创建或编辑 agent 时选择这个 runtime。对已经受影响的 run排队中的 run 在 runtime 恢复后继续等待被领取离线期间失败的 run符合条件的 issue 或 chat run 可自动重试daemon 重启时还会重新注册 runtime并重新领取上次没有正常结束的 run。如果确认连接恢复后 run 仍不启动那是另一个问题如并发上限、目录锁按 Troubleshooting 中「Issue does not start executing」一节继续排查。相关文档Daemon and runtimes注册与在线状态机制、Using the CLIdaemon/runtime命令全集、Environment variablesdaemon 侧配置项与MULTICA_PROVIDER_PATH全表。【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考