SFTP(Secure File Transfer Protocol)를 사용하면 게임 서버에 연결하여 대용량 파일, 전체 모드 폴더, 백업 등을 컴퓨터에서 직접 전송할 수 있습니다. GPanel 파일 관리자가 처리할 수 없는 것(예: 전체 디렉터리나 브라우저 크기 제한을 초과하는 파일)을 업로드해야 한다면 SFTP가 적합한 도구입니다.
SFTP를 사용해야 할 때: 폴더, 대용량 파일(예: 월드 세이브, 모드 팩, 백업) 또는 여러 파일을 한 번에 업로드해야 할 때 SFTP를 사용하세요. 단일 파일을 빠르게 편집하는 경우에는 GPanel 파일 관리자로 충분할 수 있습니다.
연결 정보
SFTP 연결은 서버의 IP 주소와 GPanel의 자격 증명을 사용합니다.
SFTP 연결 정보
| 호스트 / 주소 | 서버의 IP 주소(GPanel 대시보드 또는 Console 탭에 표시됨) |
|---|---|
| 포트 | 2022 |
| 프로토콜 | SFTP (SSH File Transfer Protocol) |
| 사용자 이름 | GPanel 사용자 이름 |
| 비밀번호 | GPanel의 Settings 탭에서 확인 가능 |
중요: 기본 SFTP 포트 22가 아니라 항상 포트 2022를 사용하세요. 포트 22 연결은 작동하지 않습니다.
옵션 1 — FileZilla (권장)
FileZilla는 Windows, macOS, Linux에서 사용할 수 있는 무료 크로스 플랫폼 FTP/SFTP 클라이언트입니다.
1단계 — FileZilla 다운로드 및 설치
- filezilla-project.org로 이동하여 FileZilla Client(FileZilla Server가 아님)를 다운로드하세요.
- 설치 프로그램을 실행하고 화면의 안내를 따르세요.
2단계 — Site Manager 열기
- FileZilla를 실행하세요.
- File → Site Manager를 클릭하세요(또는 Ctrl+S를 누르세요).
- New Site를 클릭하고 Legion Hosting과 같은 이름을 지정하세요.
3단계 — 연결 설정 입력
- Protocol을
SFTP - SSH File Transfer Protocol로 설정하세요. - Host를 서버의 IP 주소(GPanel 대시보드에서 확인)로 설정하세요.
- Port를
2022로 설정하세요. - Logon Type을
Normal로 설정하세요. - GPanel 사용자 이름과 비밀번호를 입력하세요(비밀번호는 GPanel의 Settings 탭에 있습니다).
- Connect를 클릭하세요.
4단계 — 호스트 키 수락
- 처음 연결할 때 FileZilla는 Unknown host key 대화 상자를 표시합니다.
- Always trust this host를 체크하고 OK를 클릭하세요.
5단계 — 파일 업로드
- 왼쪽 패널은 로컬 컴퓨터를 보여줍니다. 업로드할 파일이나 폴더로 이동하세요.
- 오른쪽 패널은 서버의 파일 시스템을 보여줍니다. 대상 폴더(예:
/home/container/mods/)로 이동하세요. - 왼쪽 패널에서 오른쪽 패널로 파일이나 폴더를 끌어다 놓거나, 파일을 마우스 오른쪽 버튼으로 클릭하고 Upload를 선택하세요.
- 하단의 대기열 패널에서 전송 진행 상황을 모니터링하세요.
옵션 2 — WinSCP (Windows 전용)
WinSCP는 친숙한 두 패널 파일 탐색기 인터페이스를 갖춘 인기 있는 무료 Windows용 SFTP 클라이언트입니다.
1단계 — WinSCP 다운로드 및 설치
- winscp.net으로 이동하여 설치 프로그램을 다운로드하세요.
- 설치 프로그램을 실행하세요. 인터페이스 스타일을 묻는 경우, 듀얼 패널 보기를 원하면 Commander를, 단일 패널 보기를 선호하면 Explorer를 선택하세요.
2단계 — 새 세션 만들기
- WinSCP를 실행하세요. Login 대화 상자가 자동으로 열립니다.
- File protocol을
SFTP로 설정하세요. - Host name 필드에 서버의 IP 주소(GPanel 대시보드에서 확인)를 입력하세요.
- Port number를
2022로 설정하세요. - GPanel User name과 Password를 입력하세요(비밀번호는 GPanel의 Settings 탭에 있습니다).
- Login을 클릭하세요.
3단계 — 호스트 키 수락 및 업로드
- 처음 연결할 때 서버 호스트 키 경고를 수락하세요.
- 로컬 파일은 왼쪽에, 서버 파일은 오른쪽에 나타납니다.
- 서버에서 대상 폴더로 이동한 다음, 왼쪽 패널에서 오른쪽으로 파일을 끌어다 놓거나 F5를 사용하여 선택한 파일을 복사하세요.
일반적인 업로드 작업
구성 파일 업로드
구성 파일(예: servertest.ini, server.properties)은 일반적으로 서버 홈 디렉터리의 특정 하위 폴더에 있습니다. 일반적인 경로:
- Project Zomboid:
/home/container/.cache/server/ - ARK: Survival Ascended:
/home/container/ShooterGame/Saved/Config/WindowsServer/ - Minecraft:
/home/container/
SFTP 클라이언트에서 올바른 경로로 이동한 다음, 편집한 구성 파일을 서버 패널로 끌어다 놓아 기존 파일을 교체하세요.
먼저 서버를 중지하세요 활성 구성 파일을 교체하기 전에 서버를 중지하세요. 서버가 실행 중인 동안 구성을 업로드하면 종료 시 서버가 파일을 덮어쓸 수 있습니다.
모드 업로드
- GPanel에서 서버를 중지하세요.
- SFTP를 통해 연결하고 게임의 모드 폴더(예:
/home/container/mods/또는 게임별 경로)로 이동하세요. - 전체 모드 폴더 또는
.jar/.pak파일을 로컬 컴퓨터에서 서버 모드 디렉터리로 끌어다 놓으세요. - 업로드가 완료되면 GPanel에서 서버를 시작하세요.
월드 세이브 또는 백업 업로드
- GPanel에서 서버를 중지하세요.
- SFTP를 통해 연결하고 게임의 세이브 디렉터리로 이동하세요.
- 전체 세이브 폴더를 업로드하세요(기존 세이브에 병합하는 경우가 아니라면, 폴더 내용만이 아니라 폴더 자체를 끌어다 놓으세요).
- 폴더 구조가 이전과 일치하는지 확인하세요.
- GPanel에서 서버를 시작하세요.
팁: 세이브를 덮어쓰기 전에 기존 서버 측 폴더의 이름을 먼저 변경하세요(예: 끝에
_backup 추가). 그러면 문제가 발생할 경우 복원할 수 있습니다.
문제 해결
- 포트가 22가 아니라 2022로 설정되어 있는지 다시 확인하세요.
- IP 주소가 GPanel 대시보드에 표시된 것과 일치하는지 확인하세요.
- 서버가 실행 중인지 확인하세요 — 일부 플랜에서는 SFTP 접근에 게임 서버 프로세스가 활성 상태여야 할 수 있습니다.
- 방화벽이나 백신 프로그램이 포트 2022의 아웃바운드 연결을 차단하지 않는지 확인하세요.
- gpanel.legionhosting.net에 로그인할 때 사용하는 것과 동일한 사용자 이름과 비밀번호를 사용하세요.
- 사용자 이름은 대소문자를 구분합니다. 확실하지 않으면 GPanel에서 사용자 이름을 직접 복사하세요.
- 최근에 GPanel 비밀번호를 변경한 경우, SFTP 클라이언트의 저장된 세션에서 업데이트하세요.
- 비밀번호를 잊은 경우 고객 영역에서 GPanel 비밀번호를 재설정하세요.
- 대용량 모드 팩이나 월드 세이브는 몇 분이 걸릴 수 있습니다. 전송이 완료될 때까지 기다리세요.
- FileZilla에서는 동시 전송 수를 늘릴 수 있습니다. Edit → Settings → Transfers로 이동하여 최대 동시 전송을 3으로 설정하세요.
- 전송 중에 연결이 끊어지면 FileZilla가 재개할 수 있습니다. 대기열에서 실패한 파일을 마우스 오른쪽 버튼으로 클릭하고 Reset and requeue failed transfers를 선택하세요.
- 홈 디렉터리는
/home/container/입니다. 클라이언트가 다른 디렉터리로 연결되는 경우, 원격 경로 표시줄에 이 경로를 직접 입력하세요. - 올바른 사용자 이름으로 연결되어 있는지 확인하세요 — 각 GPanel 계정은 자신의 서버 파일에만 접근할 수 있습니다.
여전히 도움이 필요하신가요? 지원 티켓을 여세요. 그리고 서버 IP 주소, 사용 중인 SFTP 클라이언트, 오류에 대한 설명을 포함해 주세요.
