Pterodactyl 패널 SFTP 연결
LightHost 마크 서버 패널에서 SFTP 정보를 확인하고 WinSCP 또는 FileZilla로 연결하는 방법입니다.
LightHost 마크 서버는 Pterodactyl 패널을 사용합니다. SFTP를 연결하면 패널의 Files 화면과 동일한 서버 저장 공간에서 플러그인, 모드, 월드와 설정 파일을 관리할 수 있습니다.
Pterodactyl에서 접속 정보 확인
- 마크 서버 패널에 로그인합니다.
- Servers 목록에서 연결할 서버를 선택합니다.
- 서버 관리 화면의 왼쪽 메뉴에서 Settings를 엽니다.
- SFTP Details 영역에서 서버 주소, 포트와 사용자명을 확인합니다.
- SFTP 프로그램이 설치되어 있다면 Launch SFTP 버튼으로 바로 연결할 수도 있습니다.
| 항목 | 입력값 |
|---|---|
| 프로토콜 | SFTP |
| 서버 주소 | 패널의 SFTP Details에 표시된 주소 |
| 포트 | 패널에 표시된 포트, 일반적으로 2022 |
| 사용자명 | 패널에 표시된 SFTP 사용자명 전체 |
| 비밀번호 | Pterodactyl 패널 계정 비밀번호 |
서버 주소, 포트와 사용자명을 임의로 추측하지 말고
SFTP Details에 표시된 값을 그대로 사용해주세요. 서버마다 SFTP 사용자명이 다르므로 이메일 주소나 마인크래프트 닉네임으로 로그인하면 안 됩니다.
Launch SFTP 사용하기
Pterodactyl의 Launch SFTP를 누르면 sftp:// 연결을 처리할 프로그램을 선택하라는 창이 표시됩니다. 설치된 SFTP 프로그램을 선택한 뒤 Pterodactyl 패널 비밀번호를 입력합니다.
아무 반응이 없다면 브라우저가 외부 프로그램 실행을 차단했거나 SFTP 프로그램이 연결 앱으로 등록되지 않은 상태입니다. 이 경우 SFTP Details의 값을 복사하여 아래 방법으로 직접 연결하면 됩니다.
WinSCP로 연결하기
- WinSCP를 실행하고 새 사이트를 선택합니다.
- 파일 프로토콜을 SFTP로 선택합니다.
- 패널에서 확인한 호스트 이름과 포트를 입력합니다.
SFTP Details에 표시된 사용자명 전체와 Pterodactyl 패널 계정 비밀번호를 입력합니다.- 로그인을 누릅니다.
- 처음 연결할 때 서버 호스트 키 확인 창이 표시되면 주소가 올바른지 확인한 후 승인합니다.
연결되면 왼쪽에는 내 컴퓨터 파일, 오른쪽에는 서버 파일이 표시됩니다. 파일을 끌어 놓아 업로드하거나 다운로드할 수 있습니다.
FileZilla로 연결하기
- FileZilla에서 파일 → 사이트 관리자를 엽니다.
- 새 사이트를 누릅니다.
- 프로토콜을 SFTP - SSH File Transfer Protocol로 선택합니다.
- 호스트와 포트에 패널의 SFTP 정보를 입력합니다.
- 로그온 유형을 일반으로 선택합니다.
SFTP Details의 사용자명과 Pterodactyl 패널 계정 비밀번호를 입력한 뒤 연결합니다.
빠른 연결을 사용할 때는 호스트 앞에 sftp://를 붙일 수 있습니다.
sftp://패널에-표시된-서버-주소파일을 변경하기 전에
- Pterodactyl의 Console 화면에서 Stop을 눌러 서버를 완전히 중지합니다.
- 월드 폴더를 교체하기 전에는 백업을 만듭니다.
server.properties, 플러그인 설정과 모드 설정은 원본을 내려받아 보관합니다.- 서버가 실행 중일 때 월드 파일을 덮어쓰면 데이터가 손상될 수 있습니다.
- 실행 파일이나 압축 파일의 출처를 확인한 뒤 업로드합니다.
업로드가 끝나면 Pterodactyl의 Files 화면에서 파일이 정상적으로 표시되는지 확인하고 Console에서 서버를 시작합니다. 압축 파일은 Files 화면에서 선택한 뒤 Unarchive 기능으로 풀 수 있습니다.
연결되지 않을 때
인증 실패
- 이메일 주소가 아니라
SFTP Details의 사용자명 전체를 입력했는지 확인합니다. - Pterodactyl 패널에 로그인할 때 사용하는 비밀번호가 맞는지 확인합니다.
- 비밀번호를 변경했다면 SFTP 프로그램에 저장된 이전 비밀번호를 삭제합니다.
연결 시간 초과
- 포트가
22로 입력되지 않았는지 확인합니다. 패널에 표시된 SFTP 포트를 사용해야 합니다. - 회사나 학교 네트워크에서 해당 포트를 차단하는지 다른 네트워크로 확인합니다.
- 서버 주소에
https://를 붙이지 않았는지 확인합니다.
업로드 권한 또는 용량 오류
- 서버 디스크 사용량이 요금제 한도에 도달했는지 확인합니다.
- SFTP 최상위 경로 밖으로 이동할 수 없는 것은 정상입니다.
- 같은 이름의 파일이 사용 중이라면 서버를 중지한 후 다시 업로드합니다.
문제가 계속되면 고객센터에 서버 주문 번호와 SFTP 프로그램의 오류 메시지를 함께 보내주세요. 비밀번호는 절대 전달하지 마세요.