इस प्रोजेक्ट के बारे में

शेल्टर एक ओपन-सोर्स डिप्लॉयमेंट इंफ्रास्ट्रक्चर टूल है जो एक single VPS को पूर्ण-विशेषताओं वाले डिप्लॉयमेंट प्लेटफ़ॉर्म में बदल देता है। यह डेवलपर्स और ऑपरेटरों के लिए है जो प्रबंधित होस्टिंग प्लेटफ़ॉर्म की सुविधा चाहते हैं, साथ ही अपने इंफ्रास्ट्रक्चर, डेटा और क्रेडेंशियल्स का पूर्ण स्वामित्व बनाए रखना चाहते हैं। **डिप्लॉयमेंट स्रोत:** शेल्टर कई डिप्लॉयमेंट स्रोतों का समर्थन करता है जिनमें GitHub रिपॉजिटरी (न्यूनतम स्कोप वाले GitHub App के माध्यम से, जिसमें वैकल्पिक push-to-deploy सुविधा है), सार्वजनिक HTTPS Git URLs, ZIP फ़ाइल अपलोड, और स्थानीय फ़ोल्डर अपलोड शामिल हैं। स्रोत अपलोड चंक्ड, मान्य और वर्शन किए जाते हैं। **बिल्ड और सक्रियण:** प्लेटफ़ॉर्म स्रोत से कंटेनर इमेज बनाता है, प्रोजेक्ट-पृथक नेटवर्क पर कैंडिडेट हेल्थ चेक करता है, और केवल सत्यापन के बाद उत्पादन ट्रैफ़िक को स्विच करता है। बिल्ड्स एक समर्पित Docker BuildKit बिल्डर का उपयोग करते हैं जिसमें मेमोरी, स्वैप, CPU, PID और अधिकतम समानता के लिए कॉन्फ़िगर करने योग्य संसाधन सीमाएं होती हैं। **रूटिंग और नेटवर्किंग:** डोमेन और एडमिन पैनल एक प्रबंधित Cloudflare Tunnel के माध्यम से प्रकाशित होते हैं, जिससे सार्वजनिक होस्ट पोर्ट की आवश्यकता समाप्त हो जाती है। Traefik HTTP रूटिंग को संभालता है, और प्रति-प्रोजेक्ट ब्रिज नेटवर्क प्रोजेक्ट अलगाव सुनिश्चित करते हैं। TLS Cloudflare Edge पर समाप्त होता है। **Cloudflare इंटीग्रेशन:** Cloudflare के साथ गहरा एकीकरण - OAuth प्रमाणीकरण, टनल प्रबंधन, DNS, ज़ोन प्रबंधन, होस्टनेम उपलब्धता जांच, और प्रति प्रोजेक्ट मल्टी-डोमेन समर्थन। API टोकन और OAuth दोनों प्रवाहों का समर्थन करता है। **ऑपरेटर सुविधाएँ:** डैशबोर्ड जिसमें डिप्लॉयमेंट लॉग्स, रोलबैक, प्रोजेक्ट CRUD, एन्क्रिप्टेड पर्यावरण चर, संसाधन सीमाएं, लाइव रनटाइम लॉग्स, और प्रति-प्रोजेक्ट अवलोकनीयता शामिल हैं। सफल वेबसाइट डिप्लॉयमेंट्स के लिए स्वचालित स्क्रीनशॉट पूर्वावलोकन। **स्वचालन:** स्कोप किए गए, समाप्त होने वाले व्यक्तिगत एक्सेस टोकन, OpenAPI विशिष्टता के साथ एक प्रलेखित HTTP API, और प्रोग्रामेटिक नियंत्रण के लिए एक स्थापनीय CLI टूल। **सुरक्षा:** आर्किटेक्चर API (जिसके पास Docker socket नहीं है) को वर्कर (जिसके पास Docker socket पहुंच है) से अलग करता है, एन्क्रिप्टेड रहस्यों का उपयोग करता है, और हटाई गई कैपेबिलिटीज़ वाले डिस्पोजेबल हेल्थ-चेक कंटेनरों का उपयोग करता है। यह एक थ्रेट मॉडल स्वीकार करता है कि यह विश्वसनीय एप्लिकेशन कोड के लिए डिज़ाइन किया गया है, न कि शत्रुतापूर्ण मल्टी-टेनेंट परिदृश्यों के लिए। **स्थापना:** Ubuntu 24.04/26.04 LTS VPS के लिए बूटस्ट्रैप स्क्रिप्ट जिसमें स्वचालित निर्भरता स्थापना, गैर-इंटरैक्टिव प्रोविज़निंग समर्थन, और स्वास्थ्य जांच के लिए एक डॉक्टर कमांड शामिल है। पैनल बूटस्ट्रैप और SSH के माध्यम से आपातकालीन पहुंच के लिए 127.0.0.1 से बंधा रहता है। यह प्रोजेक्ट AGPL-3.0-only के तहत लाइसेंस प्राप्त है और वर्तमान में MVP स्थिति में है। इसे TypeScript, Node.js 24+, Docker Compose v2, और Cloudflare Tunnel के साथ बनाया गया है।