docker部署springboot項目文件上傳路徑過程
更新時間：2026年01月06日 09:59:05 作者：最強菜鳥
文章介紹了如何使用Docker部署Spring Boot項目,并設置文件上傳路徑,通過兩種方式啟動容器,一種是不掛載文件,另一種是掛載文件,掛載文件的方式可以方便地在本地服務器上查看上傳的文件
一、問題
解決通過docker部署springboot項目，文件上傳的路徑該怎么設置？
用docker部署后，在服務器上面怎么看到自己上傳的文件，文件需不需要掛載等問題，下面直接使用springboot+docker簡單搭建一個文件服務器
二、環(huán)境
以下是本人此次搭建的環(huán)境
- 部署方式：docker
- 服務器：linux服務器
- 服務器操作系統(tǒng)：CentOS 8.2
- jdk:1.8
三、創(chuàng)建springboot項目
創(chuàng)建springboot項目upload-demo，先在本地進行測試，確保本地的項目可以進行文件上傳和下載
pom
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.7.0</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.zqcn</groupId>
<artifactId>upload_demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>upload_demo</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
application.yml
upload: # 部署服務器時的服務上文件存放地址 # path: /upload-demo/upload # 本地的文件存放地址 path: D:\zqcn\data\upload-demo\upload server: port: 8082
為了方便直觀的看到效果，這里就簡單寫了兩個html頁面進行測試
upload-page.html（文件上傳頁面）
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>File Upload</title>
</head>
<body>
<form enctype="multipart/form-data" method="post" action="/file/receive">
<div>
File Choose:
<input type="file" name="file"></div>
<div>
<input type="submit" value="Submit"/>
</div>
</form>
</body>
</html>
download-page.html（文件下載頁面）
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>File Upload</title>
</head>
<body>
<form action="/file/fetch" method="post">
下載文件名：<input type="text" name="fileName" maxlength="500" style="width:400px;">
<input type="submit" value="提交">
</form>
</body>
</html>
最后編寫對應的controller即可
FileController
package com.zqcn.upload_demo.controller;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;
/**
* @ClassName : FileController
* @Description :
* @Author : CJH
* @Date: 2022-06-15 09:37
*/
@Controller
@RequestMapping("/file")
public class FileController {
@Value("${upload.path}")
private String uploadPath;
/**
* 文件上傳頁面
* @param request
* @return
*/
@RequestMapping("/upload")
public String uploadPage(HttpServletRequest request){
return "upload-page";
}
/**
* 文件下載頁面
* @param request
* @return
*/
@RequestMapping("/download")
public String downloadPage(HttpServletRequest request){
return "download-page";
}
/**
* 文件上傳接口
* @param file
* @param request
* @return
* @throws Exception
*/
@ResponseBody
@RequestMapping(value="/receive", method = RequestMethod.POST)
public Map receiveFile(@RequestParam("file") MultipartFile file, HttpServletRequest request) throws Exception{
if(file.isEmpty()){
return new HashMap<String,Object>(){{
put("code",500);
put("msg","沒有選中任何文件");
put("status",false);
put("data",null);
}};
}
File uploadFileSaveDir = new File(uploadPath);
System.out.println("上傳文件的存放目錄："+uploadFileSaveDir.getAbsolutePath());
if(!uploadFileSaveDir.exists()){
// 遞歸生成文件夾
uploadFileSaveDir.mkdirs();
}
// 拿到文件名
String filename = file.getOriginalFilename();
// 構建真實的文件路徑
File uploadFile = new File(uploadFileSaveDir.getAbsolutePath() + File.separator + filename);
System.out.println("文件上傳到：" + uploadFile.getAbsolutePath());
//文件寫到服務器，
file.transferTo(uploadFile);
return new HashMap<String,Object>(){{
put("code",200);
put("msg","文件上傳成功");
put("status",true);
put("data",null);
}};
}
/**
* 文件下載接口
* @param fileName
* @param response
* @return
* @throws Exception
*/
@ResponseBody
@RequestMapping(value = "/fetch", method = RequestMethod.POST)
public Map fileDownload(@RequestParam() String fileName, HttpServletResponse response)throws Exception{
File downloadFile = new File(uploadPath + File.separator + fileName);
System.out.println("下載文件的完整路徑："+downloadFile.getAbsolutePath());
if(!downloadFile.exists()){
System.out.println("要下載的文件不存在："+downloadFile.getAbsolutePath());
return new HashMap<String,Object>(){{
put("code",500);
put("msg","文件不存在，下載失敗");
put("status",false);
put("data",null);
}};
}else {
//第二讀取文件
InputStream in = new FileInputStream(downloadFile);
//設置響應頭，對文件進行url編碼
fileName = URLEncoder.encode(fileName, "UTF-8");
response.setHeader("Content-Disposition", "attachment;filename="+fileName);
response.setContentLength(in.available());
//第三步：讀文件寫入http響應
OutputStream out = response.getOutputStream();
byte[] b = new byte[1024];
int len = 0;
while((len = in.read(b))!=-1){
out.write(b, 0, len);
}
out.flush();
out.close();
in.close();
return new HashMap<String,Object>(){{
put("code",200);
put("msg","文件下載成功");
put("status",true);
put("data",null);
}};
}
}
}
啟動項目，先用postman測試一下上傳接口
再測試一下下載接口
接口測試沒問題，下面可以測一下那兩個頁面
都是正常的，本地項目創(chuàng)建成功
四、docker部署項目
（1）構建鏡像
關于linux服務器和docker的基礎知識這里就不贅述了，自行百度即可，下面直接進入部署流程，先把項目的文件上傳路徑改成部署環(huán)境的上傳地址
再本地進行jar打包
創(chuàng)建Dockerfile文件
FROM java VOLUME /tmp ADD upload_demo.jar upload_demo.jar EXPOSE 8082 ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/upload_demo.jar"]
- FROM java：表示安裝的java鏡像
- VOLUME /tmp：創(chuàng)建/tmp目錄并持久化到Docker數據文件夾
- ADD upload_demo.jar upload_demo.jar：將生成的jar包（第一個）復制并重命名到upload_demo.jar（第二個）
- EXPOSE 8082：對外暴露的接口，也是訪問的接口，接口的端口號需要根據springboot項目配置的端口號來設置
- ENTRYPOINT：固定寫法，用來運行jar包，相當于java -jar xxx.jar一樣
最后將jar和Dockerfile通過xftp一起上傳到服務器上面，最好找個文件夾統(tǒng)一放在一起，例如
再通過xshell進入jar和Dockerfile所在的目錄，并且輸入構建鏡像的命令
docker build -t upload-demo .
構建成功后，先隨便創(chuàng)建
（2）啟動容器
為了更清楚的理解docker部署的項目文件上傳路徑，這里分兩種方式啟動容器，一種不掛載文件，一種掛載文件，兩種方式，簡單分析一下文件的上傳路徑
（1）不掛載文件啟動容器
命令如下:
sudo docker run -d --name upload-demo01 -p 8082:8082 upload-demo
容器啟動成功后，用postman進行文件上傳測試，上傳了1.jpeg文件
上傳也是成功了，那么怎么看到上傳的圖片呢，還有就springboot項目配置的文件上傳地址體現在哪里，要想知道這些答案，就需要進入容器內部看了，命令
docker exec -it upload-demo01 /bin/bash
進入里面后查看當前目錄下的文件，就會發(fā)現upload-demo，這個就springboot配置的上傳地址
再進入upload-demo文件里面看看
就會發(fā)現里面有一個文件夾upload，再深入里面看看，就會發(fā)現里面有一張圖片1.jpeg，就是我們上傳的圖片了
總結一下容器里面的路徑地址就是：/upload-demo/upload，這個路徑就是springboot配置的文件上傳地址
至此為止，整體容器啟動后，文件上傳和下載都是正常的，唯一不足的就是，如果要看這個圖片上傳在哪里，就需要進入容器里面看，下面推薦第二種方式，啟動容器后，并且把容器里面的圖片掛載出來
（2）掛載文件啟動容器
先在服務器上創(chuàng)建一個目錄，用于存放掛載出來的圖片，本人的路徑是/home/cainiao/upload-demo/upload
下面執(zhí)行以下命令啟動容器：
sudo docker run -d --name upload-demo02 -p 8083:8082 -v /home/cainiao/upload-demo/upload:/upload-demo/upload upload-demo
注意：
- /home/cainiao/upload-demo/upload：是你要掛載到容器外面的服務器圖片路徑
- /upload-demo/upload：是容器里面圖片地址
容器啟動成功，現在用postman進行接口上傳測試，文件2.jpeg上傳成功
現在去服務器上面的/home/cainiao/upload-demo/upload里面，刷新一下，看一下發(fā)現圖片已經掛載出來了
現在試一下圖片下載
可以看到圖片，經過測試，圖片可以完成下載
三、補充
正常部署的話，建議采用第二種采用掛載文件的形式進行啟動
四、總結
以上為個人經驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關文章
深入了解docker(docker鏡像、容器、倉庫的基本概念)
本文重點給大家介紹docker鏡像、容器、倉庫的基本概念，感興趣的朋友跟著小編一起學習吧2016-10-10
使用Docker Compose創(chuàng)建LAMP環(huán)境的詳細步驟
現如今,通過 Docker 容器化部署環(huán)境已經逐漸成為主流,特別是在部署像 LAMP 這樣的復雜環(huán)境時,本教程旨在帶您完成使用 Docker-Compose 建立 LAMP 環(huán)境的整個過程,同時還包括定制 PHP 環(huán)境的步驟,需要的朋友可以參考下2024-12-12
Docker啟動MySQL報錯：/etc/mysql/conf.d目錄缺失的解決方案
這篇文章主要介紹了MySQL容器啟動失敗的原因及解決方法,MySQL在啟動時會讀取/etc/mysql/conf.d/目錄下的配置文件,若該目錄不存在或未正確掛載,會導致初始化失敗,解決方法包括通過掛載目錄、使用Dockerfile創(chuàng)建目錄或臨時繞過檢查等,需要的朋友可以參考下2026-03-03
本文主要介紹了Docker安裝RabbitMQ并安裝延時隊列插件，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2022-05-05
Docker可視化ui管理工具Portainer安裝及使用解析
這篇文章主要介紹了Docker可視化ui管理工具Portainer安裝及使用解析,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-11-11
這篇文章主要介紹了Docker如何掛載mysql問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2023-03-03
這篇文章主要為大家詳細介紹了Ubuntu Docker 安裝教程,具有一定的參考價值，感興趣的小伙伴們可以參考一下2016-11-11
這篇文章主要介紹了簡述Docker安裝Tomcat鏡像并部署web項目，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-10-10
這篇文章主要介紹了基于docker的redis集群的搭建方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-11-11
這篇文章主要介紹了5款超好用的開源 Docker工具強烈推薦，這5個工具非常實用，有需要同學可以學習下2021-03-03