AstroBox Linux 安装指南——各发行版包型选择与 AUR 推荐
下载前确认
- 架构：仅支持 x86_64。在终端执行
uname -m，如果输出不是x86_64（比如aarch64），说明你的 Linux 是 ARM 架构，AstroBox 暂时无法安装 - 发行版：以下列出的发行版均支持
- 准备工作：如果之前安装过 AstroBox V1，先卸载 V1
查看发行版和架构
grep PRETTY_NAME /etc/os-release && uname -m输出示例：
PRETTY_NAME="Arch Linux" x86_64包型选择对照表
| 发行版系列 | 具体发行版 | 推荐包型 |
|---|---|---|
| Debian | Debian / Ubuntu / Linux Mint / Deepin（深度）/ Kali Linux | .deb |
| RedHat | RHEL / Fedora / CentOS Stream / Rocky Linux / AlmaLinux | .rpm |
| SUSE | openSUSE Leap / Tumbleweed / SLES | .rpm |
| Arch | Arch Linux / Manjaro / EndeavourOS | .pkg.tar.zst 或 AUR（推荐） |
注意：AstroBox 因上游依赖问题暂时不提供 AppImage 格式。
安装步骤
Debian 系列
sudo apt update
sudo apt install ./AstroBoxNG_2.2.0.debRedHat 系列
sudo dnf makecache
sudo dnf install ./AstroBoxNG_2.2.0.rpm如果用的是旧版 yum：
sudo yum install ./AstroBoxNG_2.2.0.rpmSUSE 系列
兼容 openSUSE Leap（稳定版）和 Tumbleweed（滚动版）：
sudo zypper refresh
sudo zypper install ./AstroBoxNG_2.2.0.rpmArch 系列（推荐用 AUR）
用 AUR helper 安装最方便（如果没装 AUR helper，先查 ArchWiki 的 AUR 助手安装指南）：
yay -S astrobox-ng或者用 paru：
paru -S astrobox-ngArch 系列（用安装包）
sudo pacman -Sy
sudo pacman -U ./AstroBoxNG_2.2.0.pkg.tar.zst启动
安装完成后：
图形界面
打开应用菜单（Application Launcher），搜索 AstroBox，点击打开。也可以右键固定到 Dock 或任务栏。
命令行
astrobox-ng常见问题
找不到蓝牙设备
Linux 桌面环境下的蓝牙堆栈可能需要额外配置：
- 确认系统蓝牙服务已运行：
systemctl status bluetooth - 如果没运行，先启动：
sudo systemctl start bluetooth - 确认
bluetoothctl power on输出成功 - 穿戴设备进入「连接新手机」模式后再在 AstroBox 里扫描
缺少依赖导致启动失败
大部分发行版会自动处理依赖。如果 Arch AUR 安装出问题，可以去 AUR 页面查看评论区有没有已知 workaround。
HiDPI 显示模糊
这是 Linux 上 Tauri 应用的已知问题。可以在启动时添加 GDK_SCALE=2 环境变量试试。