Linux 版 Chaldea 安装——Debian/Ubuntu 原生支持

系统要求

项目	要求
最低系统版本	Debian 10 (x64)
推荐发行版	Debian 11/12、Ubuntu 22.04/24.04
架构	仅 x64

官方立场

作者在文档里明确说明：

仅 Debian 发行版的 Linux 得到测试与支持。虽然可能能运行在其他发行版上，但官方团队目前无法保证完全兼容，也无法为这些平台出现的问题提供技术支持。

也就是说，如果你用 Arch、Fedora、openSUSE 等发行版，可能能跑、也可能会遇到奇怪问题，得自己解决。

安装步骤

打开 GitHub Releases 页面
下载 chaldea_<版本号>_linux_x64.tar.gz
解压：

tar -xzf chaldea_<版本号>_linux_x64.tar.gz -C ~/Applications/

（或任何你喜欢的普通用户目录，不要解压到需要 root 权限的地方）

运行：

cd ~/Applications/chaldea
./chaldea

依赖说明

Chaldea 是 Flutter 应用，在 Linux 上需要一些系统库：

libGL
libX11
libXcursor
libXrandr
libXinerama
libXxf86vm
libgtk-3

Debian / Ubuntu 用户如果运行时报库缺失，可以一次性安装：

sudo apt install libgl1 libx11-6 libxcursor1 libxrandr2 libxinerama1 libxxf86vm1 libgtk-3-0

数据存储位置

和 Windows 版类似，数据与可执行文件在同一目录：

<解压目录>/
├── chaldea              # 可执行文件
├── userdata/            # 用户数据
├── backup/              # 每日备份
└── game/                # 游戏数据

创建启动器

想在应用菜单里看到 Chaldea？创建一个 .desktop 文件：

# 在 ~/.local/share/applications/ 创建
cat > ~/.local/share/applications/chaldea.desktop << EOF
[Desktop Entry]
Type=Application
Name=Chaldea
Exec=/home/<你的用户名>/Applications/chaldea/chaldea
Icon=/home/<你的用户名>/Applications/chaldea/assets/icon.png
Terminal=false
Categories=Game;
EOF

更新

下载新版本 tar.gz，解压覆盖即可。userdata/ 文件夹保留不删就不会丢失数据。

其他发行版的 workaround

如果你用非 Debian 发行版遇到了 Flutter 运行时错误，可以尝试：

用 Docker 跑 Debian 容器里的 Chaldea
或直接使用 Web 版（见下一页）

Web 版功能基本完整，性能上除了移动端浏览器和 CanvasKit 渲染器有额外开销之外，桌面端 Chromium 表现接近原生。