A private web panel for Minecraft server hosting. Built with Docker, FastAPI, and a modern UI.
- Start/stop/status servers
- Upload plugins
- Read logs
- Edit server.properties
- Create worlds
docker-compose up --build- Test the panel at http://localhost:8000/docs
- FastAPI backend for Minecraft server panel
- Multi-server management (Start, Stop, Kill, Restart, Status, Properties, Logs, Plugins, Worlds, EULA, Auth)
- tmux process handling
- JWT auth, secure uploads, directory traversal protection
- Docker and docker-compose ready
-
Build & Starttart
docker compose up --build
-
Test API
- Login:
/login(FormData: username, password) - Server APIs:
/server/*
- Login:
-
Default Login
- Username:
admin - Password:
admin
- Username:
- Server initialization, Purpur download, etc. is done via the API (
/server/create). - Plugin upload: Only
.jarallowed, max. 10MB, secure paths. - tmux must be installed in the container (see Dockerfile).
- JWT auth for all critical endpoints
- Rate limiting recommended (optional)
- Directory traversal protection everywhere
- Stelle sicher, dass alle Shell-Skripte (z.B.
entrypoint.sh) mit Unix-Zeilenenden (LF) gespeichert sind. In VS Code unten rechts auf "LF" stellen. - Falls Fehler wie
Exec format errorauftreten, führe im Projektordner aus:dos2unix backend/entrypoint.sh chmod +x backend/entrypoint.shh
- Die Dockerfiles und das Compose-File sind so angepasst, dass sie auf Linux und Windows funktionieren.
MIT