在Shadowrocket中添加广告拦截模块时，用户在“配置”标签页中点击当前激活的配置文件进入编辑界面，在“规则集”区域点击加号选择“URL”类型，将社区维护的远程广告拦截规则集链接粘贴至地址输入框并将策略设置为REJECT，同时将规则集引用拖动至规则列表的顶部以确保广告请求在其他规则之前被拦截。部分社区模块还包含URL Rewrite区域的路径级重写规则，用户应将社区提供的完整重写规则文本粘贴至配置文件的[URL Rewrite]区域，以对特定请求路径进行精细拦截。添加完成后保存配置并重载，访问广告检测网站验证拦截功能是否正常工作，如果广告仍可见则检查规则集引用的位置是否位于配置规则列表最顶部，或返回日志捕获未被覆盖的广告域名并补充至自定义规则中。定期在配置列表下拉刷新远程模块获取最新的广告黑名单，同时将自定义的例外放行规则放置在模块引用之前，以避免模块误伤正常网站功能。如果模块因更新或网络问题导致页面异常，可在模块引用行前添加注释符号临时禁用，快速恢复访问而不丢失模块配置。通过远程规则集与本地URL Rewrite的组合，用户能够构建起层次分明、更新便捷的广告拦截方案，与手动规则形成互补而非冲突，兼顾拦截覆盖面和功能兼容性。
理解Shadowrocket中“模块”概念的真实对应关系
Shadowrocket没有独立的模块界面但通过规则集实现同等功能
与Clash或Surge中拥有独立“Module”标签页和开关管理的方式不同，Shadowrocket的应用界面中并不存在一个名为“模块”的专属管理区域，但用户可以通过配置文件的规则集引用和URL Rewrite功能实现完全等同的模块化广告拦截能力。所谓“添加广告拦截模块”，在Shadowrocket语境下指的是在配置文件中通过RULE-SET方式引用外部维护的广告域名列表，或在URL Rewrite区域导入社区维护的重写规则集合，以独立于主配置规则的方式集中管理广告拦截逻辑。理解这一对应关系是正确操作的第一步，避免用户在界面中徒劳寻找不存在的“模块”入口。
模块化去广告与内置规则集协同工作的差异
Shadowrocket的配置文件规则列表本身就支持直接写入REJECT规则来拦截广告域名，而模块化方式的区别在于将大量广告规则从主配置文件中分离出来，通过外部链接或本地文件引用的形式附加至当前配置。这种分离使得用户可以独立更新广告拦截规则而不影响主配置文件中的分流规则和策略组定义，且当广告规则集出现误伤时仅需调整模块引用而非修改整个配置。模块化方式与内联规则可以共存于同一配置文件中，两者互为补充而非替代关系。
社区维护的广告模块通常以规则集形式分发
目前主流的Shadowrocket去广告模块通常以远程规则集链接的形式分发，这些规则集文件包含了经过持续维护的广告和追踪域名列表，并按照Shadowrocket的规则语法以DOMAIN-SUFFIX和DOMAIN-KEYWORD格式编写。用户在获取到这类链接后，需要通过配置文件中的规则集添加功能将其纳入当前配置，而非直接在界面中“安装模块”。部分第三方维护者也会提供包含URL Rewrite规则的配置文件片段，用于拦截基于路径的广告请求和去除页面中的空白占位元素。
通过配置文件规则集添加远程广告拦截模块
在配置编辑界面的规则集区域添加外部规则引用
用户打开Shadowrocket后进入“配置”标签页，点击当前激活的配置文件名称进入编辑界面，在配置编辑页面中找到“规则集”或“Rule Set”设置区块并点击进入。在该区域中，用户点击右上角的加号按钮开始添加新的规则集引用，在弹出的配置窗口中将“类型”选择为“URL”，然后将从社区获取的广告拦截规则集链接粘贴至地址输入框中。保存后该远程规则集即被添加到当前配置的引用列表，每次加载配置时应用会自动从远程服务器拉取最新的广告拦截规则。
为规则集指定REJECT策略确保广告请求被拒绝
在添加远程广告规则集时，用户需要在策略下拉菜单中选择“REJECT”或“REJECT-DROP”，当规则集中的任何域名被匹配时该策略将被执行。部分规则集文件本身已内嵌了策略指令，用户可选择“无”让规则集文件自行决定，但为确保拦截行为一致，推荐统一指定为REJECT。策略选择完成后保存配置，该规则集即完整附加至当前配置文件中，其效果等同于在主规则列表顶部添加了数千条广告域名拒绝规则。
优先将广告规则集引用放置在规则列表顶部
为了确保广告拦截规则在所有分流规则之前被匹配，用户需要在配置编辑界面中拖动规则集条目至列表的最顶部，使其位于任何GEOIP直连规则和泛匹配规则之上。如果广告规则集放置在直连规则之后，国内网站的广告域名可能在匹配到广告拒绝规则前就已命中了国内直连规则而走直连通道，导致广告拦截完全失效。调整顺序后保存配置并重载，广告拦截模块即正式生效。
通过URL Rewrite区域添加路径级广告拦截规则
在URL Rewrite中粘贴社区维护的重写规则文本
部分广告拦截模块不仅包含域名级拒绝规则，还包含用于清除广告占位元素和阻止特定脚本加载的URL Rewrite规则，这些规则通常以正则表达式形式提供。用户进入配置编辑界面滑动至[URL Rewrite]区域，将社区维护者提供的完整重写规则文本粘贴至该区域，每条规则占据独立一行，格式为“正则表达式 目标地址 动作”。这些规则会对页面中的资源请求进行路径级匹配，将广告脚本或统计追踪请求替换为空响应或直接拒绝。
区分URL Rewrite中的REJECT与直接写入规则列表的域名拒绝
URL Rewrite区域中的REJECT规则作用于完整的请求URL路径，能够精确匹配特定脚本或图片的加载地址，比规则列表中基于域名的拒绝更为精细。而配置规则列表中的REJECT仅针对域名或IP段进行匹配，无法区分同一域名下不同路径的请求。两种机制可以协同工作：域名级规则拦截整个广告分发域名的所有请求，路径级规则在需要保留同一域名下核心功能的情况下精准切除广告路径。用户在添加模块时应同时关注这两个区域的规则配置。
在模块中添加注释说明每条规则的来源和用途
由于URL Rewrite区域中的正则表达式不易阅读，用户在粘贴社区模块的重写规则时应在每一条或每组规则上方添加注释行，标注该规则的目标网站或App以及预期的拦截行为，便于日后调整或停用特定规则。注释以分号开头，不影响规则的执行，例如; Netflix splash ad removal标注于相关规则之前。当模块更新时，用户可对照注释快速判断哪些规则已被新版替换或新增。
通过本地文件添加离线广告拦截模块
将规则集文件存入Shadowrocket的应用目录
对于网络环境受限或希望保持规则稳定的用户，可以将社区维护的广告拦截规则集文件下载为本地文本文件，通过iOS的“文件”应用将该文件存放至Shadowrocket的应用沙盒目录中。确保文件格式为纯文本且每行符合Shadowrocket规则语法，文件扩展名通常为.list或.conf。存放完成后在Shadowrocket中进入配置编辑界面的规则集添加功能，将类型选择为“本地文件”并从文件选择器中定位到该文件。
本地模块不受远程服务器可用性影响且加载速度更快
与URL方式引用的远程模块相比，本地文件模块在每次配置加载时直接从设备存储读取内容，不依赖网络连接，避免了因远程服务器故障或网络不通导致的规则更新失败问题。本地文件的加载速度通常也快于远程拉取，尤其在规则集文件较大的情况下，因为省去了网络传输和解压解析的时间开销。但本地模块需要用户手动更新文件内容以获取最新的广告域名列表，缺乏远程模块的自动同步便利性。
本地文件修改后需手动触发配置重新加载
当用户更新了本地存储的广告规则集文件后，Shadowrocket不会自动检测到文件变更并使用新内容，需要用户手动执行一次配置切换操作来强制应用重新读取本地文件。用户可在配置列表中选择其他配置再切回当前配置，或直接关闭再开启代理开关触发完整的配置重载流程，确保更新后的本地模块内容被完整加载至内存中生效。
模块添加后的生效验证与日常维护
访问广告检测网站验证拦截功能是否正常工作
完成规则集或URL Rewrite模块的添加后，用户应在开启Shadowrocket代理的状态下访问AdBlock测试网站或专门的广告检测页面，确认页面中的测试广告元素是否已被成功拦截。如果检测页面显示所有广告均被屏蔽或部分广告仍可见，用户可根据检测结果的反馈返回配置编辑界面调整模块的顺序或补充遗漏的规则。建议同时访问日常使用的几个主流网站，观察正常内容是否完整加载，排除模块误伤的可能性。
定期刷新远程模块获取最新的广告域名黑名单
远程规则集模块的维护者会持续向列表中添加新出现的广告域名并从列表中移除已失效的条目，用户应在Shadowrocket的配置列表中执行下拉刷新操作来拉取远程模块的最新版本。如果模块以订阅形式添加且配置列表中显示了刷新按钮，点击即可更新。建议每周或每月执行一次手动刷新，或在感觉广告拦截效果下降时立即刷新，以保持模块的时效性和拦截精度。
利用场景功能区分开启模块和关闭模块的不同配置
如果用户发现在某些特定网站或应用中使用广告模块导致页面加载异常或功能受限，可以创建两个配置文件版本，一个包含完整的广告拦截模块，另一个不包含任何广告拦截规则，并通过Shadowrocket的场景功能将这两个配置分别保存为不同场景。在遇到兼容性问题时可快速切换至不含模块的场景恢复正常访问，问题页面关闭后再切换回含模块的场景继续享受无广告浏览，实现灵活切换而非彻底禁用。
与规则列表手动规则发生冲突时的处理策略
模块规则与手动规则同时匹配时的优先级判断
当配置文件中同时存在模块引用的规则集和用户在规则列表中手动添加的规则时，两者的匹配顺序由它们在配置文件中的相对位置决定，位于列表顶部的规则优先执行。用户应确保广告拦截模块（通常设为REJECT）位于任何DOMAIN-SUFFIX代理规则或GEOIP直连规则之前，避免广告请求在命中拒绝规则前已被其他规则处理。手动添加的规则如果与模块规则针对同一域名，在规则列表中更靠前的那一条会生效，用户可通过拖动调整顺序来控制冲突时的裁决。
手动添加的例外规则应放置在模块引用之前
如果用户发现广告模块误拦截了某个正常使用的网站或功能域名，需要为该域名添加一条放行规则，此时应将这条例外规则放置在模块引用之前。因为匹配顺序遵循自上而下原则，例外规则先于模块引用被评估时，该域名的请求会匹配到放行策略而不会进入模块的拒绝规则范围。例如添加DOMAIN-SUFFIX,example.com,DIRECT规则并将其放置在RULE-SET,adblock.list,REJECT这一行之前，即可让example.com的请求绕过广告拦截。
通过注释临时停用模块而无需删除引用
当需要排查模块是否导致某个网站加载异常时，用户无需删除整个模块引用，只需在模块引用行的开头添加注释符号（分号）即可临时禁用该模块，保存配置重载后模块规则全部失效，网站恢复正常。确认问题确实由该模块引起后，用户可取消注释恢复模块功能并进一步调整其中的具体规则，或保留注释永久停用该模块并更换为其他维护者的规则集。注释停用的方式既保留了模块的配置信息又实现了快速恢复，比删除后重新添加更为高效。
常见问题FAQ
添加了多个广告模块，但广告还是弹出，是模块冲突了吗？
多个模块同时存在时，匹配顺序由它们在规则列表中的位置决定，广告无法拦截通常是因为模块位置靠后，在广告请求到达模块之前已被前置的直连规则或代理规则处理。用户应将所有广告拦截模块的引用拖动至配置规则列表的顶部，确保它们在任何分流规则之前被评估。如果模块内部的规则存在重复，不构成冲突，会依次匹配但仅第一个命中的规则生效。
如何判断是模块无效还是App广告缓存未清除？
用户在添加模块后先访问广告检测网站确认拦截功能是否正常，如果检测网站显示广告被拦截但App内开屏广告依然出现，则问题在App的本地广告缓存而非模块有效性。此时应在iPhone存储空间中彻底删除该App以清除缓存，然后重新下载安装并在代理开启状态下首次启动，观察广告是否消失。如果检测网站本身都显示广告未被拦截，则需返回配置检查模块引用是否正确且位置合适。
远程模块更新失败会影响当前配置的正常使用吗？
远程模块更新失败不会导致当前配置失效，Shadowrocket会继续使用本地缓存的旧版本模块规则，即使更新操作提示错误，已有的拦截功能依然维持有效。用户可在网络环境改善后再次执行下拉刷新重试更新，或在更新失败时暂时保持旧版本模块工作，待服务端恢复正常后再获取最新规则。唯一需要注意的是长期不更新可能导致新出现的广告域名未被覆盖，但不会破坏已生效的拦截能力。
自定义广告模块和社区通用模块可以一起用吗？
可以，自定义模块和社区通用模块可以共存于同一配置文件中，社区通用模块覆盖广泛的广告域名，自定义模块针对用户常用App中未被通用模块覆盖的特定广告进行补充。建议将自定义模块放置在社区通用模块之前，确保用户针对特定应用的规则优先于通用规则，避免通用模块中的规则覆盖了用户精心调整的特定拦截逻辑。两者共同工作可以构建更全面的广告拦截覆盖范围。