WebFTP 문제
아래에서 화면에 표시된 메시지나 겪고 있는 증상을 찾아 WebFTP 전송이 실패한 원인과 해결 방법을 확인하세요.
제한
| 항목 | 제한 |
|---|---|
| 파일 또는 폴더 이름 | 최대 128자입니다. 객체 스토리지를 쓰는 배포 환경에서 폴더 이름은 최대 124자입니다. |
| 경로 | 최대 512자입니다. |
| 세션 유지 시간 | 세션을 연 뒤 1일입니다. 이 제한은 조정할 수 없습니다. |
| 전송 유효 시간 | 전송을 생성한 뒤 1일입니다. |
| 월간 전송량 | 워크스페이스 플랜에 따라 다릅니다. 플랜과 결제를 참고하세요. |
오류 코드
아래에서 오류 코드를 찾으세요. CLI에서는 코드 없이 짧은 메시지만 표시될 수 있습니다. CLI 메시지를 참고하세요.
| 코드 | 의미 | 조치 |
|---|---|---|
webftp_name_too_long# | "이름이 너무 길어서 저장할 수 없어요. 이름을 줄인 뒤 다시 시도해 주세요." 파일이나 폴더 이름이 길이 제한을 넘었습니다. | 이름을 128자 이하로 줄인 뒤 다시 전송하세요. 객체 스토리지를 쓰는 배포 환경에서 폴더 이름은 124자 이하로 줄여야 합니다. |
max_length# | "입력 글자 수가 너무 많아요. 더 짧게 입력해 주세요." 경로가 512자를 넘었습니다. | 경로를 줄이거나 파일을 루트에 더 가까운 폴더로 옮긴 뒤 다시 전송하세요. |
webftp_invalid_path# | "같은 디렉터리 내의 파일만 선택할 수 있어요." 여러 파일을 한 번에 다운로드할 때 서로 다른 폴더의 파일을 선택했습니다. | 같은 폴더에 있는 파일끼리 나누어 다운로드하세요. |
webftp_limit_exceeded# | "이 워크스페이스의 이번 달 WebFTP 전송량을 모두 썼어요. 월간 사용량이 초기화되거나 플랜을 업그레이드하면 새 전송을 시작할 수 있어요." 워크스페이스의 월간 WebFTP 전송량을 모두 사용했습니다. 이미 진행 중인 전송은 완료할 수 있습니다. | 월간 사용량이 초기화될 때까지 기다리거나 워크스페이스 플랜을 업그레이드한 뒤 다른 전송을 시작하세요. |
webftp_content_not_accepted# | "이 배포 환경에서는 파일 내용을 객체 스토리지를 통해 전송하므로 서버에 직접 보낼 수 없어요. 페이지를 새로고침한 뒤 다시 시도해 주세요." 업로드 방식이 이 배포 환경의 파일 전송 요구 사항과 맞지 않습니다. | 페이지를 새로고침한 뒤 다시 시도하세요. alpacon cp를 쓰고 있다면 CLI를 업데이트한 뒤 다시 시도하세요. |
auth_interactive_channel_requires_presence# | "토큰으로는 Websh, 편집기, WebFTP 세션을 열 수 없어요. alpacon login이나 웹 콘솔로 로그인한 뒤 다시 시도해 주세요." 토큰으로는 WebFTP 세션을 열 수 없습니다. | alpacon login이나 웹 콘솔로 로그인한 뒤 다시 시도하세요. |
콘솔에 표시되는 문구는 오류 메시지 참조의 webftp_name_too_long, max_length, webftp_invalid_path, webftp_limit_exceeded, webftp_content_not_accepted, auth_interactive_channel_requires_presence에서 확인할 수 있습니다.
세션이 저절로 종료되는 경우
WebFTP 세션은 연 뒤 1일이 지나면 종료됩니다. 세션을 사용하거나 브라우저를 다시 연결해도 제한 시간은 초기화되지 않으며, 설정에서 연장할 수 없습니다. 파일을 계속 전송하려면 WebFTP를 다시 여세요.
파일 전송 서비스가 재시작되거나 작업 세션이 끝날 때도 세션이 종료됩니다. 작업 세션이 만료·완료되었거나 철회되었다면 다른 작업 세션을 요청한 뒤 WebFTP를 여세요.
전송이 목록에서 사라진 경우
전송을 생성하고 1일이 지나면 해당 전송이 만료됩니다. 만료된 전송은 목록에 표시되지 않고 상세 정보도 열 수 없습니다. 만료된 전송과 저장된 파일은 만료 시점으로부터 7일 뒤에 삭제됩니다. 파일이 계속 필요하다면 다시 전송하세요.
CLI 메시지
alpacon cp 명령어가 전송을 거부할 때 오류 코드가 항상 표시되지는 않습니다. 메시지와 함께 어떤 작업을 요청했고 무엇을 입력했는지 확인하세요.
Invalid input.: 파일이나 폴더 이름이 너무 길면 이 메시지가 표시될 수 있습니다. 위의 제한에 맞게 이름을 줄인 뒤 다시 시도하세요.path: Invalid input.: 서로 다른 폴더에 있는 파일을 한 번에 다운로드하면 이 메시지가 표시됩니다. 같은 폴더에 있는 파일끼리 나누어 다운로드하세요.files: Invalid input.: 이전 버전의 클라이언트가 배포 환경에서 지원하지 않는 방식으로 업로드하면 이 메시지가 표시될 수 있습니다. CLI를 업데이트한 뒤 다시 시도하세요.plan limit reached: WebFTP transfer volume this month.: 워크스페이스의 월간 전송량을 모두 사용했습니다. 메시지에는 사용량 초기화와 업그레이드 안내가 포함됩니다. 초기화를 기다리거나 플랜과 결제를 확인하세요.