本文说明在不同客户端环境中,将 HTTP 和 HTTPS 访问流量通过显式代理转发的常见配置方式,覆盖 Linux curl、Linux 环境变量、Windows 系统代理,以及 Agent(例如 OpenCode)等运行环境。
本文所述配置仅适用于应用层代理,仅读取这些配置的 HTTP/HTTPS 应用会通过显式代理防火墙转发流量。若需强制所有 TCP/UDP 流量经过代理,应采用边界防火墙方案。
前提条件
已在云防火墙控制台完成显式代理防火墙配置。若未完成,请参见显式代理防火墙。
已在显式代理 > 代理实例页面,通过单击代理实例 ID 获取并记录代理防火墙相关信息。
示例代理信息
本文以下列显式代理地址为示例,请根据实际环境替换。
参数 | 示例值 |
代理实例监听地址 |
|
代理实例监听端口 |
|
代理协议 | HTTP 代理 |
代理 URL |
|
通用占位符说明:
占位符 | 说明 |
| 代理地址,例如 |
| 代理端口,例如 |
| 代理地址中的协议前缀,表示客户端与代理建立连接的协议。当前仅支持 |
代理环境变量字段说明:
HTTP_PROXY / http_proxy:
http_proxy是环境变量名,表示代理 HTTP 目标请求;代理地址中的http://表示客户端通过 HTTP 协议连接代理。HTTPS_PROXY / https_proxy:
https_proxy是环境变量名,表示代理 HTTPS 目标请求;但代理地址中的协议当前仅支持http://(客户端通过 HTTP 协议连接代理),暂不支持https://(客户端通过 TLS 连接代理)。NO_PROXY / no_proxy:不经过代理的地址列表,多个地址用英文逗号分隔。常见值:
localhost,127.0.0.1,::1。
Linux curl 命令指定代理
客户端与代理实例的接入方式如下:
同VPC场景:客户端通过环境变量配置代理实例分配的DNS域名作为代理地址,即可直接接入。
跨VPC场景:在ECS客户端到代理实例的网络路由可达的前提下,客户端同样可使用代理实例分配的DNS域名作为代理地址接入。该域名可正常解析为代理实例的私网IP地址。
访问 HTTP 站点
curl -sS -v -m 20 -x http://fw-****.proxy.cn-hangzhou.cfw.aliyuncs.com:10001 http://www.aliyun.com通用写法:
curl -x http://<proxy_host>:<proxy_port> http://example.com访问 HTTPS 站点
curl -sS -v -m 20 -x http://fw-****.proxy.cn-hangzhou.cfw.aliyuncs.com:10001 https://example.com通用写法:
curl -x http://<proxy_host>:<proxy_port> https://example.com查看代理连接过程
curl -v -x http://<proxy_host>:<proxy_port> https://example.comHTTPS 流量成功通过代理时,通常可以看到类似输出:
CONNECT example.com:443 HTTP/1.1
HTTP/1.1 200 Connection establishedLinux 通过环境变量配置 HTTP/HTTPS 代理
临时配置当前终端代理
该方式仅对当前 Shell 会话及其启动的子进程生效。
export http_proxy="http://<proxy_host>:<proxy_port>"
export https_proxy="http://<proxy_host>:<proxy_port>"
export HTTP_PROXY="http://<proxy_host>:<proxy_port>"
export HTTPS_PROXY="http://<proxy_host>:<proxy_port>"建议同时配置不通过代理的地址:
export no_proxy="localhost,127.0.0.1,::1"
export NO_PROXY="localhost,127.0.0.1,::1"常见不通过代理地址:
地址 | 说明 |
| 本机访问 |
验证方式:
curl -v https://example.com永久配置当前用户代理
编辑Shell配置文件:
vim ~/.bashrc #Bash用户 vim ~/.zshrc #Zsh 用户追加如下内容:
export http_proxy="http://<proxy_host>:<proxy_port>" export https_proxy="http://<proxy_host>:<proxy_port>" export HTTP_PROXY="http://<proxy_host>:<proxy_port>" export HTTPS_PROXY="http://<proxy_host>:<proxy_port>" export no_proxy="localhost,127.0.0.1,::1" export NO_PROXY="localhost,127.0.0.1,::1"使配置生效:
source ~/.bashrc #Bash用户 source ~/.zshrc #Zsh 用户
永久配置所有用户代理
创建系统级代理配置文件:
sudo vim /etc/profile.d/proxy.sh写入以下内容:
export http_proxy="http://<proxy_host>:<proxy_port>" export https_proxy="http://<proxy_host>:<proxy_port>" export HTTP_PROXY="http://<proxy_host>:<proxy_port>" export HTTPS_PROXY="http://<proxy_host>:<proxy_port>" export no_proxy="localhost,127.0.0.1,::1" export NO_PROXY="localhost,127.0.0.1,::1"重新登录系统,或执行以下命令使配置立即生效:
source /etc/profile.d/proxy.sh
Agent/OpenCode 环境中配置 HTTPS 流量通过代理
Agent 场景需要重点确认 Agent 进程实际读取到的代理配置,不同类型的 Agent 可能存在差异。
命令行交互方式启动 Agent
以 OpenCode 命令行交互为例:
export HTTP_PROXY=http://fw-****.proxy.cn-hangzhou.cfw.aliyuncs.com:10001; export HTTPS_PROXY=http://fw-****.proxy.cn-hangzhou.cfw.aliyuncs.com:10001; timeout 300 opencode run --auto '查询明天的杭州天气'OpenCode 会读取系统环境变量。如果已按上文 Linux 环境变量方式完成配置,则可直接进行命令行交互,Agent 流量会自动经过显式代理:
timeout 300 opencode run --auto '查询明天的杭州天气'Windows 下配置 HTTP/HTTPS 代理
通过系统设置配置代理
以 Windows Server 2025为例,操作步骤:
打开“设置”。
进入“网络和 Internet”。
进入“代理”。
找到“手动代理设置”,单击“设置”。
开启“使用代理服务器”。
地址填写
http://<proxy_host>。端口填写
<proxy_port>。在“不对以下地址使用代理服务器”中填写例外地址,例如:
localhost;127.0.0.1;::1。保存配置。
该方式通常对浏览器、部分桌面应用和使用系统代理的应用生效。
DataWorks 下配置 HTTP/HTTPS 代理
通过 DataStudio Shell 节点配置代理
以 Serverless 资源组上运行的 Shell 节点为例,操作步骤:
进入DataWorks工作空间列表,在控制台顶部菜单栏切换所需地域。定位至目标工作空间,单击其操作列的快速进入 > Data Studio。
在已有的工作流或者新建的工作流中新建(或者打开)一个 Shell 节点。
在节点代码框中,于业务命令之前添加代理环境变量:
export http_proxy="http://<proxy_host>:10001" export no_proxy="localhost,127.0.0.1,::1" # 业务命令示例 curl -v http://example.com/ -o /dev/null curl -v https://example.com/ -o /dev/null在节点右侧运行配置 > 资源组中,资源组选择目标 Serverless 资源组。
说明该资源组绑定的 VPC 需与显式代理防火墙实例网络互通;如需访问公网,还需为该 VPC 配置 NAT 网关和 EIP。
单击节点工具栏的运行,在运行日志中确认代理生效:
HTTP 目标:请求返回
200;HTTPS 目标:日志中出现
CONNECT example.com:443 HTTP/1.1和200 Connection established。
验证通过后单击发布,将节点发布至生产环境。
该方式仅对当前 Shell 节点脚本内启动的进程生效;节点每次调度执行时随脚本自动注入,无需登录或修改托管资源组机器。