CDN回源配置不在C#代码里做
CDN回源是边缘节点和源站之间的网络行为,和你的C#应用是否用
HttpClient、
IFormFile或
FileStream上传完全无关。你写的C#程序只是源站的一部分——它只负责响应HTTP请求(比如
GET /files/photo.jpg),而CDN是否回源、回源地址填什么、回源超时设多久,全由CDN控制台或API配置决定。
常见误解是以为要“在C#里写个回源逻辑”,其实不是:C#只需保证源站能被CDN服务器正常访问(比如开放公网IP、不拦
User-Agent: CDN-Provider、不校验Referer)、返回标准HTTP状态码(
200带文件内容,
404表示真没了),剩下的交给CDN调度。
源站必须正确响应HEAD和GET请求
CDN在缓存未命中时,会先发
HEAD探活,再发
GET拉取。如果你的C# Web API(比如ASP.NET Core)只支持
GET、没开
HEAD,或者
HEAD返回
405,CDN可能直接放弃回源,返回
503或兜底页。 ASP.NET Core默认支持
HEAD(只要路由匹配且没禁用),但自定义
Controller里如果写了
[HttpGet]却没加
[HttpHead],就会丢掉
HEAD检查方式:用
curl -I https://your-origin.com/files/test.pdf,看是否返回
200且含
Content-Length和
Content-Type静态文件中间件(
UseStaticFiles())天然支持
HEAD;用
PhysicalFile()或
FileStreamResult也OK,但别手动
Response.Body.WriteAsync后忘了设
Content-Length
CDN回源路径和源站路由要对齐
比如你在CDN配置了回源地址为
https://origin.example.com,而用户请求的是
https://www.herecours.com/d/file/efpub/2026/21-21/20260221140625179579.jpg,CDN默认会把完整路径
/uploads/2024/photo.jpg透传过去。这时候你的C#源站必须能处理这个路径——不能只监听
/api/file/{id}还指望CDN自动改路径。
常见错误:源站用[Route("api/upload/{id}")],但CDN回源路径是/uploads/xxx.jpg→ 404 解决方案之一:CDN后台开启“回源重写”,把
/uploads/替换成
/api/download/;方案之二:源站暴露真实文件路径,比如用
MapFallbackToFile("/uploads/{*path}", "wwwroot/uploads/{**path}")
注意路径大小写:Windows IIS默认不区分大小写,但Linux上Kestrel+NGINX严格区分,CDN传来的/Photo.JPG若源站只存了
photo.jpg,就404
源站响应头影响CDN缓存和回源行为
CDN是否缓存、缓存多久、下次是否回源,高度依赖你C#接口返回的HTTP头。光内容对了不够,头错了照样出问题。
Cache-Control: public, max-age=3600→ CDN可缓存1小时;
private或
no-store会强制每次回源 缺失
ETag或
Last-Modified:CDN无法用条件请求(
If-None-Match)验证缓存,可能多一次全量回源
Vary: Origin或
Vary: User-Agent会让CDN为每个值建独立缓存副本,容易击穿;一般静态文件只需
Vary: Accept-EncodingASP.NET Core中用
context.Response.GetTypedHeaders().CacheControl = new CacheControlHeaderValue { Public = true, MaxAge = TimeSpan.FromHours(1) };
回源本身不难,难的是源站像一个守规矩的门卫:路径得对、方法得全、头得准、权限得开。CDN不会帮你修bug,它只按规则办事——规则错了,它就老实回源;规则对了,它才敢大胆缓存。
