CDN与Umbraco Commerce搭配：.NET电商站点怎样加速？

Umbraco Commerce是基于Umbraco的.NET电商扩展，它继承了Umbraco灵活的内容管理能力，但在高并发、远距离访问时，图片、CSS和JavaScript等静态资源会成为加载时间的主要贡献者。CDN把这些文件缓存到距离用户最近的节点，可以显著缩短页面响应时间。本文结合Umbraco Commerce的实际项目，讨论如何正确接入CDN，并保证动态交易流程不受影响。

静态资源为什么拖慢Umbraco Commerce

Umbraco Commerce默认会把商品图片、样式文件、脚本直接放在源站域名下。浏览器下载这些资源时，每次都会发起新的HTTP请求，并且要和源站建立TCP连接。如果源站部署在单一地区，跨地域用户收到这些文件的时延会非常高。一个典型场景是，服务器位于美国的Umbraco电商站，亚洲用户打开首页时，可能要用2秒加载几十个静态文件。

动态生成的购物车页面和商品详情页不能缓存，因为它们需要实时计算库存、价格和用户上下文。而产品图片、CSS、JavaScript、字体以及ECMAScript模块都属于可缓存内容。CDN缓存这些文件的效率非常高，在边缘节点上直接从内存或SSD返回内容，源站压力也随之下降。通过区分动态内容和静态文件，可以做到不影响业务逻辑的情况下提速。

从成本角度看，CDN还可以减少源站带宽消耗。Umbraco Commerce运行在云服务器或独立主机上，带宽费用是刚性成本。静态文件命中CDN边缘节点后，源站只需要处理回源请求，网络流量大幅下降。尤其是在大型促销活动期间，比如黑色星期五，CDN能承受突发流量，避免源站过载。

Umbraco Commerce中静态资源的输出与优化

Umbraco Commerce的媒体库默认以/media/目录对外提供文件。所有上传的图片、PDF等都会存储在这个物理路径下。我们可以利用IIS URL重写模块，将/media/开头的请求重写到CDN域名，而不是源站。但要注意，重写需要配合CDN服务商的回源配置，确保CDN节点没有缓存时能回到源站拉取文件。

下面是一段IIS web.config中的URL重写规则，它将/media/下的请求全部重写为https://cdn.ippipp.com/media/前缀。这个规则适合部署在Umbraco Commerce源站前的网关层，或者直接放在Umbraco站点根目录。代码示例：

<rewrite>
    <rules>
        <rule name="MediaToCDN" stopProcessing="true">
            <match url="^media/(.*)" />
            <action type="Rewrite" url="https://cdn.ippipp.com/media/{R:1}" appendQueryString="true" />
        </rule>
    </rules>
</rewrite>

注意：这里用了Rewrite而不是Redirect，这样浏览器地址栏仍然显示原站点域名，但实际上内容从CDN加载。如果使用Redirect，响应码302会导致浏览器重新请求CDN地址，性能反而不好。

除了IIS重写，Umbraco本身支持通过IUrlProvider接口控制媒体URL生成。我们可以写一个自定义提供程序，让Url.GetCropUrl等方法直接输出CDN地址。这比URL重写更灵活，因为它不需要服务器层面的拦截。但代价是需要修改代码，并确保所有业务逻辑都使用这个生成器。下面是一个精简示例：

using Umbraco.Cms.Core.Routing;

public class CdnMediaUrlProvider : IUrlProvider
{
    private readonly string _cdnDomain = "https://cdn.ippipp.com";

    public IEnumerable<UrlInfo> GetMediaUrl(UrlProviderRequest request)
    {
        var path = request.Url;
        if (path.StartsWith("/media/"))
        {
            return new UrlInfo(_cdnDomain + path, true);
        }
        return new UrlInfo(path, false);
    }
}

这里需要注册到依赖注入容器，同时保证没有遗漏其他生成媒体路径的逻辑。

配置CDN回源与缓存策略

CDN服务商的控制台通常要求配置源站地址。对于Umbraco Commerce，源站可以是你的网站域名，也可以是你源站的IP。但注意不要让重写规则和CDN回源发生循环。假设你配置CDN的源站为https://www.myshop.com，而源站又有规则把/media/重写到CDN域名，那么当CDN未命中缓存去源站拉取时，源站又把请求重写到CDN，就会造成循环。因此，重写规则必须排除来自CDN网关的回源请求，或者直接在CDN端将媒体路径单独作为一条回源规则处理。

更稳妥的做法是：在Umbraco站点中不配置重写，而是让页面模板直接使用CDN域名输出媒体URL。自定义IUrlProvider可以实现这一点，同时CDN服务商的回源地址仍然指向源站点域名。源站点正常处理来自CDN的请求，不会再次重写。因为生成的URL本身就是https://cdn.ippipp.com/media/...，源站收到的是对CDN域名的请求，但实际上CDN回源用的源站地址是https://www.myshop.com，所以一切正常。

缓存策略方面，Umbraco Commerce的媒体文件默认没有设置强缓存头。我们需要在CDN控制台上设置缓存过期时间，比如图片缓存1周，CSS和JavaScript缓存30天。也可以在源站响应的Cache-Control头中配置。使用Umbraco中间件可以统一添加头，例如：

app.Use(async (context, next) =>
{
    if (context.Request.Path.StartsWithSegments("/media"))
    {
        context.Response.Headers["Cache-Control"] = "public, max-age=604800";
    }
    await next();
});

该中间件放置在UseUmbraco之前，确保媒体文件响应头正确。动态页面不应带这个响应头，否则可能被误缓存。

保护动态交易内容并避免缓存污染

电商站点的购物车、结算页、用户个人信息等页面是不能被CDN缓存的。这些页面包含用户私有数据，缓存会引发隐私泄露和库存状态不一致。CDN通常支持根据Set-Cookie头或者响应头忽略缓存。我们必须在动态页面的响应中设置Cache-Control: private, no-store，确保CDN不会缓存这些内容。

Umbraco Commerce中有一些页面是通过路由动态生成的，比如/cart/、/checkout/。在自定义中间件中，我们可以专门处理这些路径，强制跳过缓存。同时，商品详情页虽然可以缓存一部分，但如果显示库存数量，就需要设置短缓存或者不缓存。通常商品页的HTML不推荐CDN缓存，因为价格和库存可能随时变化。我们只会缓存图片和静态资源。

对于商品图片的更新，需要注意缓存失效。当旧版本图片在CDN上未过期时，如果后台替换了图片，用户仍然看到旧图。解决方法是让Umbraco媒体URL包含版本号或者使用带哈希的文件名。Umbraco的GetCropUrl方法可以通过cache参数指定版本序号，修改媒体项时版本变化，URL也会改变。在CDN服务商控制台也可以手动清理缓存或使用API自动刷新，电商场景下应当设定一套发布流程，并配合CDN的URL批量刷新接口。

性能测试与监控

接入CDN之后，我们需要验证资源确实从边缘节点返回。最简单的方法是打开浏览器开发者工具，查看网络面板中媒体文件的响应头，确认X-Cache字段（不同服务商字段不同）显示HIT。还可以使用在线工具模拟不同区域的访问，观察静态资源加载时间的变化。

监控方面，关注CDN的缓存命中率和回源流量。如果命中率低于80%，说明很多资源没有被缓存，需要检查配置是否正确。同时，源站服务器日志中来自CDN节点IP的请求数量大幅下降，说明大部分请求已在边缘节点命中。Umbraco Commerce的日志也可以记录HTTP响应时间，便于对比优化前后的性能差距。

最后，HTTPS证书要覆盖CDN域名和服务域名。使用CDN服务商提供的证书管理功能，开启HTTP/2和TLS 1.3，进一步减少握手延迟。Umbraco Commerce本身支持HTTPS，配合CDN的全链路加密，既安全又可靠。经过以上改造，你的.NET电商站点就能在全球范围内获得接近本地的加载速度。

CDNUmbraco Commerce.NET电商修改时间：2026-08-28 01:20:15