Astra GateEnglish

桌面端

Astra 桌面应用——把控制台与常驻服务装进一个原生窗口

桌面端(@aidotnet/desktop)是控制台的 Electron 封装:同一个管理界面,外加原生集成的便利。

安装

安装包:从下载页下载对应平台的安装包——macOS .dmg、Windows 安装程序(.exe)、Linux AppImage。安装包内置服务端,不需要 Node.js 或 CLI。

安装脚本:不想手动下载时,运行一键安装脚本并选择桌面端(macOS / Linux:curl -fsSL https://astra-gate.si/install.sh | bash -s -- --desktop),同样内置服务端、无需 Node.js。

通过 npm:

命令bash
npx @aidotnet/astra-gate install --desktop

无需全局安装 CLI;已全局安装的话用 astra install --desktop 即可。

它多了什么

能力说明
独立窗口控制台跑在原生窗口里,不依赖浏览器
服务生命周期服务未运行时可直接在界面点「启动服务」,不必开终端
开机自启设置 › 通用 › 开机自启动:「桌面端」登录后只驻留托盘;「后台服务」与 astra autostart 同一机制。macOS / Windows / Linux 均支持
菜单栏入口macOS 菜单栏快捷查看服务状态、启动 / 停止
离线渲染界面资源内置于应用中,启动即用

桌面端复用同一份 ~/.astra 数据与同一个 astra-server——在桌面端与浏览器里看到的内容完全一致,astra CLI 管理的服务就是桌面端跑的服务。

服务二进制解析顺序

桌面端按以下顺序定位服务端二进制:

  1. ~/.astra/install.json 中记录的安装位置(若其版本比安装包内置的服务端旧,则改用内置的);
  2. 环境变量 ASTRA_SERVER_BIN(开发调试用);
  3. 安装包内置的服务端;
  4. 开发构建(仅源码运行时)。

更新与卸载

  • 安装包(macOS dmg、Windows 安装程序、Linux AppImage):应用内更新。新版本下载并校验 sha256 后,桌面端退出、替换自身(macOS 还要求新版本与当前版本签名团队一致),然后自动重新打开。 安装包自带服务端,所以更新的总是整个桌面端,内置的服务随新版本一起替换,桌面端与服务端版本保持一致;不会单独更新服务端。 放在无法写入的位置时(例如直接从 dmg 里运行),「立即更新」会改为打开下载页。更新过程记录在 ~/.astra/logs/desktop-update.log。
  • 预览版:在 设置 → 关于 打开「接收预览版更新」后,应用内更新会跟随预览通道;见预览版。
  • 通过 npm 安装的:
命令bash
astra update --desktop    # 只更新桌面端
astra uninstall --desktop # 只卸载桌面端