获取 Astral

下载 Astral 桌面版，或将 Astral Server 安装到 Linux VPS。

可用版本：v0.1.0 · 发行说明、全部文件与校验和 · 在 GitHub 查看最新版

下载桌面版

平台	架构	下载
macOS	Apple 芯片	DMG
macOS	Intel	DMG
Windows	x64	EXE 安装包
Windows	ARM64	EXE 安装包
Linux	x86_64	AppImage · DEB
Linux	ARM64	AppImage · DEB

• macOS：打开 DMG，将 Astral 拖入“应用程序”。官方 Mac 安装包已使用 Developer ID 签名；该版本的 Apple 公证状态见发行说明或签名报告（mac-signing-report.json）。
• Windows：运行 EXE，为当前用户安装。Windows 安装包尚未签名，可能显示 SmartScreen 提示。
• Linux：为 AppImage 添加执行权限后打开，或通过包管理器安装 DEB。AppImage 支持应用内更新；DEB 需要手动安装新版。

Windows 和 Linux 的窗口控制按钮位于应用顶部右侧，侧栏开关在左侧；按 Alt 可显示应用菜单。

打开 Astral 后，按首次配置连接模型并选择电脑。应用内更新和 Host 3 / Core 11 数据基线见升级与备份。Desktop 使用 schema-3-core-11/，旧私有版本的数据目录保留，不会自动导入。

一键安装到 Linux VPS

curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' \
  https://github.com/oines/astral/releases/latest/download/install-server.sh | bash

支持 Linux x86_64 和 ARM64，需要可用的 systemd 用户会话。安装器会注册当前用户的服务，并输出设置网页登录和访问 Astral 的命令。环境要求与远程访问步骤见运行 Server。

从源码构建

准备工具

在构建电脑上安装仓库固定的工具链：Go 1.26.3、Node.js 26.7.0 和 pnpm 10.31.0。也可以使用仓库的 mise.toml 安装相应版本。

git clone https://github.com/oines/astral.git
cd astral
pnpm install --frozen-lockfile

Core 及其 Models 包的依赖版本已固定在 go.mod，无需另行下载 Core 源码。GOWORK=off 可避免本地 go.work 覆盖固定依赖。接下来的命令都在 Astral 仓库根目录运行。

构建 Server 和产品界面

macOS 或 Linux：

GOWORK=off pnpm build:distribution

Windows PowerShell：

$env:GOWORK = 'off'
pnpm build:distribution

生成的可执行文件位于 dist/bin/。选择与运行机器的操作系统和 CPU 架构匹配的文件；apps/web/dist/ 是 Astral 产品界面，apps/website/ 是官网和本使用文档。

运行 Server说明如何启动、设置网页登录以及开放远程访问。

从源码运行桌面版

完成上面的发行文件构建后运行：

pnpm dev:desktop

Desktop 管理本机运行服务，打开后可直接进行首次配置。如果需要安装包，在对应操作系统上运行：

构建系统	命令
macOS	pnpm --filter @astral/desktop package
Windows	pnpm --filter @astral/desktop package:windows
Linux	pnpm --filter @astral/desktop package:linux

自行构建的安装包不等于经过官方签名和公证的发行包。构建输出在 apps/desktop/release/。