Sieć serwerów z Velocity: lobby, survival i minigry pod jednym adresem

Velocity to proxy, dzięki któremu gracze łączą się z jednym adresem, a potem przechodzą między serwerami poleceniem /server – na przykład z lobby na survival albo na minigry. Pokażemy, jak zainstalować i skonfigurować Velocity, połączyć je z serwerami bezpiecznym modern forwardingiem i zabezpieczyć serwery za proxy tak, aby nikt nie dostał się na nie bezpośrednio.

Kiedy potrzebujesz proxy#

Proxy samo nie uruchamia gry, tylko przekazuje połączenia. Jest oszczędne: na dziesiątki graczy wystarczy 1–⁠2 GB pamięci.

Jak działa sieć#

Gracz ──► mc.example.cz:25565  (Velocity, weryfikuje konto gracza)
              │
              ├──► lobby     (Paper, online-mode=false, przyjmuje tylko proxy)
              ├──► survival  (Paper, online-mode=false, przyjmuje tylko proxy)
              └──► minihry   (Paper, online-mode=false, przyjmuje tylko proxy)

1. Gracz łączy się z adresem proxy. Proxy sprawdza w Microsofcie, czy ma oryginalne konto (online-mode = true).
2. Proxy wysyła go na pierwszy serwer z listy try (lobby).
3. Razem z połączeniem proxy przekazuje serwerowi nick gracza, UUID, skin i prawdziwy adres IP (player info forwarding). Dane podpisuje tajnym kluczem, który zna tylko proxy i Twoje serwery.
4. Serwery za proxy (backendy) same niczego nie weryfikują (online-mode=false) i ufają tylko proxy z ważnym kluczem. Kto połączy się bezpośrednio, dostanie komunikat This server requires you to connect with Velocity.

Proxy, serwery i domena#

• Proxy: Velocity 4.x wymaga Javy 25. Uruchom je na VPS (VPS Performance, VPS Budget). Na proxy należą tylko pluginy dla Velocity – pluginy dla Papera na nim nie działają.
• Backendy: zwykłe serwery Minecraft. Mogą działać w StormHost jako osobne usługi (każda z własnym adresem i portem) albo na tym samym VPS co proxy.
• Domena (opcjonalnie): gracze wpisują mc.example.cz zamiast IP (Adres serwera i domena).

Instalacja Velocity na VPS#

Działa tak samo na Ubuntu 24.04 i na Debianie 13. Polecenia uruchamiaj jako root.

1. Zainstaluj Javę 25 i curl:

   apt update
   apt install openjdk-25-jre-headless curl

   • apt update – pobiera aktualną listę pakietów.
   • apt install openjdk-25-jre-headless – instaluje środowisko uruchomieniowe Javy 25 bez bibliotek graficznych (serwer ich nie potrzebuje).
   • curl – program do pobierania plików z internetu (jeśli już go masz, nic się nie stanie).

2. Sprawdź wersję:

   java -version

   Pierwsza linia wyniku musi zawierać 25.

3. Utwórz użytkownika i folder dla proxy:

   useradd --system --create-home --home-dir /opt/velocity --shell /usr/sbin/nologin velocity

   • useradd --system – tworzy użytkownika systemowego bez hasła (proxy nie będzie działać jako root).
   • --create-home --home-dir /opt/velocity – tworzy folder /opt/velocity, w którym będzie proxy.
   • --shell /usr/sbin/nologin – nikt nie może zalogować się jako ten użytkownik.
   • velocity – nazwa użytkownika.

4. Na papermc.io/downloads/velocity (otwiera się w nowym oknie) skopiuj link do najnowszej stabilnej wersji i pobierz ją:

   cd /opt/velocity
   curl -o velocity.jar "<DOWNLOAD_URL>"
   chown velocity:velocity velocity.jar

   • cd /opt/velocity – przechodzi do folderu proxy.
   • curl -o velocity.jar – pobiera plik i zapisuje go jako velocity.jar.
   • <DOWNLOAD_URL> – link skopiowany ze strony. Zastąp całość łącznie z nawiasami ostrymi, cudzysłowy zostaw.
   • chown velocity:velocity – ustawia użytkownika velocity jako właściciela pliku.

5. Uruchom proxy po raz pierwszy, aby utworzyło konfigurację:

   runuser -u velocity -- env MALLOC_ARENA_MAX=2 java -Xms1G -Xmx1G -XX:MaxDirectMemorySize=512M -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -jar velocity.jar

   • runuser -u velocity -- – uruchamia polecenie za -- jako użytkownik velocity.
   • env MALLOC_ARENA_MAX=2 – ogranicza areny pamięci alokatora, aby proxy nie zużywało niepotrzebnie dodatkowej pamięci.
   • -Xms1G -Xmx1G – daje proxy 1 GB sterty (od razu całość, aby nie musiało jej powiększać w trakcie działania). Dla większej sieci zwiększ do 2G. Proxy potrzebuje dużo pamięci także poza stertą na sieć, więc nie dawaj mu więcej niż połowę pamięci, którą masz dla niego przeznaczoną.
   • -XX:MaxDirectMemorySize=512M – limit dla buforów sieciowych. Bez niego mogą urosnąć do rozmiaru sterty.
   • -XX:+UseG1GC … -XX:+AlwaysPreTouch – parametry zalecane przez dokumentację Velocity (garbage collector G1 dostrojony dla proxy).
   • -jar velocity.jar – uruchamia proxy.

   Generator skryptu startowego przygotuje polecenie dla innego rozmiaru pamięci.

   Po starcie zobaczysz linię Done (…)!. Wpisz end i naciśnij Enter, a proxy się wyłączy. W folderze są teraz velocity.toml i forwarding.secret.

6. Aby proxy działało stale i samo uruchamiało się po restarcie VPS, utwórz dla niego usługę systemd według poradnika Aplikacja 24/7 na VPS. W pliku unit ustaw User=velocity, WorkingDirectory=/opt/velocity, Environment=MALLOC_ARENA_MAX=2, a w ExecStart wpisz polecenie z kroku 5 bez runuser -u velocity -- env MALLOC_ARENA_MAX=2 i z pełną ścieżką do Javy, czyli zaczynające się od /usr/bin/java -Xms1G ….

7. Zezwól na port proxy w zaporze VPS: TCP 25565 (i port UDP Geysera, jeśli będziesz go używać). Zobacz Zapora w strefie klienta i UFW.

velocity.toml#

Otwórz /opt/velocity/velocity.toml (na przykład nano /opt/velocity/velocity.toml). Oto przykład z ustawieniami dla sieci trzech serwerów (resztę pliku zostaw bez zmian):

bind = "0.0.0.0:25565"
motd = "<gold><bold>StormCraft</bold></gold> <gray>| lobby, survival, minihry"
show-max-players = 100
online-mode = true
force-key-authentication = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "203.0.113.10:30066"
survival = "203.0.113.11:30067"
minihry = "203.0.113.12:30068"

try = [
    "lobby"
]

[forced-hosts]
"survival.example.cz" = [
    "survival"
]

W sekcjach [advanced] i [query] warto zwrócić uwagę na trzy pozycje:

Tajny klucz forwardingu#

Przy pierwszym starcie Velocity tworzy plik forwarding.secret z losowym 12-⁠znakowym kluczem. Zalecamy zastąpić go dłuższym:

1. W generatorze haseł wygeneruj losowe hasło o długości co najmniej 32 znaków (litery i cyfry).
2. Wpisz je jako jedyną linię do /opt/velocity/forwarding.secret (na przykład przez nano).
3. Ten sam klucz wpiszesz potem na wszystkich backendach.

Konfiguracja backendów (Paper i Purpur)#

Na każdym serwerze za proxy:

1. W zakładce Ustawienia serwera w grupie Gracze wyłącz Weryfikacja kont (online-mode) (online-mode=false) i kliknij Zapisz.

   Strefa klienta pokaże ostrzeżenie, że dołączyć może każdy. Za proxy z modern forwardingiem to prawidłowe – weryfikację robi proxy, a serwer przyjmuje tylko graczy z ważnym kluczem.

2. W zakładce Pliki otwórz spigot.yml i sprawdź, czy settings.bungeecord ma wartość false:

   settings:
     bungeecord: false

   • bungeecord – włącza forwarding w formacie BungeeCord (legacy). Przy modern forwardingu musi być wyłączony.

3. Otwórz config/paper-global.yml i w sekcji proxies ustaw:

   proxies:
     velocity:
       enabled: true
       online-mode: true
       secret: "<SECRET>"

   Zamiast <SECRET> wpisz zawartość pliku forwarding.secret z proxy. Zastąp całość łącznie z nawiasami ostrymi, cudzysłowy zostaw.

4. Uruchom serwer ponownie.

Co oznaczają ustawienia w paper-global.yml:

Na Paperze 1.18.2 i starszym te ustawienia są w paper.yml pod nazwami settings.velocity-support.enabled, settings.velocity-support.online-mode i settings.velocity-support.secret.

Fabric, Forge i NeoForge#

Ustawienia FabricProxy-Lite:

Zabezpieczenie backendów#

Backend z online-mode=false bez działającego forwardingu wpuściłby każdego pod dowolnym nickiem. Zależnie od tego, gdzie działają Twoje serwery:

• Backendy w StormHost (osobne usługi): adres i port ustawiamy automatycznie (server-ip nie da się zmienić), więc serwery są osiągalne z internetu. Chroni je właśnie modern forwarding: przy proxies.velocity.enabled: true serwer odrzuci każdego, kto nie przyjdzie przez proxy z ważnym kluczem. Nigdy więc nie używaj legacy ani none.
• Backendy na tym samym VPS co proxy: w server.properties każdego backendu ustaw server-ip=127.0.0.1, a w velocity.toml użyj adresów 127.0.0.1:<PORT>. Serwery nie będą wtedy w ogóle osiągalne z zewnątrz. W zaporze VPS zezwól tylko na port proxy.
• Backendy na innym VPS: w zaporze backendu zezwól na port serwera tylko z adresu IP proxy (Zapora w strefie klienta).

Przełączanie serwerów i pluginy na proxy#

Pluginy na proxy (w folderze /opt/velocity/plugins, wersje dla Velocity):

• LuckPerms – uprawnienia do poleceń proxy. Do uprawnień na serwerach LuckPerms musi być także na każdym backendzie, a wszystkie instancje muszą używać tej samej bazy MySQL/MariaDB (MySQL dla pluginów). Na każdym backendzie ustaw w konfiguracji LuckPerms inny server (na przykład lobby, survival), aby móc nadawać uprawnienia per serwer, oraz messaging-service: sql, aby zmiany działały od razu na wszystkich serwerach. Szczegóły w poradniku LuckPerms.
• Geyser i Floodgate – gracze Bedrocka; instaluj je tylko na proxy (poradnik).
• spark – profilowanie proxy, polecenie sparkv.

Sprawdzenie, czy działa#

1. Uruchom proxy i backendy. Konsola proxy pokaże Listening on …:25565 i Done (…)!.
2. Połącz się w grze z adresem proxy. Trafisz na serwer lobby.
3. Wpisz /server survival – przełączy Cię bez rozłączania.
4. W konsoli backendu sprawdź linię z Twoim połączeniem: musi zawierać Twój prawdziwy adres IP, a nie adres proxy. Wtedy forwarding działa. W domyślnym Trybie streamera konsola strefy klienta ukrywa adresy IP – do tego sprawdzenia kliknij u góry Pokaż szczegóły.
5. Spróbuj połączyć się bezpośrednio z adresem backendu. Musisz dostać This server requires you to connect with Velocity.

Rozwiązywanie problemów#

Your server did not send a forwarding request to the proxy. Make sure the server is configured for Velocity forwarding.#

Backend nie ma włączonego modern forwardingu. Sprawdź proxies.velocity.enabled: true w config/paper-global.yml (na Fabricu FabricProxy-Lite) i czy po zmianie uruchomiłeś serwer ponownie.

Unable to verify player details#

Klucz na backendzie nie zgadza się z forwarding.secret na proxy. Skopiuj go ponownie (bez zbędnych spacji i pustych linii) i uruchom backend ponownie.

This server requires you to connect with Velocity.#

Łączysz się bezpośrednio z backendem – tak ma być, serwer jest chroniony. Jeśli widzisz ten komunikat także przy łączeniu przez proxy, proxy ma player-info-forwarding-mode ustawione na coś innego niż modern.

Unable to connect you to lobby. Please try again later.#

Proxy nie dotarło do backendu: serwer nie działa, adres lub port w [servers] nie zgadza się z adresem w zakładce Sieć tego serwera albo połączenie blokuje zapora.

There are no available servers to connect you to. Try again later or contact an admin.#

Żaden z serwerów z listy try nie jest dostępny. Uruchom lobby albo dodaj do try serwer zapasowy.

Gracze mają po przejściu na proxy pusty ekwipunek i inne uprawnienia#

Gracze dostali inne UUID. Przyczyną jest player-info-forwarding-mode = "none" (offline UUID) albo niezgodność online-mode na proxy i proxies.velocity.online-mode na backendzie. Ustaw modern forwarding i obie wartości na true. Dane pod starymi UUID zostają w świecie i plikach pluginów; przed przeniesieniem dużej sieci na proxy zrób kopię zapasową.

Proxy nie wpuszcza graczy Bedrocka albo nie mogą pisać#

Zobacz Crossplay z Bedrockiem: Geyser musi być na proxy, a force-key-authentication w velocity.toml musi być wyłączone.

Dalsza lektura#

• Velocity: pierwsze kroki (otwiera się w nowym oknie)
• Velocity: przekazywanie informacji o graczach (otwiera się w nowym oknie)
• Velocity: konfiguracja (otwiera się w nowym oknie)
• Velocity: zabezpieczenie serwerów (otwiera się w nowym oknie)
• Paper: konfiguracja globalna (otwiera się w nowym oknie)
• LuckPerms: instalacja w sieci serwerów (otwiera się w nowym oknie)