在配置prefer-ipv6时，正确的决策逻辑是首先在已连接VPN的状态下访问ipv6-test.com确认本地网络和代理节点均支持IPv6地址的获取与转发，若测试成功则进入配置文件在[General]段落添加“prefer-ipv6 = true”并重载配置开启IPv6优先策略。开启后访问双栈网站并通过实时日志验证实际使用的地址族是否为IPv6，若页面加载速度有显著提升则在当前网络环境保持启用状态，若出现访问异常或加载变慢则立即修改为false回退至IPv4优先。对于家庭宽带原生IPv6和5G移动网络的用户可优先尝试开启以获取潜在的速度优化，而对于代理节点不支持IPv6或访问特定老旧网站频繁的用户则必须保持关闭以维持连接的绝对稳定性。定期在更换网络环境或代理节点后重新评估该参数的效果，确保始终选择最适合当前网络条件的地址族策略。
prefer-ipv6的核心功能定义
控制DNS解析中IPv6与IPv4的优先级排序
prefer-ipv6是Shadowrocket配置文件[General]段落中的一项高级DNS行为控制参数，它直接决定了当目标域名同时拥有IPv6（AAAA记录）和IPv4（A记录）两种解析结果时，规则引擎在路由决策中优先采纳哪一种地址类型。当该参数设置为true时，引擎会优先选用域名的IPv6地址进行连接尝试和规则匹配，只有当IPv6地址不可达或连接超时时才会回退至IPv4地址。当设置为false或保持默认状态时，系统则严格按照传统的IPv4优先策略处理所有解析结果，仅在IPv4完全不可用时才会考虑使用IPv6地址，这种默认行为与大多数网络设备的传统习惯保持一致。
参数作用于解析后而非解析请求本身
prefer-ipv6并不改变DNS查询请求的目标服务器或查询类型，设备仍然会同时请求域名的A记录和AAAA记录，该参数的影响范围仅限于解析结果返回后的处理阶段。当引擎获得了两种地址类型并存时，该参数决定了在规则匹配、路由选择和连接建立的过程中首先尝试哪个地址族，而非决定是否应该发出AAAA记录的查询请求。这种作用于解析后的特性使得prefer-ipv6与是否禁用IPv6完全无关，即使开启该参数，设备在DNS查询时仍然会获取IPv4地址作为备选方案。
与GEOIP和IP-CIDR规则的协作关系
在规则匹配层面，prefer-ipv6会影响基于IP地址的规则（如IP-CIDR和GEOIP）对匹配结果的选择顺序，当某个域名的IPv6地址落入特定的地址段规则时，引擎会优先命中该规则并执行对应的路由策略。这意味着如果用户在配置文件中编写了针对IPv6地址段的直连或代理规则，开启prefer-ipv6会让这些IPv6规则优先于IPv4规则被触发，从而改变流量的最终走向。这种协作关系使得prefer-ipv6不仅是地址选择的偏好控制，更是影响整个分流逻辑顺序的关键参数。
开启与关闭状态下的实际行为差异
开启状态下的解析结果处理逻辑
当prefer-ipv6设置为true时，引擎在获得一个域名的双栈解析结果后会优先将IPv6地址放入路由决策的首要位置，所有基于IP的规则匹配都会首先尝试与IPv6地址进行比对。如果一个域名的IPv6地址命中了代理规则而IPv4地址命中了直连规则，引擎会选择代理路径执行，意味着流量会通过代理节点转发。只有当IPv6地址无法建立连接或匹配的规则执行失败时，引擎才会触发回退机制重新使用IPv4地址进行第二轮匹配，这种优先尝试IPv6的设计充分利用了下一代互联网协议的优势。
关闭状态下的传统IPv4优先策略
prefer-ipv6在默认关闭状态（false）下，引擎完全按照传统的网络行为模式优先使用IPv4地址进行规则匹配和连接建立，只有在IPv4地址完全不可用或匹配的规则执行失败时才会考虑使用IPv6地址。这种模式保证了与绝大多数现有网络基础设施和应用的兼容性，因为目前互联网上仍有大量服务和CDN节点在IPv4环境下的性能表现优于IPv6。关闭状态也意味着用户无需担心因IPv6路由不通而导致访问失败，因为引擎会始终优先使用相对成熟稳定的IPv4通道。
双栈环境下两种模式的速度对比
在同时支持IPv6和IPv4的完整双栈网络环境中，开启prefer-ipv6能够让用户优先体验IPv6可能带来的路由优化和更短的网络路径，某些ISP的IPv6骨干网由于用户量较少，实际传输速度可能优于拥堵的IPv4网络。但这一优势并非绝对，如果用户的IPv6流量的实际路由需要经过更多的跳数或存在更高的丢包率，开启prefer-ipv6反而可能导致访问速度下降。关闭状态下优先使用IPv4则能够确保网络路径的稳定性和可预测性，避免因IPv6网络质量不佳而影响整体上网体验。
强烈建议开启prefer-ipv6的典型场景
家庭宽带已获取原生IPv6地址的环境
当用户的家庭宽带运营商提供了原生IPv6地址且设备能够正常获取到全球单播IPv6地址时，强烈建议开启prefer-ipv6以充分利用下一代互联网协议带来的优势。原生IPv6环境通常意味着用户可以直接与支持IPv6的服务建立端到端的连接，无需经过运营商级的网络地址转换设备（CGNAT），这对于P2P下载、在线游戏和视频通话等对网络质量敏感的应用来说能够显著降低延迟并提高连接稳定性。在家庭宽带双栈网络下开启该参数，用户访问Google、YouTube等主流IPv6站点时会获得更纯净的路由路径和更低的数据包丢失率。
移动蜂窝网络（4G/5G）中的IPv6优先策略
国内三大运营商的4G和5G移动网络已经全面部署了IPv6，移动设备在这些网络下获取的IPv6地址通常具有更短的网络路径和更低的服务质量限制，因为核心网中的IPv6流量承载能力已接近饱和而利用率相对较低。开启prefer-ipv6后，手机在使用移动数据时访问支持IPv6的服务会优先走IPv6通道，这些通道在繁忙时段往往比IPv4通道具有更高的带宽余量和更稳定的连接质量。特别是在5G网络下，IPv6是网络架构的原生配置，优先使用IPv6能够更充分地发挥5G的高速率和低时延特性。
教育网和科研网络等纯IPv6优先环境
在教育网（CERNET）和各类科研网络环境中，IPv6是网络建设的核心组成部分且性能明显优于IPv4，这些网络通常部署了先进的IPv6路由优化策略。在这些网络环境下开启prefer-ipv6能够让所有支持双栈的访问请求优先走IPv6通道，充分利用网络基础设施的优化能力获得最佳的访问体验。如果不开启该参数，部分应用和服务可能会错误地选择IPv4通道，而这些通道在这些网络中往往需要经过繁琐的转换设备，导致速度大幅下降。纯IPv6优先的环境是prefer-ipv6功能的最佳适用场域。
必须保持关闭prefer-ipv6的敏感场景
IPv6网络质量劣于IPv4的运营商环境
部分宽带运营商虽然为用户分配了IPv6地址，但IPv6出口带宽有限、国际路由绕路严重或存在较高的丢包率，导致IPv6通道的实际体验远不如成熟的IPv4网络。在这种网络环境下开启prefer-ipv6会导致所有优先使用IPv6的连接变慢或失败，用户访问境外网站时可能频繁超时。用户可以通过在开启前后分别访问同一双栈网站并对比加载速度来判断自身网络的IPv6质量，若开启后速度明显下降则应果断关闭该参数，保持传统的IPv4优先策略。
使用代理节点不支持IPv6连接的场景
如果用户当前使用的代理节点服务器仅配置了IPv4地址，而本地网络却启用了IPv6并开启了prefer-ipv6，则会产生一个严重的问题：引擎会优先尝试使用IPv6地址去连接代理目标，但代理节点本身无法处理IPv6流量，导致代理连接始终无法建立。这种情况表现为节点延迟测试正常但在实际使用时所有代理域名都无法打开，且日志中反复出现IPv6连接超时的错误提示。此时用户必须关闭prefer-ipv6或更换支持双栈的代理节点，否则代理通道将完全不可用。
老旧应用和特定网站对IPv6兼容性不佳的环境
部分老旧的企业应用、政府网站或特定银行的网上银行系统对IPv6的支持尚不完善，当客户端通过IPv6访问这些站点时可能出现页面显示异常、功能按钮无响应或安全证书验证失败等问题。开启prefer-ipv6会让这些应用的访问请求优先走IPv6通道，而该通道与应用的兼容性缺陷会导致用户体验严重受损。用户如果频繁访问这类IPv6兼容性欠佳的站点，为了确保功能的完整性和稳定性，应当保持prefer-ipv6关闭，让所有请求始终通过成熟的IPv4通道完成。
在配置文件中设置prefer-ipv6的操作步骤
定位配置文件编辑入口与参数添加位置
由于prefer-ipv6并未出现在Shadowrocket的图形化设置界面中，用户必须通过编辑配置文件的纯文本来实现对该参数的修改。进入Shadowrocket的“配置”页面，找到当前正在加载的配置文件并点击进入详情页，选择“编辑纯文本”或“编辑配置”以打开内置的文本编辑器。在文件中找到以[General]开头的全局设置段落，该段落通常位于配置文件的顶部区域，包含了日志级别、DNS超时等基础参数，prefer-ipv6参数应添加在此段落的任意空行位置。
按照正确语法添加或修改参数行
在[General]段落下新增一行“prefer-ipv6 = true”以开启IPv6优先策略，或输入“prefer-ipv6 = false”以明确关闭该功能并保持默认的IPv4优先行为。注意参数名与等号之间、等号与值之间各保留一个英文空格，值必须为小写的true或false，任何大小写错误或多余符号都会导致解析引擎忽略该行配置。如果配置文件中已经存在该参数行，则直接修改等号后的值即可而无需重复添加，确保文件中仅保留一行prefer-ipv6定义以避免解析冲突。
保存配置并执行重载使修改生效
完成参数行的添加或修改后，点击页面右上角的“保存”按钮将更改写入配置文件，然后返回配置页面并点击“重新加载”按钮让引擎重新解析整个配置文件的内容。重载完成后如果VPN处于连接状态，建议手动断开并重新建立VPN连接，确保网络栈全面重置以应用新的地址偏好策略。此后可以通过访问双栈网站并查看实时日志中显示的连接IP地址族来验证prefer-ipv6是否按预期正常工作。
开启后的验证方法与故障应急处理
通过实时日志确认连接的地址族
配置完成后，打开Shadowrocket的实时日志功能，然后访问一个已知同时支持IPv6和IPv4的境外网站（如google.com或youtube.com），观察日志中该域名解析后返回的IP地址类型。如果日志显示连接尝试使用了以“2001:”或“240e:”等开头的IPv6地址，则说明prefer-ipv6已成功开启并正指导引擎优先使用IPv6通道。如果日志中出现的仍然是IPv4地址且在该网站明显支持IPv6的情况下，则该参数可能未被正确加载，需要返回配置文件检查语法并重新执行重载操作。
因IPv6质量不佳导致访问异常的快速回退
开启prefer-ipv6后如果发现网页加载速度明显变慢、部分网站无法打开或代理连接频繁超时，应立即怀疑IPv6通道的质量问题并果断回退配置。用户只需要再次进入配置文件的文本编辑器，将“prefer-ipv6 = true”修改为“prefer-ipv6 = false”并保存重载，网络行为即可恢复到IPv4优先的稳定状态。回退后无需重启设备或重置其他配置，所有网络连接会立即切换回使用IPv4地址进行连接建立，访问速度通常会在数秒内恢复正常。
与代理节点支持的兼容性验证方法
为了确认代理节点对IPv6的实际支持情况，用户可以在开启prefer-ipv6后访问一个纯IPv6测试站点（如ipv6.google.com），观察连接是否能够成功建立并正常加载页面内容。如果测试站点无法访问且日志显示IPv6连接超时，说明当前代理节点不支持IPv6转发，用户要么关闭prefer-ipv6彻底禁用IPv6优先，要么更换一个明确支持双栈的代理节点来同时享受IPv6的潜在优势。定期进行这种兼容性验证有助于用户根据节点变化及时调整prefer-ipv6的配置状态。
常见问题FAQ
prefer-ipv6与系统设置的IPv6开关是同一个概念吗？
不是。系统设置的IPv6开关控制设备是否启用IPv6协议栈，而prefer-ipv6仅控制DNS解析结果的优先级排序。即使系统开启了IPv6，prefer-ipv6关闭时引擎仍会优先使用IPv4地址，两者相互独立。
开启prefer-ipv6会导致国内网站访问变慢吗？
有可能会。如果本地运营商IPv6国际出口带宽有限，访问境外双栈网站可能变慢，但访问国内双栈网站时，由于国内IPv6网络通常性能良好，速度可能反而提升。具体效果取决于本地IPv6网络的真实质量。
如何确认当前网络环境下IPv6和IPv4哪个更快？
先关闭prefer-ipv6使用IPv4访问，记录速度，再开启并使用IPv6访问同一双栈网站，对比加载时间。如果IPv6访问明显更慢，则应保持关闭状态；如果速度提升，则开启是最佳选择。
所有代理节点都支持prefer-ipv6吗？
不是。只有代理节点服务器本身配置了IPv6且支持双栈转发的节点才支持该参数的效果。如果节点仅支持IPv4，开启prefer-ipv6可能导致代理连接失败，此时必须关闭或更换支持IPv6的节点。