# 파일 관리자

> Portal의 내장 파일 관리자나 SFTP를 사용해 서버 파일을 업로드, 관리, 편집하는 방법.

Portal의 **Files** 탭에서는 브라우저로 서버의 파일 시스템에 접근할 수 있어요. 파일을 업로드하고, 디렉터리를 만들고, 웹 편집기에서 파일을 편집하고, 압축 파일을 풀 수 있어요 — 모두 브라우저를 벗어나지 않고 가능해요. 더 큰 용량을 옮길 때는 SFTP도 사용할 수 있어요.

## 배울 내용

- 파일을 탐색하고 관리하는 방법
- 파일을 업로드하는 방법(폴더 제한을 다루는 방법 포함)
- 브라우저에서 파일을 만들고 편집하는 방법
- 제한 없는 접근을 위해 SFTP를 사용하는 방법

---

## 파일 둘러보기

파일 관리자는 서버의 디렉터리 트리를 보여줘요. 폴더를 클릭하면 안으로 들어가고, 텍스트 파일을 클릭하면 내장 웹 편집기에서 열려요.

---

## 파일 업로드하기

**Upload**를 클릭하면 컴퓨터에서 파일을 하나 이상 업로드할 수 있어요. 파일은 현재 열려 있는 디렉터리에 저장돼요.

> **정보:** 웹 파일 관리자는 파일당 업로드 크기 제한이 있어요. 큰 파일이나 많은 파일을 한 번에 옮기려면 아래 섹션의 SFTP를 사용하세요.

---

## 폴더 업로드하기

웹 파일 관리자에서는 폴더를 직접 업로드하는 기능을 **지원하지 않아요**. 다음 방법 중 하나를 사용하세요:

### 방법 1: 압축 파일 업로드 (가장 빠름)

1. 컴퓨터에서 폴더를 `.zip` 또는 `.tar.gz` 파일로 압축하세요.
2. **Upload** 버튼으로 압축 파일을 업로드하세요.
3. 파일 관리자에서 압축 파일을 마우스 오른쪽 버튼으로 클릭하고 **Extract**를 선택해 서버에서 풀어 주세요.

### 방법 2: SFTP 사용 (크기 제한 없음)

SFTP를 사용하면 브라우저 제한 없이 폴더 트리 전체를 업로드할 수 있어요. 아래의 SFTP 섹션을 참고하세요.

---

## 파일 만들기 및 편집하기

| 작업 | 방법 |
| :--- | :--- |
| 새 파일 만들기 | **New File**을 클릭 |
| 기존 파일 편집하기 | 파일을 클릭해 웹 편집기에서 열고, **Save**를 클릭 |
| 디렉터리 만들기 | **New Directory**를 클릭 |
| 이름 바꾸기 또는 삭제 | 파일이나 폴더를 마우스 오른쪽 버튼으로 클릭해 옵션 사용 |

---

## 압축 파일 작업

- **Extract:** `.zip` 또는 `.tar.gz` 파일을 업로드한 뒤 마우스 오른쪽 버튼으로 클릭하고 **Extract**를 선택하면 그 자리에서 풀려요.
- **Compress:** 파일이나 폴더를 선택한 뒤 압축 옵션을 사용해 `.zip`을 만드세요.

---

## SFTP 사용하기

SFTP를 사용하면 데스크톱 클라이언트에서 파일 시스템에 직접, 제한 없이 접근할 수 있어요.

### SFTP 정보 확인하기

1. Portal에서 서버를 열고 **Settings** 탭으로 이동하세요.
2. **SFTP Details** 섹션을 찾으세요:
   - **Host** — SFTP 서버 주소
   - **Port** — 보통 2022
   - **Username** — Portal 사용자 이름
3. SFTP 비밀번호로 Portal 계정 비밀번호를 사용하세요.

### 추천 SFTP 클라이언트

| 클라이언트 | 플랫폼 |
| :--- | :--- |
| FileZilla | Windows, Mac, Linux (무료) |
| WinSCP | Windows (무료) |
| Cyberduck | Mac, Windows (무료) |
| `sftp` | 모든 터미널 |

### SFTP로 할 수 있는 일

- 폴더 트리 전체를 한 번의 전송으로 업로드
- 브라우저 제한에 걸리지 않고 큰 파일 전송
- 데스크톱 환경에서 효율적으로 파일 관리

---

## 팁

- 파일 충돌을 피하려면 애플리케이션의 새 버전을 업로드하기 전에 서버를 중지하세요.
- 파일 하나를 빠르게 고칠 때는 웹 편집기를 사용하고, 초기 프로젝트 설정이나 큰 업로드에는 SFTP를 사용하세요.
- 코드의 외부 사본(예: GitHub)을 보관하세요. 특히 삭제된 파일을 복구할 수 없는 Free Tier에서는 더 중요해요.

---

## 다음 단계

- [시작 설정](https://daki.cc/ko/wiki/guides/startup-settings) — 파일을 업로드한 뒤 서버의 시작 명령을 설정하세요.
- [환경 변수](https://daki.cc/ko/wiki/guides/environment-variables) — 봇 토큰과 기타 설정 값을 지정하세요.
- [콘솔 & 전원 작업](https://daki.cc/ko/wiki/guides/console) — 서버를 시작하고 출력을 확인하세요.

---
Source: https://daki.cc/ko/wiki/guides/file-manager