ToMoon 使用教程

发布日期: 2026-09-24更新日期: 2026-10-12平台: Steam OS(Steam Deck)类别: 客户端下载配置

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

安装步骤

  1. 进入 Steam Deck 设置,在“系统 - 系统设置”中打开开发者模式。
  2. 回到设置找到“开发者”,打开 CEF 远程调试,等待重启。
  3. 按电源键切换到桌面模式,打开 Konsole;没有设置过密码的先用 passwd 设置。
  4. 依次执行 README 中安装 Plugin Loader 和安装 ToMoon 的两条命令(已装过 Plugin Loader 2.0 以上的可跳过前者)。
  5. 切回游戏模式,按右摇杆下方的快捷按钮(三个点),即可看到 Decky 插件面板。

导入订阅

  1. 打开 Manage Subscriptions,添加机场的 Clash 订阅链接 并下载。也可以扫码添加,要求手机和 Steam Deck 在同一局域网。
  2. 本地配置文件可以用 file:// 加绝对路径作为链接,例如 file:///home/deck/config.yaml。
  3. 回到主界面选择订阅并启动;桌面模式下可在浏览器打开 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。