본문으로 건너뛰기

SFTP 서비스

SFTP(SSH File Transfer Protocol)는 SSH 프로토콜을 사용하여 데이터를 안전하게 전송하는 방법입니다. 주로 파일 전송에 사용되며, 클라이언트 서비스를 이용해 PC에서 파일을 다루는 것과 같은 방식으로 데이터를 이용할 수 있습니다.

특징​

  • 대용량 파일을 안전하게 전송하거나, 정기적으로 백업 파일을 클라이언트에게 제공해야 하는 경우에 유용합니다.
  • 많은 양의 데이터를 한 번에 배치로 전송하는 데 사용되며, 대용량 데이터 파일을 다루는 데 적합합니다.

활용 사례​

  • 백업 데이터 만들기: SFTP 서비스를 사용하면 대용량 데이터 파일을 효율적으로 관리할 수 있습니다. 데이터를 일괄적으로 다운로드하여 백업 저장소에 보관하거나 자체 분석 서비스에 활용할 수 있습니다.

  • 빅데이터 분석, 데이터 실험하기: SFTP로 데이터를 다운로드한 후, 데이터를 자체 시스템이나 데이터 웨어하우스에 로딩하여 원하는 방식으로 관리하고 분석할 수 있습니다.

SFTP 서비스 이용 방법​

  • SFTP 서비스의 경우 접속 계정 발급 절차를 필요로 합니다. 문의 채널을 통해 서비스 이용을 신청하시면 SFTP에 접속 가능한 클라이언트 계정을 발급드립니다.
  • 업무 담당자와 협의를 통해 네트워크 방화벽 설정 등 추가적인 보안 조치를 설정할 수 있습니다.
  • SFTP는 클라이언트 프로그램, CLI, 또는 프로그래밍 방식 등 다양한 방법으로 사용할 수 있습니다.
  • 아래에서는 가장 일반적인 방식인 SFTP 클라이언트 프로그램을 통한 사용 방법을 소개합니다.

SFTP 클라이언트​

클라이언트 설치​

대표적인 SFTP 클라이언트 프로그램은 다음과 같습니다.

  • OpenSSH
  • FileZilla
  • PuTTY

이들 중 하나를 설치하여 사용할 수 있습니다.


인증 정보 입력​

SFTP 서버에 접속하기 위해서는 인증 정보가 필요하며,
해당 정보는 서비스 이용 신청 후 발급됩니다.

인증 정보 구성 예시는 다음과 같습니다.

  • 호스트: sftp://...
  • 포트: 22
  • 사용자명: (발급된 사용자명)
  • 인증 수단: SSH 키 또는 비밀번호 (아래 참고)

인증 방식​

계정마다 아래 두 가지 중 하나로 로그인합니다.

방식준비할 것비고
SSH 키 인증 (권장)고객사에서 만든 SSH 키 쌍 중 공개키공개키를 전달해 주시면 계정에 등록해 드립니다. 개인키는 고객사에서만 보관합니다.
비밀번호 인증발급된 비밀번호보안 정책상 키 인증을 요구하시는 경우에는 비밀번호 로그인을 끄고 운영합니다.
개인키는 전달하지 마세요

SSH 키 쌍은 공개키(.pub)와 개인키(확장자 없음)로 이루어집니다. 저희에게는 공개키만 보내 주시고, 개인키는 접속하는 PC나 서버에만 보관해 주세요.

클라이언트 IP 대역 요청​

보안 강화를 위해 SFTP 서버에 접근 가능한 IP 대역을 제한할 수 있습니다.
필요할 경우 사용 중인 IP 대역을 전달해 주시면 보안 정책에 반영됩니다.


Windows에서 접속하기​

Windows 10(1809 이후)과 Windows 11 기준으로, SSH 키를 만들고 접속해 데이터를 내려받는 순서를 안내합니다.

1) SSH 키 만들기​

Windows 10·11에는 OpenSSH 클라이언트가 기본 포함되어 있어 별도 설치 없이 키를 만들 수 있습니다.

  1. 시작 메뉴에서 PowerShell을 엽니다.

  2. 아래 명령을 실행합니다.

    mkdir "$env:USERPROFILE\.ssh" -Force
    ssh-keygen -t rsa -b 4096 -f "$env:USERPROFILE\.ssh\mash_sftp"
  3. 암호(passphrase)를 묻는 화면이 나오면 원하는 암호를 입력하거나, 그대로 Enter를 눌러 생략합니다.

  4. C:\Users\{사용자}\.ssh\ 폴더에 두 파일이 만들어집니다.

    • mash_sftp — 개인키. 접속할 때 사용하며 외부로 보내지 않습니다.
    • mash_sftp.pub — 공개키. 이 파일을 담당자에게 전달해 주세요.

공개키 등록이 끝나면 접속 정보(호스트, 사용자명)를 별도로 안내해 드립니다.

2) FileZilla로 접속하기​

  1. FileZilla 공식 사이트에서 FileZilla Client를 내려받아 설치합니다.

  2. 메뉴에서 파일 → 사이트 관리자를 열고 새 사이트를 누릅니다.

  3. 아래와 같이 입력합니다.

    항목입력값
    프로토콜SFTP - SSH File Transfer Protocol
    호스트안내받은 호스트 주소
    포트22
    로그온 유형키 파일
    사용자안내받은 사용자명
    키 파일C:\Users\{사용자}\.ssh\mash_sftp (개인키)
  4. 연결을 누릅니다.

    • 키 파일 선택 창에 파일이 보이지 않으면, 파일 형식을 모든 파일로 바꿔서 선택합니다.
    • 키 형식을 변환할지 묻는 창이 나오면 예를 눌러 변환된 파일(.ppk)을 저장한 뒤 그 파일을 사용합니다.
    • 처음 접속할 때 서버 인증서(호스트 키)를 신뢰할지 묻는 창이 나오면 확인을 누릅니다.
  5. 접속되면 오른쪽 리모트 사이트 창에 event/ 등 제공 폴더가 보입니다. 원하는 폴더나 파일을 왼쪽 로컬 사이트 창으로 끌어다 놓으면 내려받아집니다.

3) PowerShell(명령어)로 접속하기​

프로그램 설치 없이 PowerShell에서 바로 접속할 수도 있습니다.

sftp -i "$env:USERPROFILE\.ssh\mash_sftp" {사용자명}@{호스트}

접속 후 자주 쓰는 명령은 다음과 같습니다.

명령설명
ls현재 폴더 목록 보기
cd event폴더 이동
lcd C:\mash_data내려받을 내 PC 폴더 지정
get 2026-11-04.parquet파일 하나 내려받기
get -r {매장태그}폴더 통째로 내려받기
exit접속 종료

내려받은 데이터 열어보기​

제공 파일은 .csv 또는 .parquet 형식입니다. .csv는 Excel에서 바로 열 수 있고, .parquet은 아래 방법으로 내용을 확인하거나 CSV로 바꿀 수 있습니다.

DuckDB (설치형 조회 도구)​

  1. PowerShell에서 DuckDB를 설치합니다.

    winget install DuckDB.cli
  2. 새 PowerShell 창에서 duckdb를 실행한 뒤 아래처럼 조회합니다.

    -- 파일 하나의 앞 10행 보기
    SELECT * FROM 'C:/mash_data/2026-11-04.parquet' LIMIT 10;

    -- 폴더 안의 parquet 파일을 모두 합쳐 CSV 로 저장
    COPY (SELECT * FROM 'C:/mash_data/*.parquet')
    TO 'C:/mash_data/merged.csv' (HEADER, DELIMITER ',');

Python​

import pandas as pd  # pip install pandas pyarrow

df = pd.read_parquet(r"C:\mash_data\2026-11-04.parquet")
print(df.head())

# Excel 에서 한글이 깨지지 않도록 utf-8-sig 로 저장
df.to_csv(r"C:\mash_data\2026-11-04.csv", index=False, encoding="utf-8-sig")

파일 시스템 구조​

상위 문서에서 설명한 meta/ event/ 디렉터리 구조와 파일 구조를 따릅니다.