Velocity Proxy ile Network Kurulumu: Eksiksiz Rehber

# Velocity Nedir?

Velocity, PaperMC ekibi tarafından geliştirilen modern bir Minecraft proxy yazılımıdır. Birden fazla Minecraft sunucusunu tek bir IP altında birleştirerek oyuncuların sunucular arasında sorunsuz geçiş yapmasını sağlar. BungeeCord'un modern, güvenli ve performanslı alternatifidir.

# BungeeCord vs Velocity Karşılaştırması

# Velocity Kurulumu

Velocity için ayrı bir kullanıcı ve dizin oluşturun. Proxy, backend sunuculardan bağımsız çalışır.

# Gereksinimler

• Java 17 veya üzeri
• Minimum 512 MB RAM (proxy için)
• Ayrı port (varsayılan: 25577)
• Backend sunucular için ek RAM ve portlar

# İndirme ve İlk Başlatma

İlk başlatmadan sonra aşağıdaki dosyalar oluşur:

# Dizin Yapısı

~/velocity/
├── velocity-3.4.0.jar        # Ana proxy dosyası
├── velocity.toml              # Ana yapılandırma
├── forwarding.secret          # Modern forwarding anahtarı
├── server-icon.png            # Sunucu listesi ikonu (64x64)
├── plugins/                   # Velocity eklentileri
└── logs/                      # Log dosyaları

# velocity.toml Yapılandırması

velocity.toml, proxy'nin tüm davranışını belirleyen ana config dosyasıdır. Her ayarı detaylı inceliyoruz:

# Genel Ayarlar

# velocity.toml — Genel ayarlar
bind = "0.0.0.0:25577"
motd = "&b&lKEYDAL &fNetwork &7| &aSunucumuza hoş geldiniz!"
show-max-players = 500
online-mode = true
force-key-presence = true
player-info-forwarding-mode = "modern"

# Sunucu Tanımları

[servers] bölümünde backend sunucuları tanımlarsınız. Her sunucu bir isim ve IP:port çiftinden oluşur.

[servers]
lobby = "127.0.0.1:25565"
survival = "127.0.0.1:25566"
skyblock = "127.0.0.1:25567"
creative = "127.0.0.1:25568"

# Oyuncu ilk bağlandığında sırayla denenecek sunucular
try = ["lobby"]

# Forced Hosts

Farklı alan adları ile farklı sunuculara doğrudan yönlendirme yapabilirsiniz:

[forced-hosts]
"play.example.com" = ["lobby"]
"survival.example.com" = ["survival"]
"skyblock.example.com" = ["skyblock"]
"creative.example.com" = ["creative"]

Tüm alan adları DNS'te aynı sunucu IP'sine ve Velocity portuna (25577) yönlenmelidir. Velocity, gelen hostname'e göre doğru backend'e yönlendirir.

# DNS A kayıtları (hepsi aynı IP'ye)
play.example.com       A    185.x.x.x
survival.example.com   A    185.x.x.x
skyblock.example.com   A    185.x.x.x

# SRV kaydı (port 25577 ise gerekli)
_minecraft._tcp.play.example.com  SRV  0 0 25577 play.example.com

# Gelişmiş Ayarlar

[advanced]
compression-threshold = 256
compression-level = -1
login-ratelimit = 3000
connection-timeout = 5000
read-timeout = 30000
haproxy-protocol = false
tcp-fast-open = false
bungee-plugin-message-channel = true
show-ping-requests = false
failover-on-unexpected-server-disconnect = true
announce-proxy-commands = true
log-command-executions = false
log-player-connections = true

# Backend Sunucu Ekleme

Her backend sunucu bağımsız bir Paper/Purpur instance'ıdır. Farklı portlarda çalışır ve kendi config dosyaları vardır.

# Backend Dizin Yapısı

~/servers/
├── lobby/                 # Port 25565
│   ├── paper.jar
│   ├── server.properties
│   └── config/paper-global.yml
├── survival/              # Port 25566
│   ├── paper.jar
│   ├── server.properties
│   └── config/paper-global.yml
└── skyblock/              # Port 25567
    ├── paper.jar
    ├── server.properties
    └── config/paper-global.yml

# server.properties Ayarları

Her backend sunucunun server.properties dosyasında şu ayarlar kritiktir:

# Modern Forwarding Yapılandırması

Modern forwarding, Velocity'nin HMAC tabanlı güvenli IP/UUID iletim sistemidir. Backend sunucular oyuncunun gerçek IP'sini, UUID'sini ve skin bilgilerini güvenli şekilde alır.

# Adım 1: Velocity Tarafı

# velocity.toml
player-info-forwarding-mode = "modern"

Bu ayar zaten varsayılan olarak mevcuttur. forwarding.secret dosyası ilk başlatmada otomatik oluşur.

# Adım 2: Secret'ı Kopyalama

Bu anahtarı her backend sunucuya kopyalamanız gerekir.

# Adım 3: Paper Backend Yapılandırması

Her backend sunucuda config/paper-global.yml dosyasını düzenleyin:

# config/paper-global.yml
proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "aB3dEf7GhI9jKlMnOpQrStUvWxYz12"   # forwarding.secret ile birebir aynı

# Forwarding Modları Karşılaştırması

# Sunucular Arası Geçiş

Oyuncuların sunucular arasında geçiş yapması için Velocity yerleşik komutlar sunar:

Sunucu seçim menüsü (GUI) için LobbyAPI, HubCommand veya ServerSelectorX gibi eklentiler kullanabilirsiniz.

# Güvenlik

Network kurulumunda güvenlik kritiktir. Yanlış yapılandırma UUID spoofing, unauthorized erişim ve DDoS saldırılarına kapı açar.

# Firewall: Sadece Proxy Portunu Aç

Kural: Dışarıya sadece Velocity portu (25577) ve SSH (22) açık olmalı. Backend portları (25565-25567) dışarıdan erişilemez olmalı.

# Backend 25565 Kapat

Backend sunucuların server.properties dosyasında server-ip=127.0.0.1 ayarı ile sadece localhost'tan bağlantı kabul etmelerini sağlayın:

# Her backend sunucunun server.properties dosyasında:
server-ip=127.0.0.1
online-mode=false

# IPWhitelist

Backend sunucularda sadece Velocity'nin IP'sinden gelen bağlantıları kabul etmek için IPWhitelist eklentisi kullanabilirsiniz:

• Backend sunuculara IPWhitelist eklentisini kurun
• Config'de sadece 127.0.0.1 (veya Velocity'nin IP'si) izin verin
• Doğrudan bağlanan herkes reddedilir

# DDoS Koruması

• TCPShield — Ücretsiz Minecraft DDoS koruması, reverse proxy
• Cloudflare Spectrum — Ücretli, enterprise düzey TCP proxy
• OVH Game DDoS Protection — OVH sunucularda yerleşik
• Velocity yerleşik rate limiting — login-ratelimit: 3000 ayarı ile brute force engeli

# LuckPerms Network Kurulumu

Network'te yetki yönetimi için LuckPerms'ü tüm sunuculara kurmanız ve ortak bir veritabanı kullanmanız gerekir. Böylece yetkiler tüm sunucularda senkron çalışır.

# MySQL Veritabanı Kurulumu

# LuckPerms Config (Her Sunucuda)

Velocity, lobby, survival ve tüm backend sunuculardaki LuckPerms config.yml dosyasında:

# plugins/LuckPerms/config.yml (tüm sunucularda aynı)
storage-method: mysql

data:
  address: localhost:3306
  database: luckperms
  username: luckperms
  password: 'guclu_sifre_buraya'
  pool-settings:
    maximum-pool-size: 10

# Sunucular arası anlık senkronizasyon
messaging-service: sql

# Network Bazlı Yetkiler (Context)

LuckPerms context sistemi ile belirli sunuculara özel yetkiler atayabilirsiniz:

# Sadece survival sunucusunda fly yetkisi
lp user Oyuncu permission set essentials.fly true server=survival

# Sadece creative sunucusunda gamemode yetkisi
lp group vip permission set essentials.gamemode true server=creative

# Tüm sunucularda geçerli yetki (context belirtilmezse)
lp group default permission set essentials.home true

# Başlatma Scripti

Tüm sunucuları tek komutla başlatmak için bir bash script oluşturun:

#!/bin/bash
# start-network.sh

echo "=== KEYDAL Network Başlatılıyor ==="

# Backend sunucuları screen ile başlat
echo "[1/4] Lobby başlatılıyor..."
screen -dmS lobby bash -c 'cd ~/servers/lobby && java -Xms1G -Xmx1G -XX:+UseG1GC -jar paper.jar --nogui'
sleep 8

echo "[2/4] Survival başlatılıyor..."
screen -dmS survival bash -c 'cd ~/servers/survival && java -Xms4G -Xmx4G -XX:+UseG1GC -jar paper.jar --nogui'
sleep 8

echo "[3/4] Skyblock başlatılıyor..."
screen -dmS skyblock bash -c 'cd ~/servers/skyblock && java -Xms2G -Xmx2G -XX:+UseG1GC -jar paper.jar --nogui'
sleep 8

# Velocity proxy'yi en son başlat
echo "[4/4] Velocity başlatılıyor..."
screen -dmS velocity bash -c 'cd ~/velocity && java -Xms512M -Xmx512M -XX:+UseG1GC -jar velocity.jar'

echo ""
echo "=== Tüm sunucular başlatıldı! ==="
echo "Bağlanmak için: screen -r <isim>"
echo "  screen -r lobby"
echo "  screen -r survival"
echo "  screen -r skyblock"
echo "  screen -r velocity"

# Systemd Service

Sunucu yeniden başladığında Velocity'nin otomatik açılması için systemd service oluşturun:

# /etc/systemd/system/velocity.service
[Unit]
Description=Velocity Minecraft Proxy
After=network.target

[Service]
User=minecraft
Group=minecraft
WorkingDirectory=/home/minecraft/velocity
ExecStart=/usr/bin/java -Xms512M -Xmx512M -XX:+UseG1GC -jar velocity.jar
Restart=on-failure
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=velocity

[Install]
WantedBy=multi-user.target

# Sık Yapılan Hatalar ve Çözümleri

# Önerilen Velocity Eklentileri

# Faydalı Kaynaklar