使用FTP连接Azure App Service失败,无法下载源码如何解决?
Azure App Service FTP连接失败排查与源码下载方案
一、FTP连接失败的核心漏配排查
- 核对FTP连接的基础配置准确性
- 不要照搬教程里的通用主机格式,直接从Azure门户对应App服务的「部署中心」复制专属FTP主机地址,格式为
ftps://<应用名>.ftp.azurewebsites.windows.net,错填应用本身的业务域名会直接导致连接被拒 - 认证凭据必须使用部署中心单独生成的「应用特定密码」,不能直接使用Azure账号的登录密码;如果之前做过凭据轮换,旧密码会直接失效,需要点击「重置部署凭据」生成新的可用密码
- 客户端必须强制使用FTPS加密连接,Azure目前已全面禁用明文FTP协议,客户端如果默认使用普通21端口的明文FTP连接,会被服务端直接拦截,需调整为隐式FTPS端口990完成握手
- 不要照搬教程里的通用主机格式,直接从Azure门户对应App服务的「部署中心」复制专属FTP主机地址,格式为
- 检查网络侧的访问拦截
- 确认本地网络(企业防火墙、出站安全策略)放行了到Azure FTP服务的21/990端口出站流量,部分企业网络会默认拦截非业务类的FTP端口通信
- 检查App Service自身的网络配置,如果开启了IP访问限制、私有终结点,公网发起的FTP连接会被直接拦截,要么将本地公网IP加入白名单,要么临时调整为公网可访问模式
- 修正客户端的配置错误
- 登录用户名必须严格按照门户提供的格式填写,为
<应用名>\<部署用户名>,缺失应用名前缀会直接触发认证失败 - 必须开启FTP客户端的被动连接模式,Azure的FTP服务不支持主动连接模式,手动勾选主动模式会导致连接卡在握手阶段
- 登录用户名必须严格按照门户提供的格式填写,为
二、非FTP渠道的稳定源码下载方案
如果完成上述排查后仍存在连接问题,无需死磕FTP通道,可通过以下方式直接获取线上源码:
- 通过Kudu高级站点下载:直接访问App服务对应的Kudu站点(
https://<应用名>.scm.azurewebsites.net),用Azure账号单点登录进入,打开调试控制台的CMD面板,定位到site/wwwroot的运行目录,点击目录旁的下载按钮,即可将完整源码打包为zip文件保存到本地 - 通过Azure CLI拉取部署包:本地安装Azure CLI后完成账号登录,执行命令
az webapp deploy --name <你的应用名> --resource-group <所属资源组名> --type zip --output-filename <本地保存路径>,可直接将线上当前运行的完整部署包拉取到本地,不受本地网络的FTP端口限制 - 如果你已配置过本地Git关联部署,直接在本地代码仓库执行
git pull azure <关联部署分支名>,即可将线上最新的源码版本同步到本地
内容的提问来源于stack exchange,提问作者Mallipeedi Vivekanand
相关产品推荐
相关产品推荐

