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

होमलैब इन्वेंटरी एक सेल्फ-होस्टेड वेब एप्लिकेशन है जो होमलैब हार्डवेयर को दस्तावेज़ करने, इकट्ठा करने, सत्यापित करने और निगरानी करने के लिए है। इसे एक Docker इमेज (mriverodorta/homelab-inventory) के रूप में वितरित किया जाता है और यह सभी स्थिति को एक निरंतर /data वॉल्यूम में संग्रहीत करता है, जिसमें इन्वेंटरी, टेलीमेट्री और कैटलॉग डेटा के लिए SQLite डेटाबेस शामिल हैं। README में वर्णित मुख्य क्षमताएँ: - भौतिक दस्तावेज़ीकरण: इंस्टॉलेशन को परियोजनाओं में व्यवस्थित करें, जिनमें प्रत्येक के लिए एक निश्चित Systems दृश्य और एक या अधिक पुनर्व्यवस्थित, रंग-कोडेड Canvas वर्कस्पेस हों। अनंत कैनवास पर सर्वर, NAS उपकरण, कस्टम PCs, मॉनिटर, स्विच, पैच पैनल, UPS सिस्टम और पावर स्ट्रिप्स रखें। पुन: उपयोग योग्य CPUs, मदरबोर्ड, कूलिंग, RAM, स्टोरेज, GPUs, वायर्ड या रेडियो नेटवर्क एडैप्टर्स, साउंड कार्ड्स, केसेस और पावर सप्लाई से होस्ट्स को इकट्ठा करें। नेटवर्क, डिस्प्ले और पावर एंडपॉइंट्स को रंग-कोडेड, ऑर्थोगोनली रूटेड केबल्स के साथ कनेक्ट करें और किसी भी एंडपॉइंट से प्रत्येक कनेक्शन का निरीक्षण करें। एक खोजने योग्य डेस्कटॉप या मोबाइल इन्वेंटरी ड्रॉअर बनाने, डुप्लिकेट करने, आर्काइव करने, पुनर्स्थापित करने और सुरक्षित हटाने का समर्थन करता है। - संगतता सत्यापन: CPU सॉकेट, पीढ़ी और पावर सीमाओं; मेमोरी पीढ़ी, क्षमता, गति, ECC, DIMM/SO-DIMM फिट और स्लॉट आवंटन; स्टोरेज बे और इंटरफेस; और PCIe, M.2, Mini PCIe, USB, OCP, मेज़ेनिन, ऑनबोर्ड और प्रोप्राइटरी इंटरफेस में विस्तार स्लॉट फिट की जाँच करता है। परिणामों को Compatible, Incompatible या Unknown के रूप में वर्गीकृत किया जाता है, जिसमें निर्धारित संसाधन आवंटन, असंगतता चेतावनियाँ और अपूर्ण डेटा चेतावनियाँ शामिल होती हैं। निष्कर्षों की समीक्षा या उपेक्षा की जा सकती है, और जानबूझकर अपवादों के लिए होस्ट-वार जाँचों को अक्षम किया जा सकता है। - हार्डवेयर कैटलॉग और टेम्पलेट्स: एक वैकल्पिक हस्ताक्षरित हार्डवेयर कैटलॉग को श्रेणी और हार्डवेयर-विशिष्ट फ़िल्टर द्वारा स्थानीय रूप से खोजा जा सकता है, जिसमें सत्यापित टेम्पलेट पुनरावृत्तियों से जुड़े आयात होते हैं। कैटलॉग अपडेट को लागू करने से पहले समीक्षा की जाती है, जबकि स्थानीय नाम, आवंटन, कैनवास स्थिति, केबल्स और केवल-इंस्टेंस फ़ील्ड्स को सुरक्षित रखा जाता है। इंस्टॉलेशन एक हस्ताक्षरित कैटलॉग स्नैपशॉट के साथ पूरी तरह से ऑफ़लाइन चल सकते हैं या चेकसम वाले JSON आयात/निर्यात के साथ निजी टेम्पलेट्स का उपयोग कर सकते हैं। वैकल्पिक सैनिटाइज़ किए गए योगदान सीरियल्स, पतों, लेबल्स, आवंटन, टोपोलॉजी और एजेंट प्रमाण को बाहर करते हैं। - होस्ट निगरानी: systemd Linux, Alpine/OpenRC, FreeBSD या OPNsense होस्ट्स पर एक आउटबाउंड-ओनली Agent को नामांकित किया जा सकता है, जो एक-मिनट की सेहत, हृदयस्पंदन इतिहास, CPU, मेमोरी, अपटाइम और OS विवरण रिपोर्ट करता है। प्रारंभिक स्नैपशॉट के बाद लाइव उपयोग और Inspector टेलीमेट्री एक प्रमाणीकृत सर्वर-सेंट इवेंट स्ट्रीम के माध्यम से आते हैं। स्थानीय संग्रहण उपयोग को भौतिक उपकरण और माउंट पॉइंट द्वारा निरीक्षण किया जाता है, जिसमें विभाजन तालिकाएँ और LVM या RAID टोपोलॉजी शामिल हैं। स्थानीय रूप से इंस्टॉल किए गए सेवाओं को खोजा जा सकता है, जिसमें ऑप्ट-इन सीमित Docker या Podman कंटेनर टेलीमेट्री शामिल है। एक अलग समीक्षित हार्डवेयर स्कैन पता लगाए गए मानों को एक समय में एक फ़ील्ड पर Undo समर्थन के साथ लागू कर सकता है। वैकल्पिक Ntfy या जेनेरिक वेबहुक अलर्ट होस्ट आउटेजेज और चयनित सेवा, कंटेनर या भौतिक-स्टोरेज परिवर्तनों को कवर करते हैं, जिसमें शांत घंटे, रिमाइंडर, पुनः प्रयास और स्थायी घटना इतिहास शामिल हैं। - प्रमाणीकरण और पहुँच: निमंत्रणों, सत्रों, अंतर्निहित भूमिकाओं और कस्टम अनुमति समूहों के साथ स्थानीय-पासवर्ड, OpenID Connect या हाइब्रिड प्रमाणीकरण। नए उत्पादन इंस्टॉलेशन एक बार के स्थानीय मालिक सेटअप की आवश्यकता रखते हैं; अपग्रेड किए गए इंस्टॉलेशन डिफ़ॉल्ट रूप से अक्षम प्रमाणीकरण का उपयोग करते हैं। OIDC PKCE के साथ Authorization Code प्रवाह का उपयोग करता है। API अनुमतियाँ सर्वर-साइड पर डिफ़ॉल्ट-डिनाई रूटिंग के साथ लागू की जाती हैं। एक रिकवरी कमांड मूल मालिक को रीसेट कर सकता है। - साझाकरण: स्पष्ट रूप से चयनित Systems और Canvas दृश्यों को स्थानीय गोपनीयता पूर्वावलोकन के माध्यम से lab.gd पर प्रकाशित किया जा सकता है, जिसमें सार्वजनिक या गैर-सूचीबद्ध पहुँच, अपरिवर्तनीय या प्रतिस्थापनीय पुनरावृत्तियाँ, मैनुअल या डिबाउंस सिंक्रनाइज़ेशन, समाप्ति, एम्बेड्स और ऑप्ट-इन मेटाडेटा शामिल हैं। नामांकन कोई इन्वेंटरी सामग्री नहीं भेजता, और साझाकरण को पूरी तरह से अक्षम किया जा सकता है। - बैकअप और पुनर्स्थापना: .hlibackup प्रारूप में पूर्ण या खंड-आधारित पोर्टेबल बैकअप, जिसमें पथों, आकारों, चेकसम्स, स्कीमा संगतता और खंड निर्भरताओं का सत्यापन, पुनर्स्थापना से पहले रिकवरी बैकअप, रखरखाव मोड और विफल होने पर स्वचालित रोलबैक शामिल है। अनुकूलनीय प्रतिधारण के साथ शेड्यूल किए गए एन्क्रिप्टेड बैकअप का समर्थन किया जाता है; मालिक-प्रमाणीकरण सामग्री के अस्तित्व में आने के बाद शेड्यूल किए गए बैकअप के लिए एक पासफ्रेज अनिवार्य है। - तैनाती: स्थिर, नवीनतम या पिन्ड संस्करण टैग के साथ Docker Compose; एन्वायरनमेंट वेरिएबल्स पोर्ट, डेटा निर्देशिका, अपडेट चैनल, रजिस्ट्री रिफ्रेश अंतराल, lab.gd साझाकरण, प्रमाणीकरण बूटस्ट्रैप, OIDC सीक्रेट्स, दर सीमा, प्रॉक्सी विश्वास और टेलीमेट्री प्रतिधारण को कवर करते हैं। README HTTPS और पहुँच नियंत्रण के बिना ऐप को सार्वजनिक इंटरनेट पर सीधे प्रकट करने के खिलाफ चेतावनी देता है, और नोट करता है कि प्रोजेक्ट सक्रिय AI-सहायता प्राप्त विकास के तहत है और इसे एक विकसित होते उपकरण के रूप में माना जाना चाहिए, न कि एक पूर्ण उद्यम CMDB के रूप में।