This commit is contained in:
2025-11-21 19:20:00 +00:00
parent 9a89841282
commit 5182ce5403

430
readme.md
View File

@@ -1,246 +1,184 @@
Markdown# 🚀 Pterodactyl Panel & Wings - Docker Compose Setup # 🚀 TuxiNet Pterodactyl Stack Docker Compose
Dette repository indeholder en komplet `docker-compose` opsætning til Pterodactyl Panel og Wings, inklusiv en MariaDB database, Redis til caching, Nginx som reverse proxy, og Certbot til automatisk SSL/TLS. Komplet Pterodactyl Panel & Wings setup pakket til Docker, inkl.:
--- - MariaDB (database)
- Redis (cache & køer)
## 🌟 Indhold i dette repository - Panel (Pterodactyl web/APP)
- Wings (daemon til game servers)
1. `README.md` (Denne fil) - Nginx (reverse proxy)
2. `docker-compose.yml` - Certbot (Let's Encrypt SSL)
3. `install.sh` (Til opsætning af mapper og Nginx-konfig) - 💜 Branded til **TuxiNet** med dark-mode/neon banner (`banner.png`)
4. `cert-renewal.sh` (Til automatisk Certbot-fornyelse)
![Banner](banner.png)
---
---
## 🛠️ Trin 1: Klargøring og Konfiguration
## 📁 Struktur
### 1.1 Opret Mappe og Hent Filer
Når du pakker dette ud i `/srv/pterodactyl`, vil du have:
Opret rodmappen på din host-maskine og gem alle de vedhæftede filer (`docker-compose.yml`, `install.sh`, `cert-renewal.sh`) heri.
```text
```bash /srv/pterodactyl/
mkdir -p /srv/pterodactyl ├── README.md
cd /srv/pterodactyl ├── docker-compose.yml
# Hent/kopier filerne her ├── install.sh
1.2 Redigér install.shÅbn install.sh og skift domænenavnet i toppen:Bash# /srv/pterodactyl/install.sh ├── cert-renewal.sh
DOMAIN="panel.ditdomæne.dk" # <--- SKAL REDIGERES ├── banner.png
1.3 Kør InstallationsscriptetKør scriptet. Det opretter den nødvendige mappestruktur og en dummy Nginx-konfiguration:Bashchmod +x install.sh ├── docker/
./install.sh │ ├── mariadb/Dockerfile
1.4 Redigér docker-compose.ymlDu skal redigere følgende sektioner i docker-compose.yml:ServiceVariabelBeskrivelsemariadbMYSQL_ROOT_PASSWORD / MYSQL_PASSWORDSkift til stærke, unikke kodeord.panelDB_PASSWORDSkal matche mariadb password.panelMAIL_* variablerUdfyld dine SMTP-oplysninger for at aktivere email (vigtigt).panelAPP_URLSkift til dit faktiske domæne.wingsportsTilføj de porte, dine spilservere skal bruge (f.eks. 25565:25565).🚀 Trin 2: Start og SSL Opsætning2.1 Start ServicesStart alle definerede services:Bashdocker-compose up -d │ ├── panel/Dockerfile
2.2 Hent SSL-certifikater med CertbotSKIFT domæne og emailadresse i kommandoen. Dette henter det rigtige certifikat:Bashdocker-compose run --rm certbot certonly \ │ ├── redis/Dockerfile
--webroot -w /var/www/certbot \ ├── wings/Dockerfile
-d panel.ditdomæne.dk \ ├── nginx/Dockerfile
--email din@email.dk \ └── certbot/Dockerfile
--agree-tos \ ├── panel/
--no-eff-email ├── wings/
Genstart Nginx for at indlæse de nye, gyldige certifikater:Bashdocker-compose restart nginx ├── servers/
2.3 Kør Pterodactyl SetupKør migrations og opret administratorbrugeren i Panel-containeren:Bash# Kør databasemigreringer og sæt APP_KEY ├── mysql/
docker-compose exec panel php artisan migrate --force │ └── data/
docker-compose exec panel php artisan p:environment:setup └── nginx/
├── conf.d/
# Opret den første administratorbruger └── certbot/
docker-compose exec panel php artisan p:user:make ├── conf/
2.4 Konfigurering af WingsLog ind på dit Panel via browseren.Opret en Location og en Node.På Node-konfigurationssiden, kopier Konfigurations-tokenet.Kør denne kommando på din host, og ERSTAT "DIT_TOKEN_HER":Bash# Opretter den Wings-konfigurationsfil, den skal bruge └── www/
docker-compose exec wings /bin/bash -c "echo '{ \"token\": \"DIT_TOKEN_HER\" }' > /etc/pterodactyl/config.json" ```
# Genstart Wings for at indlæse konfigurationen > Mapperne `panel/`, `wings/`, `servers/`, `mysql/data`, `nginx/...` er med som tomme mapper, så alt er klar fra start.
docker-compose restart wings
🔄 Trin 3: Automatisk Certifikatfornyelse3.1 cert-renewal.shGør fornyelsesscriptet eksekverbart:Bashchmod +x /srv/pterodactyl/cert-renewal.sh ---
3.2 Opret Cron JobÅbn din brugers Cron-tabel:Bashcrontab -e
Indsæt denne linje i bunden af filen (kører kl. 08:00 og 20:00 dagligt):Kodestykke# Kør Pterodactyl Certbot fornyelsesscript to gange dagligt ## 🛠️ Trin 1: Klargøring
0 8,20 * * * /srv/pterodactyl/cert-renewal.sh >> /var/log/cert-renewal.log 2>&1
💾 Vedhæftede Filerdocker-compose.ymlYAMLversion: '3.7' ### 1.1 Flyt projektet til `/srv/pterodactyl`
services: ```bash
# --- 1. MariaDB Database Service --- sudo mkdir -p /srv/pterodactyl
mariadb: sudo chown -R $(whoami):$(whoami) /srv/pterodactyl
image: mariadb:10.5 # Kopiér/zippens indhold herind
container_name: pterodactyl_database ```
restart: always
environment: ---
# SKAL UDSKIFTES!
MYSQL_ROOT_PASSWORD: DitSuperSikreRootPassword ### 1.2 Redigér `install.sh`
MYSQL_DATABASE: panel
MYSQL_USER: pterodactyl Øverst i `install.sh`:
MYSQL_PASSWORD: DitSuperSikreDBPassword
volumes: ```bash
- /srv/pterodactyl/mysql/data:/var/lib/mysql DOMAIN="panel.ditdomæne.dk" # ← SKAL OPDATERES
ports: ```
- "3306:3306"
---
# --- 2. Pterodactyl Panel Service (Webserver/PHP) ---
panel: ### 1.3 Kør installationsscriptet
image: ghcr.io/pterodactyl/panel:latest
container_name: pterodactyl_panel ```bash
restart: always cd /srv/pterodactyl
depends_on: chmod +x install.sh
- mariadb ./install.sh
- redis ```
environment:
# Databaseforbindelse Dette opretter mappestruktur og en midlertidig Nginx-konfiguration + dummy certifikater.
DB_HOST: mariadb
DB_PORT: 3306 ---
DB_DATABASE: panel
DB_USERNAME: pterodactyl ## ⚙️ Trin 2: Tilpas `docker-compose.yml`
DB_PASSWORD: DitSuperSikreDBPassword # SKAL MATCHES
**Vigtige felter:**
# SMTP Email Konfiguration - SKAL UDFYLDES!
MAIL_FROM_ADDRESS: "noreply@ditdomæne.dk" - MariaDB:
MAIL_FROM_NAME: "Pterodactyl Panel" - `MYSQL_ROOT_PASSWORD`
MAIL_DRIVER: smtp - `MYSQL_PASSWORD`
MAIL_HOST: smtp.ditdomæne.dk # DIN SMTP HOST
MAIL_PORT: 587 - Panel (Pterodactyl):
MAIL_USERNAME: "din-email-bruger" # DIN SMTP BRUGER - `APP_URL=https://panel.ditdomæne.dk`
MAIL_PASSWORD: "din-email-adgangskode" # DIN SMTP ADGANGSKODE - Alle `MAIL_*` (SMTP-konfiguration)
MAIL_ENCRYPTION: tls
- Wings (game server ports):
# Generel App Konfiguration - Tilføj fx `25565:25565` for Minecraft, m.m.
APP_URL: [https://panel.ditdomæne.dk](https://panel.ditdomæne.dk) # SKAL REDIGERES
APP_TIMEZONE: Europe/Copenhagen Når alt er rettet, start stacken:
CACHE_DRIVER: redis
SESSION_DRIVER: redis ```bash
QUEUE_DRIVER: redis docker-compose up -d
REDIS_HOST: redis ```
REDIS_PORT: 6379
volumes: ---
- /srv/pterodactyl/panel:/app
## 🔐 Trin 3: Hent rigtige SSL-certifikater
# --- 3. Redis Service (Caching/Køer) ---
redis: Skift domæne og email i følgende kommando:
image: redis:latest
container_name: pterodactyl_redis ```bash
restart: always docker-compose run --rm certbot certonly \\
--webroot -w /var/www/certbot \\
# --- 4. Pterodactyl Wings Service (Game Server Daemon) --- -d panel.ditdomæne.dk \\
wings: --email din@email.dk \\
image: ghcr.io/pterodactyl/wings:latest --agree-tos \\
container_name: pterodactyl_wings --no-eff-email
restart: always ```
cap_add:
- NET_ADMIN Genstart Nginx:
- NET_RAW
ports: ```bash
# Wings API Port & SFTP Port (OBLIGATORISK) docker-compose restart nginx
- "8080:8080" ```
- "2022:2022"
# Tilføj dine spilserver-porte her: ---
# - "25565-25570:25565-25570"
volumes: ## 🧩 Trin 4: Pterodactyl Panel Setup
- /srv/pterodactyl/wings:/etc/pterodactyl
- /var/run/docker.sock:/var/run/docker.sock:ro ```bash
- /srv/pterodactyl/servers:/var/lib/pterodactyl/volumes docker-compose exec panel php artisan migrate --force
docker-compose exec panel php artisan p:environment:setup
# --- 5. Nginx Reverse Proxy Service (Webserver med SSL) --- docker-compose exec panel php artisan p:user:make
nginx: ```
image: nginx:stable-alpine
container_name: pterodactyl_nginx Følg anvisningerne i terminalen for at oprette din admin-bruger.
restart: always
ports: ---
- "80:80"
- "443:443" ## 🛰️ Trin 5: Wings konfiguration
volumes:
- /srv/pterodactyl/nginx/conf.d:/etc/nginx/conf.d:ro 1. Log ind i Panelet i browseren.
- /srv/pterodactyl/nginx/certbot/www:/var/www/certbot:ro 2. Opret en **Location** og derefter en **Node**.
- /srv/pterodactyl/nginx/certbot/conf:/etc/letsencrypt:ro 3. Kopiér tokenet fra Node-konfigurationen.
depends_on: 4. Kør på hosten (indsæt dit token):
- panel
```bash
# --- 6. Certbot Service (SSL/TLS) --- docker-compose exec wings /bin/bash -c "echo '{ \"token\": \"DIT_TOKEN_HER\" }' > /etc/pterodactyl/config.json"
certbot: docker-compose restart wings
image: certbot/certbot ```
container_name: pterodactyl_certbot
volumes: ---
- /srv/pterodactyl/nginx/certbot/www:/var/www/certbot
- /srv/pterodactyl/nginx/certbot/conf:/etc/letsencrypt ## 🔄 Trin 6: Automatisk SSL-fornyelse
entrypoint: /bin/sh -c "trap exit TERM; while :; do sleep 3600; done"
install.shBash#!/bin/bash ### 6.1 Gør scriptet eksekverbart
# Domæne du vil bruge til Pterodactyl Panel (SKAL REDIGERES!) ```bash
DOMAIN="panel.ditdomæne.dk" chmod +x /srv/pterodactyl/cert-renewal.sh
```
# Opret hovedmapper
mkdir -p /srv/pterodactyl/{panel,wings,mysql/data,servers} ### 6.2 Cron-job
mkdir -p /srv/pterodactyl/nginx/{conf.d,certbot/{conf,www}}
```bash
# Opret Nginx konfigurationsfil crontab -e
cat <<EOF > /srv/pterodactyl/nginx/conf.d/default.conf ```
server {
listen 80; Tilføj:
server_name ${DOMAIN};
```cron
location ~ /.well-known/acme-challenge { # Certbot automatisk fornyelse (08:00 & 20:00)
allow all; 0 8,20 * * * /srv/pterodactyl/cert-renewal.sh >> /var/log/cert-renewal.log 2>&1
root /var/www/certbot; ```
}
---
location / {
return 301 https://\$host\$request_uri; ## 🧡 Brand & Tilpasning (TuxiNet)
}
} - Banneret (`banner.png`) er lavet i dark-mode med neon/teal gaming-look.
- Du kan frit udskifte det med et nyt TuxiNet-brandet banner (samme filnavn, så README stadig virker).
server { - Dockerfiles har simple `LABEL`-felter, hvor du kan tilføje mere metadata, hvis du vil.
listen 443 ssl http2;
server_name ${DOMAIN}; Har du brug for en version med flere noder, Traefik i stedet for Nginx, eller ekstra monitoring (Prometheus/Grafana), kan vi bygge næste lag ovenpå den her stack.
# SSL konfiguration (Certbot stier)
ssl_certificate /etc/letsencrypt/live/${DOMAIN}/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/${DOMAIN}/privkey.pem;
include /etc/letsencrypt/options-ssl-nginx.conf;
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
root /var/www/html/public;
index index.html index.php;
location / {
try_files \$uri \$uri/ /index.php?\$query_string;
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass panel:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME \$document_root\$fastcgi_script_name;
fastcgi_param PATH_INFO \$fastcgi_path_info;
}
location ~ /\. {
deny all;
}
}
EOF
echo "✅ Mappestruktur og Nginx konfiguration er oprettet."
# Generer dummy certifikater for at starte Nginx
openssl req -x509 -nodes -newkey rsa:4096 -days 365 \
-keyout /srv/pterodactyl/nginx/certbot/conf/privkey.pem \
-out /srv/pterodactyl/nginx/certbot/conf/fullchain.pem \
-subj "/CN=${DOMAIN}" 2>/dev/null
echo "✅ Dummy SSL-certifikater oprettet."
echo ""
echo "Næste trin: Rediger 'docker-compose.yml' og kør 'docker-compose up -d'."
cert-renewal.shBash#!/bin/bash
# /srv/pterodactyl/cert-renewal.sh
# Script til automatisk fornyelse af Certbot certifikater
cd /srv/pterodactyl/ || exit
echo "--- Starter Let's Encrypt certifikatfornyelse ---"
# Kører Certbot for at tjekke fornyelse
docker-compose run --rm certbot renew --quiet
# Tjekker exit-koden
if [ $? -eq 0 ]; then
echo "Certbot kørsel succesfuld. Genstarter Nginx."
docker-compose restart nginx
else
echo "FEJL: Certbot fornyelsen mislykkedes."
fi
echo "--- Certifikatfornyelse afsluttet ---"