基于OnBeforeBrowse事件的智能代理分流技术

🎯 技术背景

在开发智能代理浏览器过程中，我们遇到了一个关键问题：第一次访问IP检测网站显示真实IP，刷新后才显示代理IP。这个问题的根本原因是代理设置的时机不正确。

❌ 原始错误方案

问题现象

bash

# 第一次访问 whatismyipaddress.com
显示结果：真实本地IP (xxx.xxx.xxx.xxx)

# 刷新页面后
显示结果：代理IP (43.134.174.54)

错误原因分析

错误的事件选择：在 OnBeforeResourceLoad 事件中设置代理
时机问题：资源加载前设置代理，需要刷新页面才能生效
违反官方规范：未按照FBro官方文档推荐的代理设置时机

错误代码示例

csharp

// ❌ 错误做法：在资源加载前设置代理
public override FBroSharpReturnValueType OnBeforeResourceLoad(IFBroSharpBrowser browser,
    IFBroSharpFrame frame, IFBroSharpRequest request, IFBroSharpCallback callback)
{
    string url = request.GetURL();
    
    if (url.Contains("ip138.com"))
    {
        // 这里设置代理需要刷新后才生效！
        ClearProxy(browser);
    }
    
    return FBroSharpReturnValueType.RV_CONTINUE;
}

✅ 标准解决方案

关键发现

根据FBro官方文档明确指出：

设置当前浏览器代理，在"浏览器_即将导航OnBeforeBrowse"或"浏览器_创建完毕OnAfterCreated"事件中设置，也可在其他地方设置，但刷新后才会生效

技术原理

OnBeforeBrowse：页面导航前事件，是代理设置的最佳时机
OnBeforeResourceLoad：资源加载前事件，设置代理需要刷新才生效
时序关系：OnBeforeBrowse → OnBeforeResourceLoad → 实际网络请求

正确实现代码

csharp

/// <summary>
/// 即将导航事件 - 标准代理控制时机
/// 根据FBro官方文档，代理设置应在此事件中进行以立即生效
/// </summary>
public override bool OnBeforeBrowse(IFBroSharpBrowser browser, IFBroSharpFrame frame, 
    IFBroSharpRequest request, bool user_gesture, bool is_redirect)
{
    try
    {
        string url = request.GetURL();
        
        // 基础过滤：过滤掉内部通信和特殊协议
        if (string.IsNullOrEmpty(url) || url.StartsWith("chrome://") || 
            url.StartsWith("devtools://") || url.StartsWith("chrome-extension://"))
        {
            return false; // 继续导航
        }
        
        // 🚀 智能代理分流：根据URL决定代理策略
        bool shouldUseDirect = url.Contains("ip138.com") || // 测试用
                              url.Contains("douyinvod.com") || url.Contains("douyinpic.com") || 
                              url.Contains("douyinstatic.com") || url.Contains("byteimg.com");
        
        if (shouldUseDirect)
        {
            // ⚡ 直连：清除代理
            ClearProxyForNavigation(browser, url);
            Console.WriteLine($"⚡ [页面直连] {TruncateUrl(url, 60)}");
            Console.WriteLine($"🔍 [页面直连] 代理已清除，页面将走本地网络");
        }
        else
        {
            // 🌐 代理：确保代理设置
            EnsureProxyForNavigation(browser, url);
            Console.WriteLine($"🌐 [页面代理] {TruncateUrl(url, 60)}");
            Console.WriteLine($"🔍 [页面代理] 代理已设置，页面将走SOCKS5代理");
        }
        
        return false; // 继续导航
    }
    catch (Exception ex)
    {
        Console.WriteLine($"❌ OnBeforeBrowse异常: {ex.Message}");
        return false; // 继续导航
    }
}

/// <summary>
/// 清除代理用于页面导航（OnBeforeBrowse中使用）
/// </summary>
private void ClearProxyForNavigation(IFBroSharpBrowser browser, string url)
{
    try
    {
        using (var vipControl = browser.GetVIPControl())
        {
            var advancedControl = vipControl.GetAdvancedControl();
            advancedControl.ClearProxy();
        }
        Console.WriteLine($"✅ [导航代理清除] {TruncateUrl(url, 50)}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"❌ 导航代理清除失败: {ex.Message}");
    }
}

/// <summary>
/// 确保代理设置用于页面导航（OnBeforeBrowse中使用）
/// </summary>
private void EnsureProxyForNavigation(IFBroSharpBrowser browser, string url)
{
    try
    {
        var proxySettings = _proxyController.GetProxySettings();
        if (proxySettings?.Enabled == true)
        {
            using (var vipControl = browser.GetVIPControl())
            {
                var advancedControl = vipControl.GetAdvancedControl();
                
                // 设置SOCKS5代理
                advancedControl.SetProxy(
                    proxySettings.GetProxyUrl(), 
                    proxySettings.Username, 
                    proxySettings.Password, 
                    true
                );
            }
            Console.WriteLine($"✅ [导航代理设置] {TruncateUrl(url, 50)}");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"❌ 导航代理设置失败: {ex.Message}");
    }
}

🏗️ 双层架构设计

架构思路

主控制层：OnBeforeBrowse - 页面级代理控制
监控层：OnBeforeResourceLoad - 资源级监控调试

OnBeforeResourceLoad 简化版

csharp

/// <summary>
/// 资源加载前事件 - 仅用于监控和调试
/// 主要的代理控制已移至OnBeforeBrowse事件中
/// </summary>
public override FBroSharpReturnValueType OnBeforeResourceLoad(IFBroSharpBrowser browser,
    IFBroSharpFrame frame, IFBroSharpRequest request, IFBroSharpCallback callback)
{
    try
    {
        string url = request.GetURL();
        
        // 基础过滤
        if (string.IsNullOrEmpty(url) || url.StartsWith("chrome://") || 
            url.StartsWith("devtools://") || url.StartsWith("chrome-extension://"))
        {
            return FBroSharpReturnValueType.RV_CONTINUE;
        }
        
        // 📊 仅记录资源类型，不进行代理操作
        bool isDirectTarget = url.Contains("ip138.com") || 
                             url.Contains("douyinvod.com") || url.Contains("douyinpic.com") || 
                             url.Contains("douyinstatic.com") || url.Contains("byteimg.com");
        
        // 降低日志频率
        if (_requestCounter % 50 == 0)
        {
            if (isDirectTarget)
                Console.WriteLine($"⚡ [资源直连] {TruncateUrl(url, 50)}");
            else
                Console.WriteLine($"🌐 [资源代理] {TruncateUrl(url, 50)}");
        }
        
        Interlocked.Increment(ref _requestCounter);
        return FBroSharpReturnValueType.RV_CONTINUE;
    }
    catch (Exception ex)
    {
        Console.WriteLine($"❌ OnBeforeResourceLoad异常: {ex.Message}");
        return FBroSharpReturnValueType.RV_CONTINUE;
    }
}

🧪 测试验证

测试场景

首次访问代理测试站点

访问：https://whatismyipaddress.com/
预期：立即显示代理IP (43.134.174.54)
实际：✅ 成功显示代理IP

直连测试站点

访问：https://www.ip138.com/
预期：显示真实本地IP
实际：✅ 成功显示本地IP

页面间切换测试

从 whatismyipaddress.com → ip138.com
预期：代理状态立即切换，无需刷新
实际：✅ 立即生效

控制台输出示例

bash

⚡ [页面直连] https://www.ip138.com/
🔍 [页面直连] 代理已清除，页面将走本地网络
✅ [导航代理清除] https://www.ip138.com/

🌐 [页面代理] https://whatismyipaddress.com/
🔍 [页面代理] 代理已设置，页面将走SOCKS5代理
✅ [导航代理设置] https://whatismyipaddress.com/

🎯 核心技术要点

1. 事件时序理解

用户访问URL
    ↓
OnBeforeBrowse (页面导航前) ← 🎯 在这里设置代理
    ↓
OnBeforeResourceLoad (资源加载前)
    ↓
实际网络请求 (使用已设置的代理)

2. 代理设置最佳实践

✅ 推荐：在 OnBeforeBrowse 或 OnAfterCreated 中设置
❌ 避免：在 OnBeforeResourceLoad 中设置（需要刷新才生效）
⚠️ 注意：其他地方设置代理需要刷新页面

3. 智能分流规则设计

csharp

// 直连规则（走本地网络）
bool shouldUseDirect = url.Contains("ip138.com") ||           // IP检测站点
                      url.Contains("douyinvod.com") ||        // 抖音视频
                      url.Contains("douyinpic.com") ||        // 抖音图片
                      url.Contains("douyinstatic.com") ||     // 静态资源
                      url.Contains("byteimg.com");            // 字节图片

// 代理规则（走SOCKS5代理）
// 所有其他请求，包括API调用、统计上报等

4. 性能优化要点

避免频繁代理切换：智能去重机制
降低日志频率：避免控制台刷屏
异常处理：确保代理操作失败不影响浏览
资源管理：正确使用using语句管理VIP控制类

📋 最佳实践清单

✅ 应该做的

在 OnBeforeBrowse 事件中设置代理
使用 using 语句管理VIP控制类
添加异常处理避免崩溃
记录清晰的调试日志
设计智能的分流规则

❌ 不应该做的

在 OnBeforeResourceLoad 中设置代理
忽略异常处理
频繁切换代理导致性能问题
过量的调试日志影响性能
硬编码代理配置

🔧 故障排查

常见问题及解决方案

问题1：代理设置不生效

原因：在错误的事件中设置代理
解决：移至OnBeforeBrowse事件中

问题2：第一次访问显示真实IP

原因：代理设置时机太晚
解决：使用OnBeforeBrowse进行页面级控制

问题3：频繁的代理切换导致卡顿

原因：每个资源请求都切换代理
解决：在页面级别控制，避免资源级别切换

📚 相关文档

🎉 总结

通过使用 OnBeforeBrowse 事件进行代理控制，我们成功实现了：

立即生效：代理设置在页面导航前完成，无需刷新
智能分流：根据URL自动选择直连或代理
性能优化：避免资源级别的频繁代理切换
标准合规：严格按照FBro官方文档规范实现

这个解决方案完美解决了"第一次显示真实IP，刷新后才显示代理IP"的问题，为FBro浏览器的智能代理分流提供了标准化的技术方案。

基于OnBeforeBrowse事件的智能代理分流技术 ​

🎯 技术背景 ​

❌ 原始错误方案 ​

问题现象 ​

错误原因分析 ​

错误代码示例 ​

✅ 标准解决方案 ​

关键发现 ​

技术原理 ​

正确实现代码 ​

🏗️ 双层架构设计 ​

架构思路 ​

OnBeforeResourceLoad 简化版 ​

🧪 测试验证 ​

测试场景 ​

控制台输出示例 ​

🎯 核心技术要点 ​

1. 事件时序理解 ​

2. 代理设置最佳实践 ​

3. 智能分流规则设计 ​

4. 性能优化要点 ​

📋 最佳实践清单 ​

✅ 应该做的 ​

❌ 不应该做的 ​

🔧 故障排查 ​

常见问题及解决方案 ​

📚 相关文档 ​

🎉 总结 ​

基于OnBeforeBrowse事件的智能代理分流技术

🎯 技术背景

❌ 原始错误方案

问题现象

错误原因分析

错误代码示例

✅ 标准解决方案

关键发现

技术原理

正确实现代码

🏗️ 双层架构设计

架构思路

OnBeforeResourceLoad 简化版

🧪 测试验证

测试场景

控制台输出示例

🎯 核心技术要点

1. 事件时序理解

2. 代理设置最佳实践

3. 智能分流规则设计

4. 性能优化要点

📋 最佳实践清单

✅ 应该做的

❌ 不应该做的

🔧 故障排查

常见问题及解决方案

📚 相关文档

🎉 总结