Pterodactyl wings 설치가이드

Pterodactyl Wings는 Pterodactyl 패널과 연결되어 게임 서버를 호스팅하는 데 필요한 에이전트입니다. Wings는 서버에 실제로 게임 서버를 배포하고 관리하는 역할을 합니다. 아래는 Wings 설치 가이드입니다.

1. 시스템 업데이트

먼저, 시스템의 패키지 목록을 업데이트하고 필요한 의존성을 설치합니다.

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl sudo apt-transport-https lsb-release ca-certificates

2. Docker 설치

Pterodactyl Wings는 Docker를 사용하여 서버를 실행하므로 Docker를 설치해야 합니다.

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

Docker 설치가 완료되면, Docker 서비스가 정상적으로 실행되는지 확인합니다.

sudo systemctl start docker
sudo systemctl enable docker
sudo docker --version

3. Docker-Compose 설치

Docker-Compose는 Wings에서 사용하는 컨테이너를 관리하는 데 사용됩니다.

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

설치가 완료되면, docker-compose 명령어가 잘 작동하는지 확인합니다.

docker-compose --version

4. Wings 설치

Wings 설치를 위해 GitHub에서 최신 Wings 버전을 클론합니다.

cd /var/www
sudo git clone https://github.com/pterodactyl/wings.git pterodactyl-wings
cd pterodactyl-wings

5. Wings 설정

Wings의 설정을 위해 환경 변수 파일을 설정합니다.

sudo cp .env.example .env
sudo nano .env

파일에서 APP_URL, PANEL_URL, WINGS_SECRET와 같은 값을 설정합니다. PANEL_URL에는 Pterodactyl 패널의 주소를, WINGS_SECRET에는 패널에서 생성한 비밀 키를 입력해야 합니다.

예시:

APP_URL=http://your-server-ip:8080
PANEL_URL=https://panel.yourdomain.com
WINGS_SECRET=secret-key-here

6. Docker Compose 파일 설정

Wings는 docker-compose.yml 파일을 사용하여 Docker 컨테이너를 관리합니다. docker-compose.yml 파일을 확인하고 설정합니다.

nano docker-compose.yml

7. Wings 시작

설정이 완료되면, Docker Compose를 사용하여 Wings를 시작합니다.

sudo docker-compose up -d

이 명령어는 Wings가 Docker 컨테이너에서 백그라운드로 실행되도록 합니다.

8. Firewall 설정

Wings는 기본적으로 포트 8080을 사용합니다. 이 포트를 방화벽에서 열어야 합니다.

sudo ufw allow 8080

9. Pterodactyl 패널에서 Wings 연결

Pterodactyl 패널에 로그인하고 “Wings” 섹션에서 새 서버를 추가한 후, 생성된 Wings의 WINGS_SECRET 값을 입력하여 연결합니다. 패널에서 서버를 관리할 수 있습니다.

10. 서비스로 Wings 실행 (선택사항)

Wings를 시스템 서비스로 실행하려면, 시스템 서비스 파일을 작성하여 Wings가 부팅 시 자동으로 시작되도록 설정할 수 있습니다.

sudo nano /etc/systemd/system/pterodactyl-wings.service

내용 예시:

[Unit]
Description=Pterodactyl Wings Daemon
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/var/www/pterodactyl-wings
ExecStart=/usr/local/bin/docker-compose up
TimeoutStopSec=20
Restart=always

[Install]
WantedBy=multi-user.target

서비스 파일을 저장한 후, 시스템 서비스를 시작하고 자동으로 시작되도록 설정합니다.

sudo systemctl daemon-reload
sudo systemctl enable pterodactyl-wings
sudo systemctl start pterodactyl-wings

이로써 Wings 설치가 완료되었습니다. Pterodactyl 패널에서 서버를 관리하고, Docker를 통해 게임 서버를 호스팅할 수 있습니다.