.NET桌面应用实现附加文件按需下载的最佳实践咨询

不建议使用FTP作为文件分发渠道，这是已经被行业淘汰的方案，实际落地会遇到非常多网络兼容、安全、稳定性问题，目前同类场景的通用落地方案是HTTPS静态资源托管+版本化清单机制，维护成本、兼容性、安全性都远优于FTP。

服务端实现要点 #

• 不需要单独搭复杂的文件服务，直接在你现有官网/后端服务上开一个HTTPS静态资源目录即可，确保服务支持HTTP Range请求（大部分Web服务器默认就支持），可以天然实现断点续传，且443端口几乎不会被家用、企业防火墙拦截，不会出现FTP那种内网连不上的问题。
• 所有扩展文件提前打包为zip/7z压缩包减少传输体积，每个压缩包生成对应的SHA256哈希值，用于后续客户端侧的完整性校验。
• 在资源目录根路径放置一个固定地址的扩展清单文件extensions.json，作为客户端拉取扩展信息的唯一入口，文件示例如下：

{
  "manifestVer": 1,
  "extensions": [
    {
      "extId": "report-export",
      "extName": "批量报表导出扩展",
      "latestVer": "1.2.3",
      "supportMinAppVer": "2.1.0",
      "fileSizeBytes": 1468006,
      "fileSha256": "8A9F2D7E4B...（替换为文件实际哈希值）",
      "downloadPath": "/packages/report-export-1.2.3.zip",
      "description": "支持PDF、Excel、CSV格式的批量报表导出能力"
    }
  ]
}

• 清单文件必须配置Cache-Control: no-cache响应头，避免客户端缓存旧版本清单，导致拉取到过时的扩展文件。

.NET客户端实现要点 #

• 下载逻辑直接用.NET内置的HttpClient实现即可，不需要引入第三方FTP类库，请求时带上HttpCompletionOption.ResponseHeadersRead参数，可以很方便地实现下载进度回调、断点续传能力，大文件下载时内存占用稳定。
• 不要把下载的扩展文件存到应用安装目录（比如Program Files路径），统一存到Environment.SpecialFolder.ApplicationData下的应用专属数据目录，避免普通用户权限不足导致写入失败。
• 文件下载完成后，第一时间计算本地文件的SHA256值，和清单中记录的哈希值做比对，校验不通过直接删除损坏文件并提示用户重试，从根源上避免传输损坏、文件被篡改的问题，安全性远高于明文传输的FTP。
• 客户端拉取到最新清单后，自动和本地已安装的扩展做版本比对：未安装的扩展展示下载入口，已安装但版本低于清单版本的提示更新，不需要用户手动查找对应文件。
• 如果扩展是官方签名发布的，可以在加载扩展前增加数字签名校验逻辑，避免第三方恶意替换本地扩展文件。

为什么不推荐FTP方案 #

我在多个桌面端项目里踩过FTP分发的坑，核心问题有几个：

• 网络兼容性极差：大部分企业内网、公共网络会拦截FTP默认21端口及被动模式的随机端口，大量用户会出现连不上服务器、下载中途断连的问题，排查成本极高。
• 安全性不足：FTP默认明文传输账号、文件内容，容易被中间人劫持篡改，没有内置的完整性校验能力，文件传输出错很难感知。
• 维护成本高：FTP的用户权限、被动模式端口配置非常繁琐，出现问题没有直观的日志可以排查，远不如HTTP服务的运维体系成熟。

可选进阶优化 #

• 如果用户分布范围广，可以给静态资源配置就近访问节点，大幅提升不同地区用户的下载速度。
• 增加下载队列、暂停/继续、限速能力，避免扩展下载占满用户带宽影响正常使用。
• 扩展安装完成后自动删除临时压缩包，减少不必要的磁盘占用。

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