Quantumult X UDP 转发怎么设置？节点不支持时这样排查

更新于 2026-10-25 · bywave.buzz

简答：Quantumult X 的 UDP 转发要同时满足节点启用 UDP Relay、配置写入 udp-relay=true，并确认没有被 udp_whitelist 或 udp_drop_list 拦截；否则应检查 fallback_udp_policy 和服务端 UDP 能力。

定义：Quantumult X UDP 转发，是让经过 Tunnel 的 UDP 流量通过支持 UDP Relay 的代理节点转发，而不是只转发 TCP 或 HTTP 流量。

先试这一步：确认三个条件是否同时满足

如果游戏、语音、QUIC 或某些实时应用无法连接，先不要急着改 DNS。Quantumult X 的官方示例显示，UDP 是否能转发至少涉及节点参数、全局回退策略和 UDP 端口过滤三个部分。

官方示例还说明，fallback_udp_policy 只会在规则命中的服务器不支持 UDP Relay 时生效；默认值是 reject，无效的节点标签也会回退到拒绝行为。可查看 Quantumult X 官方 sample.conf 中的参数注释。

Quantumult X 中 UDP 转发参数在哪里改

Quantumult X 的 UDP 参数通常写在配置文件的 [general] 区块，节点的 udp-relay=true 则写在对应的服务器条目中。不同版本的界面名称可能变化，具体入口以当前 App 的配置编辑页为准，不要把普通的节点延迟测试当成 UDP 测试。

1. 打开配置文件。进入 Quantumult X 当前使用的配置或配置编辑器，找到 [general] 区块。
2. 检查全局回退策略。先使用 fallback_udp_policy=reject，这样可以明确判断当前命中的节点是否真正支持 UDP。
3. 检查节点条目。在要测试的节点行中查找 udp-relay=true。如果订阅内容没有该字段，不要自行推断服务端一定开放了 UDP。
4. 检查端口过滤。确认目标 UDP 端口没有被 udp_whitelist 排除，也没有被 udp_drop_list 或协议名规则丢弃。
5. 保存并重新连接 Tunnel。修改配置后重新连接 Quantumult X Tunnel，再测试同一个应用或协议。

官方示例把 udp_whitelist 定义为目标 UDP 端口允许列表；不在列表中的流量会被丢弃并可能返回 ICMP。udp_drop_list 则用于进一步丢弃指定端口或协议，例如 STUN、QUIC。详情以 官方示例配置 为准。

最小可用配置示例：三种回退方案

下面是配置结构示例，不是可直接使用的真实节点。示例中的节点标签、服务器地址和凭据必须替换为你自己的内容；字段是否被订阅提供商支持，以实际配置和官方说明为准。

方案一：默认拒绝，适合先定位问题

[general]
fallback_udp_policy=reject

[server_local]
; 节点示例：必须替换为自己的节点配置
;shadowsocks=<服务器地址>:<端口>, method=<加密方式>, password=<密码>, udp-relay=true, tag=UDP节点示例

这个方案不会把不支持 UDP 的流量偷偷改走直连，适合确认“当前命中的节点是否具备 UDP Relay”。如果应用立即无法连接，再继续看节点条目和服务端能力。

方案二：不支持 UDP 时改为直连

[general]
fallback_udp_policy=direct

direct 会让不满足 UDP Relay 条件的流量尝试直连。它可能改善某些应用的可用性，但 UDP 直连意味着流量可能绕过代理节点，真实网络出口和目标连接关系可能暴露给本地网络或运营商环境。只在你明确接受这个风险时使用。

方案三：指定一个支持 UDP 的节点作为备用

[general]
fallback_udp_policy=UDP节点示例

这里的值必须是配置中已经存在、并且启用了 udp-relay=true 的节点标签。不能填写随意的策略组名称、未核实的节点名称或普通文本，否则官方示例说明会按无效值处理并使用 reject。

udp_whitelist 和 udp_drop_list 怎么写

这两个参数都针对 UDP 目标端口或协议，但作用不同。配置前先确认应用实际使用的端口；不要因为看到某个端口常见，就断定所有应用都使用它。

如果你要排查 QUIC 无法连接，不要同时大范围修改多个参数。先暂时移除或注释掉包含 QUIC 的丢弃规则，重新连接 Tunnel，再观察应用是否恢复。若仍失败，再回到节点 UDP Relay 和服务端 UDP 能力检查。

udp-relay=true 不等于服务端一定可用

udp-relay=true 只能说明 Quantumult X 的节点配置声明启用 UDP Relay，不能单独证明远端服务器、传输方式和服务端防火墙已经完整支持 UDP。判断时要把三个层次分开：

• 客户端声明：节点条目是否包含 udp-relay=true。
• 协议与传输方式：某些 WebSocket、TLS 封装或特殊传输可能只适合 TCP，是否支持 UDP 要看该节点实际配置。
• 服务端能力：远端服务是否开放 UDP、是否允许目标端口，以及中间网络是否丢弃 UDP。

因此，节点可以在配置中写有 udp-relay=true，但游戏、语音或 QUIC 仍然失败。此时应换一个明确支持 UDP 的节点进行对照，而不是只反复修改 fallback_udp_policy。

udp-over-tcp 和原生 UDP Relay 有什么区别

原生 UDP Relay 会尽量保持 UDP 的传输形态；udp-over-tcp 则是把 UDP 流量封装到 TCP 通道中。Quantumult X 官方示例同时列出了带 udp-relay=true 的节点和带 udp-over-tcp 参数的节点写法。

不要把 udp-over-tcp=true 当成原生 UDP 的替代证明。具体参数格式必须以当前 Quantumult X 官方示例和节点服务端配置为准。

配置后如何确认 UDP 转发真的生效

1. 先固定变量。只选择一个节点、一个应用和一个测试场景，不要同时切换多个订阅或策略组。
2. 确认配置已加载。检查当前使用的配置文件确实包含修改后的 fallback_udp_policy，节点条目也包含预期的 udp-relay=true。
3. 检查 UDP 过滤。暂时移除与目标协议相关的 udp_drop_list 项，并确认目标端口没有被 udp_whitelist 排除。
4. 查看请求记录或日志。记录只用于判断请求命中了哪个策略和节点；日志内容会随版本和设置变化，示例日志不能当成固定格式。
5. 做对照测试。分别使用 fallback_udp_policy=reject、指定 UDP 节点和其他已知支持 UDP 的节点测试。如果只有某一个节点成功，问题更可能在节点或服务端，而不是全局配置。
6. 单独测试直连风险。如果使用 direct 后恢复，只能说明直连路径可用，不能证明代理 UDP Relay 正常。完成测试后应恢复符合你网络安全要求的策略。

Quantumult X 官方仓库还说明，普通节点延迟测试主要是网页响应性测试，不等同于 UDP 可用性测试。因此，看到节点 HTTP 延迟正常，不能直接推出游戏、语音或 QUIC 一定能用。参考 官方 sample.conf 的检测说明。

常见问题排查

为什么配置了 udp-relay=true，游戏还是连不上？

先检查服务端是否真正支持 UDP、目标端口是否被白名单或丢弃规则拦截，再用另一个明确支持 UDP 的节点做对照。客户端字段存在不代表远端链路一定可用。

fallback_udp_policy 应该填 reject 还是 direct？

排障时优先使用 reject，便于确认节点是否支持 UDP；只有在你接受 UDP 直连的网络出口风险时，才考虑 direct。如果有已核实支持 UDP 的节点，可填写该节点标签作为备用策略。

udp_whitelist 留空是不是允许全部 UDP？

官方示例对留空行为有说明，但实际配置仍应以当前版本显示和官方文档为准。修改前先备份配置，并优先用单一应用验证，不要直接假设所有端口都已放行。

为什么 QUIC 被拦截后网页还能打开？

部分应用会从 QUIC 回落到 TCP，因此网页可能仍能打开，但连接协议已经改变。如果需要验证 QUIC，先检查 udp_drop_list 是否包含 QUIC，再查看应用或请求记录。

Quantumult X 的 UDP 设置是否能修复所有语音和游戏问题？

不能。UDP 转发只是其中一个条件，还可能受到节点服务端、防火墙、MTU、DNS、路由和应用自身限制影响。应按“节点参数—端口过滤—服务端能力—网络路径”的顺序排查。

常见问题

Quantumult X UDP 转发在哪里设置？

通常在当前配置文件的 [general] 区块设置 fallback_udp_policy、udp_whitelist 和 udp_drop_list；节点条目则检查 udp-relay=true。具体界面入口以当前版本配置编辑页为准。

Quantumult X UDP 转发失败怎么判断是节点问题？

先用 fallback_udp_policy=reject 固定策略，再换一个配置中明确含 udp-relay=true 的节点对照测试。如果只有个别节点失败，问题更可能在节点或服务端 UDP 能力。

fallback_udp_policy=direct 安全吗？

它可能让不支持 UDP Relay 的流量改走直连，但 UDP 直连可能暴露真实网络出口。排障可以短暂测试，长期使用前应确认你接受该连接路径。

udp_drop_list 里的 QUIC 要不要删除？

如果你正在排查 QUIC 或 HTTP/3 连接，先临时移除 QUIC 丢弃项并重新连接 Tunnel；如果问题与 QUIC 无关，则不要为了放行全部 UDP 而盲目删除其他规则。

相关阅读

• 站内指南
• 节点怎么选速度最快最稳定
• Clash Verge Rev连接不上网排查

参考资料

1. Quantumult-X 官方 sample.conf
2. Quantumult-X 官方 GitHub 仓库