---
title: "WebFTP 문제"
description: "Alpacon에서 WebFTP 파일 전송이 실패했을 때 원인을 확인하고 해결하는 방법을 안내합니다. 파일과 폴더 이름·경로의 길이 제한, 세션 종료 시점, 목록에서 사라진 전송을 살펴보고, alpacon cp 명령어에 표시되는 오류 메시지에 맞춰 다시 전송하는 방법을 알아보세요."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# WebFTP 문제

아래에서 화면에 표시된 메시지나 겪고 있는 증상을 찾아 WebFTP 전송이 실패한 원인과 해결 방법을 확인하세요.

## 제한

| 항목 | 제한 |
| --- | --- |
| 파일 또는 폴더 이름 | 최대 128자입니다. 객체 스토리지를 쓰는 배포 환경에서 폴더 이름은 최대 124자입니다. |
| 경로 | 최대 512자입니다. |
| 세션 유지 시간 | 세션을 연 뒤 1일입니다. 이 제한은 조정할 수 없습니다. |
| 전송 유효 시간 | 전송을 생성한 뒤 1일입니다. |
| 월간 전송량 | 워크스페이스 플랜에 따라 다릅니다. [플랜과 결제](/use/workspace/plans-billing/)를 참고하세요. |

## 오류 코드

아래에서 오류 코드를 찾으세요. CLI에서는 코드 없이 짧은 메시지만 표시될 수 있습니다. [CLI 메시지](#cli-메시지)를 참고하세요.

콘솔에 표시되는 문구는 오류 메시지 참조의 [webftp_name_too_long](/reference/error-messages/#webftp_name_too_long), [max_length](/reference/error-messages/#max_length), [webftp_invalid_path](/reference/error-messages/#webftp_invalid_path), [webftp_limit_exceeded](/reference/error-messages/#webftp_limit_exceeded), [webftp_content_not_accepted](/reference/error-messages/#webftp_content_not_accepted), [auth_interactive_channel_requires_presence](/reference/error-messages/#auth_interactive_channel_requires_presence)에서 확인할 수 있습니다.

## 세션이 저절로 종료되는 경우

WebFTP 세션은 연 뒤 1일이 지나면 종료됩니다. 세션을 사용하거나 브라우저를 다시 연결해도 제한 시간은 초기화되지 않으며, 설정에서 연장할 수 없습니다. 파일을 계속 전송하려면 WebFTP를 다시 여세요.

파일 전송 서비스가 재시작되거나 작업 세션이 끝날 때도 세션이 종료됩니다. 작업 세션이 만료·완료되었거나 철회되었다면 다른 작업 세션을 요청한 뒤 WebFTP를 여세요.

## 전송이 목록에서 사라진 경우

전송을 생성하고 1일이 지나면 해당 전송이 만료됩니다. 만료된 전송은 목록에 표시되지 않고 상세 정보도 열 수 없습니다. 만료된 전송과 저장된 파일은 만료 시점으로부터 7일 뒤에 삭제됩니다. 파일이 계속 필요하다면 다시 전송하세요.

## CLI 메시지

[`alpacon cp` 명령어](/reference/cli/cp/)가 전송을 거부할 때 오류 코드가 항상 표시되지는 않습니다. 메시지와 함께 어떤 작업을 요청했고 무엇을 입력했는지 확인하세요.

- `Invalid input.`: 파일이나 폴더 이름이 너무 길면 이 메시지가 표시될 수 있습니다. 위의 제한에 맞게 이름을 줄인 뒤 다시 시도하세요.
- `path: Invalid input.`: 서로 다른 폴더에 있는 파일을 한 번에 다운로드하면 이 메시지가 표시됩니다. 같은 폴더에 있는 파일끼리 나누어 다운로드하세요.
- `files: Invalid input.`: 이전 버전의 클라이언트가 배포 환경에서 지원하지 않는 방식으로 업로드하면 이 메시지가 표시될 수 있습니다. CLI를 업데이트한 뒤 다시 시도하세요.
- `plan limit reached: WebFTP transfer volume this month.`: 워크스페이스의 월간 전송량을 모두 사용했습니다. 메시지에는 사용량 초기화와 업그레이드 안내가 포함됩니다. 초기화를 기다리거나 [플랜과 결제](/use/workspace/plans-billing/)를 확인하세요.

## 관련 문서

- [파일 업로드하기](/use/work-sessions/files/upload/)
- [연결 문제](/use/work-sessions/troubleshoot-connections/)
- [Websh 세션 관리하기](/use/work-sessions/terminal/sessions/)

Source: https://docs.alpacax.com/ko/use/work-sessions/files/troubleshooting/