Astra Gate

桌面端

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

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

安装

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

通过 npm:

npx @aidotnet/astra-gate install --desktop

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

它多了什么

能力说明
独立窗口控制台跑在原生窗口里,不依赖浏览器
服务生命周期服务未运行时可直接在界面点「启动服务」,不必开终端
开机自启设置里一键开关(与 astra autostart 同一机制)
菜单栏入口macOS 菜单栏快捷查看服务状态、启动 / 停止
离线渲染界面资源内置于应用中,启动即用

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

服务二进制解析顺序

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

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

更新与卸载

  • macOS 安装包:应用内自动更新。
  • Windows / Linux 安装包:从下载页下载新版本覆盖安装。
  • 通过 npm 安装的:
astra update --desktop    # 只更新桌面端
astra uninstall --desktop # 只卸载桌面端

端口显示以 runtime.json 为准

与浏览器版相同:桌面端展示的监听地址来自 ~/.astra/runtime.json 的实际值, 不会假设配置里的端口仍然可用。

On this page