Docker + Spring Boot + Nginx로 나만의 이미지 파일 서버 만들기

🖼️ 서론: 왜 개인 파일 서버인가?

프로젝트를 개발하다 보면 이미지를 업로드하고, URL로 접근해서 보여줘야 할 일이 많습니다.
AWS S3 같은 클라우드 스토리지도 좋지만, 간단한 내부 서비스나 테스트용으로는 직접 구축한 파일 서버가 더 간편하고 비용도 들지 않죠.

그래서 이번에는 Spring Boot + Docker + Nginx 조합으로 개인 이미지 파일 서버를 구축해보겠습니다.

 

 

전체구조

 

[Client]
   |
[Spring Boot]  ← 파일 업로드 + 디렉토리 자동 생성
   |
[Docker Volume] (공유)
   |
[Nginx]       → 정적 파일 서버 (이미지 서빙)

 

---

⚙️ 1. Spring Boot: 이미지 업로드 + 디렉토리 생성

Spring Boot는 클라이언트로부터 이미지를 받아,
사용자 ID별 디렉토리에 저장합니다.
디렉토리가 없다면 자동으로 생성합니다.

 

 

📁 FileUploadController.java

 

@RestController
@RequestMapping("/api/files")
public class FileUploadController {

    private final FileUploadService fileUploadService;

    public FileUploadController(FileUploadService fileUploadService) {
        this.fileUploadService = fileUploadService;
    }

    @PostMapping("/upload/{userId}")
    public ResponseEntity<String> uploadFile(
            @PathVariable String userId,
            @RequestParam("file") MultipartFile file) {
        try {
            String savedPath = fileUploadService.saveFile(userId, file);
            return ResponseEntity.ok("File saved at: " + savedPath);
        } catch (IOException e) {
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                                 .body("File upload failed");
        }
    }
}

 

---

📁 FileUploadService.java

 

@Service
public class FileUploadService {

    private final String uploadRoot = "/app/uploads/users";

    public String saveFile(String userId, MultipartFile file) throws IOException {
        Path userDir = Paths.get(uploadRoot, userId);
        if (Files.notExists(userDir)) {
            Files.createDirectories(userDir);
        }
        String originalFilename = file.getOriginalFilename();
        Path targetPath = userDir.resolve(originalFilename);
        file.transferTo(targetPath.toFile());
        return targetPath.toString();
    }
}

 

📄 application.yml

 

spring:
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 10MB

 

---

🐳 2. Docker + docker-compose 구성

Spring Boot 컨테이너와 Nginx 컨테이너가 **같은 볼륨(/uploads)**을 공유하도록 설정합니다.

 

version: '3'
services:
  app:
    build: .
    volumes:
      - ./uploads:/app/uploads
    ports:
      - "8080:8080"

  nginx:
    image: nginx
    volumes:
      - ./uploads:/usr/share/nginx/html:ro
    ports:
      - "80:80"

🌍 3. Nginx: 정적 이미지 파일 제공

Nginx는 uploads 디렉토리를 마운트해서
http://localhost/users/1234/profile.jpg처럼 정적 파일을 직접 서빙합니다.

 

---

🧪 4. 테스트하기

✅ 파일 업로드

curl -F "file=@profile.jpg" http://localhost:8080/api/files/upload/1234

✅ 이미지 접근

http://localhost/users/1234/profile.jpg

 

 

✅ 마무리

이 방식은 다음과 같은 장점이 있습니다:

• 간단하고 로컬 테스트에 유리
• 비용이 들지 않음
• Nginx가 파일을 빠르게 서빙

하지만 다음과 같은 점도 유의해야 합니다:

• 대용량 파일 백업 및 내구성은 S3에 비해 떨어짐
• 보안, 인증 로직은 직접 구현해야 함

---