# Ağ portları ve uç noktalar

> Merkez sunucunun, Edge Gateway'lerin ve Docker kurulumundaki servislerin dinlediği portlar ve bu portlardaki HTTP uç noktaları.

Kaynak: https://proxus.io/tr/docs/reference/ports

Bu sayfada bir Proxus kurulumunun her bileşeninin hangi portu dinlediği listelenir. Varsayılan portlar yapılandırma
dosyasından ve kurulumla gelen Docker Compose dosyasından alınmıştır. Güvenlik duvarı kurallarını yazarken bu
listeyi kullanın. Hangi portlara sunucunun dışından erişilmesi gerektiği
[Güvenliği sıkılaştırma](https://proxus.io/tr/docs/operate/security) sayfasında anlatılır.

## Merkez sunucu

| Port | Protokol | Ayar | Kullanan |
| --- | --- | --- | --- |
| 8443 | HTTPS | `[Service] UI-HTTPS-Port` | Tarayıcılar, API istemcileri, MCP istemcileri ve Edge Gateway kurulumu. Varsayılan olarak açıktır; değer boş bırakılırsa kapanır. |
| 8080 | HTTP | `[Service] UI-Port` | 8443 ile aynı erişimi şifresiz sağlar; yerel kullanım içindir. `[Service] RedirectHttpToHttps = "true"` ile istekler HTTPS'ye yönlendirilir. |
| 4222 | TLS üzerinden NATS | `[NATS] BrokerUrl` | Merkez sunucunun kendi süreçleri ve **SYSTEM** Edge Gateway'i. |
| 7422 | TLS üzerinden NATS | | Başka makinelerde çalışan Edge Gateway'ler. |
| 6222 | TLS üzerinden NATS | | Yalnızca Kubernetes HA kurulumunda: kümedeki NATS sunucuları birbirine pod adıyla bağlanır. |
| 8222 | HTTP | | NATS izleme. Yalnızca iç kullanım içindir. |

NATS portları, merkez sunucunun NATS sunucusu olan `hub-server` konteynerine aittir. Her NATS bağlantısında sunucunun sertifikası
platform CA'sına göre doğrulanır. Ayrıntılar için [Sertifikalar](https://proxus.io/tr/docs/administer/certificates) sayfasına bakın.

Merkez sunucunun HTTP ve HTTPS portlarındaki uç noktalar:

| Yol | İşlevi | Oturum açma |
| --- | --- | --- |
| `/` | Merkez sunucunun ekranları. | kullanıcı |
| `/api/Authentication/Authenticate` | Erişim anahtarı verir. Bkz. [REST API](https://proxus.io/tr/docs/develop/rest-api). | gerekmez |
| `/api/odata/...` | Nesneleri okur ve değiştirir. | erişim anahtarı ya da tarayıcı oturumu |
| `/api/Telemetry/execute` | Kayıtlı değerleri sorgular. Bkz. [Telemetry API](https://proxus.io/tr/docs/develop/telemetry-api). | erişim anahtarı |
| `/swagger` | Etkileşimli API açıklaması. OpenAPI dosyası `/swagger/v1/swagger.json` adresindedir. | görüntülemek için gerekmez |
| `/mcp` | Yapay zekâ asistanları için MCP sunucusu. Bkz. [MCP sunucusu](https://proxus.io/tr/docs/develop/mcp). | MCP içinden oturum açılır |
| `/edge/<token>` | Yeni bir Edge Gateway'in kurulum betiği. Tek kullanımlıktır ve bir saat geçerlidir. Bkz. [Edge Gateway kurma](https://proxus.io/tr/docs/connect/edge-gateways/install-a-gateway). | adresteki erişim anahtarı |
| `/edge/uninstall/<gateway ID>` | Bir Edge Gateway'in kaldırma betiği. | gerekmez |
| `/healthz` | Merkez sunucu çalışıyorsa `Healthy` döndürür. Yük dengeleyiciler ve konteyner çalışma durumu denetimleri bu adresi kullanır. | gerekmez |
| `/metrics` | Prometheus metrikleri. Yalnızca `[Metrics] Enable` ya da `[Tracing] Enable` `true` ise açılır. | gerekmez |

## Edge Gateway

Merkez sunucunun kendi **SYSTEM** Edge Gateway'i da dahil olmak üzere her Edge Gateway şu portları dinler:

| Port | Protokol | Ayar | Kullanan |
| --- | --- | --- | --- |
| 8883 | TLS üzerinden MQTT | `[MQTTBroker] TlsPort` | UNS aboneleri ve kendi değerlerini yayınlayan cihazlar. Bağlantı, Edge Gateway'in sertifikasıyla şifrelenir. Port, merkez sunucu sertifikayı verdikten sonra açılır. `0` değeri portu kapatır. Bkz. [MQTT ve UNS konuları](https://proxus.io/tr/docs/develop/mqtt). |
| 1883 | MQTT | `[MQTTBroker] MQTTBrokerPort` | 8883 ile aynı erişimi TLS olmadan sağlar; TLS kullanamayan cihazlar içindir. `[MQTTBroker] PlainEnabled = false` portu kapatır. |
| 8083 | HTTP | `[Service] Server-Port` | Çalışma durumu denetimleri ve geçmiş veri aktarımı. |
| ayarlanmamış | HTTPS | `[Service] Server-HTTPS-Port` | 8083 ile aynı erişimi, merkez sunucunun verdiği Edge Gateway sertifikasıyla şifreli olarak sağlar. Yalnızca bu ayara bir port girildiğinde açılır. |

Edge Gateway'in HTTP portundaki uç noktalar:

| Yol | İşlevi | Oturum açma |
| --- | --- | --- |
| `/healthz` | Edge Gateway çalışıyorsa `Healthy` döndürür. | gerekmez |
| `/api/v1/devices/<ID>/historical/batches` | Geçmiş veri aktarımı. Bkz. [Geçmiş veri aktarımı](https://proxus.io/tr/docs/develop/historical-import). | `X-IoT-Token` başlığında cihazın erişim anahtarı |
| `/metrics` | Prometheus metrikleri. Yalnızca `[Metrics] Enable` ya da `[Tracing] Enable` `true` ise açılır. | gerekmez |

Edge Gateway, gereken bağlantıları kendisi açar: TLS üzerinden merkez sunucunun NATS sunucusuna, kurulum sırasında 8443
portundan merkez sunucuya, okuduğu cihazlara ve veri hedeflerine. Merkez sunucudan kurulan Edge Gateway'ler NATS için 7422
leaf portunu, merkez sunucunun kendi Edge Gateway'i ise 4222'yi kullanır. Cihazlar ve hedefler Edge Gateway'e bağlantı açmaz.
Tek istisna, Edge Gateway'in MQTT sunucusuna kendi değerlerini yayınlayan cihazlardır. Merkez sunucudan kurulan bir uç
cihaz, bulunduğu makinede 8883, 1883 ve servis portu 8083'ü dışarı açar.

## Docker kurulumundaki servisler

Kurulumla gelen `docker-compose.yml` dosyası, sunucuda şu portları dışarı açar:

| Konteyner | Sunucudaki port | İşlevi |
| --- | --- | --- |
| `proxus-ui` | 8080, 8443 | HTTP ve HTTPS üzerinden merkez sunucu. |
| `proxus-server` | 8083, 1883, 8883 | Merkez sunucunun Edge Gateway'i (**SYSTEM**): HTTP, MQTT ve TLS üzerinden MQTT. |
| `hub-server` | 4222 | TLS üzerinden NATS. Merkez sunucu ile kendi Edge Gateway'i arasındaki mesajlaşma bağlantısı. |
| `hub-server` | 7422 | TLS üzerinden NATS leaf bağlantıları. Başka makinelerdeki Edge Gateway'ler bu porta bağlanır. |
| `hub-server` | 8222 | NATS izleme sayfası (HTTP). |
| `postgresql` | 5442 | PostgreSQL yapılandırma veritabanı. |
| `clickhouse` | 8123 | HTTP üzerinden ClickHouse. Veri noktası değerleri ve günlükler bu veritabanında tutulur. |
| `clickhouse` | 9000 | ClickHouse'un kendi protokolü. |
| `clickhouse` | 9004 | ClickHouse'un MySQL uyumlu protokolü. Raporlar bu portu kullanır. |
| `clickhouse` | 9005 | ClickHouse'un PostgreSQL uyumlu protokolü. |

> **Uyarı:**
Kullanıcıların erişmesi gereken tek port 8443'tür. Başka makinelerdeki Edge Gateway'lerin ise 7422 ve 8443 portlarına
erişmesi gerekir. Veritabanı portlarını (5442, 8123, 9000, 9004, 9005), 4222'yi ve 8222'yi sunucunun dışına kapalı
tutun. Sunucunun dışından bu portlara ihtiyaç duyan bir sistem yoksa bunları Compose dosyasından da kaldırabilirsiniz.

## Edge Gateway'in bağlandığı portlar

Bir cihazda **Port** alanı boş bırakılırsa Edge Gateway, protokolün varsayılan portunu kullanır. Örneğin Modbus TCP için
502, Siemens S7 için 102, EtherNet/IP için 44818 kullanılır. Tam liste [Protokoller](https://proxus.io/tr/docs/reference/protocols)
sayfasındadır.

## Sonraki adımlar

- [Yapılandırma anahtarları](https://proxus.io/tr/docs/reference/configuration): portları belirleyen ayarların tam listesi.
- [Docker](https://proxus.io/tr/docs/operate/docker): hazır Compose dosyasıyla yığını başlatma ve tesise göre ayarlama.
- [Güvenliği sıkılaştırma](https://proxus.io/tr/docs/operate/security): hangi portların dışarıya açılacağına karar verme.
