服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- OpenWrt 24.10.3 的一组诊断状态是 OpenClash inactive、没有核心监听,而 dnsmasq 仍向 7874 转发。
- sh: out of range 是启动脚本诊断线索,单凭这行不能确定是哪项配置或代码导致启动失败。
- 可在接受直连 DNS 路径的前提下,只移除确认失效的 7874 配置值;这不会修复 OpenClash 启动。
- 路由器能解析不代表 LAN 客户端和网页访问已恢复;在完成客户端验证前不要宣布全网修复。
先分开两个问题:DNS 转发失效与 OpenClash 启动失败
在 OpenWrt 24.10.3 设备上,如果 OpenClash 报 inactive、进程列表没有预期核心,而 dnsmasq 仍被配置为把请求转发到 7874,问题至少有两层:代理 DNS 服务没有就绪,以及本地解析器仍指向该服务。dnsmasq 继续监听 53 不能弥补下游无人接收的转发请求,客户端可能因此看到 DNS 超时。
启动日志中的 sh: out of range 应作为需要保留的错误线索,而不是完整根因。它本身无法说明是输入范围、配置内容、脚本分支、插件包还是运行环境导致失败。先让路由器有一个可用的解析路径,再单独分析启动输出;不要把绕开 DNS 端口写成 OpenClash 已经修好。
只读检查:确认 inactive、7874 无监听和转发配置
先查看 OpenClash 服务状态、核心进程、端口与持久化 dnsmasq UCI,再从 53 监听 PID 确认其活动生成配置路径,核对其中实际存在的 server=转发项。UCI 只说明已保存值;netstat/ps 只说明当前监听和进程,三者必须与目标 dnsmasq 实例的活动配置对应。若 7874 由预期核心监听,或运行时配置与 UCI 不一致,不执行直连 DNS 修改。
本流程的适用版本范围是 OpenWrt 24.10.3;其他 OpenWrt 或 OpenClash 版本应核对当前 dnsmasq 实例、生成配置、服务状态及对应版本文档,不能由此推断兼容性。完整日志可能含设备名、订阅路径、域名或其他敏感字段;分享前仅保留软件版本、时间、脱敏的错误和状态,不要上传整个日志包。
只读检查服务、进程、端口与日志
sh/etc/init.d/openclash status
ps w | grep -E '[c]lash|[o]penclash_watch|[m]ihomo'
netstat -lnp 2>/dev/null | grep -E ':(53|7874|7890|7891|7892|7893|9090)([[:space:]]|$)'
uci -q show dhcp.@dnsmasq[0]
logread | grep -iE 'openclash|clash|mihomo|out of range' | tail -n 80
DNSMASQ_PID='REPLACE_WITH_PID_LISTENING_ON_53'
ps w | awk -v p="$DNSMASQ_PID" '$1 == p { print; found=1 } END { if (!found) exit 1 }'
RUNTIME_CONFIG='REPLACE_WITH_ACTIVE_CONFIG_PATH_FROM_THIS_DNSMASQ_PROCESS'
EXPECTED_FORWARD='REPLACE_WITH_EXACT_SERVER_TARGET#7874'
grep -nF "$EXPECTED_FORWARD" "$RUNTIME_CONFIG"
临时恢复解析:只删确认失效的 7874 项
只有在已确认 dnsmasq 持久化 UCI 中存在精确指向 7874 的本地 server 值、该端口没有预期监听者,且活动生成配置也包含同一转发项时,才考虑临时使用系统上游 DNS。先验证上游可用并备份 /etc/config/dhcp。若生成配置与 UCI 不一致或无法确定活动文件,先查明服务加载路径,不要编辑保存值来猜测运行时行为。
提交配置并重启 dnsmasq 会改变路由器 DNS 行为,且可能短暂中断解析。命令会在重启前显示备份名;重启返回非零时会报告失败码并用相同码退出。即使重启命令返回成功,也不能据此宣称运行时配置已加载;需要检查活动生成配置,并从 LAN 客户端验证解析和 HTTPS。
备份并选择性删除转发项
shBROKEN='<BROKEN_DNS_TARGET>#7874'
BACKUP="/root/dhcp.before-openclash-dns-$(date +%Y%m%d-%H%M%S)"
test ! -e "$BACKUP" || exit 1
cp -p /etc/config/dhcp "$BACKUP" || exit 1
printf 'Backup: %s\n' "$BACKUP"
uci set dhcp.@dnsmasq[0].noresolv='0' || exit 1
uci -q del_list dhcp.@dnsmasq[0].server="$BROKEN" || exit 1
uci commit dhcp || exit 1
if /etc/init.d/dnsmasq restart; then
printf 'dnsmasq restart command returned success; verify the active config and LAN DNS separately\n'
else
RESTART_STATUS=$?
printf 'dnsmasq restart failed (exit %s); do not assume the new config is active\n' "$RESTART_STATUS" >&2
exit "$RESTART_STATUS"
fi
恢复原 DHCP/DNS 文件
shBACKUP='/root/dhcp.before-openclash-dns-REPLACE_WITH_PRINTED_TIMESTAMP'
test -f "$BACKUP" || exit 1
cp -p "$BACKUP" /etc/config/dhcp && /etc/init.d/dnsmasq restart
单独分析启动错误,不把未知原因写成修复
若要恢复 OpenClash DNS 接管,先处理插件启动问题。保留 OpenWrt、OpenClash、核心文件和配置的实际版本,复核当前选中的 YAML/配置是否能被读取,并按日志时间顺序查看启动前后的错误。检查目标端口是否由其他实例占用、依赖核心是否存在、管理界面选择是否与实际启动路径相符;这些是排查方向,不是已确认的根因。
如果启动脚本和相邻日志仍无法定位到具体文件或脚本行,就不要推断插件根因;遇到无法解释的启动分支时先停止其他变更,并保留脱敏后的相关日志。
分别验证路由器 DNS 与 LAN 客户端路径
临时 DNS 变更后,先验证路由器本机能否通过系统上游解析一个普通域名,再在一台 LAN 客户端确认 DHCP 提供的 DNS、客户端解析结果和网页访问。查询成功只证明该查询路径可用;若网页仍打不开,还需区分默认路由、代理规则、WAN 连通和目标站响应。
若要求 OpenClash 处理 DNS,成功条件还应包括插件处于预期运行状态、目标端口由正确核心监听、dnsmasq 转发值与该端口匹配,以及客户端真实请求通过。仅看到路由器本机解析恢复,或只看到 UI 状态改变,都不足以证明 LAN 服务恢复。
限制、停止条件与回滚
当上游 DNS 不明确、管理入口不稳定、server 列表含多个用途不同的值,或不能确认端口归属时,保持只读状态,不运行 UCI 变更。OpenWrt 分支、dnsmasq 实例和 OpenClash 设置不同,目标地址与端口都应以设备当前输出为准;不能套用另一台路由器的完整配置。
如果解析更差或策略行为不符,使用备份恢复 DHCP/DNS 文件并重启 dnsmasq;准备本地访问方式以免远程管理中断。只有另行解决启动故障并验证 LAN 客户端后,才可将 OpenClash 服务标记为恢复。对于启动错误的具体原因和本机 LAN 的最终结果,未完成这些验证前都应保持未知。
资料来源
常见问题
OpenWrt 上看到 sh: out of range 就能确定插件缺陷吗?
不能。这行是启动日志线索,但不足以指出具体脚本、输入或配置原因。保留版本和上下文,继续按启动顺序查看日志。
删掉 7874 转发后 OpenClash 会自动修好吗?
不会。选择性删除只改变 dnsmasq 的解析路径,可能让系统上游 DNS 暂时可用;它不修复 OpenClash 的启动或核心状态。
怎样回退选择性 DNS 变更?
用变更前保存的 /etc/config/dhcp 备份恢复原文件,再重启 dnsmasq。执行前核对备份路径;如果已做其他配置变更,也要逐项判断是否一并回滚。
路由器能解析,是否可以说局域网已恢复?
不可以。还要在 LAN 客户端检查其 DNS 配置和解析,并验证所需网页访问。插件启动状态、路由器解析与客户端联网是不同验证项。