安装与卸载
install / update / uninstall / set-password
安装桌面端
astra install --desktop
# 未全局安装 CLI 时:
npx @aidotnet/astra-gate install --desktop
下载并安装当前平台的 Astra 桌面应用(Electron),并在 ~/.astra/install.json 记录服务端位置供桌面端使用。--client 是 --desktop 的旧写法,仍然可用。详见桌面端。
更新
astra update # 更新 CLI;若装了桌面端也一并更新,最后重启服务
astra update --desktop # 只更新桌面端
astra update --check # 只检查,不安装
astra update --channel preview # 这一次按预览版更新(stable | preview)
更新通道默认跟随控制台 设置 → 关于 的「接收预览版更新」(服务未运行时按正式版),--channel 只影响这一次。CLI 会安装与服务端相同的版本(npm install -g <包名>@<版本>)。详见预览版。
管理密码
astra config set-password
交互式输入并保存管理密码(用于对外监听时的控制台登录)。密码验证后才能把服务监听到非环回地址;忘记密码重新执行本命令即可重设。
卸载
astra uninstall # 停止服务 + 还原所有被接管客户端 + 移除自启动
astra uninstall --desktop # 只卸载桌面端
astra uninstall --purge # 连 ~/.astra 数据目录一起删除
卸载顺序:先按 restore-all 的逻辑还原客户端配置(漂移项会先询问),再停止服务、移除 LaunchAgent / systemd / schtasks 条目。