iOS端WebView场景使用HTTPDNS

3.1 方案概述

iOS 17.0引入了ProxyConfiguration相关API，允许应用为WKWebView配置本地代理服务器。通过这种方式，我们可以在本地启动一个代理服务器，拦截WKWebView的所有网络请求，在代理层面实现HTTPDNS域名解析，然后将请求转发到真实服务器。

相比传统技术方案，本地代理方案具有以下显著优势：

1. 稳定性：基于iOS 17+官方API，无需依赖私有API或混淆技术，稳定性和兼容性最佳。

2. 适用性：对WebView完全透明，无需处理cookie、重定向、CORS等复杂细节。支持HTTP/HTTPS/WebSocket等所有协议，覆盖面更广。

3. 易维护：实现逻辑清晰，维护成本相对较低。

3.2 接入参考

考虑创建本地代理服务、解析HTTP请求、基于HTTPDNS解析结果创建连接、数据转发等步骤有一定实现成本，我们在Demo中提供了一个实现作为参考。您可以结合业务实际情况，按需调整这份代码，使得更符合您的业务需要。

直接引入Demo中的`HttpdnsLocalHttpProxy.h`和`HttpdnsLocalHttpProxy.m`文件后，在WkWebView初始化时，只需要进行如下配置，结合HTTPDNS，就可以实现WebView中的网络请求，都使用HTTPDNS进行域名解析了。

// 创建 WKWebViewConfiguration
WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];

// 配置WebView代理
BOOL proxyConfigured = [HttpdnsLocalHttpProxy installIntoWebViewConfiguration:config];
if (proxyConfigured) {
    NSLog(@"WKWebViewProxyScenario: Proxy configuration applied successfully");
} else {
    NSLog(@"WKWebViewProxyScenario: Using system network (proxy unavailable)");
}

// 配置DNS解析器
[HttpdnsLocalHttpProxy setDNSResolverBlock:^NSString *(NSString *hostname) {
    // 获取HTTPDNS服务实例
    HttpDnsService *httpdns = [HttpDnsService sharedInstance];
    if (!httpdns) {
        return hostname;
    }

    // 使用HTTPDNS解析域名
    HttpdnsResult *result = [httpdns resolveHostSync:hostname byIpType:HttpdnsQueryIPTypeAuto];

    if (result) {
        NSString *resolvedIP = nil;

        // 使用IPv4地址
        if ([result hasIpv4Address]) {
            resolvedIP = [result firstIpv4Address];
            NSLog(@"WKWebViewProxyScenario: HTTPDNS IPv4 resolved: %@ -> %@", hostname, resolvedIP);
        } else if ([result hasIpv6Address]) {
            // 如果没有IPv4地址，使用IPv6地址
            resolvedIP = [result firstIpv6Address];
            NSLog(@"WKWebViewProxyScenario: HTTPDNS IPv6 resolved: %@ -> %@", hostname, resolvedIP);
        }

        if (resolvedIP) {
            return resolvedIP;
        }
    }

    NSLog(@"WKWebViewProxyScenario: didn't get an IP from HTTPDNS, fallback to use original hostname: %@", hostname);
    return hostname;
}];

[HttpdnsLocalHttpProxy setLogLevel:HttpdnsProxyLogLevelDebug];

WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:config];

3.3 实现细节

本章节介绍本地代理方案的核心实现流程，仅摘录核心代码片段。如果需要完整理解技术细节，请参考我们开源的代码实现。

1. 创建本地代理服务：使用Network framework在本地启动HTTP代理服务器。

   说明

   如果在当前应用或者多个应用中存在多个本地代理服务器，待创建的新的本地代理服务器的端口可能会存在冲突，可以使用随机端口和重试机制降低冲突的可能。

   // 配置网络连接参数
   nw_parameters_t parameters = nw_parameters_create_secure_tcp(
       NW_PARAMETERS_DISABLE_PROTOCOL,    // 禁用TLS，代理本身不加密
       NW_PARAMETERS_DEFAULT_CONFIGURATION
   );
   
   // 启用地址重用，便于快速重启和端口复用
   nw_parameters_set_reuse_local_address(parameters, true);
   
   // 创建本地回环地址端点，仅监听本地连接
   NSString *portString = [NSString stringWithFormat:@"%d", port];
   nw_endpoint_t localEndpoint = nw_endpoint_create_host("127.0.0.1", [portString UTF8String]);
   nw_parameters_set_local_endpoint(parameters, localEndpoint);
   
   // 使用配置创建网络监听器
   _listener = nw_listener_create(parameters);

2. 解析从WkWebView下发的connect代理建连请求。无论是何种请求，都会通过Connect方法建立隧道，然后使用这条连接承载HTTP协议报文。

   // 接收客户端请求数据
   nw_connection_receive(connection, 1, 4096, ^(dispatch_data_t content, ...) {
       NSString *requestLine = /* 解析请求数据 */;
       
       if ([requestLine hasPrefix:@"CONNECT "]) {
           // HTTPS 隧道请求：CONNECT example.com:443 HTTP/1.1
           [self handleHTTPSConnect:request connection:connection];
       }
   });

3. 实现双向数据转发：在客户端和目标服务器之间建立透明的数据通道。

   - (void)relayDataFrom:(nw_connection_t)source to:(nw_connection_t)destination {
       nw_connection_receive(source, 1, 8192, ^(dispatch_data_t content, ...) {
           if (content && dispatch_data_get_size(content) > 0) {
               // 转发数据到目标连接
               nw_connection_send(destination, content, NW_CONNECTION_DEFAULT_MESSAGE_CONTEXT, 
                                false, ^(nw_error_t error) {
                   if (!error) {
                       // 递归继续接收数据
                       [self relayDataFrom:source to:destination];
                   }
               });
           }
       });
   }

4. 配置WKWebView代理：使用iOS 17.0引入的ProxyConfiguration完成WKWebView代理配置。

   if (@available(iOS 17.0, *)) {
       // 创建代理端点配置
       NSString *proxyHost = @"127.0.0.1";
       NSString *proxyPortString = [NSString stringWithFormat:@"%d", _proxyPort];
       nw_endpoint_t proxyEndpoint = nw_endpoint_create_host([proxyHost UTF8String], [proxyPortString UTF8String]);
   
       // 创建HTTP CONNECT代理配置
       nw_proxy_config_t proxyConfig = nw_proxy_config_create_http_connect(proxyEndpoint, NULL);
       if (proxyConfig) {
           WKWebsiteDataStore *dataStore = [WKWebsiteDataStore defaultDataStore];
           NSArray<nw_proxy_config_t> *proxyConfigs = @[proxyConfig];
   
           // 检查API可用性并设置代理配置
           if ([dataStore respondsToSelector:@selector(setProxyConfigurations:)]) {
               [dataStore setProxyConfigurations:proxyConfigs];
               configuration.websiteDataStore = dataStore;
           }
       }
   }

5. 集成HTTPDNS：代理直接使用HTTPDNS解析结果向目标服务器建连。

   // 使用HTTPDNS解析域名并创建到目标服务器的连接
   NSString *resolvedHost = [self resolveHostname:host];
   
   NSString *portString = [NSString stringWithFormat:@"%d", port];
   nw_endpoint_t remoteEndpoint = nw_endpoint_create_host([resolvedHost UTF8String], [portString UTF8String]);
   
   // 创建连接，禁用TLS的TCP连接参数（代理本身不加密）
   nw_parameters_t params = nw_parameters_create_secure_tcp(
       NW_PARAMETERS_DISABLE_PROTOCOL,
       NW_PARAMETERS_DEFAULT_CONFIGURATION
   );
   
   // 启用地址重用，便于端口快速重绑定
   nw_parameters_set_reuse_local_address(params, true);
       
   nw_connection_t connection = nw_connection_create(remoteEndpoint, params);
   
   // 设置连接队列
   nw_connection_set_queue(connection, dispatch_get_global_queue(QOS_CLASS_UTILITY, 0));

3.4 降级及优化方案

HttpdnsLocalHttpProxy 在设计之初即充分考虑了多种异常场景，内建多层防护与自动降级（Fallback）机制，旨在提供高性能本地代理能力的同时，保障系统的高可用性与最终网络请求的可达性，即便在组件故障或外部依赖异常的情况下，也能最大程度减少对用户体验的影响。

以下是不同的异常场景及应对：

通过以上多层设计，HttpdnsLocalHttpProxy 能够在复杂多变的网络环境中实现可靠运行。其完备的降级机制确保即使部分组件失效，仍能保障请求通路不中断。