Velocity-proxy draait, maar spelers kunnen niet joinen

Uw Velocity-proxy staat in het panel op running, maar spelers kunnen niet joinen of worden gekickt met “Unable to connect”. In de meeste gevallen is de oorzaak een poortprobleem. Deze gids behandelt de meest voorkomende oorzaken en hoe u elk punt oplost.

Hoe de poorten werken

Een Velocity-netwerk gebruikt meer dan één poort, en elke poort moet kloppen:

Onderdeel	Wat het is	Standaardpoort
Velocity-proxy	De server waar spelers naartoe verbinden. Dit is het enige adres dat u aan spelers geeft.	`25577` (in `velocity.toml`)
Backend-server (Paper, lobby, survival, enz.)	De servers achter de proxy. Spelers moeten hier niet rechtstreeks naartoe.	Een vrije poort, bijvoorbeeld `25566`

Spelers verbinden met Velocity, en Velocity verbindt met de backend-servers. Als de poort in een stap fout is, faalt de verbinding.

Snelle checklist

Loop deze punten in volgorde na:

De proxypoort in velocity.toml komt overeen met de poort die het panel aan deze server heeft toegewezen.
Geen andere server gebruikt dezelfde poort.
De backend-adressen in velocity.toml gebruiken het juiste IP en de juiste poort.
De backend-server is online.
Forwarding-modus en secret komen overeen op de proxy en de backends.
De poort is open in de firewall.
Spelers gebruiken het juiste adres (en de poort, als die niet 25565 is).

Oorzaak 1: De poort in velocity.toml komt niet overeen met de allocatie

De bind-regel in velocity.toml moet de poort gebruiken die uw host aan deze server heeft gegeven. Bij een andere poort draait de proxy, maar niemand bereikt hem.

Stop de server.
Open in het panel het tabblad Network en noteer de poort die als Primary is gemarkeerd. Dat is de poort waarmee spelers uw server bereiken. (U ziet hem ook in het serveradres op de Console-pagina.)
Open de File Manager en bewerk velocity.toml.
Zoek de bind-regel en zet de poort goed:
```
bind = "0.0.0.0:25577"
```
Vervang 25577 door uw toegewezen poort.
Sla het bestand op en start de server.

Let op: Laat het IP op 0.0.0.0. Wijzig alleen het getal na de dubbele punt.

Oorzaak 2: Poortconflict (“Address Already in Use”)

Als twee servers dezelfde poort proberen, start er één niet, of start hij wel maar accepteert hij geen verbindingen. Het panel kan de server meteen na het starten als gestopt tonen met een exitcode.

Voorbeeld van wat u in de console kunt zien (tijden en nummers wijken af):

[20:14:02 INFO]: Booting up Velocity 3.4.0...
[20:14:03 ERROR]: Unable to bind to /0.0.0.0:25577
java.net.BindException: Address already in use
[Pterodactyl Daemon]: Server marked as offline...
[Pterodactyl Daemon]: ---------- Detected server process in a crashed state! ----------
[Pterodactyl Daemon]: Exit code: 1
[Pterodactyl Daemon]: Out of memory: false

Logregel	Wat het betekent
`Address already in use`	Een ander programma of een andere server gebruikt deze poort al.
`Exit code: 1`	Het proces is gestopt door een fout. Hier: het poortconflict.
`Out of memory: false`	Dit is geen geheugenprobleem.

Hoe u het oplost:

Zorg dat geen andere service of plugin dezelfde poort als de proxy gebruikt. Inclusief plugins of mods met een eigen poort, zoals Geyser, Dynmap, Plan of een webpanel.
De proxy moet de Primary-poort uit het panel gebruiken. Open het tabblad Network, kijk welke poort als Primary staat, en zet precies die poort in de bind-regel van velocity.toml:
```
bind = "0.0.0.0:25577"
```
Vervang 25577 door uw Primary-poort.
Als u extra poorten heeft, kunt u in het tabblad Network een andere poort toevoegen of wisselen, die als Primary zetten en bind in velocity.toml bijwerken.
Herstart de server.

Oorzaak 3: Verkeerd backend-adres in velocity.toml

Spelers kunnen met de proxy verbinden, maar worden gekickt met een melding zoals “Unable to connect you to lobby” of “Could not connect to a default or fallback server.” Velocity kan uw backend-server niet bereiken.

Open velocity.toml en controleer het blok [servers]:

[servers]
lobby = "203.0.113.10:25566"
survival = "203.0.113.10:25567"

try = ["lobby"]

Controleer elk punt:

IP en poort kloppen voor die backend-server.
De naam in try = [...] komt exact overeen met een naam in de [servers]-lijst.
De backend-server is online in het panel.

Voorbeeld van console-output als de backend niet bereikbaar is (de tekst kan per versie verschillen):

[20:31:44 INFO]: [connected player] Player1 (/198.51.100.23:40417) has connected
[20:31:46 ERROR]: [server connection] Player1 -> lobby: Connection refused: /203.0.113.10:25566
[20:31:46 INFO]: [connected player] Player1 (/198.51.100.23:40417) has disconnected: Could not connect to a default or fallback server, please try again later.

Logregel	Wat het betekent
`Connection refused`	Er luistert niets op dat IP en die poort. De backend is offline of de poort is fout.
`Connection timed out` (als u dit in plaats daarvan ziet)	De firewall blokkeert de poort, of het IP is fout.
`Could not connect to a default or fallback server`	Velocity bereikte geen server in de `try`-lijst.

Oorzaak 3: Forwarding-modus of secret komt niet overeen

Als de poort klopt maar spelers alsnog worden gekickt, kunnen de forwarding-instellingen tussen proxy en backend niet overeenkomen.

Op de Velocity-proxy (velocity.toml):

online-mode = true
player-info-forwarding-mode = "modern"

Velocity bewaart het secret in een bestand forwarding.secret in de proxymap.

Op elke Paper-backend-server:

Zet in server.properties:
```
online-mode=false
```

Zet in config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "paste-the-contents-of-forwarding.secret-here"

Sla op en herstart de backend-server.

Het secret moet exact dezelfde tekst zijn als in forwarding.secret.

Melding	Wat het betekent
`Unable to verify player details`	Het secret komt niet overeen, of forwarding is anders ingesteld op proxy en backend.
`This server requires you to connect with Velocity.`	De speler joinde de backend rechtstreeks in plaats van via de proxy.

Oorzaak 4: Spelers gebruiken het verkeerde adres

Spelers moeten verbinden met het proxy-adres, niet met een backend-adres.
Als de proxy op een andere poort dan 25565 draait, moet het adres de poort bevatten, bijvoorbeeld play.example.com:25577 of 203.0.113.10:25577.
Bij een domeinnaam controleert u of die naar het juiste IP wijst. Als spelers zonder poort moeten joinen, vraag uw host of DNS-provider naar een SRV-record.
Test eerst met IP en poort. Werkt dat wel maar het domein niet, dan is de DNS-record het probleem.

Werkt het nog steeds niet?

Open een supportticket en voeg toe:

Uw Velocity-versie en de Minecraft-versie van de backends
De bind-regel en het blok [servers] uit velocity.toml
De laatste 30 tot 50 regels van de console wanneer een speler probeert te joinen
Het serveradres waarmee u verbindt