Cloudflare Tunnel部署ASP.NET Core Blazor网站遇404问题求助

1. 核对容器端口映射与应用监听端口 #

你的Docker命令将主机8084端口映射到容器8080端口，但需确认容器内ASP.NET Core应用的实际监听端口：

• 查看镜像内的appsettings.json或launchSettings.json，确认ASPNETCORE_URLS配置，比如是否为http://+:80而非8080。若应用监听80端口，需修改Docker映射为-p 8084:80。
• 进入容器执行curl localhost:80或curl localhost:8080，验证容器内应用是否能正常响应。

2. 检查Cloudflare Tunnel的路径转发规则 #

托管型Blazor WASM包含前端静态文件和后端API路由，需确保Tunnel配置覆盖所有路径：

• 确认Tunnel服务目标指向http://192.168.86.116:8084（本地映射后的端口），而非仅转发特定路径（如/api/*）。
• 排查是否存在自定义路由规则拦截了前端静态文件请求，导致无法访问index.html等核心文件。

3. 验证ASP.NET Core的静态文件与Fallback路由配置 #

Blazor WASM前端路由依赖正确的Fallback配置，需确认项目Program.cs包含以下代码：

app.UseStaticFiles();
app.MapFallbackToFile("index.html");

缺失该配置会导致前端路由返回404，同时检查是否有自定义中间件拦截了请求转发流程。

4. 匹配Cloudflare SSL模式与ASP.NET Core配置 #

公网使用HTTPS访问时，需确保Cloudflare SSL模式与应用配置兼容：

• 若Cloudflare设置为Full或Full (strict)模式，需确保ASP.NET Core应用配置了有效HTTPS证书；或在容器内禁用HTTPS，让Cloudflare处理SSL终止。
• 可临时切换Cloudflare SSL模式为Flexible测试，若能正常访问，说明是SSL证书配置不匹配问题。

5. 检查Docker网络连通性 #

你使用了自定义网络my-custom-network，需确认Cloudflare Tunnel容器也在该网络内：

• 执行docker network inspect my-custom-network查看网络内容器列表，确保Tunnel容器与Blazor应用容器处于同一网络。
• 若Tunnel通过Docker部署，需启动时添加--network my-custom-network参数，否则无法通过内网IP或容器名访问应用。

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