DockerGryKonteneryzacjaPoradniki

Crafty Controller: Instalacja na Windows, Linux i Docker (2026)

PanRomekPL

06 kwi 2026

11 Min Read

65 Views

0 Comments

Zarządzanie serwerem Minecraft tradycyjnymi metodami – czyli za pomocą czarnego okna linii komend (CLI) – dla wielu osób jest synonimem profesjonalizmu. Jednak rzeczywistość bywa brutalna. Ręczne wpisywanie komend, pilnowanie procesów Java działających w tle czy żmudna edycja plików .properties przez SSH może przyprawić o zawrót głowy. Jest to szczególnie uciążliwe, gdy chcesz błyskawicznie przełączyć się między wersjami silników (np. z Paper na Fabric), zaplanować automatyczne kopie zapasowe, które uchronią Cię przed utraceniem danych, lub gdy chcesz dać zaufanemu koledze dostęp do konsoli, by mógł zrestartować serwer pod Twoją nieobecność.

W tym miejscu wkracza Crafty Controller. To nowoczesne, całkowicie darmowe i niezwykle intuicyjne rozwiązanie, które zamienia surowy wiersz poleceń w estetyczny i potężny panel webowy. To centrum dowodzenia, które sprawia, że bycie administratorem przestaje być walką z kodem, a staje się czystą przyjemnością.

W tym artykule przejdziemy przez cały proces: od wyjaśnienia, jak działa to narzędzie, przez instalację na różnych systemach, aż po Twoją pierwszą konfigurację.

Czym dokładnie jest Crafty Controller?

Crafty Controller technicznie definiuje się jako “wrapper” (otoczkę). Oznacza to, że nie jest on samym serwerem gry, lecz inteligentną warstwą pośrednią, która „siedzi” pomiędzy Twoim systemem operacyjnym a procesem Java Minecrafta. Crafty obserwuje serwer, zbiera dane i pozwala Ci na interakcję z nim za pomocą przeglądarki z dowolnego miejsca na świecie.

Dlaczego warto wybrać właśnie ten panel?

Oto co sprawia, że Crafty wyróżnia się na tle konkurencji:

• Zarządzanie wieloma serwerami z jednego miejsca: Niezależnie od tego, czy prowadzisz jeden świat Survival, czy całą sieć składającą się z lobby, SkyBlocka i Creative – wszystkim zarządzasz z poziomu jednej karty w przeglądarce. Możesz błyskawicznie przełączać się między instancjami bez przelogowywania.
• Kopie zapasowe (Backupy): Każdy administrator wie, że brak kopii zapasowej to proszenie się o kłopoty. Crafty pozwala na pełną automatyzację tego procesu. Możesz ustawić harmonogram tak, aby system sam tworzył punkty przywracania co godzinę, dzień czy tydzień, a w razie awarii – przywrócił serwer jednym kliknięciem.
• Konsola zdalna z podglądem na żywo: Koniec z byciem uwiązanym do komputera stacjonarnego. Dzięki panelowi webowemu możesz zalogować się do konsoli swojego serwera z tabletu lub smartfona będąc w drodze. Możesz nadawać uprawnienia (OP), banować graczy czy restartować serwer z dowolnego urządzenia z dostępem do internetu.
• Wbudowany menedżer plików i edytor: Zapomnij o konieczności konfigurowania zewnętrznych klientów FTP (jak FileZilla czy WinSCP). Crafty posiada zintegrowany eksplorator plików, który pozwala na przesyłanie map, wgrywanie pluginów i edycję plików konfiguracyjnych bezpośrednio w przeglądarce, z kolorowaniem składni ułatwiającym czytanie kodu.
• Monitoring zasobów w czasie rzeczywistym: Crafty dostarcza czytelne wykresy zużycia procesora (CPU) oraz pamięci operacyjnej (RAM). Dzięki temu od razu zauważysz, gdy któraś instancja Minecrafta zużywa zbyt dużo pamięci lub gdy procesor nie radzi sobie z dużą liczbą graczy, co pozwala na szybką reakcję i optymalizację.
• Obsługa wielu silników i wersji: Niezależnie czy preferujesz czysty silnik Vanilla, optymalizowany Paper/Spigot, czy zaawansowane modyfikacje na Forge/Fabric – Crafty wspiera je wszystkie, oferując łatwe pobieranie odpowiednich plików .jar prosto z panelu.

Wymagania systemowe

Zanim przejdziesz do instalacji, upewnij się, że Twój sprzęt spełnia minimalne wymagania:

• System operacyjny: Linux (Ubuntu/Debian polecane), Windows 10/11 lub macOS.
• Procesor: Dowolny współczesny procesor (im więcej rdzeni, tym więcej serwerów obsłużysz).
• RAM: Minimum 4 GB dla samego systemu i Crafty + tyle, ile potrzebuje Twój serwer Minecraft.
• Dysk: SSD jest zalecane dla szybkości ładowania świata.

Metoda 1: Instalacja na Windows

Dla użytkowników systemu Windows, którzy szukają najszybszego sposobu na uruchomienie panelu bez konieczności ingerencji w pliki systemowe, najlepszym rozwiązaniem jest Crafty Portable. W przeciwieństwie do instalacji jako usługa systemowa (Windows Service), wersja ta nie wymaga instalacji ani uprawnień administratora. Całość oprogramowania zamknięta jest w jednym, przenośnym folderze. To idealny wybór do testów, lokalnych projektów lub dla osób, które chcą mieć możliwość skopiowania całego środowiska serwerowego na pendrive.

Wymagania systemowe i środowiskowe

Zanim przejdziesz do samej instalacji, upewnij się, że Twój system jest gotowy. Ta metoda wymaga zainstalowania kilku kluczowych narzędzi deweloperskich:

• System: Windows 10 lub 11.
• Środowisko .NET: Wersja 8.0 lub wyższa.
• Stabilne połączenie internetowe do pobrania niezbędnych bibliotek.

1. Przygotowanie wersja Portable

Najpierw musisz pobrać pliki usługi: Crafty Controller dla windowas. Znajdziesz ją w oficjalnym repozytorium.

1. Pobranie programu: Pobierz najnowszą paczkę (Windows Package) dla systemu Windows z oficjalnego repozytorium: GitLab Crafty Controller (Windows Package).
2. Rozpakowanie plików: Kliknij prawym przyciskiem myszy na pobrany plik i wybierz opcję „Wyodrębnij wszystko” (Extract All).
3. Przeniesienie: Skopiuj rozpakowany katalog z folderu “Pobrane” np. do folderu “Dokumenty”.
4. Start panelu: Wejdź do folderu i kliknij dwukrotnie plik crafty.exe, aby uruchomić aplikację.

Panel będzie dostępny pod adresem https://twoje-ip:8443 lub https://localhost:8443.

Pamiętaj: w wersji Portable zamknięcie okna konsoli wyłącza serwer!

Przejdź teraz do sekcji: Pierwsze logowanie i konfiguracja.

Aktualizacja wersji Portable

Zatrzymaj panel (Ctrl+C), a następnie uruchom plik crafty_updater.exe znajdujący się w folderze programu. Program sam zajmie się resztą.

Metoda 2: Instalacja na Linux

Linux to naturalne środowisko dla serwerów Minecraft. Crafty Controller działa na nim niezwykle wydajnie, a systemy takie jak Ubuntu, Debian czy CentOS są oficjalnie wspierane. Masz do wyboru dwie drogi: automatyczna (skrypt) oraz manualną (dającą pełną kontrolę nad środowiskiem).

Metoda 1: Automatyczny Skrypt (Najszybsza)

Dla większości użytkowników najlepszym wyborem będzie oficjalny skrypt instalacyjny, który automatycznie skonfiguruje zależności, użytkownika systemowego oraz środowisko Python.

Aby go uruchomić, zaloguj się przez SSH do swojego serwera i wykonaj aktualizacje i zainstaluj nie zbędne pakiety:

sudo apt update && sudo apt upgrade && sudo apt install git -y

potem wklej w terminalu ten łańcuszek komend

git clone https://gitlab.com/crafty-controller/crafty-installer-4.0.git && cd crafty-installer-4.0 && sudo ./install_crafty.sh

Skrypt przeprowadzi Cię przez proces, zapyta o podstawowe ustawienia i zainstaluje Crafty jako usługę systemową.

1. Instalacja zależności: Skrypt wykryje Twój system operacyjny (np. Debian czy Ubuntu) i zapyta, czy zainstalować pakiety niezbędne do działania panelu. Wpisz y (od yes) i wciśnij Enter.

2. Katalog instalacyjny: Instalator zaproponuje domyślną lokalizację dla plików panelu (standardowo jest to /var/opt/minecraft/crafty). Najlepiej nic tu nie zmieniać – ponownie wpisz y.

3. Wybór wersji: Zostaniesz zapytany, którą wersję oprogramowania chcesz pobrać. Koniecznie wpisz master i zatwierdź Enterem. Jest to stabilna wersja programu (Opcja „dev” może zawierać błędy oraz testowe funkcje i rozwiązania — instalujesz ją na własną odpowiedzialność).

4. Usługa systemowa: Skrypt zapyta, czy utworzyć plik usługi dla systemd (Would you like to make a service file…). Koniecznie wpisz y. To najważniejszy krok, dzięki któremu Crafty będzie mogło działać w tle i uruchamiać się automatycznie po restarcie maszyny.

5. Gdy zatwierdzisz ostatni krok, instalator utworzy specjalnego użytkownika systemowego (crafty), skopiuje pliki i wyświetli zielony komunikat o zakończeniu pracy, podsumowując najważniejsze ścieżki i komendy.

Uruchamianie panelu po instalacji

Po zakończeniu instalacji możesz uruchomić Crafty ręcznie za pomocą poniższego skryptu. (Uwaga: jeśli podczas instalacji wybrałeś inny katalog niż domyślny, upewnij się, że podajesz poprawną ścieżkę):

sudo -u crafty /var/opt/minecraft/crafty/run_crafty.sh

Jeśli jednak podczas instalacji w kreatorze odpowiedziałeś twierdząco na pytanie o dodanie usługi do systemd (co jest zalecane), użyj poniższego polecenia. Uruchomi ono panel i ustawi jego automatyczny start po restarcie serwera:

sudo systemctl enable --now crafty

Panel będzie dostępny pod adresem https://twoje-ip:8443 lub https://localhost:8443.

Przejdź teraz do sekcji: Pierwsze logowanie i konfiguracja.

Aktualizacja Crafty Controller (Linux Skrypt)

Wersja instalowana ze skryptu posiada wbudowane narzędzie do aktualizacji. Wystarczy wpisać w terminalu poniższe polecenie:

sudo -u crafty /var/opt/minecraft/crafty/update_crafty.sh

Metoda 2: Instalacja ręczna (Krok po kroku)

Jeśli chcesz dokładnie wiedzieć, co dzieje się w Twoim systemie, lub instalujesz Crafty na niestandardowej konfiguracji, skorzystaj z poniższych kroków.

1. Przygotowanie zależności

Zależnie od Twojej dystrybucji, zainstaluj niezbędne pakiety (Python 3, Git oraz biblioteki budowania).

• Dla Ubuntu/Debian:

apt update && apt upgrade -y && apt install sudo git python3 python3-venv python3-dev python3-pip openjdk-25-jdk -y

• Dla CentOS / AlmaLinux:

sudo dnf groupinstall "Development tools" && sudo dnf install git python3 python3-devel java-17-openjdk java-17-openjdk-devel

2. Tworzenie użytkownika i pobieranie Crafty

Ze względów bezpieczeństwa nigdy nie uruchamiaj Crafty Controller z konta root. Zamiast tego, stwórz dedykowanego użytkownika o nazwie crafty i przydziel mu odpowiedni katalog domowy:

sudo useradd -m -d /var/opt/minecraft -s /bin/bash crafty

Następnie utwórz niezbędne katalogi, w których znajdzie się panel oraz Twój serwer Minecraft:

sudo mkdir -p /var/opt/minecraft/crafty /var/opt/minecraft/server

Konieczne jest również nadanie nowo utworzonemu użytkownikowi crafty pełnych uprawnień do tych folderów:

sudo chown -R crafty:crafty /var/opt/minecraft

3. Pobieranie plików źródłowego

Przeloguj się na utworzonego przed chwilą użytkownika crafty. Następnie przejdź do docelowego katalogu:

sudo su crafty

cd /var/opt/minecraft/crafty

Teraz pobierz najnowszą, czwartą wersję (v4) panelu Crafty prosto z oficjalnego repozytorium GitLab:

git clone https://gitlab.com/crafty-controller/crafty-4.git

4. Konfiguracja wirtualnego środowiska (Venv)

Crafty używa izolowanego środowiska Python, aby nie ingerować w pakiety systemowe. Będąc w głównym folderze (/var/opt/minecraft/crafty) i wciąż zalogowanym jako użytkownik crafty, utwórz środowisko (venv). Zrobimy to celowo obok folderu z kodem źródłowym, aby ułatwić przyszłe aktualizacje:

python3 -m venv venv

Aktywuj nowo utworzone wirtualne środowisko. Zauważysz, że na początku Twojej linii komend w terminalu pojawi się dopisek (venv):

source venv/bin/activate

Gdy środowisko jest już aktywne, wejdź do pobranego folderu z kodem źródłowym:

cd /var/opt/minecraft/crafty/crafty-4

Zaktualizuj narzędzie instalacyjne pip i od razu zainstaluj wszystkie biblioteki wymagane do działania panelu:

pip install --upgrade pip

pip install -r requirements.txt

6. Pierwsze uruchomienie

Teraz możesz sprawdzić, czy cały proces przebiegł poprawnie. Uruchom skrypt główny za pomocą polecenia:

python3 main.py

Po chwili powinieneś zobaczyć w konsoli komunikat potwierdzający, że panel jest uruchomiony i nasłuchuje pod adresem IP Twojego serwera na porcie 8443 (HTTPS). Jeśli widzisz ten komunikat, wszystko działa!

Naciśnij skrót Ctrl+C, aby zamknąć działający w konsoli proces, a następnie wpisz komendę exit, aby wylogować się z użytkownika crafty i wrócić na swoje główne konto systemowe (zazwyczaj root lub konto z sudo). Teraz możesz przejść do konfiguracji autostartu (Systemd).

Autostart Crafty: Konfiguracja Systemd

Aby Crafty Controller nie wyłączał się po zamknięciu konsoli i uruchamiało się automatycznie po każdym restarcie serwera, należy stworzyć specjalny plik usługi.

1. Utwórz plik, używając poniższej komendy:

sudo nano /etc/systemd/system/crafty.service

2. Wklej do poniższą zawartość:

[Unit]
Description=Crafty Controller
After=network.target

[Service]
Type=simple
User=crafty
WorkingDirectory=/var/opt/minecraft/crafty/crafty-4
ExecStart=/var/opt/minecraft/crafty/venv/bin/python3 main.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Zapisz plik (skrót Ctrl+O, następnie Enter) i zamknij edytor (Ctrl+X).

3. Przeładuj konfigurację menedżera usług systemd, aby wczytał nowy plik:

sudo systemctl daemon-reload

4. Aktywuj usługę i uruchom ją natychmiast:

sudo systemctl enable --now crafty

Przejdź teraz do sekcji: Pierwsze logowanie i konfiguracja.

Aktualizacja Crafty (przy instalacji manualnej)

Jeśli zainstalowałeś panel ręcznie, proces jego aktualizacji również należy przeprowadzić w konsoli. Zaloguj się na utworzonego użytkownika systemowego, którego wcześniej utworzyliśmy:

sudo su crafty

Przejdź do głównego katalogu aplikacji (folderu pobranego z repozytorium GitLab):

cd /var/opt/minecraft/crafty/crafty-4

Pobierz najnowsze poprawki z oficjalnego repozytorium:

git fetch && git pull

Wróć jeden katalog wyżej (do folderu /var/opt/minecraft/crafty):

cd ..

Aktywuj swoje wirtualne środowisko Pythona:

source venv/bin/activate

Wróć ponownie do folderu aplikacji:

cd crafty-4

Ostatnim krokiem jest aktualizacja wymaganych pakietów Python, która zignoruje pamięć podręczną, aby wymusić pobranie najnowszych plików:

pip3 install -r requirements.txt --no-cache-dir

Gotowe! Twoja aplikacja została zaktualizowana. Pamiętaj, aby po wszystkim zrestartować usługę systemową (jako zwykły użytkownik, wychodząc wcześniej z konta crafty komendą exit):

sudo systemctl restart crafty

Konfiguracja Firewalla (Bardzo ważne!)

Aby mieć dostęp do panelu z zewnątrz oraz pozwolić graczom na łączenie się z serwerami, musisz otworzyć odpowiednie porty w zaporze sieciowej. Jeśli używasz UFW (standard w systemach Ubuntu/Debian), wykonaj poniższe polecenia:

1. Panel Webowy Crafty (Port 8443 TCP)

sudo ufw allow 8443/tcp

2. Serwer Minecraft Java Edition (Port 25565 TCP)

sudo ufw allow 25565/tcp

3. Serwer Minecraft Bedrock / GeyserMC (Port 19132 UDP)

sudo ufw allow 19132/udp

Opcja alternatywna: Konfiguracja za pomocą iptables

Dla systemów, które nie korzystają z UFW (np. CentOS), porty należy otworzyć bezpośrednio w tabeli iptables. Wykonaj poniższe polecenia:

1. Panel Webowy Crafty (Port 8443 TCP)

sudo iptables -A INPUT -p tcp --dport 8443 -j ACCEPT

2. Serwer Minecraft Java Edition (Port 25565 TCP)

sudo iptables -A INPUT -p tcp --dport 25565 -j ACCEPT

3. Serwer Minecraft Bedrock / GeyserMC (Port 19132 UDP)

sudo iptables -A INPUT -p udp --dport 19132 -j ACCEPT

Pamiętaj o zapisaniu reguł!
Reguły wpisane bezpośrednio w konsoli iptables mają charakter tymczasowy i zostaną usunięte po ponownym uruchomieniu serwera. Aby zapisać je na stałe, musisz wykonać kolejny krok.

Dla systemów Ubuntu / Debian:
Najpierw zainstaluj paczkę odpowiadającą za zapisywanie ustawień, a następnie zapisz reguły:

sudo apt-get install iptables-persistent 

sudo netfilter-persistent save

Dla systemów CentOS:

service iptables save

Metoda 3: Instalacja na Docker – Zalecana

Użycie Dockera to najlepszy sposób na zachowanie porządku w systemie i łatwe aktualizacje. Jeśli nie masz jeszcze zainstalowanego tego środowiska, sprawdź napisany przeze mnie poradnik: Instalacja i konfiguracja Dockera w systemach Windows 10/11 i Linux (Arch linux, Ubuntu, Fedora).

Krok 1: Utworzenie katalogu roboczego

Stwórz folder dla Crafty i przejdź do niego:

mkdir crafty && cd crafty

Krok 2: Przygotowanie pliku docker-compose

Otwórz edytor tekstu, aby stworzyć plik konfiguracyjny docker compose:

nano docker-compose.yml

Wklej poniższą zawartość do pliku. Pamiętaj, aby zachować poprawne wcięcia!

version: '3'
services:
  crafty:
    container_name: crafty_controller
    image: registry.gitlab.com/crafty-controller/crafty-4:latest
    restart: always
    environment:
      - TZ=Europe/Warsaw
    ports:
      - "8443:8443" # HTTPS
      - "8123:8123" # DYNMAP
      - "19132:19132/udp" # BEDROCK
      - "25500-25600:25500-25600" # MC SERV PORT RANGE
    volumes:
      - /var/opt/docker/crafty/backups:/crafty/backups
      - /var/opt/docker/crafty/logs:/crafty/logs
      - /var/opt/docker/crafty/servers:/crafty/servers
      - /var/opt/docker/crafty/config:/crafty/app/config
      - /var/opt/docker/crafty/import:/crafty/import
    networks:
      - crafty_net

networks:
  crafty_net:
    driver: bridge

Zapisz plik (kombinacja Ctrl+O, następnie Enter) i wyjdź z edytora (Ctrl+X).

Krok 3: Uruchomienie Crafty

Wpisz komendę, która powoła kontener do życia w tle:

docker-compose up -d

Crafty pobierze teraz niezbędne obrazy z sieci i uruchomi panel. Będzie on dostępny w przeglądarce pod adresem: https://ip-twojego-serwera:8443.

przejdż teraz do punktu Pierwsze logowanie i konfiguracja

Pierwsze logowanie i konfiguracja

Gdy po raz pierwszy wejdziesz w przeglądarce pod adres swojego serwera (na port 8443), przejdziesz przez prosty proces logowania:

1. Ostrzeżenie HTTPS: Na start może pojawić się komunikat o “braku certyfikatu bezpieczeństwa” lub “niezaufanym połączeniu”. To całkowicie normalne przy pierwszych instalacjach na własnym adresie IP. Kliknij “Zaawansowane” i wybierz “Przejdź do strony (niebezpieczne)”.
2. Dane logowania: Panel poprosi Cię o podanie domyślnych danych autoryzacyjnych. Znajdziesz je w pliku tekstowym wygenerowanym podczas instalacji.
   • Dla instalacji manualnej lub skryptu instalacyjnego w Linuxie: Wpisz w terminalu komendę

cat /var/opt/minecraft/crafty/crafty-4/app/config/default-creds.txt

Zobaczysz tam wygenerowany login i hasło.

• Dla instalacji w Dockerze: Plik ten znajdziesz w podfolderze konfiguracyjnym, który zmapowaliśmy w docker-compose. Wpisz komendę

cat ./docker/config/default-creds.txt

3. Dashboard: Po pomyślnym wpisaniu hasła zostaniesz przeniesiony do głównego widoku (Dashboard).

Jak dodać pierwszy serwer Minecraft w Crafty?

1. W lewym panelu bocznym kliknij zakładkę “Servers”, a następnie wybierz opcję “Create a Server”.
2. Wybierz preferowany sposób instalacji:
   • Upload Zip Archive: Wybierz tę opcję, jeśli posiadasz już własną paczkę z plikami serwera na dysku.
   • Create New Server: Wybierz to, jeśli chcesz, aby Crafty automatycznie pobrało najnowszy silnik gry z sieci (obsługuje m.in. Paper, Spigot, Fabric, Forge oraz klasyczną Vanillę).
3. Wybierz docelową wersję gry (np. 1.20.4 lub najnowszą dostępną).
4. Wpisz nazwę dla swojego serwera i przydziel mu odpowiednią ilość pamięci operacyjnej (RAM),
5. Kliknij przycisk “Create Server” na dole strony.
6. Po krótkiej chwili (gdy panel pobierze pliki), przejdź do widoku swojego serwera i naciśnij zielony przycisk “Start”.

Ważne: Akceptacja EULA!
Podczas pierwszego uruchomienia serwera pojawi się okno z prośbą o akceptację regulaminu Mojang. Kliknij przycisk „YES”, a następnie po chwili uruchom serwer ponownie.

Podsumowanie

Crafty Controller to rewelacyjne rozwiązanie zarówno do hostowania małych serwerów dla paczki znajomych, jak i zarządzania bardziej zaawansowanymi projektami. Dzięki intuicyjnemu interfejsowi webowemu zadania takie jak zarządzanie plikami, instalacja pluginów, monitorowanie zasobów czy tworzenie automatycznych kopii zapasowych stają się banalnie proste.

Jeśli zależy Ci na najwyższej stabilności i planujesz, aby Twój serwer działał 24/7, zdecydowanie polecam instalację przez Dockera lub natywnie na systemie Linux. Z kolei jeśli potrzebujesz środowiska do szybkich testów na lokalnym komputerze, wersja Windows Portable sprawdzi się do tego idealnie.

Jeśli spodobał Ci się ten poradnik, zajrzyj do innych artykułów w kategorii Gry.
Masz pytania, natrafiłeś na błąd podczas instalacji lub coś jest niejasne? Daj znać w komentarzu poniżej, chętnie pomogę!