连接桌面客户端
如果你是用 start-desktop 或 python start.py --desktop 启动的,桌面客户端已经打开,并连上了本机的 Hub,可以跳过本页。
以下情况请继续阅读:
- 想从源码单独运行桌面客户端;
- 想让客户端连接另一个 Hub,例如团队的 Hub;
- 想为其他人创建账号。
为其他人创建账号
在管理端打开 用户管理,点 新建用户,为每一位要使用客户端的人各建一个账号。
如果你开启了自助注册并配置了邮件,用户也可以在客户端登录页点 创建账号。
从源码单独运行客户端
保持 Hub 运行,另开一个终端:
cd client
npm ci
npm start
三种桌面系统都适用。Windows 也可以运行 client/start-soduwork.bat。
这样启动的客户端有自己的连接和配置,与 --desktop 使用的 desktop-profile/ 互不影响。
也可以从下载页安装桌面客户端。
让客户端连接某个 Hub
客户端默认连接 http://127.0.0.1:18989,与源码启动器的地址一致。要连接其他 Hub:
- 在登录页点 服务连接 · 更改地址。
- 填写 Hub 地址,例如
http://127.0.0.1:18990或https://work.example.com。 - 保存,然后用那个 Hub 上的账号登录。
只填地址,不要加账号、密码或 /api。连接其他电脑上的 Hub 时请使用 HTTPS。
登录后,可以在 设置 → 服务连接 里切换 本机服务 和 团队服务。
如果客户端提示 请先在 Agent 管理中安装并启动 Runner。,打开 设置 → Agent 管理,按提示操作。Runner 是客户端里负责在本机执行工作的部分。

确认连接成功
- 主页显示 想让 SoduWork 做什么?
- 在管理端 执行网络 → 员工终端 里,你的电脑显示为 在线。
补充说明
- 每个 Hub 有各自的账号。切换到另一个 Hub 不会把数据迁移过去。
127.0.0.1只代表当前这台电脑,其他电脑访问不到源码启动的 Hub。团队使用请用 Docker 部署。