【Linux】2025 可用：在 Linux 下游玩《炉石传说》国服（hearthstone-linux 实战

参考项目

• hearthstone-linux
  https://github.com/0xf4b1/hearthstone-linux

一、背景说明

《炉石传说》国服回归后，官方依然没有提供 Linux 客户端。
目前比较常用的第三方方案是开源项目hearthstone-linux，但在实际使用过程中会发现：

直接选择国服（cn）会导致资源下载失败，无法完成安装。

本文记录本人在2025 年，成功在 Linux 系统下登录并游玩《炉石传说》国服的完整过程，希望能帮助到同样使用 Linux 的玩家。

二、运行环境

操作系统：Linux（x86_64） 桌面环境：不限 游戏：炉石传说（国服） 项目地址：https://github.com/0xf4b1/hearthstone-linux

本文方法与具体发行版关系不大，Ubuntu / Arch / Fedora 理论上都适用。

三、问题表现（为什么直接用 cn 不行）

在执行craft.sh并选择cn区域时，会遇到类似错误：

Region: cn Using CN CDN from netease Error: NGDP repository http://cn.patch.battle.net:1119/hsb not found NoSuchKey: tpr/hs

原因是：

• 国服（网易）已迁移/关闭旧的 NGDP 仓库
• hearthstone-linux 在cn区仍尝试访问失效地址
• 导致 CDN 列表和资源清单无法获取

因此不能直接使用 cn 区下载资源。

四、核心解决思路（重点）

使用 kr 区完成资源下载，然后切换为国服运行环境并使用国服登录页。

简单总结就是：

• ✅下载资源：kr
• ✅运行环境：国服
• ❌不要用 cn 下载

这是目前在 Linux 下游玩国服炉石最稳定、可行的方案。

五、详细操作步骤

Step 1：使用 kr 区下载资源

在项目根目录执行：

rm-f .region .locale ./craft.sh

当脚本提示选择区域时：

Region: kr Locale: zhCN

等待资源下载和解压完成。

Step 2：修改为国服运行环境

进入安装目录：

cdhearthstone

编辑client.config：

Aurora.Env=cn.actual.battlenet.com.cn

这一步决定客户端最终连接的是国服服务器。

Step 3：修改登录 URL 为国服（关键）

hearthstone-linux 默认使用的是国际服登录页，需要手动改为国服。

原登录地址：

https://battle.net/login/?app=wtcg

修改为国服登录地址：

https://account.battlenet.com.cn/login/?app=wtcg

这样才能使用国服战网账号正常登录。

修改完成后，重新编译并替换login程序即可（不同发行版依赖略有差异，这里不展开）。

Step 4：登录并启动游戏

在hearthstone目录下执行：

./login

若看到类似输出：

Found Token Login successful

说明登录成功。

启动游戏：

Bin/Hearthstone.x86_64

至此即可进入《炉石传说》国服。

六、注意事项（非常重要）

• ❌不要使用 cn 区下载资源
• ✅ 更新或重装时仍然使用kr或us
• ✅ 运行前确认Aurora.Env=cn.actual.battlenet.com.cn
• ⚠️ 若登录页或 URL 参数变动，需要同步调整登录代码

七、效果说明

• 可正常使用国服战网账号登录
• 可进入国服天梯、对战、酒馆战棋
• 稳定运行于 Linux 桌面环境

八、总结

通过kr 区下载资源 + 国服运行环境 + 国服登录页的方式，
可以在2025 年的 Linux 系统中稳定游玩《炉石传说》国服。

希望这篇文章能帮助到更多 Linux 玩家。