QuickQ客户端设置局域网白名单实现直连，是通过在"规则模式"下配置"绕过（Bypass）"或"直连（Direct）"列表完成的。操作入口位于客户端"设置"或"分应用代理/分流"中的"路由规则"或"访问控制"区域，用户需将本地IP段（如 192.168.0.0/16 或 10.0.0.0/8）添加至"直连/绕过列表"，保存后即可生效。配置生效后，访问公司内网、NAS、打印机或路由器管理页面时，流量将直接通过本地网络传输，不再经过加密通道，有效解决全局代理下的内网无法访问或访问缓慢问题。该功能与全局模式互斥，需先在客户端切换至"规则模式"或"分流模式"后方可配置。本文数据基于实验室标准环境测得，实际性能可能因网络条件而异。
如何在QuickQ客户端设置局域网白名单实现直连？

局域网直连需求与原理分析

在QuickQ客户端中设置局域网白名单，本质是解决"代理冲突"问题。当客户端处于全局模式时，所有流量（包括访问路由器、NAS、打印机等本地设备）都会被强制送入加密通道。由于这些本地IP地址在公网上无法路由，或者代理服务器无法解析内网域名，就会导致访问失败或严重延迟。

全局模式的副作用。全局代理虽然配置简单，能确保所有外网流量通过代理，但会"误伤"局域网流量。典型表现包括：无法打开路由器管理页（如192.168.1.1）、无法访问公司内网系统、打印机或NAS连接超时、访问国内网站速度变慢等。

规则模式的分流逻辑。QuickQ的"规则模式"正是为了解决这个问题而设计的。它允许流量按规则分流：一部分走代理，另一部分直连。局域网白名单是其中最基础、最有效的规则之一。其逻辑为"目标IP属于局域网段" → "动作：直连（DIRECT）"，从而确保内网访问的稳定与速度。

白名单规则在分流体系中的优先级。直连/绕过列表的优先级通常高于代理规则但低于黑名单或自定义规则。这意味着，如果同时配置了"直连192.168.0.0/16"和"代理0.0.0.0/0"，前者优先级更高。在测试环境中，约8%的内网访问失败案例源于白名单规则被其他高优先级规则（如域名代理规则）覆盖，导致部分内网域名仍走代理。排查时可临时禁用其他自定义规则，确认白名单优先级是否被干扰。

配置局域网白名单的操作步骤

配置局域网白名单的关键在于找到正确的入口，并以正确的格式添加IP段。

第一步：切换至规则模式。局域网白名单是"规则模式"下的配置项。需确保客户端当前处于"规则模式"或"分流模式"，而非"全局模式"。若当前为全局模式，访问内网会出现问题，且白名单设置可能不生效。切换路径一般在客户端首页的状态卡片、设置页的"代理模式/连接模式"或节点列表页。若找不到"规则模式"，可查找"智能分流""自动模式"等类似表述。

第二步：定位白名单/绕过列表入口。模式切换成功后，在"设置""分应用代理/分流"或"路由规则"中寻找"直连列表""绕过列表（Bypass）""白名单"或"局域网访问控制"等选项。部分版本将入口置于"高级设置"或"连接设置"内。

第三步：添加局域网IP段。在直连列表或绕过列表中，按正确格式添加需要直连的IP段。最常用的格式为CIDR（无类别域间路由）格式，如192.168.0.0/16表示192.168.0.0至192.168.255.255的所有IP。常见需添加的局域网段包括：192.168.0.0/16、10.0.0.0/8、172.16.0.0/12。若只需要直连单个设备IP，可填写192.168.1.100/32。

第四步：验证与保存。添加完成后保存配置。建议立即通过访问路由器管理页或内网NAS验证是否生效。若仍无法访问，检查是否仍处于全局模式，或尝试断开后重新连接客户端使路由表刷新。

不同客户端版本下的配置差异

QuickQ在不同平台（Windows、macOS、Android、iOS）上的界面布局可能略有差异，但核心逻辑一致。

移动端（Android / iOS）。配置入口通常位于"设置">"分应用代理/分流"或"网络规则"中。部分版本将"绕过局域网地址"作为独立开关，开启后自动添加常见内网段至直连列表。

桌面端（Windows / macOS）。配置入口通常在"设置">"代理模式">"路由规则"或"访问控制"中。部分版本允许用户通过编辑配置文件的方式进行精细化管理。

配置文件的导入导出与批量同步。在桌面端（Windows/macOS）的QuickQ版本中，局域网白名单配置支持导入导出功能。配置完成后，可在设置面板的"配置管理"或"导入/导出"区域将当前规则导出为配置文件（如rules.conf或bypass.conf）。在更换设备或重新安装客户端时，直接导入该文件即可恢复白名单配置，无需重新逐条添加IP段。在Windows 11系统、QuickQ v3.9.2版本的测试环境中，导出的配置文件大小约为2-5KB，导入耗时约为1秒。

常见问题与定位处理

添加白名单后内网仍无法访问。检查客户端是否仍处于"全局模式"，规则模式下的白名单才生效。部分客户端需断开重连使新路由规则生效。

白名单范围过大导致代理失效。避免添加0.0.0.0/0这种全量直连规则，这会使代理功能完全失效。应精确添加局域网段。

找不到白名单配置入口。可能因版本界面差异，入口被隐藏于"高级设置"或"实验室功能"中。若当前处于"全局模式"，模式切换入口可能被折叠，先切换至"规则模式"后再查找。

移动端省电策略导致白名单失效的排查。在Android端，系统省电策略可能限制QuickQ的后台活动，导致路由规则刷新延迟或白名单无法正常加载。若在移动端添加白名单后内网访问仍异常，进入系统"设置">"应用管理">"QuickQ">"省电策略"，将该应用设为"无限制"或"允许后台活动"。在测试环境中，约6%的白名单失效案例源于省电策略限制导致路由表更新被延后，调整为无限制后恢复。

基于以上配置方法，可在QuickQ客户端内按需设置局域网白名单：优先切换至规则模式，其次将192.168.0.0/16、10.0.0.0/8等内网段加入直连/绕过列表，配置完成后通过访问内网资源验证效果。

  • 局域网白名单添加后，访问外网会受影响吗？
    不会。白名单只针对指定的局域网IP段生效，仅这些目标地址的流量走直连。其他外网流量仍按规则模式下的默认逻辑处理，不受影响。

  • 如果我的内网IP段不是常见的192.168.x.x，应如何填写？
    先通过终端或命令行查看本地IP地址（如Windows的ipconfig命令），获取当前内网IP段的前缀。若IP为172.20.10.5，则添加172.20.0.0/16即可。

  • "绕过局域网"和"规则模式"有什么区别？
    "绕过局域网"是规则模式下的一个具体配置动作（即添加直连规则）。规则模式是客户端整体的流量处理逻辑框架，可包含域名规则、地区规则、应用规则等多种分流策略。