HTTPDNS：iOS端WebView情境使用HTTPDNS

1. 前言

通過iOS端Native情境使用HTTPDNS這篇文檔，我們已經知道如何在iOS平台上的Native情境中如何使用HTTPDNS，實現防劫持、調度精準、解析及時生效的能力。

而iOS上還有一個頻繁發生網路請求的情境：WkWebView。WKWebView是WebKit架構提供的一個現代Web視圖，用於在iOS應用中顯示網頁內容。它替代了舊的UIWebView，提供了更好的效能、更多的功能和更高的安全性。我們期望，在WkWebView載入網頁的時候，也能使用HTTPDNS，提升網路安全性與網路效能。

2. 技術現狀

隨著iOS系統的不斷髮展，WKWebView整合HTTPDNS的技術方案也在持續演化：

• iOS 17.0之前：Apple官方並未在WkWebView上開放DNS解析相關的hook介面，也並未直接開放自訂網路請求實現的介面，需要通過hook 私人API攔截流量的複雜方案實現。

• iOS 17.0及以後：Apple引入了ProxyConfiguration相關API，為WKWebView提供了官方的代理配置能力，可以通過“接近完美”的方式攔截所有網路請求，使得優雅整合HTTPDNS成為可能。

根據Apple官方統計資料（截至2025年6月4日），在系統版本分布上，iOS 17+已經佔全部iPhone裝置的85%以上，且在持續增長中。因此，考慮到HTTPDNS為WkWebView情境帶來的是防劫持、調度精準、解析及時生效等非功能性提升，建議直接通過本方案接入HTTPDNS，覆蓋大部分客戶，且舊版本系統使用者，也會在後續的陸續版本升級中，逐漸享受這個能力。

3. 推薦方案：iOS 17+基於本地代理的方案

source 'https://github.com/aliyun/aliyun-specs.git'

target 'yourAppTarget' do
    use_framework!
    
    pod 'AlicloudHTTPDNS', 'x.x.x'
    pod 'EMASLocalProxy', 'x.x.x'
end

#import <EMASLocalProxy/EMASLocalProxy.h>
#import <AlicloudHttpDNS/AlicloudHttpDNS.h>

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

// 配置DNS解析器
[EMASLocalHttpProxy setDNSResolverBlock:^NSArray<NSString *> *(NSString *hostname) {
    // 擷取HTTPDNS服務執行個體
    HttpDnsService *httpdns = [HttpDnsService sharedInstance];
    HttpdnsResult *result = [httpdns resolveHostSyncNonBlocking:hostname byIpType:HttpdnsQueryIPTypeBoth];

    if (result && (result.hasIpv4Address || result.hasIpv6Address)) {
        NSMutableArray<NSString *> *allIPs = [NSMutableArray array];
        if (result.hasIpv4Address) {
            [allIPs addObjectsFromArray:result.ips];
        }
        if (result.hasIpv6Address) {
            [allIPs addObjectsFromArray:result.ipv6s];
        }
        NSLog(@"HTTPDNS解析成功，網域名稱: %@, IP: %@", hostname, allIPs);
        return allIPs;
    }

    NSLog(@"HTTPDNS解析失敗，網域名稱: %@", hostname);
    return nil;
}];

// 設定記錄層級
[EMASLocalHttpProxy setLogLevel:EMASLocalHttpProxyLogLevelDebug];

// 配置WebView代理
BOOL proxyConfigured = [EMASLocalHttpProxy installIntoWkWebViewConfiguration:config];
if (proxyConfigured) {
    NSLog(@"WebView代理配置成功");
} else {
    NSLog(@"WebView代理配置失敗，使用系統網路");
}

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

4. 全域攔截NSURLProtocol的方案

本方案是最早在iOS WebView上適配HTTPDNS的可行方案，它接入門檻實際上很高，效果也不好，只不過早年iOS並未提供其他選擇，因此流傳下來。它的原理是，基於NSURLProtocol可攔截iOS系統上基於上層網路程式庫NSURLConnection/NSURLSession發出的網路請求，WkWebView發出的請求同樣包含在內，攔截請求後，再使用HTTPDNS做網域名稱解析和後續處理。步驟如下：

1. 通過以下介面註冊自訂NSURLProtocol，用於攔截WkWebView上層網路請求，並建立新的網路請求接管資料發送、接收、重新導向等處理邏輯，將結果反饋給原始請求。

   [NSURLProtocol registerClass:[HttpDnsNSURLProtocolImpl class]];

2. 自訂NSURLProtocol處理過程概述：

   • 在canInitWithRequest中過濾需要做HTTPDNS網域名稱解析的請求。

   • 請求攔截後，做HTTPDNS網域名稱解析。

   • 解析完成後，同普通請求一樣，替換URL.host欄位，替換HTTP Header Host域，並接管該請求的資料發送、接收、重新導向等處理。

   • 通過NSURLProtocol的介面，將請求處理結果反饋到WebView原始請求。

3. 自訂NSURLProtocol的實現邏輯可參考我們提供的demo中的 HttpDnsNSURLProtocolImpl.m。

5. 方案總結與對比

本文檔介紹了在iOS端WKWebView情境下整合HTTPDNS的兩種主要技術方案：基於iOS 17+的本地代理方案和全域攔截NSURLProtocol的方案。

每種方案都有其特定的適用情境、優缺點和實現複雜度。為協助您快速決策，下表對這兩種方案進行了橫向對比：

綜合考慮穩定性、開發維護成本和未來趨勢，我們強烈推薦使用基於iOS 17+的本地代理方案。

隨著iOS 17+系統版本的高速普及，該方案能以最低的成本為絕大多數使用者帶來穩定、可靠的HTTPDNS服務，有效解決網域名稱劫持問題，並提升網路效能。其優雅的實現方式和官方支援，確保了方案的長期可行性。對於低於iOS 17的系統版本，採取平滑降級策略，即直接使用系統預設的網路請求，待使用者升級系統後自動享受HTTPDNS帶來的優勢。

其他方案由於其固有的複雜性和不確定性，僅建議在有特殊需求且具備深厚技術儲備的團隊，經過充分評估和測試後謹慎採用。