FTP UPLOADER

개요

📦
업로더 프로그램 다운로드
CloudFileTransfer Client · flow.js 포함
ZIP

Uploader(CloudFileTransfer Client)는 CDN 서비스를 위해 FTP 서버에 접속하여 파일을 업로드하거나 다운로드 받을 수 있는 전용 FTP 클라이언트 프로그램입니다. 일반적인 FTP 기능 이외에 자동 퍼지(Purge) 기능과 업로드 파일 테스트 기능을 추가적으로 제공합니다.

주요 특징

특징설명
동기화 불필요CDN 서비스가 캐싱 구조로 되어 있어 별도 동기화 과정 없이 업로드와 동시에 바로 서비스 가능
서비스 상태 확인업로드된 파일의 CDN 서비스 상태 여부를 URL 복사 후 브라우저에서 바로 확인 가능
자동 퍼지동일 이름의 파일을 업로드(덮어쓰기)하거나 파일이 삭제되는 경우, 엣지(Edge) 서버의 캐시 교체를 위해 자동으로 퍼지 실행
수동 퍼지필요 시 업로드된 파일에 대해 수동으로 퍼지 요청 가능
원격지 파일 관리FTP 서버 상의 파일/디렉토리 복사, 잘라내기, 붙여넣기 지원

기본 정보

프로그램명CloudFileTransfer Client
버전2.6.x
운영환경Windows
기본 포트21 (입력하지 않아도 됨)
문자셋 기본값UTF-8
💡 CDN 캐싱 구조의 특성상 동일 이름의 파일(내용만 변경)을 업로드하는 경우, 엣지 서버에서 즉각적인 파일 교체가 필요하므로 퍼지(Purge) 기능을 이용합니다. Uploader 프로그램에서는 이를 사용자가 특별히 조작할 일 없이 자동으로 처리합니다.

설치 및 삭제

제공된 설치 파일(CloudFileTransfer_2.x.x_setup.exe)을 실행하여 설치를 진행합니다.

설치 절차
단계내용비고
1설치 파일 실행CloudFileTransfer_2.x.x_setup.exe
2사용권 계약 동의[I Agree] 클릭
3설치 옵션 선택All users 또는 Only for me
4설치 컴포넌트 선택전체 선택 권장
5설치 위치 선택기본: C:\Program Files (x86)\CloudFileTransfer Client
6시작 메뉴 폴더기본: CloudFileTransfer Client
7설치 완료[Close] 클릭
삭제 방법

제어판의 프로그램 제거 또는 변경에서 CloudFileTransfer Client를 선택하여 삭제합니다.

설치 화면 안내
Step 2 — 사용권 계약 동의
License Agreement
Step 3 — 설치 옵션 선택
Choose Options
Step 4 — 설치 컴포넌트 선택
Choose Components
Step 5 — 설치 위치 선택
Choose Install Location
Step 6 — 시작 메뉴 폴더
Choose Start Menu Folder
Step 7 — 설치 완료
Installation Complete
삭제 — 제어판
Uninstall

사용 방법

서버 접속

Uploader를 실행하면 상단에 접속 정보 입력란이 표시됩니다. User Portal에서 제공된 업로드 서버 정보와 CDN domain 생성 시 생성한 계정 정보를 입력합니다.

입력 항목설명비고
호스트(H)업로드 서버 주소User Portal에서 제공
사용자명(U)FTP 사용자명CDN domain 생성 시 설정한 계정
비밀번호(W)FTP 비밀번호
포트(P)FTP 포트기본값 21 — 미입력 가능

입력 후 [빠른 연결] 버튼을 클릭하면 업로드 서버와 연결됩니다.

파일 업로드 / 다운로드

연결 후 좌측은 로컬 PC(FTP Client), 우측은 서버(FTP Server)의 디렉토리를 표시합니다.

동작방법설명
업로드좌측 → 우측더블 클릭 또는 Drag & Drop
다운로드우측 → 좌측더블 클릭 또는 Drag & Drop
CDN 서비스 URL 확인

업로드된 파일의 우클릭 메뉴에서 "클립보드로 URL 복사(S)"를 선택하면 CDN 서비스 URL이 복사됩니다. 브라우저에서 붙여넣기하여 서비스 상태를 바로 확인할 수 있습니다.

화면 구성
메인 화면 — 접속 정보 입력
메인 화면
접속 후 — 업로드 (Drag & Drop)
파일 업로드
우클릭 — 클립보드로 URL 복사
URL 복사

문자셋 설정

사이트 관리자에서 문자셋(Charset)을 설정할 수 있습니다. 새 사이트 생성 시 기본값은 UTF-8로 설정됩니다.

설정 경로

메뉴 → 파일(F)사이트 관리자 → 사이트 선택 → 문자셋

문자셋 옵션
옵션설명비고
자동 감지(A)서버 UTF-8 지원 시 자동 사용, 아니면 로컬 문자셋
UTF-8로 강제 설정(U)항상 UTF-8 사용기본값, 권장
문자셋 직접 설정(C)직접 인코딩 값 입력한글 깨짐 시 EUC-KR 입력
⚠️ FTP 내 한글이 깨져 보일 경우, 문자셋 직접 설정 란에서 EUC-KR로 기재 후 사용하시면 됩니다.
사이트 관리자 — 문자셋 탭
파일 메뉴 → 사이트 관리자 → 문자셋 탭
문자셋 설정

사이트 관리자 내보내기 / 가져오기

Uploader의 사이트 관리자 설정을 XML 파일로 내보내거나 가져올 수 있습니다. 설정 이전이나 백업 시 유용합니다.

내보내기
단계내용비고
1파일(F) → 내보내기(m)
2내보내기 팝업 → 항목 선택사이트 관리자 항목 체크
3[확인] 클릭 → XML 저장
가져오기
단계내용비고
1파일(F) → 가져오기(m)
2내보낸 XML 파일 선택
3사이트 가져오기로 등록 완료
내보내기 / 가져오기 화면
파일 메뉴 → 내보내기 → 설정 내보내기 팝업
사이트 관리자 내보내기

원격지 파일 관리

FTP 서버(우측 패널)에 업로드된 파일 및 폴더에 대해 복사, 잘라내기, 붙여넣기 등의 파일 관리 작업을 수행할 수 있습니다.

파일 관리 기능
기능방법비고
복사파일 우클릭 → 복사
잘라내기파일 우클릭 → 잘라내기
붙여넣기이동할 경로에서 우클릭 → 붙여넣기
새로고침F5 키잘라내기-붙여넣기 후 필수
디렉토리 생성우클릭 → 디렉터리 만들기(C)
이름 변경우클릭 → 이름 바꾸기(R)
삭제우클릭 → 삭제(E)
URL 복사우클릭 → 클립보드로 URL 복사(S)CDN 서비스 URL
💡 복사/잘라내기 완료 후 성공 여부와 어떤 파일을 처리했는지 결과 팝업에서 확인할 수 있습니다.
원격지 파일 관리 화면
우클릭 컨텍스트 메뉴 (복사/잘라내기)
원격지 컨텍스트 메뉴
복사/붙여넣기 완료 결과
복사 결과

자동 퍼지 기능

CDN 캐싱 구조의 특성상 동일 이름의 파일(내용만 변경)을 업로드하는 경우, 엣지(Edge) 서버에서 즉각적인 파일 교체가 필요합니다. Uploader 프로그램은 이를 위해 자동으로 퍼지를 실행합니다.

자동 퍼지 실행 조건
상황설명동작
파일 덮어쓰기동일 이름 파일 업로드업로드 후 자동 퍼지
파일 삭제리모트(FTP Server) 파일 삭제삭제 시 자동 퍼지
퍼지 결과 확인

상단 툴바의 P 아이콘을 클릭하면 퍼지 결과 팝업에서 결과를 확인할 수 있습니다.

항목설명비고
Object퍼지 대상 파일 경로ex) testdraw.png
Purge_ts퍼지 실행 시각ex) 2020-09-17 10:16:04.4
status_code퍼지 결과 코드100 = 성공
💡 자동 퍼지는 사용자가 특별히 조작할 일 없이 백그라운드에서 자동으로 처리됩니다.
자동 퍼지 화면
업로드 시 자동 퍼지 + P 아이콘 결과 팝업
자동 퍼지 결과
자동 퍼지 발생 시나리오
자동 퍼지 업로드

수동 퍼지 기능

자동 퍼지 외에 필요 시 업로드된 파일에 대해 수동으로 퍼지를 요청할 수 있습니다.

수동 퍼지 방법
단계내용비고
1서버(우측) 패널에서 파일 선택
2우클릭 → 컨텍스트 메뉴
3퍼지 메뉴 선택
4P 아이콘에서 결과 확인status_code: 100 = 성공
⚠️ 수동 퍼지는 파일 단위로 실행됩니다. 대량의 파일에 대한 퍼지가 필요한 경우 Purge Open API를 이용하시기 바랍니다.
수동 퍼지 화면
우클릭 메뉴에서 퍼지 선택
수동 퍼지
💬 문의하기