FTP 어댑터

FTP 어댑터는 FTP 프로토콜 기반의 파일 전송을 담당하는 최상위 컴포넌트입니다.

어댑터 생성

FTP 어댑터의 생성 방법 및 설정 항목에 대해서는 어댑터 생성을 참고합니다.

엔드포인트 그룹 생성

FTP 엔드포인트 그룹은 여러 FTP 엔드포인트를 하나의 그룹으로 묶어 관리할 수 있게 해줍니다.

FTP 엔드포인트 그룹의 생성 방법 및 설정 항목은 엔드포인트 그룹 생성을 참고합니다.

엔드포인트 생성

FTP 엔드포인트는 FTP 프로토콜 기반의 파일 업로드 및 다운로드를 처리하는 최종 컴포넌트입니다.

Active/Passive 모드를 모두 지원하며, 아웃바운드 방향만 지원합니다.

다음은 FTP 엔드포인트 생성 화면입니다. FTP 엔드포인트 생성 화면으로 이동하는 방법은 엔드포인트 생성을 참고합니다.

ftp ep create form

기본 설정

다음은 FTP 엔드포인트의 기본 설정 항목입니다. (*: 필수 설정 항목)

항목 설명

엔드포인트 아이디 *

엔드포인트의 고유 식별자입니다. 영문, 숫자, 언더스코어(_)를 조합하여 2~32자 이내로 입력합니다.

엔드포인트 이름

엔드포인트의 표시 이름을 입력합니다. 미입력 시 아이디 값으로 자동 설정됩니다.

통신 방향

아웃바운드 통신만 지원합니다. 외부 FTP 서버로 요청을 전달하기 위한 엔드포인트입니다.

부팅 초기값

엔드포인트의 초기 실행 상태를 지정합니다.

  • 실행: 엔진 시작 시 엔드포인트가 자동으로 시작됩니다.

  • 정지: 엔진 시작 시 엔드포인트가 시작되지 않습니다.

설명

엔드포인트에 대한 설명을 입력합니다.

연결 정보 설정

[연결 정보] 탭에서 HTTP 엔드포인트의 연결 방식, 연결 관리, 접속 정보를 설정합니다.

연결 방식
항목 설명

주소 *

FTP 서버의 IP 주소 또는 호스트 이름을 설정합니다.

포트 *

FTP 서버의 포트 번호를 설정합니다. (기본값: 21)

연결 방식

엔드포인트가 동작하는 연결 방식을 설정합니다.

  • Active: 클라이언트가 서버에 데이터 포트를 알려주고, 서버가 클라이언트로 연결을 시도합니다. 방화벽이 없는 환경에서 사용합니다.

  • Passive: 클라이언트가 서버에 데이터 포트를 요청하고, 클라이언트가 서버로 연결을 시도합니다. 방화벽/NAT 환경에서 권장됩니다.

다음은 네트워크 환경별 권장 연결 방식입니다.

  • 사내 네트워크(방화벽 없음): 직접 연결이 가능하므로 Active 모드를 사용할 수 있습니다.

  • 클라우드/외부/NAT 환경: 외부에서 접근 가능한 포트가 제한될 수 있으므로 Passive 모드를 권장합니다.

  • 연결 실패 시: Passive 모드로 변경한 후 다시 시도합니다.

버퍼 사이즈 *

파일 업로드 및 다운로드 시 사용할 버퍼 크기를 설정합니다. (기본값: 1024, 단위: byte)

업로드 속도 제한 *

파일 업로드 시 최대 전송 속도를 설정합니다. -1로 설정하면 속도 제한을 적용하지 않습니다. (기본값: -1, 단위: KB/s)

다운로드 속도 제한 *

파일 다운로드 시 최대 전송 속도를 설정합니다. -1로 설정하면 속도 제한을 적용하지 않습니다. (기본값: -1, 단위: KB/s)
연결 관리
항목 설명

소켓 타임아웃 *

데이터 송수신 시 최대 대기 시간을 설정합니다. 0으로 설정하면 시간 제한을 적용하지 않습니다. (기본값: 0, 단위: ms)

연결 타임아웃 *

FTP 서버 연결을 시도할 때 최대 대기 시간을 설정합니다. 0으로 설정하면 시간 제한을 적용하지 않습니다. (기본값: 0, 단위: ms)

데이터 타임아웃 *

데이터 채널을 통한 파일 전송 시 최대 대기 시간을 설정합니다. 0으로 설정하면 시간 제한을 적용하지 않습니다. (기본값: 0, 단위: ms)

연결 메시지 전송 주기 *

연결 유지를 위한 NOOP 명령 전송 간격을 설정합니다. 0으로 설정하면 비활성화됩니다. (기본값: 0, 단위: ms)

재시도 횟수 *

작업 실패 시 최대 재시도 횟수를 설정합니다. (기본값: 0)

재시도 간격 *

작업 실패 시 재시도 간격을 설정합니다. (기본값: 0, 단위: ms)
접속 정보
항목 설명

사용자 아이디

FTP 서버에 접속할 사용자 아이디를 설정합니다.

비밀번호

FTP 서버에 접속하기 위한 비밀번호를 설정합니다.

사용 예시

파일 업로드 (Active 모드)

내부 네트워크의 FTP 서버에 파일을 업로드하는 엔드포인트 설정 예시입니다.

시나리오
AnyLink → 내부 FTP 서버 (파일 업로드)

엔드포인트 설정 예시입니다.

항목 설정값

통신 방향

Outbound

부팅 초기값

실행

주소

192.168.1.200

포트

21

연결 방식

Active

버퍼 사이즈

8192

업로드 속도 제한

-1 (제한 없음)

사용자 아이디

ftp_user

비밀번호

**

타임아웃 설정 예시입니다.

항목 설정값

연결 타임아웃

10000 ms

소켓 타임아웃

30000 ms

데이터 타임아웃

60000 ms

재시도 횟수

3

재시도 간격

5000 ms

내부 네트워크에서 방화벽이 없는 환경이라면 Active 모드를 사용할 수 있습니다.

파일 다운로드 (Passive 모드)

외부 FTP 서버에서 파일을 다운로드하는 엔드포인트 설정 예시입니다.

시나리오
외부 FTP 서버 → AnyLink (파일 다운로드)

엔드포인트 설정 예시입니다.

항목 설정값

통신 방향

Outbound

부팅 초기값

실행

주소

ftp.external.com

포트

21

연결 방식

Passive

버퍼 사이즈

8192

다운로드 속도 제한

1024 (KB/s)

사용자 아이디

external_user

비밀번호

**

연결 유지 설정 예시입니다.

항목 설정값

연결 메시지 전송 주기

60000 ms

클라우드나 NAT 환경에서는 반드시 Passive 모드를 사용해야 합니다. Active 모드는 방화벽에 의해 차단될 수 있습니다.