桌面端
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 管理的服务就是桌面端跑的服务。
服务二进制解析顺序
桌面端按以下顺序定位服务端二进制:
~/.astra/install.json中记录的安装位置(若其版本比安装包内置的服务端旧,则改用内置的);- 环境变量
ASTRA_SERVER_BIN(开发调试用); - 安装包内置的服务端;
- 开发构建(仅源码运行时)。
更新与卸载
- macOS 安装包:应用内自动更新。
- Windows / Linux 安装包:从下载页下载新版本覆盖安装。
- 通过 npm 安装的:
astra update --desktop # 只更新桌面端
astra uninstall --desktop # 只卸载桌面端端口显示以 runtime.json 为准
与浏览器版相同:桌面端展示的监听地址来自 ~/.astra/runtime.json 的实际值,
不会假设配置里的端口仍然可用。
Astra Gate