Docker部署.NET Core项目静态文件无法持久化至Linux宿主机问题

问题核心 #

你当前的问题是容器内的文件存储路径和Docker卷的挂载路径不匹配：

• docker-compose.yml中把StaticFilesBackend卷挂载到了容器的/var/opt/Fiber目录
• 但你的.NET Core项目实际将上传文件存在容器的/app/StaticFiles目录（容器WORKDIR为/app，项目代码大概率用了Directory.GetCurrentDirectory() + "/StaticFiles"这类路径）
• 因此文件并未写入挂载的卷，而是存在容器本地文件系统，自然在宿主机卷目录中看不到，且容器删除后文件会丢失。

解决方案 #

方案1：修改Docker Compose挂载路径（无需改动代码） #

直接将卷挂载到项目实际的文件存储目录/app/StaticFiles，修改webfiber服务的volumes配置：

services:
  webfiber:
    # 其他配置保持不变
    volumes:
       - StaticFilesBackend:/app/StaticFiles # 改为项目实际的文件存储路径

方案2：修改.NET Core项目的文件存储路径（无需改动Docker配置） #

在项目代码中将文件保存路径改为挂载的卷路径/var/opt/Fiber：

1. 在appsettings.json中添加配置项：

{
  "FileStorage": {
    "RootPath": "/var/opt/Fiber"
  }
}

2. 在代码中读取该路径并用于文件保存：

var storagePath = Configuration.GetValue<string>("FileStorage:RootPath");
// 保存文件时使用storagePath替代原有的StaticFiles目录

方案3：使用宿主机自定义目录挂载（更直观可控） #

如果希望直接将文件存储到宿主机指定目录（比如/home/your-user/fiber-static-files），可以用绑定挂载替代命名卷：

services:
  webfiber:
    # 其他配置保持不变
    volumes:
       - /home/your-user/fiber-static-files:/app/StaticFiles # 宿主机路径:容器路径

验证步骤 #

1. 停止当前服务：docker-compose down
2. 应用上述任意一种修改方案
3. 重新启动服务：docker-compose up -d --build
4. 通过API上传文件，检查宿主机对应目录（命名卷路径为/var/snap/docker/common/var-lib-docker/volumes/fiber_StaticFilesBackend/_data，或自定义绑定挂载路径），确认文件已持久化。

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