명령줄은 자동화에 필요한 별도 진입점입니다. GUI 대기열·예약·대화형 승인과 같은 동작이라고 가정하지 마세요. 명령 예제의 접속 설정과 경로를 직접 준비하고 서버 작업 전에 읽기 전용 목록 조회부터 확인합니다.
tasteftp cli --help로 해당 판의 도움말을 확인합니다. 실행 파일이 검색 경로에 없으면 설치한 실행 파일의 전체 경로를 사용합니다.
접속 JSON은 protocol(sftp·ftp·ftps·ftps-implicit), host, username 및 필요한 port, passwordEnv, privateKey, hostKey, tlsFingerprint를 지정합니다. passwordEnv에는 비밀번호 값이 아니라 환경 변수 이름을 넣습니다. 개인 키 암호도 필요한 경우 지정한 환경 변수에서 읽습니다. SFTP hostKey는 관리자가 확인해 준 SHA256 지문이 필요합니다.
목록 조회 형식은 다음과 같습니다.
tasteftp cli list --config connection.json --remote /sample접속 정보 파일에 비밀번호를 직접 넣거나 로그에 환경 변수 값을 출력하지 마세요. 대화형 추가 인증은 CLI에서 지원하지 않을 수 있으므로 오류가 나면 GUI 인증 흐름과 구분합니다.
upload 또는 download에 --config, --local, --remote를 지정합니다. 원격은 파일 이름을 포함한 절대 경로이며 부모 경로의 존재·권한을 확인합니다. 기본은 대상이 있으면 실패하고, 대체를 명시 승인할 때만 --overwrite를 추가합니다. GUI의 묻기 창이 뜨기를 기대하지 마세요.
--timeout은 초 단위(기본 600), --speed-limit은 초당 바이트입니다. GUI의 KiB/s와 단위가 다릅니다.
delete는 SFTP 전용이며 --remote와 동일한 --confirm 경로 및 --expected-items 개수를 요구합니다. 루트 경로나 추정 개수로 실행하지 마세요. 항목 수 사전 확인은 백업을 대신하지 않으며 실제 서버 내용을 삭제하는 기능입니다.
benchmark는 단일 파일 업로드·다운로드 왕복과 검증을 수행하며 --local, --remote, --download-to를 지정합니다. 대상은 존재하지 않아야 하고 자동 정리하지 않습니다. 중요 파일이 있는 위치에 측정 명령을 사용하지 마세요.
결과는 JSON 객체로 출력됩니다. 종료 코드는 성공 0, 입력 오류 2, 작업 실패 3입니다. 오류 시 JSON 코드와 경로·인증·권한을 확인하고 같은 변경 명령을 무조건 반복하지 마세요.