跳转到内容

在 APP 中连接

  1. 打开侧边栏「设置」,找到「服务与账号」。
  2. 选择「自部署服务器」卡片,在「服务器地址」中原样粘贴向导输出的 APP 地址。
  3. 点「测试连接」,查看下方检查结果;可连接时点「连接到这台服务器」。
  4. 弹窗中按提示 创建管理员,或填写已有账号,点「登录并连接」。

已登录一探官方时可直接这样切换,原空间数据保留,无须先删除或退出官方账号;见 空间切换。地址可带服务器要求的路径,但不要附加用户名、密码、查询参数或片段;除同机回环地址外必须 HTTPS。

检查项含义不通过时
连接安全地址、TLS 证书与安全连接条件处理证书或地址问题,不能跳过校验
版本兼容APP 是否满足 minClientVersion 及服务合同按提示升级 APP 或 Server
实例状态能否读取服务信息、身份与初始化状态未初始化可创建管理员;不可达或身份变化需排查
登录方式当前支持的密码登录及注册方式只提供不支持的登录方式时不能连接
AI实例是否声明已配置 AI不阻塞连接,不等于实时模型测试成功
头像实例是否启用生成头像不阻塞连接,与 AI 配置独立

测试连接不切换空间、不登录、不调用付费 AI 或 fal。编辑地址后报告失效,需要重新测试。确认连接后按提示初始化或登录;取消保留原空间。

如果实例迁到了新地址,APP 在验证其身份后可能提示「这是你之前的实例」。确认「改用新地址」保留原空间数据;活动空间可保留登录,非活动空间需重新登录。不要忽略同地址实例身份变更的错误。

失败时先看 故障排查,版本规则见 兼容矩阵。

本文档对应 v0.35.1(开发版) · 查看 v0.35.1 的文档