🐳 Docker로 10분 만에 SFTP 서버 만들기 (공개키 인증)

최근에 로컬 Windows 환경에서 OpenSSH를 설치하고 설정하는 데 꽤 많은 단계를 거쳤습니다. https://blog.naver.com/devramyun/223831949592

[20250413] Windows에서 OpenSSH SFTP 서버 구축과 WinSCP 공개키 로그인 실습 이번 글에서는 Windows 11 환경에서 내장된 OpenSSH Server를 활용해 SFTP 서버를 구축하고, Wi… 이번 글에서는 Windows 11 환경에서 내장된 OpenSSH Server를 활용해 SFTP 서버를 구축하고, Wi…

하지만 이번엔 Docker로 단 10분 만에 SFTP 서버를 세팅하고 공개키 인증까지 완성했습니다.

정말로 빠르고 깔끔하게 끝나더군요.

---

• Docker 기반 Ubuntu 컨테이너에 OpenSSH 설치
• sftpuser 사용자 계정 생성 및 공개키 인증 설정
• 호스트에서 id_rsa.pub 키를 컨테이너에 넣고 인증 연결 구성
• PowerShell/CLI와 WinSCP 양쪽에서 SFTP 접속 테스트

---

📁 프로젝트 구조

docker-sftp-server/
├── Dockerfile
├── id_rsa.pub  # 클라이언트 공개키 복사본

---

---

⚙️ Dockerfile 핵심

FROM ubuntu:22.04

RUN apt-get update && \
    apt-get install -y openssh-server && \
    mkdir /var/run/sshd

RUN useradd -m -u 1000 -s /bin/bash sftpuser && \
    mkdir -p /home/sftpuser/.ssh && \
    chmod 700 /home/sftpuser/.ssh

COPY id_rsa.pub /home/sftpuser/.ssh/authorized_keys
RUN chmod 600 /home/sftpuser/.ssh/authorized_keys && \
    chown -R sftpuser:sftpuser /home/sftpuser/.ssh

RUN sed -i 's/#*PasswordAuthentication yes/PasswordAuthentication no/' /etc/ssh/sshd_config && \
    sed -i 's/#*PubkeyAuthentication.*/PubkeyAuthentication yes/' /etc/ssh/sshd_config

EXPOSE 22
CMD ["/usr/sbin/sshd", "-D"]

---

🛠️ 실행 절차

# 0. id_rsa.pub (ssh 키) 쌍이 없다면 생성
ssh-keygen -t rsa -b 2048 -f "$env:USERPROFILE\.ssh\id_rsa"

# 1. id_rsa.pub 파일을 Dockerfile 옆에 복사
cp ~/.ssh/id_rsa.pub ./id_rsa.pub

# 2. 빌드 및 실행
cd docker-sftp-server
docker build -t my-sftp-server .
docker run -d -p 2222:22 --name sftp-server my-sftp-server

여기까지 5분도 안 걸립니다.

---

🔒 접속 테스트 ** **- PowerShell or CLI

sftp -P 2222 sftpuser@localhost

**- WinSCP **

• 프로토콜: SFTP
• 호스트: localhost
• 포트: **2222** ← 이것이 핵심!
• 사용자: sftpuser
• Keyfile: C:\Users$env.USERNAME.ssh\id_rsa

처음엔 “연결이 거부되었습니다” 에러가 떴지만, 알고 보니 포트를 22로 두고 있었더군요 😅

---

---

• **외부와 격리된 docker 환경에서 docker build 한 번에 만들어지는 sftp 서버 **