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` से संस्करणित DTO और क्लाइंट उपभोग करता है। इसमें HTTP/रिकवरी अनुबंध (v1), protobuf संदेश और Connect बाइंडिंग शामिल हैं। - **सार्वजनिक सीमा**: एकमात्र उजागर Go पैकेज `ipc/v2` है, जो स्थानीय सेवा IPC v2 अनुबंधों को संभालता है। ## बिल्ड और रिलीज़ डेवलपर्स मानक Go टूल का उपयोग करके क्लाइंट का निर्माण कर सकते हैं: ```bash go build ./cmd/endlessnet-client ./cmd/endlessnet-client-recovery-helper go test -short ./... ``` रिलीज़ Windows amd64 और Linux amd64 के लिए GitHub Releases के माध्यम से प्रकाशित की जाती हैं, साथ ही 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): स्वामित्व रिकवरी प्रक्रियाएँ।