使用C#类库+VSTS部署时Azure Function代理配置及只读问题问询

AI 小北

2026-5-20

关于Azure Functions代理与C#类库、VSTS部署的问题解答

嗨，咱们来拆解你关于Azure Functions代理结合C#类库和VSTS（现在叫Azure DevOps）部署的问题：

1. 如何在C#类库+VSTS部署场景下配置Azure Functions代理？

Azure Functions代理的核心配置是proxies.json文件，不管你用什么开发模式，只要把这个文件正确打包部署到函数应用中就能生效。具体步骤如下：

在C#类库项目中添加代理配置文件：
在你的类库项目根目录创建proxies.json，按照代理规则编写配置，示例如下：
```
{
  "$schema": "http://json.schemastore.org/proxies",
  "proxies": {
    "MySampleProxy": {
      "matchCondition": {
        "route": "/api/proxy-endpoint",
        "methods": ["GET", "POST"]
      },
      "backendUri": "https://your-target-service/api/actual-endpoint"
    }
  }
}
```
右键点击这个文件，在属性里设置复制到输出目录为「始终复制」或「如果较新则复制」，确保编译后这个文件会出现在输出目录中。
配置VSTS部署流程：
确保你的Azure DevOps Pipeline构建任务能正确打包包含proxies.json的内容。比如用DotNetCoreCLI任务完成类库编译后，使用AzureFunctionApp任务进行部署——只要部署包中包含proxies.json，Azure就会自动加载这个代理配置。
可以在构建后的artifact中检查一下，确认proxies.json已经被包含在内，避免打包环节漏掉文件。

当然可以！就是上面提到的proxies.json方式。当你通过部署包把这个文件推送到Azure后，门户中的代理会显示为只读状态——这是正常行为，因为此时代理配置由部署包中的文件管理，门户会优先使用代码库中的配置，避免手动修改被后续部署覆盖。

版本控制同步管理：把proxies.json和C#类库代码放在同一个Git仓库中，一起做版本控制。这样代理配置和函数代码的变更可以同步提交、审核，避免出现配置和代码脱节的情况。
一体化构建部署：在Azure DevOps Pipeline中，构建时同时处理函数代码编译和proxies.json的打包，部署时一次性推送到同一个函数应用。这样代理和函数共享同一个应用环境，方便统一管理应用设置、连接字符串等资源。
通过代码变更修改代理：如果需要调整代理规则，直接修改仓库里的proxies.json，提交后触发自动部署，变更会同步到Azure，还能保留完整的变更历史。

通常不需要，除非你的代理有完全独立的生命周期（比如需要单独扩容、单独设置访问权限），或者需要和主函数应用隔离资源。大多数场景下，把代理和函数放在同一个应用里更高效，能减少多应用的管理成本，还能共享应用级别的配置。

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