최근 수정 시각 : 2025-12-12 21:11:29

pterodactyl

Pterodactyl에서 넘어옴
🌐 소프트웨어 관련 정보
{{{#!wiki style="min-height: calc(1.5em + 5px); margin: 0 -10px -5px"
{{{#!folding [ 펼치기ㆍ접기 ]
{{{#!wiki style="margin: -5px -1px -11px"		<colbgcolor=#64C3FA> 소프트웨어
<colcolor=#000,#fff> 기능에 따른 구분 시스템 소프트웨어(플랫폼)
응용 소프트웨어
유틸리티
펌웨어
권한에 따른 구분 사유 소프트웨어 프리웨어, 셰어웨어, 애드웨어
오픈 소스, 자유 소프트웨어
직업 프로그래머(개발자), 분석가, QA, DB Admin, 디자이너
목록 소프트웨어/목록
}}}}}}}}} ||
Pterodactyl
프테로닥틸
파일:pterodactyl.svg
개발 및 정보
개발자 Dane Everitt 외 다수
라이선스 MIT 라이선스
작성 언어 PHP, React, Go
최신 버전 Panel: v1.11.11
운영 체제 리눅스
웹사이트 공식 홈페이지
리포지토리 GitHub

1. 개요2. 특징3. 시스템 구조
3.1. Panel (패널)3.2. Wings (윙즈)
4. 설치 및 요구 사항
4.1. 필수 요구 사항
5. 장단점
5.1. 장점5.2. 단점
6. 여담

1. 개요

The open-source game server management panel
오픈소스 게임 서버 관리 패널

리눅스 환경에서 동작하는 오픈소스 게임 서버 관리 패널이다.
기존의 유료 패널인 Multicraft나 TCAdmin 등을 대체하기 위해 만들어졌으며, 무료이면서도 강력한 기능과 깔끔한 UI로 개인 호스팅 운영자나 소규모 호스팅 업체들 사이에서 사실상의 표준(De facto)으로 자리 잡았다.

단순히 서버를 켜고 끄는 것을 넘어, Docker 컨테이너 기술을 활용하여 각각의 게임 서버를 격리된 환경에서 구동하는 것이 가장 큰 특징이다. 이 덕분에 보안성과 안정성이 매우 뛰어나다.

이름인 Pterodactyl은 익룡인 프테로닥틸루스에서 따왔다. 그래서 그런지 로고도 익룡 모양이다.

2. 특징

  • 완전 무료 및 오픈소스: MIT 라이선스를 따르며 누구나 무료로 사용 및 수정이 가능하다.
  • Docker 기반 격리: 모든 게임 서버는 독립된 Docker 컨테이너 내부에서 실행된다. 덕분에 한 서버가 해킹당하거나 오류가 생겨도 다른 서버나 호스트 머신에 영향을 주지 않는다.
  • 직관적인 웹 UI: React 기반의 모던하고 깔끔한 웹 인터페이스를 제공한다.
  • 다양한 게임 지원: 'Egg(알)'라고 불리는 설정 파일을 통해 마인크래프트뿐만 아니라 Rust, ARK: Survival Evolved, CS:GO, Team Fortress 2, 디스코드 봇 등 거의 모든 종류의 애플리케이션을 구동할 수 있다.
  • 확장성: 여러 대의 물리 서버(Node)를 하나의 패널에서 통합 관리할 수 있다.

3. 시스템 구조

Pterodactyl은 크게 두 가지 구성 요소로 나뉜다.

3.1. Panel (패널)

사용자가 웹 브라우저를 통해 접속하는 인터페이스 부분이다.
  • 역할: 사용자 관리, 서버 생성/삭제, 결제 시스템 연동(별도 애드온 필요), 노드 제어 등 전반적인 관리 기능을 담당한다.
  • 기술 스택: PHP(Laravel 프레임워크), React, MariaDB, Redis 등을 사용한다.
  • 사용자는 이 패널을 통해 명령어를 입력하거나 파일을 업로드한다.

3.2. Wings (윙즈)

실제 물리 서버(데디케이티드 서버나 VPS)에 설치되어 게임 서버를 구동하는 데몬(Daemon)이다.
  • 역할: 패널의 명령을 받아 실제 Docker 컨테이너를 생성하고, 게임 서버의 콘솔 출력을 패널로 전송하며, FTP/SFTP 파일 전송을 처리한다.
  • 기술 스택: Go 언어로 작성되었으며, 성능이 매우 가볍고 빠르다. 과거에는 Node.js 기반의 데몬을 사용했으나 v1.0 업데이트와 함께 Go 언어 기반의 Wings로 교체되었다.

4. 설치 및 요구 사항

설치 난이도가 꽤 높은 편이다. 리눅스 명령어(CLI)에 익숙하지 않은 초보자라면 설치 과정에서 좌절할 수 있다.
일반적인 윈도우 환경에서는 구동할 수 없으며, 반드시 리눅스 (Ubuntu, CentOS 등) 환경이 필요하다.[1]

4.1. 필수 요구 사항

  • 운영 체제: Ubuntu 20.04/22.04 LTS, Debian 11/12, Rocky Linux 8/9 등
  • 가상화 기술: KVM (OpenVZ 등 컨테이너 기반 가상화에서는 Docker 실행 문제로 작동이 어려울 수 있다.)
  • 소프트웨어: PHP, Composer, MySQL(MariaDB), Redis, Nginx(또는 Apache), Docker

설치 과정이 복잡하기 때문에 커뮤니티에서 만든 자동 설치 스크립트를 사용하는 경우가 많다. 하지만 공식 문서에서는 문제 해결 능력을 기르기 위해 수동 설치를 권장한다.

5. 장단점

5.1. 장점

  • 보안성: Docker를 통한 철저한 격리 환경 제공.
  • 비용: 100% 무료. 상용 패널(cPanel, Multicraft 등)의 라이선스 비용을 아낄 수 있다.
  • 커뮤니티: 사용자 층이 두터워 디스코드나 포럼에서 도움을 받기 쉽고, 유저들이 만든 다양한 테마와 애드온이 존재한다.
  • 자원 효율: Wings가 Go 언어로 작성되어 시스템 리소스를 매우 적게 점유한다.

5.2. 단점

  • 진입 장벽: 리눅스와 네트워크, 웹 서버 설정에 대한 기본 지식이 없으면 설치와 유지 보수가 어렵다.
  • 공식적인 결제 모듈 부재: 호스팅 업체용 빌링 시스템(WHMCS, Blesta 등)과 연동하려면 별도의 모듈을 구매하거나, Pterodactyl 기반의 결제 패널(Jexactyl, CtrlPanel.gg 등)을 따로 설치해야 한다.

6. 여담

  • 한국의 많은 마인크래프트 호스팅 업체들이 이 패널을 사용하여 서비스를 제공하고 있다.
  • 워낙 유명한 프로젝트라 '프테로닥틸 설치 대행'을 해주는 재능 마켓 상품도 존재한다.
  • 로고가 꽤 귀엽다는 평가가 많다. 에러 페이지에서 우는 익룡을 볼 수 있다.

[1] 우분투 일부 버전만 지원하는 것으로 보인다.

분류