astral 中文文档 下载 App

Linux 版使用指南——发行版兼容与依赖安装

支持的发行版

官方说明支持主流 Linux 发行版,包括但不限于 Ubuntu、Debian、Fedora、Arch Linux、openSUSE 等。

安装方式

AppImage(推荐,最通用)

  1. 下载 .AppImage 文件
  2. 在终端里给它加执行权限:chmod +x Astral-xxx.AppImage
  3. 直接双击运行或终端执行:./Astral-xxx.AppImage

优点:不依赖发行版包管理器,解压即用,跨发行版通用。

包管理器格式

各发行版可能提供 .deb(Debian/Ubuntu)、.rpm(Fedora/openSUSE)或 AUR 包(Arch Linux)。使用对应的包管理器安装即可。

关键依赖

TUN 设备

Astral 的虚拟网卡依赖 Linux 内核的 TUN 设备模块。大多数发行版默认已加载,但如果连接时提示「无法创建虚拟网卡」,手动加载:

sudo modprobe tun

权限问题

非 root 用户运行时,可能因为无法操作 /dev/net/tun 而失败。两种解决方案:

方案一:以 root 运行

sudo ./Astral-xxx.AppImage

方案二:把用户加入 tun 组

sudo usermod -aG tun $USER

然后重新登录。

systemd-resolved 冲突

部分发行版(如较新的 Ubuntu)使用 systemd-resolved 管理 DNS,可能与 Astral 的 TUN 设备冲突。如果连接后 DNS 解析异常:

  1. 检查 Astral 的 DNS 设置是否指向可用的 DNS 服务器
  2. 或在 Astral 设置里手动指定 DNS(如 8.8.8.8)

Wayland vs X11

Astral 使用 Flutter GUI,在 X11 和 Wayland 下都能运行。如果 Wayland 下界面异常,切换到 X11 会话试试。