fnOS环境下Docker Compose部署Web项目静态资源加载失败求助

1. 检查静态文件中间件配置 #

确认项目Program.cs中已正确添加静态文件中间件，且顺序在路由中间件之前：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews(); // 或对应模板的服务注册逻辑
var app = builder.Build();

// 必须在路由、端点映射之前调用
app.UseStaticFiles();

app.UseRouting();
app.MapControllers(); // 或app.MapRazorPages()等端点配置
app.Run();

本地运行正常说明代码逻辑无问题，但需确保发布的程序集包含正确的中间件配置。

2. 修正Docker Compose的Volume挂载冲突 #

当前配置中同时挂载/app和/app/wwwroot会引发挂载覆盖问题，直接移除重复的wwwroot挂载，保留完整的/app挂载即可：

version: '3.4'

services:
  ywh:
    image: mcr.microsoft.com/dotnet/samples:aspnetapp
    ports:
      - "8091:80"
    volumes:
      - /vol1/1000/docker/publish:/app
    environment:
      ASPNETCORE_URLS: http://+:80
    entrypoint: ["dotnet", "/app/YWH.dll"]

重复挂载会强制替换容器内/app/wwwroot目录，可能触发NAS文件权限或路径映射异常，移除后直接使用宿主机发布的完整/app目录即可。

3. 排查NAS目录权限问题 #

fnOS的文件系统权限控制可能导致容器无法读取静态文件：

• 进入容器检查文件权限：

  docker exec -it <你的容器ID> ls -l /app/wwwroot
  

• 如果显示权限不足，修改宿主机目录权限：

  chmod -R 755 /vol1/1000/docker/publish
  

确保容器运行用户（通常为root或app）对挂载目录有读取权限。

4. 验证容器内静态文件路径 #

进入容器确认静态文件实际路径与请求路径匹配：

docker exec -it <你的容器ID> find /app -name "site.js"

如果文件存在但路径与请求的/js/site.js不对应，需检查项目静态文件路由配置或发布后的文件结构是否与本地一致。

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