ToMoon 是一款为 Steam Deck 定制的网络工具,由 Rust 驱动,作为 Decky 插件运行。它会自动配置 FAKE-IP 模式,让游戏的 TCP 和 UDP 流量都能通过代理,并提供基于 Yacd 的策略管理面板。
ToMoon 曾是 Steam Deck 上最流行的代理插件,但项目最近一次更新是在 2025 年初。新用户可以优先考虑仍在维护的 DeckyClash。
| 运行平台 | Steam OS,Decky 插件 |
|---|---|
| 开发语言 | Rust |
| 代理模式 | 自动 FAKE-IP + TUN |
| 面板 | Yacd(127.0.0.1:9090/ui) |
| 维护状态 | 最近更新于 2025 年初 |
本文只讲软件本身,不推荐具体服务商。客户端只是工具,节点需要另外订阅;如果还没有订阅,可以先看 性价比机场挑选与防坑指南。
官方项目地址:https://github.com/YukiCoco/ToMoon
安装步骤
- 进入 Steam Deck 设置,在“系统 - 系统设置”中打开开发者模式。
- 回到设置找到“开发者”,打开 CEF 远程调试,等待重启。
- 按电源键切换到桌面模式,打开 Konsole;没有设置过密码的先用
passwd设置。 - 依次执行 README 中安装 Plugin Loader 和安装 ToMoon 的两条命令(已装过 Plugin Loader 2.0 以上的可跳过前者)。
- 切回游戏模式,按右摇杆下方的快捷按钮(三个点),即可看到 Decky 插件面板。
导入订阅
- 打开 Manage Subscriptions,添加机场的 Clash 订阅链接 并下载。也可以扫码添加,要求手机和 Steam Deck 在同一局域网。
- 本地配置文件可以用
file://加绝对路径作为链接,例如file:///home/deck/config.yaml。 - 回到主界面选择订阅并启动;桌面模式下可在浏览器打开
http://127.0.0.1:9090/ui管理节点。
系统更新后断网怎么修
SteamOS 更新等原因导致 Decky Loader 失效时,ToMoon 可能没有正确关闭 Clash,系统 DNS 仍被接管,表现为完全无法上网。v0.0.5 及以上版本可以在桌面模式的 Konsole 中运行恢复脚本:
bash ~/tomoon_recover.sh
更早的版本需要按 README 中的命令手动恢复 resolv.conf 和 NetworkManager 的 DNS 设置。
常见问题 (FAQ)
ToMoon 还值得装吗?
已在用且工作正常可以继续使用;新装建议选择 DeckyClash,它仍在维护并内置较新的 Mihomo 内核。
游戏模式下找不到插件?
确认 Decky Loader 已安装成功,并在快捷菜单的插件图标中查找 ToMoon。