常见问题

启动 Hub

端口已被占用

启动器会报错，并保留原来的进程。换一个空闲端口重新启动，例如 python start.py --desktop --port 18990。单独运行的客户端也要填同样的地址。

安装或构建失败

打开数据目录里的 startup.log 查看原因。检查网络或代理后，重新运行原命令，已完成的步骤会复用。启动器不会跳过失败的步骤去启动一个残缺的服务。

首次设置时密码输错了，或者中途停止了

重新启动即可继续创建账号。账号建好之后，启动器不会再要求设置密码，也不会重置账号。

关掉窗口后页面打不开了

Hub 随启动器窗口一起停止，重新启动即可。需要在后台持续运行，请使用 Docker 或生产部署。

启动器不接受我指定的目录

请选择源码目录之外的空目录。启动器不会覆盖不是它创建的文件。

忘记了管理员密码

不要删除数据库重新初始化。保留数据，走管理员密码恢复流程。Docker 部署时，python ops/self-host/deploy.py credentials 只显示首次启动时的密码。

客户端

客户端连接不上

确认 Hub 正在运行，并且登录页（​服务连接 · 更改地址）里的地址与它一致，包括端口。只填地址，不要加 /api。

其他电脑访问不到我的 Hub

源码启动的 Hub 监听 127.0.0.1，只有本机能访问。要让其他电脑访问，请用 Docker 部署，并配置你自己的 HTTPS 代理。

客户端提示安装并启动 Runner

打开 设置 → Agent 管理，按提示操作。Runner 负责在本机执行工作。

AI 工作

对话没有回复

确认 模型目录 里已接入模型服务并启用了模型，客户端的 设置 → 我的模型 里也能看到它。见配置模型和 Agent 底座。

底座显示"未安装"

在 设置 → Agent 管理 安装。只有 Pi 是内置的。

还没解决？

搜索 GitHub Issues，或提交缺陷报告。

harness harnesses runtime runtimes 底座