无法为Azure Hybrid Connection终结点主机使用localhost，求解答

核心结论 #

• Azure确实更新了Hybrid Connection的配置规则，新创建的连接不再允许使用localhost、127.0.0.1等环回地址作为终结点主机名
• 已存在的历史Hybrid Connection不受影响，会继续正常运行

无需修改代码的替代方案 #

如果你想保持代码里统一调用固定地址的逻辑，可以通过本地主机映射实现：

1. 在运行Hybrid Connection Manager（HCM）的本地服务器上，修改hosts文件：
   • Windows：打开C:\Windows\System32\drivers\etc\hosts（需管理员权限）
   • Linux：编辑/etc/hosts
2. 添加一行自定义映射，比如：

   127.0.0.1  api-local
   

3. 创建新Hybrid Connection时，终结点主机名填api-local，端口保持原有的3000
4. 生产和测试环境的HCM各自配置相同的hosts映射，App Service代码即可统一调用http://api-local:3000，无需区分环境

代码适配方案（无需修改本地配置） #

如果不想维护hosts文件，可以通过App Service环境变量实现：

1. 在生产环境App Service的「配置」→「应用程序设置」中添加环境变量：
   • 名称：LOCAL_API_HOST，值：生产本地服务器的主机名/内网IP
2. 测试环境App Service同理，添加相同名称的环境变量，值为测试本地服务器的主机名/内网IP
3. 代码中读取环境变量拼接请求地址，比如（以Node.js为例）：

   const apiHost = process.env.LOCAL_API_HOST || 'localhost';
   const apiUrl = `http://${apiHost}:3000`;
   

补充说明 #

微软的这个限制主要是为了明确Hybrid Connection的目标资源标识，避免环回地址在多环境场景下的潜在歧义。目前没有办法绕过新规则创建使用localhost的Hybrid Connection，只能通过上述方案替代。

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