安装 | Astra Gate

系统要求

npm install -g @aidotnet/astra-gate

astragate 是同一个包的另一个名字（npm install -g astragate 效果相同），二者装出的都是 astra 命令，选一个即可，不要同时全局安装。

安装包会按当前平台自动选择对应的 @aidotnet/server-* 二进制（darwin/linux/win32 × arm64/x64），不需要单独安装 .NET 运行时。

安装完成后验证：

astra --version

不想全局安装？

也可以用 npx @aidotnet/astra-gate <命令> 直接运行，效果相同。

桌面端是一个 Electron 壳，把控制台包成了独立应用，并支持菜单栏快捷操作与开机自启。

不想装 Node.js 的话，直接从下载页下载安装包（macOS .dmg / Windows .exe / Linux AppImage），安装包内置服务端。

也可以通过 npm 安装，不需要全局安装 CLI，一条命令即可：

npx @aidotnet/astra-gate install --desktop

已全局安装 CLI 的话，等价于：

astra install --desktop

通过 npx 安装时，服务端二进制会被复制到 ~/.astra/server/，桌面端不依赖 npx 缓存。详见桌面端。

Astra 的所有状态都在 ~/.astra（可用环境变量 ASTRA_HOME 覆盖）：

路径	内容
`~/.astra/config.json`	启动配置（端口、监听地址等）
`~/.astra/runtime.json`	实际运行状态（pid / 端口 / apiVersion）
`~/.astra/astra.db`	SQLite 数据库（请求记录、模型、提供商、设置）
`~/.astra/server/`	托管的服务端二进制与界面资源（`astra update` 或 npx 安装桌面端时写入）
`~/.astra/keys/`	加密密钥（权限已限制为当前用户）
`~/.astra/logs/`	服务日志
`~/.astra/backups/client-configs/`	接管客户端前的配置备份

astra update            # 更新 CLI（及已装的桌面端），然后重启服务
astra uninstall         # 停止服务并还原所有被接管的客户端配置
astra uninstall --purge # 连 ~/.astra 数据目录一起删除

卸载前会自动还原

astra uninstall 会先用 restore-all 的逻辑把每个被接管客户端的配置恢复为启用前的样子，再停止服务—— 客户端不会因为 Astra 卸载而失联。