网页爬虫浏览器控制【免费下载链接】camoufox Anti-detect browser项目地址https://gitcode.com/gh_mirrors/ca/camoufox点击查看免费下载导读本文以 patches/patch-dependencies.md 为骨架系统梳理 Camoufox 补丁体系中的共享基础设施依赖关系哪些补丁依赖config.patch提供的camoucfgMaskConfig配置目录、哪些 per-context 补丁依赖cross-process-storage.patch提供的跨进程存储以及为什么所有补丁必须以0-playwright.patch和1-leak-fixes.patch为基线依次应用。读完本文你将理解 Camoufox 每个反检测补丁背后的配置读取链路、IPC 同步机制与正确的打补丁顺序能够自行评估新增一个补丁时它依赖哪些基础设施。Camoufox Anti-detect browser是一套基于 Firefox 的源码级反检测浏览器其核心思路是把大量指纹伪装逻辑直接打进浏览器二进制通过环境变量注入的 JSON 配置MaskConfig控制各模块行为通过命名空间化的偏好项实现 per-context每个浏览器上下文独立的伪装数据同步再叠加上 PlaywrightJuggler自动化协议层。这三个基础设施构成了补丁体系的地基。1. 补丁体系概览共享基础设施决定依赖关系Camoufox 的补丁并非彼此独立而是建立在一套共享基础设施之上。补丁依赖关系文档给出了一张速查总览基础设施提供方补丁依赖方camoucfgMaskConfig 配置头文件目录config.patch所有通过MaskConfig::GetBool()/GetString()等读取配置的补丁RoverfoxStorageManager跨进程命名空间存储cross-process-storage.patch需要跨进程同步指纹数据的 per-context 补丁Juggler / Playwright 自动化层0-playwright.patch1-leak-fixes.patch除这两个基线外的所有补丁换句话说理解依赖关系只需要回答三个问题配置从哪来、配置存到哪、补丁以什么顺序落地。下面三节逐一展开。2. camoucfgMaskConfig统一的配置读取层2.1config.patch提供什么文档明确指出任何补丁如果在其moz.build中加入了LOCAL_INCLUDES [/camoucfg]就说明它依赖config.patch先被应用——因为camoucfg目录本身是由config.patch引入源码树的。查看 config.patch 可以看到它做了三件事在根 moz.build 末尾追加DIRS [lw]新建lw子目录创建 lw/moz.build把 Camoufox 运行时文件安装进构建产物FINAL_TARGET_FILEScamoufox.cfg、chrome.css、properties.jsonFINAL_TARGET_FILES.distributionpolicies.jsonFINAL_TARGET_FILES.defaults.preflocal-settings.js修改 browser/installer/package-manifest.in把local-settings.js、policies.json、camoufox.cfg打入安装包。这些源文件在仓库中位于 settings 目录例如 camoufox.cfg 中可以看到defaultPref(media.peerconnection.ice.no_host, false)等一系列反指纹默认偏好。也就是说config.patch不仅是配置读取层的入口还负责把 Camoufox 的运行时配置文件安装进浏览器。2.2 MaskConfig 的读取机制CAMOU_CONFIG 环境变量camoucfg目录的核心是 MaskConfig.hpp。它定义了命名空间MaskConfig从环境变量读取 JSON 配置。核心读取逻辑位于GetJson()MaskConfig.hpp依次读取CAMOU_CONFIG_1、CAMOU_CONFIG_2……并拼接直到某个编号不存在为止若编号形式为空则回退读取原始的CAMOU_CONFIG用nlohmann::json::accept()校验 JSON 合法性非法 JSON 会通过printf_stderr输出ERROR: Invalid JSON passed to CAMOU_CONFIG!并视为空配置配置在进程生命周期内只解析一次std::call_once。这种编号分片 拼接的设计让调用方如 Camoufox 的 Python 驱动可以按上下文把庞大的指纹配置切分成多段注入避免环境变量长度限制。2.3 MaskConfig 公开 API 一览从 MaskConfig.hpp 的源码可以看到它不止有文档表格中提到的GetBool/GetString而是一整套类型化读取 APIAPI返回类型说明GetString(key)std::optionalstd::string读取字符串值缺失返回std::nulloptGetStringList(key)std::vectorstd::string读取字符串数组GetStringListLower(key)std::vectorstd::string读取字符串数组并全部小写用于字体指纹白名单GetBool(key)/CheckBool(key)std::optionalbool/bool读取布尔值CheckBool缺失时按false处理GetUint64/GetUint32/GetInt32对应optional整数带类型校验类型不符会打印错误GetDouble(key)std::optionaldouble读取浮点数兼容整数输入GetRect(left, top, width, height)std::optionalstd::arrayuint32_t,4组合四个键读取矩形width/height缺一不可GetNested(domain, key)std::optionalnlohmann::json读取嵌套对象如webGl:parametersGetAttribute(attrib, isWebGL2)模板函数读取 WebGL 上下文属性webGl:contextAttributes/webGl2:contextAttributesGLParam(pname, isWebGL2)variant按 GL 参数枚举号读取伪装值MParamGL/MParamGLVector带默认值模板WebGL 参数读取缺失时回退默认MShaderData数组WebGL shader 精度格式伪装MVoices()tuple 数组语音speechSynthesis伪装数据要求每条记录完整包含lang/name/voiceUri/isDefault/isLocalService五个字段FontAllowlist()/IsFontAllowed()常量引用 / bool字体白名单空列表表示不启用字体伪装值得注意的类型安全设计每个 Getter 都会校验 JSON 值的类型如is_boolean()、is_number_unsigned()类型不符时打印ERROR: Value for key ... is not a boolean之类的诊断信息并返回std::nullopt而不是抛出异常导致浏览器崩溃——这对常驻进程的稳定性至关重要。json.hpp位于 additions/camoucfg/json.hpp即随仓库内置的 nlohmann/json 单头库。3. 使用 MaskConfig 的补丁清单文档给出了四组典型的 MaskConfig 消费方这里逐个结合源码深入3.1media-codec-spoofing.patch媒体编解码器伪装项内容配置键media:spoof_codecs布尔作用绕过PDMFactory::Supports()检查使canPlayType()/isTypeSupported()不泄露系统安装的编解码器库FFmpeg、VideoToolbox、GStreamer查看 media-codec-spoofing.patch它修改了两个解码器dom/media/mp4/MP4Decoder.cpp 的IsSupportedType()当MaskConfig::GetBool(media:spoof_codecs).value_or(false)为真时直接返回true跳过对具体轨道编解码器的系统解码器探测dom/media/webm/MatroskaDecoder.cpp 的IsSupportedType()同样的短路逻辑。补丁同时向这两个目录的moz.build添加LOCAL_INCLUDES [/camoucfg]——这正是文档所说的依赖 config.patch的直接证据。注意其源码注释也诚实地提醒伪装后实际播放可能失败如果系统确实没有对应解码器因此该键适合只报告能力、不真正解码的指纹场景。3.2navigator-spoofing.patchNavigator 属性伪装per-context项内容配置键各种navigator:*键作用按浏览器上下文userContextId分别伪装 navigator 属性这是文档表格中唯一同时涉及两个基础设施的补丁。查看 navigator-spoofing.patch它新增了 dom/base/NavigatorManager.cpp 与 dom/base/NavigatorManager.h通过BrowsingContext的OriginAttributesRef().mUserContextId获取当前上下文 ID配置读写全部经由RoverfoxStorageManager::PutString()/PutBool()/GetString()/GetBool()键名形如nav_plat_id、nav_plat_d_id_d_后缀表示 disabled 标记、nav_oscpu_*、nav_hwc_*、nav_ua_*提供IsPlatformFunctionEnabledForWebIDL、IsOscpuFunctionEnabledForWebIDL、IsHwcFunctionEnabledForWebIDL、IsUaFunctionEnabledForWebIDL等 WebIDL 开关控制navigator.platform、oscpu、hardwareConcurrency、userAgent等属性是否被拦截。正因为它直接使用RoverfoxStorageManager所以它同时依赖cross-process-storage.patch见第 4 节。3.3geolocation-spoofing.patch地理位置坐标伪装项内容配置键geolocation:latitude、geolocation:longitude、geolocation:accuracy均为 double作用用配置的坐标替换真实地理位置查看 geolocation-spoofing.patch改动分三层dom/geolocation/Geolocation.cpp 的RegisterRequestWithPrompt()一旦配置了经纬度直接以DelayedTaskType::Allow放行请求跳过权限提示流程dom/geolocation/GeolocationPosition.cpp 的GetLatitude()/GetLongitude()/GetAccuracy()存在配置值时用配置值覆盖真实坐标dom/system/NetworkGeolocationProvider.sys.mjs在 JS 侧通过ChromeUtils.camouGetDouble(geolocation:latitude, -180)读取配置若未显式配置accuracy还会根据经纬度的小数位数估算精度(111320 * cos(lat * π / 180)) / 10^precision米让精度与坐标看起来一致。3.4locale-spoofing.patch语言/区域伪装项内容配置键locale:all、locale:language、locale:region、locale:script、navigator.language作用伪装navigator.language、Accept-Language与底层 ICU 语言标签查看 locale-spoofing.patchbrowser/base/content/browser-init.js 中启动时优先用locale:all一组逗号分隔的语言覆盖intl.accept_languages若未提供则用locale:languagelocale:region拼出语言-地区, 语言形式再退而求其次用navigator.languageintl/components/src/Locale.cpp 新增GetCamouLanguage()、GetCamouRegion()、GetCamouScript()、GetCamouLocale()与GetDefaultLocale()其中GetDefaultLocale()在无配置时回退到uloc_getDefault()intl/components/src/Locale.h 为LanguageSubtag、ScriptSubtag、RegionSubtag增加mCamou*变体成员对应 intl/components/moz.build 添加LOCAL_INCLUDES [/camoucfg]。它同时修改了浏览器 UI 层browser-init.js 用ChromeUtils.camouGetString与 C ICU 层属于JS 配置读取 C 配置读取混合型补丁因此同样是config.patch的依赖方。3.5 小结判断一个补丁是否依赖 config.patch文档给出的判据非常实用只要补丁的moz.build变更中出现LOCAL_INCLUDES [/camoucfg]或源码中出现MaskConfig::、ChromeUtils::camouGet*它就必须排在config.patch之后。4. RoverfoxStorageManager 与 cross-process-storage.patch4.1 为什么需要跨进程存储Firefox 是多进程架构父进程 内容进程 各种 worker 进程。per-context 指纹伪装的数据如果只存在单个进程内worker、子进程就读不到无法保持一致。文档指出使用跨进程存储的 per-context 补丁都依赖cross-process-storage.patch。4.2 实现机制查看 cross-process-storage.patchdom/ipc/ContentParent.cpp 新增RecvRoverfoxStoragePut/RecvRoverfoxStorageGet两个 IPC 处理函数dom/ipc/PContent.ipdl 声明两个同步sync消息RoverfoxStoragePut/RoverfoxStorageGetipc/ipdl/sync-messages.ini 为它们登记说明写入同步是为了保证 worker 内容进程启动前父进程已持有该值读取同步是因为worker 进程仅在首次读取指纹时使用modules/libpref/Preferences.cpp 把roverfox.s.前缀加入sDynamicPrefOverrideList使这类偏好项支持运行时动态设置。4.3 安全约束roverfox.s. 命名空间一个值得强调的安全细节IPC 两端都会校验键名必须以roverfox.s.开头否则直接拒绝写入返回空、读取返回空串。源码注释写明这是安全考虑——内容进程理论上不可信绝不能让它通过该通道写入任意 Firefox 偏好项。因此RoverfoxStorageManager实际是命名空间化偏好项 PContent 同步 IPC之上的封装层。4.4 依赖方已确认的依赖方是 navigator-spoofing.patchNavigatorManager通过RoverfoxStorageManager读写nav_*键。关于 per-context 补丁的整体设计可进一步阅读 docs/per-context-patches.md。5. Playwright 基线0-playwright.patch 与 1-leak-fixes.patch文档最后一条规则最简洁也最严格所有补丁都应排在0-playwright.patch与1-leak-fixes.patch之后应用。0-playwright.patch3587 行是把 Playwright 需要的 Juggler 自动化层与相关基础设施打入源码树的主补丁。从其 diff 可见它涉及面极广例如 accessible/interfaces/nsIAccessibleDocument.idl 增加isUpdatePendingForJugglerAccessibility属性、accessible/xpcom/xpcAccessibleDocument.cpp 实现该属性、Windows launcherLauncherProcessWin.cpp的改动等。这些改动定义了后续补丁依赖的自动化层上下文1-leak-fixes.patch 紧随其后修复 0 号补丁引入的内存/资源泄漏构成稳定基线。之所以强调顺序是因为后续大量补丁如 browser-init.patch、trusted-automation-events.patch 等会在 Juggler 协议层之上叠加行为若顺序颠倒会导致补丁上下文错位、无法干净应用。补丁目录 patches/playwright 下的 README.md 和 docs/patch-upgrading-guide.md 提供了更完整的升级与维护指引。6. 依赖关系速查与升级建议综合文档与源码Camoufox 补丁依赖可以浓缩为一张依赖图config.patch提供 /camoucfg、打包运行时配置 └─ 任何使用 MaskConfig::* / LOCAL_INCLUDES [/camoucfg] 的补丁 ├─ media-codec-spoofing.patchmedia:spoof_codecs ├─ navigator-spoofing.patchnavigator:*另依赖 cross-process-storage.patch ├─ geolocation-spoofing.patchgeo:* └─ locale-spoofing.patchlocale:* / navigator.language cross-process-storage.patch提供 roverfox.s. 命名空间 PContent 同步 IPC └─ 使用 RoverfoxStorageManager 的 per-context 补丁如 navigator-spoofing.patch 0-playwright.patch → 1-leak-fixes.patchPlaywright/Juggler 自动化层基线 └─ 所有其他补丁给补丁维护者的三条实操建议新增补丁先判断配置来源如果补丁需要读指纹配置优先复用MaskConfig在moz.build加LOCAL_INCLUDES [/camoucfg]并确认config.patch在应用顺序中位于其之前per-context 数据一律走命名空间存储不要新增随意前缀的偏好项统一使用RoverfoxStorageManager与roverfox.s.命名空间才能获得跨进程一致性以及ContentParent内置的键名校验保护始终以 Playwright 基线为锚点0-playwright.patch1-leak-fixes.patch是补丁栈的地基后续补丁必须在其后应用升级 Firefox 上游版本时优先参考 docs/patch-upgrading-guide.md 中关于补丁栈迁移的说明。围绕补丁的工程化工具链应用、打包、测试可继续查看 scripts/patch.py、scripts/bootstrap.py 以及 tests/patches 下的补丁验证测试从而在修改补丁栈时获得可复现的验证闭环。赞分享网页爬虫浏览器控制【免费下载链接】camoufox Anti-detect browser项目地址https://gitcode.com/gh_mirrors/ca/camoufox点击查看免费下载相关推荐5个HunyuanVideo-1.5视频生成高级技巧与性能优化实战指南5个HunyuanVideo 1.5视频生成高级技巧与性能优化实战指南 HunyuanVideo 1.5作为腾讯混元团队开发的轻量级AI视频生成模型凭借仅83网页爬虫浏览器控制解析 nhost 依赖的 go-jsonmergeJSON 补丁合并语义与底层实现解析 nhost 依赖的 go jsonmergeJSON 补丁合并语义与底层实现 本文以 nhost 仓库中 vendored 的 go jsonmerge后端认证鉴权数据库无服务开发工具云原生RevokeMsgPatcher修改信息ModifyInfo存储补丁配置数据RevokeMsgPatcher修改信息ModifyInfo存储补丁配置数据 引言 在PC端即时通讯软件防撤回补丁开发中如何高效管理和存储不同版本的补丁配置桌面应用即时通讯上一篇SteamOS-Waydroid-Installer进阶技巧GPU配置、音频优化与网络修复全攻略下一篇LTX-2本地部署终极指南GPU配置与性能优化实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考