Astra GateEnglish

安装与卸载

install / update / uninstall / set-password

安装桌面端

命令bash
astra install --desktop
# 未全局安装 CLI 时:
npx @aidotnet/astra-gate install --desktop

下载并安装当前平台的 Astra 桌面应用(Electron),并在 ~/.astra/install.json 记录服务端位置供桌面端使用。--client 是 --desktop 的旧写法,仍然可用。详见桌面端。

更新

命令bash
astra update             # 更新 CLI;若装了桌面端也一并更新,最后重启服务
astra update --desktop   # 只更新桌面端
astra update --check     # 只检查,不安装
astra update --channel preview   # 这一次按预览版更新(stable | preview)

更新通道默认跟随控制台 设置 → 关于 的「接收预览版更新」(服务未运行时按正式版),--channel 只影响这一次。CLI 会安装与服务端相同的版本(npm install -g <包名>@<版本>)。详见预览版。

管理密码

命令bash
astra config set-password

交互式输入并保存管理密码(用于对外监听时的控制台登录)。密码验证后才能把服务监听到非环回地址;忘记密码重新执行本命令即可重设。

卸载

命令bash
astra uninstall                # 停止服务 + 还原所有被接管客户端 + 移除自启动
astra uninstall --desktop      # 只卸载桌面端
astra uninstall --purge        # 连 ~/.astra 数据目录一起删除

卸载顺序:先按 restore-all 的逻辑还原客户端配置(漂移项会先询问),再停止服务、移除 LaunchAgent / systemd / schtasks 条目。