客户端接入显式代理防火墙

更新时间:
复制 MD 格式

本文说明在不同客户端环境中,将 HTTP 和 HTTPS 访问流量通过显式代理转发的常见配置方式,覆盖 Linux curl、Linux 环境变量、Windows 系统代理,以及 Agent(例如 OpenCode)等运行环境。

说明

本文所述配置仅适用于应用层代理,仅读取这些配置的 HTTP/HTTPS 应用会通过显式代理防火墙转发流量。若需强制所有 TCP/UDP 流量经过代理,应采用边界防火墙方案。

前提条件

  • 已在云防火墙控制台完成显式代理防火墙配置。若未完成,请参见显式代理防火墙。

  • 已在显式代理 > 代理实例页面,通过单击代理实例 ID 获取并记录代理防火墙相关信息。

示例代理信息

本文以下列显式代理地址为示例,请根据实际环境替换。

参数

示例值

代理实例监听地址

fw-****.proxy.cn-hangzhou.cfw.aliyuncs.com

代理实例监听端口

10001

代理协议

HTTP 代理

代理 URL

http://fw-****.proxy.cn-hangzhou.cfw.aliyuncs.com:10001

通用占位符说明:

占位符

说明

<proxy_host>

代理地址,例如 fw-****.proxy.cn-hangzhou.cfw.aliyuncs.com

<proxy_port>

代理端口,例如 10001

<proxy_protocol>

代理地址中的协议前缀,表示客户端与代理建立连接的协议。当前仅支持 http://,暂不支持 https://。

代理环境变量字段说明:

  • 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.com

HTTPS 流量成功通过代理时,通常可以看到类似输出:

CONNECT example.com:443 HTTP/1.1
HTTP/1.1 200 Connection established

Linux 通过环境变量配置 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"

常见不通过代理地址:

地址

说明

localhost、127.0.0.1、::1

本机访问

验证方式:

curl -v https://example.com

永久配置当前用户代理

  1. 编辑Shell配置文件:

    vim ~/.bashrc #Bash用户
    vim ~/.zshrc #Zsh 用户
  2. 追加如下内容:

    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"
  3. 使配置生效:

    source ~/.bashrc #Bash用户
    source ~/.zshrc  #Zsh 用户

永久配置所有用户代理

  1. 创建系统级代理配置文件:

    sudo vim /etc/profile.d/proxy.sh
  2. 写入以下内容:

    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"
  3. 重新登录系统,或执行以下命令使配置立即生效:

    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为例,操作步骤:

  1. 打开“设置”。

  2. 进入“网络和 Internet”。

  3. 进入“代理”。

  4. 找到“手动代理设置”,单击“设置”。

  5. 开启“使用代理服务器”。

  6. 地址填写 http://<proxy_host>。

  7. 端口填写 <proxy_port>。

  8. 在“不对以下地址使用代理服务器”中填写例外地址,例如:localhost;127.0.0.1;::1。

  9. 保存配置。

该方式通常对浏览器、部分桌面应用和使用系统代理的应用生效。

DataWorks 下配置 HTTP/HTTPS 代理

通过 DataStudio Shell 节点配置代理

以 Serverless 资源组上运行的 Shell 节点为例,操作步骤:

  1. 进入DataWorks工作空间列表,在控制台顶部菜单栏切换所需地域。定位至目标工作空间,单击其操作列的快速进入 > Data Studio。

  2. 在已有的工作流或者新建的工作流中新建(或者打开)一个 Shell 节点。

  3. 在节点代码框中,于业务命令之前添加代理环境变量:

    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
  4. 在节点右侧运行配置 > 资源组中,资源组选择目标 Serverless 资源组。

    说明

    该资源组绑定的 VPC 需与显式代理防火墙实例网络互通;如需访问公网,还需为该 VPC 配置 NAT 网关和 EIP。

  5. 单击节点工具栏的运行,在运行日志中确认代理生效:

    • HTTP 目标:请求返回 200;

    • HTTPS 目标:日志中出现 CONNECT example.com:443 HTTP/1.1 和 200 Connection established。

  6. 验证通过后单击发布,将节点发布至生产环境。

该方式仅对当前 Shell 节点脚本内启动的进程生效;节点每次调度执行时随脚本自动注入,无需登录或修改托管资源组机器。