client

# EndlessNet Client EndlessNet Client EndlessNet نیٹ ورک کے لیے بنیادی انفراسٹرکچر فراہم کرتا ہے، جو Linux، macOS اور Windows پر طویل المدتی ایجنٹ، کمانڈ لائن انٹرفیس (CLI)، اور سروس انٹیگریشن کے طور پر کام کرتا ہے۔ یہ اہم نیٹ ورک آپریشنز کو سنبھالتا ہے جن میں سائن شدہ سروس کیٹلاگ کی کھپت، L3 ایپلیکیشن روٹ مینجمنٹ، کنیکٹر ڈسکوری، اور پیکٹ انفورسمنٹ شامل ہیں۔ ## اہم خصوصیات - **کراس پلیٹ فارم سپورٹ**: Linux (Ubuntu/Debian)، Windows Server، اور macOS پر مقامی آپریشن۔ - **محفوظ نیٹ ورکنگ**: ڈیٹا کی سالمیت اور مجاز رسائی کو یقینی بنانے کے لیے سائن شدہ وائر کنٹریکٹس اور کنٹرول پلین HTTP تعاملات کو نافذ کرتا ہے۔ - **سروس انٹیگریشن**: `ipc/v2` عوامی حد کے ذریعے مقامی انٹر پروسیس کمیونیکیشن (IPC) کا انتظام کرتا ہے، سخت ٹرانسپورٹ کلائنٹس کو بے نقاب کرتا ہے جبکہ اندرونی حالت، شناخت، اور STUN نفاذات کو نجی رکھتا ہے۔ - **CLI اور آٹومیشن**: صارف کے تعامل کے لیے CLI پیش کرتا ہے، جس میں مخصوص کمانڈز سیکیورٹی پالیسیوں کے ذریعے محدود ہیں (مثلاً روٹ کی منظوری کے لیے ایڈمنسٹریشن کنسول درکار ہے)۔ - **مضبوط ٹیسٹنگ**: جامع CI پائپ لائنز شامل ہیں جو انسٹالیشن ٹیسٹ، بنیادی سروس قبولیت، ڈسکنیکٹ استقامت، اور الگ تھلگ ٹیسٹ سرورز کے خلاف حقیقی کلائنٹ کنٹریکٹ منظرناموں کا احاطہ کرتی ہیں۔ ## آرکیٹیکچر اور انحصار کلائنٹ اپنے API کنٹریکٹس کے لیے بیرونی ماڈیولز پر انحصار کرتا ہے: - **کنٹرول پلین API**: `github.com/endless-net/client-api/clientapi` سے ورژن شدہ DTOs اور کلائنٹس استعمال کرتا ہے۔ اس میں HTTP/ریکوری کنٹریکٹس (v1)، پروٹوبف پیغامات، اور Connect بائنڈنگز شامل ہیں۔ - **عوامی حد**: واحد بے نقاب Go پیکیج `ipc/v2` ہے، جو مقامی سروس IPC v2 کنٹریکٹس کو سنبھالتا ہے۔ ## بلڈ اور ریلیز ڈویلپرز معیاری Go ٹولز کا استعمال کرتے ہوئے کلائنٹ بناسکتے ہیں: ```bash go build ./cmd/endlessnet-client ./cmd/endlessnet-client-recovery-helper go test -short ./... ``` ریلیز GitHub Releases کے ذریعے Windows amd64 اور Linux amd64 کے لیے شائع کی جاتی ہیں، ساتھ ہی Debian/Ubuntu (amd64/arm64) کے لیے APT پیکیجز بھی۔ CI میٹرکس Ubuntu 22.04/24.04، Windows 2022/2025، اور macOS 15 پر مطابقت کو یقینی بناتا ہے۔ ## دستاویزات تفصیلی آپریشنل گائیڈز اور تکنیکی تفصیلات ریپوزٹری کی `docs` ڈائریکٹری میں دستیاب ہیں: - [`docs/ru/client-and-network.md`](docs/ru/client-and-network.md): روسی آرکیٹیکچر اور آپریشنز گائیڈ۔ - [`docs/service-discovery.md`](docs/service-discovery.md): سائن شدہ سروس کیٹلاگ کی کھپت کی تفصیلات۔ - [`docs/application-runtime.md`](docs/application-runtime.md): L3 روٹس اور پیکٹ انفورسمنٹ۔ - [`docs/installation-tests.md`](docs/installation-tests.md): انسٹالیشن اور قبولیت کے معیار۔ - [`docs/testing-control-plane.md`](docs/testing-control-plane.md): کنٹرول پلین منظرنامہ ٹیسٹنگ۔ - [`docs/client-ipc-v2.openapi.yaml`](docs/client-ipc-v2.openapi.yaml): مقامی سروس IPC کنٹریکٹ۔ - [`docs/client-ownership-recovery.md`](docs/client-ownership-recovery.md): ملکیت کی ریکوری کے عمل۔