Platypus

लिनक्स मशीनों के बेड़े के लिए एक होस्ट प्रबंधन केंद्र। अपनी प्रत्येक मशीन पर Platypus एजेंट स्थापित करें; एजेंट TLS + protobuf के माध्यम से आपके Platypus सर्वर पर वापस कॉल करता है; सर्वर से आपको प्रत्येक प्रबंधित होस्ट पर एक इंटरैक्टिव शेल, फ़ाइल प्रबंधन और नेटवर्क टनलिंग मिलती है - एक केंद्रीय नियंत्रण तल के माध्यम से।

स्क्रीनशॉट

एक Vercel-शैली फ्लैट-नेव UI जिसमें एक प्रोजेक्ट डैशबोर्ड, एक होस्ट/लिसनर/सेशन ब्राउज़र, एक मल्टी-होस्ट डिस्पैच कंसोल और एक व्यवस्थापक उपयोगकर्ता प्रबंधक शामिल है। पूरी गैलरी docs/screenshots/ पर देखें। लाइव ऐप से उन्हें फिर से जनरेट करने के लिए make screenshots चलाएँ।

आर्किटेक्चर

Platypus दो बैकएंड बाइनरी और एक स्टैंडअलोन डेस्कटॉप क्लाइंट के रूप में आता है:

बाइनरी	भूमिका
platypus-server	डेमन। TLS इनग्रेस पोर्ट्स पर इनबाउंड एजेंट कनेक्शन स्वीकार करता है; एडमिन टूलिंग के लिए REST + WebSocket API प्रस्तुत करता है; वितरण के लिए एजेंट बाइनरी प्रस्तुत करता है।
platypus-agent	वह प्रक्रिया जो प्रत्येक प्रबंधित होस्ट पर चलती है। TLS + protobuf के माध्यम से सर्वर पर वापस कॉल करती है।
platypus-desktop	नेटिव (Wails v2) डेस्कटॉप GUI। URL + सीक्रेट के साथ किसी भी पहुँच योग्य सर्वर से कनेक्ट करें; टैब वाला UI सेशन, टर्मिनल, लिसनर, फ़ाइलें, टनल। desktop/ देखें।

सर्वर पूरी तरह से एक API है - इसमें कोई एम्बेडेड वेब UI नहीं है। एकाधिक डेस्कटॉप एक साथ एक ही सर्वर से कनेक्ट हो सकते हैं।

विशेषताएँ

• एजेंट और सर्वर के बीच TLS + protobuf चैनल
• एकाधिक इनग्रेस पोर्ट ताकि विभिन्न नेटवर्कों में बेड़े एक केंद्र साझा कर सकें
• प्रति होस्ट इंटरैक्टिव शेल, WebSocket पर स्ट्रीम किया गया
• फ़ाइल पढ़ना/लिखना/अपलोड/डाउनलोड चंक्ड ट्रांसफर के साथ
• नेटवर्क टनल: स्थानीय-पोर्ट-फ़ॉरवर्ड, रिमोट-पोर्ट-फ़ॉरवर्ड, डायनामिक SOCKS5
• बियरर-टोकन-प्रमाणित REST API
• Python SDK
• config.yml से ऑटो-स्टार्ट लिसनर
• ग्रेसफुल शटडाउन (30 सेकंड के भीतर SIGINT/SIGTERM पर कनेक्शन ड्रेन करता है)

दस्तावेज़

• Chinese | 中文文档

त्वरित प्रारंभ

एक-क्लिक परिनियोजन (अनुशंसित)

पूर्ण Platypus सिस्टम (सर्वर, Web UI और MinIO-समर्थित एजेंट वितरक सहित) चलाने का सबसे तेज़ तरीका Docker Compose का उपयोग करना है:

git clone https://github.com/WangYihang/Platypus
cd Platypus
docker-compose up -d

• Web UI: अपने ब्राउज़र में https://localhost:9443 खोलें (कंटेनर स्व-हस्ताक्षरित प्रमाणपत्र के साथ आता है; पहली यात्रा पर ब्राउज़र आपको इसे स्वीकार करने के लिए संकेत देगा)।
• लॉगिन: bootstrap_secret पहले बूट पर कंटेनर के अंदर /app/data/bootstrap.secret (मोड 0600) पर लिखा जाता है। इसे docker compose exec platypus-server cat /app/data/bootstrap.secret के साथ पढ़ें, पहला एडमिन बनाने के लिए एक बार उपयोग करें, फिर फ़ाइल हटा दें। बूटस्ट्रैप पूरा होने के बाद सीक्रेट अब स्वीकार नहीं किया जाएगा।
• एजेंट जोड़ें: UI में "Add Agent" पर क्लिक करें ताकि एक-पंक्ति curl ... | sh कमांड प्राप्त हो, जो प्रोजेक्ट CA द्वारा हस्ताक्षरित और पिन की गई है, ताकि आपके बेड़े में एजेंट तैनात हो सकें।

स्रोत से निर्माण

Go 1.24+ और protoc की आवश्यकता है (केवल यदि आप protobuf कोड को पुन: उत्पन्न करते हैं)।

git clone https://github.com/WangYihang/Platypus
cd Platypus
make build              # → ./build/{platypus-server,platypus-agent}

अन्य उपयोगी लक्ष्य: make test, make lint, make snapshot (goreleaser के माध्यम से क्रॉस-प्लेटफ़ॉर्म), make help।

विकास (प्री-कमिट हुक)

योगदानकर्ताओं को git हुक स्थापित करने चाहिए ताकि प्रत्येक कमिट से पहले gofmt / goimports / go vet / golangci-lint चलें:

pip install pre-commit   # या: pipx install pre-commit
make hooks               # एक बार: .git/hooks/pre-commit वायर करता है
make pre-commit          # वैकल्पिक: अब सभी फ़ाइलों पर सभी हुक चलाएँ

डेस्कटॉप ऐप बनाएँ

Node 22+, Wails CLI निर्भरताएँ (wails doctor), और प्लेटफ़ॉर्म की WebView लाइब्रेरीज़ (Linux पर webkit2gtk-4.1, Windows पर WebView2, macOS पर WKWebView) की आवश्यकता है।

make desktop-deps       # एक बार: Wails CLI + pnpm पैकेज स्थापित करता है
make desktop-build      # → desktop/build/bin/platypus-desktop
make desktop-dev        # हॉट-रिलोड डेव मोड

या: स्टैंडअलोन वेब UI का उपयोग करें (कोई इंस्टॉल नहीं)

समान पृष्ठ, समान सुविधाएँ (रीयल-टाइम इवेंट पुश के बिना), किसी भी ब्राउज़र में चलता है:

make web-ui             # → desktop/frontend/dist-web/ (स्टैटिक बंडल)
make web-ui-serve       # http://localhost:8080 पर पूर्वावलोकन

dist-web/ पूरी तरह से स्टैटिक है; इसे GitHub Pages / S3 / nginx पर रखें। लॉगिन फ़ॉर्म के माध्यम से इसे किसी भी platypus-server पर इंगित करें।

पूर्ण नोट desktop/README.md में।

रिलीज़ बाइनरी से स्थापित करें

रिलीज़ पृष्ठ से अपने OS/arch के लिए उपयुक्त संग्रह डाउनलोड करें, निकालें और चलाएँ।

Docker के साथ चलाएँ

docker build -t platypus-server .
docker run --rm -p 9443:9443 \
  -e PLATYPUS_DEV=1 \
  -v $(pwd)/config.yml:/config.yml \
  platypus-server

PLATYPUS_DEV=1 ऑन-डिस्क KEK फ़ॉलबैक को सक्षम करता है ताकि एक ताज़ा प्रारंभ "बस काम करे"; उत्पादन के लिए, उस env var को हटा दें और इसके बजाय PLATYPUS_CA_KEK (32 बाइट्स हेक्स; openssl rand -hex 32) सेट करें ताकि CA निजी-कुंजी एन्क्रिप्शन कुंजी कभी एन्क्रिप्टेड डेटाबेस के बगल में न लिखी जाए।

चलाएँ

./build/platypus-server                # अग्रभूमि; ग्रेसफुल शटडाउन के लिए Ctrl-C

उत्पादन के लिए, सर्वर को मैन्युअल रूप से बैकग्राउंड करने के बजाय systemd के तहत चलाएँ।

उत्पादन सावधानियाँ