WarDogs agent

Agent mı, RCON adresi mi?

• Kiralık oyun sunucusu (xREALM, Nitrado, …): orada genelde program çalıştıramazsın. Dashboard'da, sağlayıcının gösterdiği RCON portuyla RCON adresi kullan.
• Kendi makinen (root sunucu, VPS, evdeki bir PC): agent'ı kullan. RCON 127.0.0.1 üzerinde kalabilir ve güvenlik duvarında hiçbir şey açılması gerekmez.
• Bir agent aynı makinedeki en fazla on oyun sunucusuna hizmet verebilir. Bir Discord'un beş agent'ı olabilir.

Adım adım

1. 1

   Sunucu config'inde RCON'u aç

   ServerSettings.ini içinde [/Script/WDRCON.WDRCONSettings] bölümünde RCON açık olmalı ve bir şifre olmalı. Agent ile sadece bu makinede dinleyebilir:

   [/Script/WDRCON.WDRCONSettings]
   bEnabled=true
   BindAddress=127.0.0.1
   Port=7776
   Password=choose-a-long-password

   Bu bölümü değiştirdikten sonra oyun sunucusunu yeniden başlat.

2. 2

   Agent'ı dashboard'da oluştur

   Sunucunu panelini içinde aç, Genel bakış → Doğrudan RCON ile → WarDogs agent yoluna git (zaten doğrudan bağlıysan Ayarlar → Bağlantı), makineye bir ad ver ve Agent oluştur'a bas. Dashboard, içinde token'ının olduğu başlatma komutunu gösterir. Token yalnızca bir kez gösterilir.

3. 3

   Sunucuda başlat

   Docker ile (Linux). --network host sayesinde 127.0.0.1 üzerindeki RCON'a ulaşır:

   docker run -d --name wardogs-agent --restart unless-stopped --network host \
     -e WARDOGS_TOKEN=wda_your_token \
     -e RCON_URL=http://127.0.0.1:7776 \
     -e RCON_PASSWORD=your-rcon-password \
     registry.wardogsbot.com/wardogs-agent:1

   Ya da diğer servislerinin yanında Docker Compose ile:

   services:
     wardogs-agent:
       image: registry.wardogsbot.com/wardogs-agent:1
       restart: unless-stopped
       network_mode: host
       environment:
         WARDOGS_TOKEN: wda_your_token
         RCON_URL: http://127.0.0.1:7776
         RCON_PASSWORD: your-rcon-password

   İmaj x86-64 ve ARM64 üzerinde Linux için derlenmiştir. Sürüm 1 düzeltmeleri aynı tag altında alır.

   Node.js ile 18 veya üstü (Linux ya da Windows), örneğin bir Windows oyun sunucusunun yanında:

   Invoke-WebRequest https://wardogsbot.com/api/agent/wardogs-agent.js -OutFile wardogs-agent.js
   $env:WARDOGS_TOKEN="wda_your_token"; $env:RCON_PASSWORD="your-rcon-password"
   node wardogs-agent.js

   Çalışır tut: Docker onu kendisi yeniden başlatır; Node.js ile bir servis, açılışta zamanlanmış görev ya da pm2 kullan.

4. 4

   Tamamlandı

   Birkaç saniye içinde dashboard agent'ı Çevrimiçi olarak gösterir ve sunucunu listeler. Durum paneli, moderasyon, ban'lar, whitelist, rotasyon, özetler ve sunucu config düzenleyicisi artık onun üzerinden çalışır.

Ayarlar

Güvenlik

• Agent sadece wardogsbot.com'a giden HTTPS istekleri yapar. Bağlantı bekleyen hiçbir şey yoktur.
• Yalnızca belirlediğin adreslerdeki oyunun RCON API'sine (/v1/ altındaki yollar) istek iletir. Makinedeki başka hiçbir şeye onun üzerinden ulaşılamaz.
• RCON şifresi agent'ın ortamında kalır. Biz agent token'ının yalnızca hash'ini saklarız.
• Script'in hiçbir bağımlılığı yok ve okunacak kadar kısa: wardogs-agent.js. Docker imajı, node:22-alpine üzerinde yetkisiz bir kullanıcıyla çalışan aynı script'tir. Yeni bir sürüm çıktığında dashboard sana söyler.
• Güncelleme: docker pull registry.wardogsbot.com/wardogs-agent:1, sonra docker rm -f wardogs-agent ve tekrar başlatma komutu (Compose: docker compose pull && docker compose up -d). Node.js ile script'i yeniden indir.
• Token sızdı mı? Yenisi için agent'ın yanındaki anahtar butonuna bas ya da agent'ı kaldır. Eski token anında geçersiz olur.

Sorun giderme

• “İlk başlatma bekleniyor”da kalıyor: agent wardogsbot.com'a ulaşamadı. Log'unu (docker logs wardogs-agent) ve giden HTTPS'i kontrol et.
• Çevrimiçi ama “oyun sunucusuna ulaşılamadı”: RCON kapalı, başka bir portta ya da sunucu kapalı. RCON_URL değerini kontrol et ve config değişikliklerinden sonra oyunu yeniden başlat.
• “agent'ta ayarlanan RCON şifresini kabul etmiyor”: RCON_PASSWORD, config'teki Password ile aynı değil.
• Agent log'unda “Token kabul edilmedi”: agent kaldırıldı ya da yeni bir token aldı. Güncel token ile başlat.
• Windows veya macOS'taki Docker'da host ağı yoktur: orada Node.js sürümünü çalıştır ya da RCON 0.0.0.0'a bağlıyken RCON_URL=http://host.docker.internal:7776 kullan.