---
title: "파일 관리 개요"
description: "작업 세션에서 WebFTP를 열어 브라우저와 원격 서버 사이에서 파일을 옮깁니다. 원격 서버 파일을 관리하고 업로드와 다운로드에 적용되는 보안 조건을 확인하세요. 전송을 마친 뒤에는 감사 기록에서 누가 어떤 파일을 언제 옮겼는지 확인해 작업 내역을 추적할 수 있습니다."
---

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

# 파일 관리 개요

WebFTP를 사용해 브라우저에서 등록된 서버의 파일을 전송하고 관리합니다.

## WebFTP란?

WebFTP는 서버 파일을 브라우저에서 직관적으로 관리하게 해 줍니다. 별도 소프트웨어 없이 매끄러운 화면에서 파일을 올리고, 내리고, 다룹니다.

### 주요 기능

**1. 시각적 파일·디렉터리 탐색**

- 트리 뷰로 전체 디렉터리 구조를 살펴봅니다
- 클릭 가능한 경로 표시줄로 원하는 위치로 바로 이동합니다
- 파일 미리보기와 정보를 즉시 확인합니다
- 다중 컬럼 레이아웃으로 효율적으로 탐색합니다

**2. 로컬에서 서버로 업로드**

- 로컬 기기의 파일이나 폴더를 올립니다
- 드래그 앤 드롭을 지원합니다
- 여러 파일을 한꺼번에 선택합니다
- 대용량 업로드의 진행 상황을 추적합니다

**3. 서버에서 로컬로 다운로드**

- 파일이나 폴더를 로컬 기기로 내려받습니다
- 일괄 다운로드를 지원합니다
- 폴더는 압축해 내려받습니다
- 진행 상황을 표시합니다

**4. 기본 파일 작업**

- 자주 쓰는 Linux 파일 명령을 실행합니다
- 파일과 디렉터리 복사(`cp`)
- 파일과 디렉터리 이동(`mv`)
- 파일과 디렉터리 삭제(`rm`)
- 새 디렉터리 생성(`mkdir`)
- 파일과 폴더 이름 변경
- 권한 변경(`chmod`)

## 특징과 장점

**웹 기반 인터페이스**

- 별도 FTP 클라이언트 설치가 필요 없습니다
- 브라우저에서 바로 동작합니다
- 어느 플랫폼에서나 쓸 수 있습니다
- 익숙한 UI/UX를 따릅니다

**서버 관리와 통합**

- 등록된 서버와 자동으로 연결됩니다
- 그룹 기반으로 접근을 제어합니다
- 다른 Alpacon 기능과 같은 인증을 사용합니다
- 하나의 워크스페이스에서 통합해 다룹니다

**안전한 전송**

- Alpamon 에이전트를 거쳐 암호화합니다
- TLS로 통신 채널을 보호합니다
- 모든 작업에 감사 로그를 남깁니다
- 권한에 따라 파일 접근을 제어합니다

**편리한 사용성**

- 드래그 앤 드롭으로 업로드
- 다중 선택 지원
- 즉시 파일 미리보기
- 키보드 단축키
- 반응형 디자인

## 보안 기능

**인증과 권한 부여**

- 워크스페이스 멤버 인증이 필요합니다
- 그룹 기반으로 서버에 접근합니다
- 파일 시스템 권한을 그대로 따릅니다(Linux, macOS)
- 읽기 전용 모드를 쓸 수 있습니다

**암호화된 통신**

- 모든 전송을 TLS로 암호화합니다
- WebSocket 연결을 보호합니다
- 데이터 무결성을 검증합니다
- 평문으로 전송하지 않습니다

**감사 로깅**

- 모든 파일 작업을 기록합니다
- 사용자 활동을 추적합니다
- 시각과 IP를 남깁니다
- 규정 준수를 뒷받침합니다

**권한 관리(Linux, macOS)**

- POSIX 파일 권한을 적용합니다
- 사용자·그룹 소유권을 보존합니다
- chmod로 권한을 변경합니다
- 새 파일에 안전한 기본값을 적용합니다

Windows에서는 에이전트가 SYSTEM 권한으로 실행되므로, WebFTP는 호스트에서 접근 가능한 모든 경로를 읽고 쓸 수 있으며 `chmod` 방식의 권한 변경은 적용되지 않습니다. 접근 범위는 Alpacon 역할과 연결 허용 사용자로 제어됩니다. [WebFTP 권한](/use/work-sessions/files/permissions/)을 참고하세요.

## 자주 쓰는 사례

**구성 관리**

- 구성 파일 업로드
- 서버 설정 편집
- 중요 파일 백업
- 애플리케이션 구성 배포

**애플리케이션 배포**

- 애플리케이션 코드 업로드
- 정적 자산 배포
- 빌드 아티팩트 전송
- 애플리케이션 파일 업데이트

**로그 분석**

- 로그 파일 다운로드
- 오래된 로그 아카이브
- 분석용 로그 전송
- 중요 로그 백업

**콘텐츠 관리**

- 미디어 파일 업로드
- 정적 콘텐츠 관리
- 웹사이트 자산 업데이트
- 문서 라이브러리 정리

**백업과 복구**

- 백업 다운로드
- 복원 파일 업로드
- 중요 데이터 아카이브
- 재해 복구 작업

## WebFTP 접속

WebFTP는 [작업 세션](/use/work-sessions/)을 통해 열립니다. **파일 전송** 기능을 포함해 세션을 요청하세요. 세션이 활성화되면 **세션** 탭에서 접속할 서버의 **파일**을 클릭합니다. 세션에 진입한 뒤 CLI에서 `alpacon cp`로도 파일을 전송할 수 있습니다.

[세션 요청하기](/use/work-sessions/create/)와 [세션 사용하기](/use/work-sessions/detail/)를 참고하세요.

## 계정 선택

WebFTP는 세션을 요청할 때 **접속 계정**에서 고른 계정으로 접속합니다. 기본값은 본인 계정이며, 서버의 다른 계정을 고를 수도 있습니다.

Windows에서 선택한 계정은 감사 라벨일 뿐이며, 표시된 계정과 무관하게 WebFTP는 SYSTEM 권한으로 실행됩니다. [Windows 서버](/reference/platforms/windows/#windows의-권한과-사용자-식별)를 참고하세요.

선택지, 본인 계정이 아닌 계정을 쓸 수 있는 사람, MFA를 요구하는 경우는 [계정 선택](/use/work-sessions/account-selection/)을 참고하세요.

## 시작하기

바로 파일 관리를 시작해 보세요.

1. [파일 업로드](/use/work-sessions/files/upload/)
2. [파일 다운로드](/use/work-sessions/files/download/)
3. [파일 및 폴더 관리](/use/work-sessions/files/manage/)
4. [파일 권한 설정](/use/work-sessions/files/permissions/)

## 관련 문서

- [서버 등록하기](/use/servers/register/)
- [접근 제어](/use/workspace/settings/roles/)
- [터미널 접근](/use/work-sessions/terminal/)

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