Appearance
ToMoon 快速配置与详细使用指南
ToMoon（飞向月球）是一款在 Steam Deck 玩家群体中备受赞誉的网络代理插件。与传统的桌面软件不同，它是依托于 Decky Loader 框架原声运行在 SteamOS 游戏模式（Game Mode）下的神级工具。
Steam Deck 作为一台掌机，经常面临着游戏商店打不开、社区无法加载、下载大作被限速、锁区联机游戏无法进入等尴尬场景。ToMoon 的出现，让玩家不需要再切换到繁琐的 Linux 桌面模式敲代码，只需在游戏界面的侧边栏按下按键，就能轻松将网络“送上月球”，享受无缝的主机级加速体验。
1. 插件下载与 Steam Deck 安装准备
前提条件：您的 Steam Deck 必须已经提前安装好了 Decky Loader 插件管理器。
第一步：在 Steam Deck 上开启权限
在您的掌机原生游戏模式下：
- 按下
Steam键进入系统主菜单。 - 依次进入 设置 -> 系统，勾选“启用开发者模式”。
- 在左侧菜单栏拉到最下方，找到 开发者 选项，打开“CEF 远程调试”。
第二步：安装 ToMoon 插件
绝大多数玩家推荐使用最直观的商店安装法：
- 按下掌机右下角的
...键，点击右侧边栏最下方的插头图标进入 Decky Loader。 - 点击右上角的小摊位图标，进入 Decky 插件商店。
- 在搜索框中输入
ToMoon，找到带有月球/火箭图标的插件，直接点击 Install（安装）即可。
(极客玩家也可以在桌面模式下，通过 GitHub 作者提供的一键 curl 安装脚本通过终端强刷入系统。)
2. 获取机场订阅链接
要让掌机满速下载几十 GB 的 3A 大作，甚至应对要求极高的 FPS 联机游戏，您必须为其装配高端节点。
- 登录您的机场服务商后台（如果您还在寻找极其稳定、适合主机联机加速的大带宽节点，欢迎查看本站的 👉 2026 优质稳定机场精选）。
- 在网站的用户控制面板或订阅中心找到 “一键订阅” 区域。
- 请点击 “复制 Clash 订阅链接” 或者 “复制通用订阅”。ToMoon 完美支持这些标准的节点格式。
3. 导入节点与开启代理（掌机手柄图文流程）
在 ToMoon 中，一切操作都完美适配了掌机的十字键与摇杆：
步骤一：呼出 ToMoon 控制面板
在任意游戏界面或掌机主页，按下右下角的 ... 键。找到插头图标，点击进入 ToMoon 插件专属面板。
步骤二：便捷导入订阅链接
在 ToMoon 界面点击 “订阅管理 (Subscriptions)”。由于掌机打字太痛苦，ToMoon 极具创意地提供了一个局域网二维码扫描功能：用您的手机扫一下屏幕上的二维码，即可在手机浏览器里将机场 URL 直接发送给掌机。
步骤三：更新并拉取节点数据
链接发送成功后，在掌机上点击 “更新 (Update/Download)”，等待右下角弹出下载成功的系统级气泡通知。
步骤四：一键开启透明代理
回到 ToMoon 主界面，将最上方的 “启用代理 (Enable Proxy)” 拨杆打开。底层系统会利用 TUN 虚拟网卡技术强制接管所有的掌机流量。
步骤五：挑选低延迟节点并开始游玩
在面板下方的 “节点选择 (Proxies)” 菜单中，使用方向键挑选一个带有绿色低延迟标志的节点，按下 A 键确认。现在，去尽情访问 Steam 商店和下载游戏吧！
4. 进阶玩法：联机游戏 UDP 加速与绕过国内流媒体
由于这是一台游戏机，分流的准确性对于游戏体验至关重要。
- 硬核 UDP 转发：Steam 的 P2P 下载机制和许多联机游戏（如 APEX、荒野大镖客）极其依赖 UDP 流量。在 ToMoon 的高级设置中，请务必确保 “启用 UDP 代理” 处于打开状态，否则您可能会遇到下载断流或联机疯狂掉线的问题。
- 强制全局/规则路由切换：如果您一边打外服游戏，一边想听国内的网易云音乐或看 B站，请在插件顶部将路由模式从“全局 (Global)”切换为 “规则 (Rule)”，让国内流量自动绕开代理直连，省电且低延迟。
5. 常见问题排查与 FAQ
在封闭的 Linux 掌机环境下，排查网络故障需要清晰的思路：
1. 为什么用手机扫码发送订阅后，掌机上点击更新一直失败？
这通常是因为掌机的本地网络无法解析机场订阅域名的 DNS。 解决办法：请联系机场客服要一个国内能直连的“备用防污染订阅链接”；或者最简单的办法是：让掌机连上手机开启的热点（手机提前挂好翻墙工具），成功拉取配置后再切回家里 Wi-Fi。
2. ToMoon 代理开关已经打开，为什么商店打不开，游戏也报网络错误？
这是因为 Linux 底层的 iptables 路由劫持发生了冲突。 解决办法：尝试在插件的高级设置中切换代理工作模式（如从 TUN 切换为 Tproxy 模式），然后把 ToMoon 开关关闭，重启一遍 Steam Deck，再次打开开关即可修复。
3. 为什么在面板里查看节点，全部显示 Timeout (超时)？
全部超时说明底层进程无法和任何境外服务器建立通信。
- 请登录机场官网检查您的流量是否已经耗尽或套餐已过期。
- 当前的节点 IP 已经被防火墙大规模阻断，请去“订阅管理”重新拉取最新的节点列表。
4. 为什么下载游戏速度特别快，但打联机游戏依然卡顿跳 Ping？
代理核心对 TCP 大文件下载处理很好，但如果没有指定优质的节点，UDP 数据包容易在跨国线路中丢包。 解决办法：在节点选择列表中，不要使用默认的“自动选择 (Auto)”，请手动指定并锁定一条距离较近的高质量专线节点（如香港、日本专线），然后再启动游戏。
5. 感觉插件出了 Bug，如何彻底卸载？
严重警告：如果在代理还开着的时候直接去删插件，掌机的防火墙规则无法复原，将导致直接断网！ 解决办法：务必先在 ToMoon 中关闭“启用代理”开关，让它自动清理掉底层的劫持规则。确认掌机能正常打开国内网站后，再进入 Decky Loader 商店点击垃圾桶卸载图标。