Edge Gateway, fabrika sahanızda çalışan fiziksel veya sanal ajandır. Endüstriyel varlıklarınız ile Merkezi Sunucu arasında yerel veri toplayıcı, işleyici ve tampon görevi görür.
Neden Gateway Kullanmalıyız?
- Ağ Segmentasyonu: OT ağınızı buluttan izole tutun. Gateway güvenli bir köprü görevi görür.
- Protokol Çevirisi: Farklı endüstriyel protokolleri (Siemens, Modbus, OPC UA vb.) birleşik bir dahili formata dönüştürün.
- Veri Tamponlama: Ağ hatası durumunda, Gateway verileri yerel olarak önbelleğe alır ve bağlantı yeniden sağlandığında iletir (Sakla ve İlet).
Gateway Türleri
Her Proxus kurulumu varsayılan bir gateway ile başlar, ancak binlerce uzak konuma ölçeklenebilirsiniz.
- SYSTEM Gateway (ID 1): Kurulum sırasında otomatik olarak oluşturulur. Merkezi Sunucu ile aynı yerde (aynı Docker ağında) çalışır. Dahili sistem görevleri veya yerel veri alımı için kullanılır.
- Uzak Gateway'ler (ID 2+): Makinelerinizin yakınındaki uzak endüstriyel PC'lere (IPC'ler), sunuculara veya VM'lere dağıttığınız ajanlardır.
Uzak Bir Gateway Dağıtma
Bir gateway'i uzak bir Linux makinesine (Docker kurulu) dağıtmak için şu adımları izleyin:
Gateway Kaydı Oluşturun
- Yönetim Konsolunda Data Management > Edge Gateways (Veri Yönetimi > Uç Gateway'ler) menüsüne gidin.
- New (Yeni) butonuna tıklayın.
- Bir isim verin (örneğin, "Fabrika A - Hat 1") ve Save (Kaydet) butonuna tıklayın.
Dağıtımı Yapılandırın
- Detay Görünümünü açmak için yeni oluşturulan gateway'e tıklayın.
- Ekranın üst kısmındaki "Deploy to Edge" butonuna tıklayın.
- Bir konfigürasyon iletişim kutusu görünecektir. Burada aşağıdaki parametreleri ayarlayabilirsiniz:
- Cluster Address Type: Sunucu adresinin nasıl çözümleneceğini seçin.
LocalAddress, yalnızca uç host sunucunun yerel IP'sine gerçekten erişebiliyorsa çalışır. Uzak, VPN, NAT veya çoklu subnet dağıtımlarında routable ya da DNS tabanlı bir adres tercih edin. - Cluster Address: Gateway'in geri bağlanacağı tam adres. Seçtiğiniz türle ve ağ yoluyla eşleştiğini mutlaka kontrol edin.
- Service Port: Gateway servisinin dinleyeceği port (varsayılan:
8083). - Target Architecture: Donanımınıza göre seçin (örneğin,
Amd 64veyaArm 64).
- Cluster Address Type: Sunucu adresinin nasıl çözümleneceğini seçin.
Komutu Çalıştırın
- İletişim kutusundan oluşturulan Komutu kopyalayın.
- Uzak Linux makinenize giriş yapın (Docker'ın kurulu olduğundan emin olun).
- Komutu yapıştırın ve çalıştırın (
sudo sh -s <<'SH'ile başlar).
İlk kırpım, uzak kurulumlarda en çok önem taşıyan alanları gösteren genel görünüm.

- LocalAddress yalnızca uç host sunucunun yerel IP'sine gerçekten erişebiliyorsa çalışır.
- Uzak, VPN, NAT veya çoklu subnet kurulumlarında LocalAddress yerine routable ya da DNS adres kullanın.
- UI açılsa bile hub tarafındaki NATS leaf portuna erişim yoksa gateway bağlı kalmaz. Uç stack'in hub leaf listener'ına varsayılan olarak 7422 üzerinden ulaşabilmesi gerekir.
- Uç makinede 8083 (edge servisi) ve 1883 (embedded MQTT broker) portlarının boş olduğundan emin olun.
- Sunucu firewall veya reverse proxy arkasındaysa hem adresi hem de portu kontrol edin.
Bu yakın plan, uzak kurulumlarda en çok hata yaptıran alanı gösteriyor.

- Deploy to Edge seçeneğini, başka bir makinede çalışacak gateway için kullanın. Yerel SYSTEM gateway zaten sunucuyla birlikte kurulur.
- Cluster Address hedef makineden erişilebilir olmalı.
- Seçtiğiniz Target Architecture, hedef host'un gerçek CPU mimarisi ile aynı olmalı.
- Hedef makinede boş bir Service Port kullanın.
- Oluşturulan komut bu gateway kaydına bağlıdır. Gateway adını, adresini veya mimariyi değiştirirseniz komutu yeniden üretin.

Dağıtım komutu hedef makineyi otomatik hazırlar:
- Gateway için gerekli dosyaları yazar.
- Bu gateway kaydına ait yerel ayarları oluşturur.
- Edge servisi konteynerini Docker Compose ile başlatır.
- İletişim kutusunda seçtiğiniz değerlerle Gateway'i Merkezi Sunucuya bağlar.
Bağlantıyı Doğrulayın
Betik tamamlandıktan sonra Yönetim Konsoluna dönün. Gateway durumu, gerçek zamanlı CPU, bellek ve disk tanılamalarını göstererek Yeşil (Çevrimiçi) olmalıdır.
Bağlanmazsa Ne Kontrol Etmeli
Gateway dağıtımdan sonra bağlı kalmıyorsa önce şunlara bakın:
- Hedef makine, iletişim kutusunda seçtiğiniz Merkezi Sunucu adresine ulaşabiliyor mu?
- Hub'ın leaf-node portu (varsayılan 7422) hedef makineden erişilebilir mi?
- Gateway için seçtiğiniz port hedef host üzerinde başka bir servis tarafından kullanılıyor mu?
- Gateway mimarisi host CPU ile uyumlu mu?
- Gateway makinesi ile sunucu/broker ağı arasında firewall, VPN veya NAT engeli var mı?
Yönetim Konsolunda Data Management > Edge Gateways bölümüne dönün, gateway kaydını açın ve durumun Connected olduğunu, son görülme zamanının güncellendiğini doğrulayın.
NATS bağlantısını ve EdgeGateway kimliğini Proxus-config.toml dosyasındaki NATS ve Edge Gateway bölümlerinden yapılandırın.
Sorun mu Yaşıyorsunuz?
Gateway'iniz bağlanmıyorsa veya beklenmedik davranışlar gösteriyorsa, Gateway Bağlanmıyor veya MQTT Broker Sorunları bölümlerine bakın.