12.2 网络代理与环境适配 - 人人都会AI编程

在桌面应用开发中，网络环境的复杂性往往被低估。用户可能处于企业内网（需要代理认证）、使用 VPN，或者在网络受限的地区需要配置镜像源。Tauri 应用分为前端（WebView）和后端（Rust）两部分，它们在代理处理上略有不同，但都可以通过合适的配置平稳适配各种网络环境。

开发环境：让 Cargo 和 npm 走通代理

在下载 Rust 依赖或前端包时，如果终端无法直接访问外网，需要先设置代理环境变量：

# Linux / macOS
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
# 如有不需要代理的地址
export NO_PROXY=localhost,127.0.0.1,.local

# Windows (PowerShell)
$env:HTTP_PROXY="http://proxy.example.com:8080"
$env:HTTPS_PROXY="http://proxy.example.com:8080"

许多企业代理还要求认证，可以在 URL 中嵌入用户名和密码（注意特殊字符需转义）：

http://user:pass@proxy.example.com:8080

更持久的做法是将代理写入 Cargo 配置文件（~/.cargo/config.toml）：

[http]
proxy = "http://proxy.example.com:8080"

[net]
git-fetch-with-cli = true   # 若 Git 走 SSH 被阻，可改用 HTTPS

npm 同样遵循 HTTP_PROXY 环境变量，或单独设置：

npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080

构建依赖：使用国内镜像加速

如果网络延迟高或受限制，可以将 Rust 和前端包源切换到国内镜像。例如，在 ~/.cargo/config.toml 中添加：

[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"

对于 npm，可以使用淘宝镜像或公司内部私有仓库：

npm config set registry https://registry.npmmirror.com

Tauri 本身也会在首次构建时下载一些平台相关的二进制文件（如 WebView2 安装包），这些文件通常托管在 GitHub Releases 上。如果下载失败，可以手动设置环境变量指定本地路径或镜像，具体可查阅 Tauri 官方文档的“国内镜像配置”章节。

应用运行时：让网络请求走系统代理

前端请求（WebView 内）

在 WebView 中运行的前端 JavaScript（如 fetch、axios）自动继承操作系统的代理设置。因为 WebView 使用的是系统网络栈，Windows 上会读取 IE/Edge 的代理配置，macOS 遵循系统网络偏好设置中的代理，Linux 则通常读取环境变量。这意味着用户如果在系统层面配置了 PAC 脚本或全局代理，前端的网络请求无需任何额外代码即可通过代理发出。

后端请求（Rust 代码）

当你在 Rust 中使用 reqwest 或 Tauri 提供的 HTTP 插件发起网络请求时，默认不会自动使用系统代理。你需要手动为 HTTP 客户端配置代理。以 reqwest 为例：

use reqwest::Client;

let client = Client::builder()
    .proxy(reqwest::Proxy::all("http://proxy.example.com:8080")?)
    .build()?;

更智能的做法是，让应用自动检测系统代理。可以使用 reqwest 的 socks 或 system-configuration 特性，或者在 Windows 上读取注册表，在 macOS 上调用系统 API。社区有一些现成的库可以提取系统代理，比如 proxy-agent 或者通过 Tauri 插件获取。

一个实用的模式是：在应用设置界面中允许用户手动配置代理地址和认证信息，然后将其保存到本地配置文件，Rust 后端读取后应用到全局 HTTP 客户端。这样即使用户不在系统代理环境中，也能强制通过指定代理通信。

企业环境：处理 PAC 文件和认证

部分企业使用 PAC（Proxy Auto-Config）脚本动态决定代理。前端在 WebView 中能自动解析 PAC，但 Rust 后端通常难以直接执行 JavaScript PAC 文件。解决办法有两个：

在后端直接请求时，让用户将 PAC 脚本转为固定代理地址；
在 Rust 中使用 curl 的 --proxy-pac-url 类似机制（reqwest 暂不原生支持，需借助 curl 命令行或 C 库绑定）；
更简单的方案：所有需要走代理的请求尽量通过前端发起，利用 WebView 的系统代理能力，然后通过 Tauri 命令将结果回传给 Rust。但这不适用于 Rust 自主发起的后台同步。

对于需要 NTLM 或 Kerberos 认证的代理，WebView 通常能通过系统凭据自动处理，而 Rust HTTP 客户端则需要额外配置并依赖如 reqwest-ntlm 等库。

环境适配：自定义证书与特殊拦截

某些网络环境会实施 SSL 深度检测，要求安装自定义根证书。WebView 同样会使用系统证书存储，因此只要用户将企业 CA 证书正确安装到操作系统中，前端 HTTPS 请求即可正常工作。Rust 后端若使用 rustls 且开启了 native-certs 功能，也会自动加载系统根证书；如果使用 openssl，则需确保系统 OpenSSL 证书目录正确。

若遇到证书验证问题，可以在开发阶段临时禁用验证（仅限开发，切勿用于生产）：

let client = Client::builder()
    .danger_accept_invalid_certs(true)
    .build()?;

总结一句话：前端请求天然适配系统代理，后端请求需要你主动配置。做好开发环境代理设置和运行时代理策略，Tauri 应用就能在任何网络环境下流畅运行。