如何让iPadOS端Firebase应用通过HTTP代理运行？

问题说明 #

客户iPadOS应用已配置系统级WinGate代理，Firebase常规连接正常，但所有Firestore订阅功能失效。防火墙检测到部分连接绕过HTTP代理直接使用TCP协议被拦截，而同后端的Web版应用可正常运行，需实现Firestore订阅走HTTP代理或强制使用HTTP协议。

解决方法 #

1. 配置gRPC强制走代理 #

Firestore iOS SDK基于gRPC实现，默认TLS加密的HTTP/2连接可能绕过系统代理，可通过gRPC配置指定代理并调整传输方式：

• Objective-C 代码示例：

#import <GRPCClient/GRPCClient.h>

// 替换为客户的WinGate代理地址与端口
NSString *proxyUrl = @"http://proxy-ip:proxy-port";
[[GRPCCallOptions defaultInstance] setHTTPProxy:proxyUrl];
// 强制使用兼容代理的传输类型
[[GRPCCallOptions defaultInstance] setTransportType:GRPCDefaultTransportType];

• Swift 代码示例：

import GRPCClient

let proxyUrl = "http://proxy-ip:proxy-port"
GRPCCallOptions.default.httpProxy = proxyUrl
GRPCCallOptions.default.transportType = .default

注意：需确保代理支持HTTP/2明文传输，且防火墙放行对应端口。

2. 强制Firestore使用REST API #

通过配置让Firestore使用REST API替代gRPC，REST请求会自动遵循系统代理设置：

• Objective-C 代码示例：

#import <FirebaseFirestore/FirebaseFirestore.h>

FIRFirestoreSettings *settings = [[FIRFirestoreSettings alloc] init];
settings.host = @"firestore.googleapis.com";
settings.isSSLEnabled = YES;
settings.persistenceEnabled = YES;
// 开启REST API模式
settings.useRESTAPI = YES;
[[FIRFirestore firestore] setSettings:settings];

• Swift 代码示例：

import FirebaseFirestore

let settings = FirestoreSettings()
settings.host = "firestore.googleapis.com"
settings.isSSLEnabled = true
settings.persistenceEnabled = true
settings.useRESTAPI = true
Firestore.firestore().settings = settings

提示：REST API不支持实时流式订阅，需改用轮询方式模拟实时更新。

3. 调整WinGate代理配置 #

无需修改应用代码的前提下，可配置WinGate代理支持gRPC流量：

• 开启WinGate的HTTP/2支持，将firestore.googleapis.com加入代理允许列表
• 配置WinGate转发gRPC的TLS流量（默认443端口），避免防火墙拦截直接TCP连接

差异说明 #

Web版Firestore使用WebSocket或HTTP流式传输，默认遵循浏览器代理设置；而iOS SDK的gRPC实现默认不自动适配系统代理，因此出现功能差异。

内容的提问来源于stack exchange，提问作者Jarno