连接电脑
在 设置 → 电脑 管理机器连接,再到具体 Bot 的 电脑权限决定谁可以使用它。连接和授权分别管理。
使用服务所在电脑
跳转到“使用服务所在电脑”选择“添加电脑”中的服务所在机器入口。它使用运行 Astral Server 的机器及其操作系统账号;在 Desktop 中通常就是安装 Desktop 的电脑。
电脑上线后,可以在详情中查看类型、运行环境、版本和数据目录。
连接其他机器
跳转到“连接其他机器”- 打开 设置 → 电脑 → 添加电脑 → 连接其他机器。
- 选择目标机器能够访问的服务器地址与目标操作系统。
- 生成接入命令,在目标电脑的 Shell 或 PowerShell 中运行完整命令。
- 命令会检查连接并安装后台服务。回到 Astral,等待该电脑显示在线。
命令包含临时配对凭据,请只在要接入的电脑上使用。命令过期时重新生成,不要反复运行旧命令。安装器需要访问对应版本的官方发行资源;从源码开发时,若尚未发布匹配资源,应按当前开发环境处理,不能假定公开下载已经可用。
远程电脑主动连接 Server。127.0.0.1 只适用于同一台机器;局域网、VPN 或公网地址必须从目标电脑实际可达。接入地址可以是 HTTP 或 HTTPS,电脑通道自身使用加密连接和服务器身份校验。浏览器登录的网络要求见运行 Server。
更新已连接的 Daemon
跳转到“更新已连接的 Daemon”在电脑详情的 Daemon 维护 中点击 更新 Daemon,确认正在运行的任务会中断。Astral 检查最新官方版本、下载校验并重启 Daemon,确认新版本已重新连接。电脑身份、凭据和工作文件保留。如果 Daemon 比 Server 新,Astral 会建议同时更新 Desktop 或 Server,但不会因此阻止 Daemon 更新。
服务所在电脑的本机 Daemon 随 Desktop 或 Server 更新。电脑离线、尚不支持管理更新或更新失败时,使用同一区域的 Shell 或 PowerShell 更新命令:裸机命令在目标电脑运行,容器命令在容器所在电脑运行。裸机更新始终使用原操作系统用户的权限。
授予 Bot 使用权限
跳转到“授予 Bot 使用权限”进入 设置 → Bot → 目标 Bot → 电脑权限,允许使用刚接入的电脑。按需要设置新会话的默认电脑。
全局电脑页显示在线,不代表某个 Bot 已有权限。如果会话里找不到这台电脑,先检查该 Bot 的授权。
后台服务与断开
跳转到“后台服务与断开”远程接入以当前用户安装后台服务:macOS 使用用户 LaunchAgent,Linux 使用用户 systemd,Windows 使用当前用户的计划任务。能访问哪些文件,取决于运行服务的账号权限。
撤销 Bot 权限会停止它使用该电脑;移除连接和删除电脑上的实际文件是不同操作。服务管理与升级见升级与备份。