使用express-msteams-host的@BotDeclaration时如何配置网络代理

express-msteams-host 本身未提供独立的代理配置入口，其内部对https://login.botframework.com的鉴权请求由底层依赖的Bot Framework SDK通过Node.js原生网络模块发起，可通过以下两种方式配置代理，适配企业内网的流量路由规则：

方案一：配置全局环境变量（推荐，无代码侵入） #

在Node服务启动前配置代理相关环境变量，所有Node.js进程的出站HTTP/HTTPS请求会自动走指定代理，无需修改业务代码：

• 配置环境变量（Linux/macOS环境可直接在启动脚本中写入，Windows环境在系统环境变量面板配置）

# 替换为企业实际的代理服务地址
export HTTP_PROXY=http://<代理服务IP>:<代理端口>
export HTTPS_PROXY=http://<代理服务IP>:<代理端口>
# 配置无需走代理的内网地址，多个值用逗号分隔
export NO_PROXY=localhost,127.0.0.1,.corp.internal,10.0.0.0/8

• 如果代理服务需要身份认证，代理地址格式调整为http://<用户名>:<密码>@<代理服务IP>:<代理端口>即可
• 配置完成后重启Node服务即可生效

方案二：代码层面全局注入代理（适合无环境变量配置权限的场景） #

如果无法修改服务运行的环境变量，可在项目入口文件最顶部（即引入express-msteams-host之前）注入全局代理拦截逻辑：

1. 安装全局代理依赖

npm install global-agent --save

2. 在入口文件最开头添加初始化代码

const { bootstrap } = require('global-agent');
// 替换为企业实际的代理服务地址
process.env.GLOBAL_AGENT_HTTP_PROXY = 'http://<代理服务IP>:<代理端口>';
process.env.GLOBAL_AGENT_NO_PROXY = 'localhost,127.0.0.1,.corp.internal';
bootstrap();

// 后续再编写引入express、注册Bot、启动服务的业务代码

该方案会拦截所有基于Node.js原生http/https模块发起的请求，覆盖express-msteams-host内部的鉴权接口调用逻辑，不需要修改第三方包源码。

注意事项 #

• 不要在@BotDeclaration装饰器参数中寻找代理配置项，该装饰器仅负责注册Bot路由、存储Bot元信息，本身不处理网络请求逻辑
• 配置完成后可先在服务器上通过curl等工具验证代理到https://login.botframework.com的连通性，确认企业白名单规则、代理转发规则正常后再启动服务

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