Pared

Pared एक सुरक्षित, उच्च-प्रदर्शन Linux होस्ट सुरक्षा नियंत्रण प्लेन और रीयल-टाइम प्रशासनिक वेब कंसोल है जिसे Crystal में लिखा गया है। Kemal और Blueprint सर्वर-रेंडर किए गए कंपोनेंट्स, SQLite3, एक छोटी vanilla-JS/WebSocket परत, और नेटिव libsystemd जर्नल स्ट्रीमिंग पर आधारित, यह firewalld और NetworkManager ऑर्केस्ट्रेशन को एक केंद्रीकृत, रिएक्टिव इंटरफ़ेस में एकीकृत करता है।

Pared में mutual TLS (mTLS) पासवर्डलेस प्रमाणीकरण, Linux PAM/SSSD पहचान प्रबंधन, लाइव जर्नल स्ट्रीमिंग के लिए libsystemd के लिए नेटिव C-बाइंडिंग, कर्नेल पैकेट सिमुलेशन, स्वचालित एंटी-लॉकआउट रोलबैक गार्जियन, और कंटेनर नेटवर्क बायपास ऑडिटिंग शामिल हैं।

मुख्य नियंत्रण प्लेन विशेषताएँ

लिविंग टोपोलॉजी और ग्राफ़ इंजन: भौतिक इंटरफ़ेस, नेटवर्क बॉन्ड, ब्रिज, WireGuard टनल, Netavark कंटेनर नेटवर्क, फ़ायरवॉल ज़ोन, और लिसनिंग डेमन को मैप करने वाली डायरेक्टेड एसाइक्लिक ग्राफ़ (DAG) टोपोलॉजी।
ट्रेस-अ-पैकेट सिम्युलेटर: 7-चरणीय नियतात्मक पैकेट मूल्यांकन पाइपलाइन जो लाइव नेटवर्क ट्रैफ़िक इंजेक्ट किए बिना इनग्रेस इंटरफ़ेस, स्रोत ओवरराइड, रिच रूल्स, पॉलिसी, NAT, और सॉकेट लक्ष्यों के पार पैकेट ट्रैवर्सल का सिमुलेशन करती है।
एंटी-लॉकआउट गार्जियन (डेड मैन्स स्विच): विघटनकारी ज़ोन टारगेट म्यूटेशन (DROP/REJECT) पर 30-सेकंड रोलबैक वॉचडॉग टाइमर के साथ स्वचालित वोलेटाइल स्टेजिंग स्नैपशॉट, जो ऑपरेटर लॉकआउट को रोकता है।
विज़ुअल रिच रूल कंपाइलर और AST: सिंटैक्स सत्यापन, कॉन्फ्लिक्ट डिटेक्शन (शैडोड, विरोधाभासी, और डुप्लिकेट रूल्स), डुअल-स्टैक IPv4/IPv6 CIDR कंटेनमेंट, और सादे अंग्रेज़ी में रूल अनुवाद।
होस्ट सॉकेट और डेमन कोरिलेटर: खुले TCP/UDP सॉकेट का स्थानीय systemd सर्विस यूनिट, प्रोसेस ID, और फ़ायरवॉल एक्सपोज़र स्टेट के साथ रीयल-टाइम कोरिलेशन।
सर्विस एक्सपोज़र कंसोल: प्रति पोर्ट/प्रोटोकॉल एक कार्रवाई योग्य पंक्ति जो लिसनर और फ़ायरवॉल स्टेट को मर्ज करती है (घोस्ट ओपनिंग, शैडो ब्लॉक, एक्सपोज़्ड, लोकल ओनली), प्रति-पंक्ति रेमेडिएशन और लाइव फ़िल्टरिंग के साथ।
Netavark कंटेनर ब्रिज इंस्पेक्टर: Podman/Netavark कंटेनर नेटवर्क की स्वचालित खोज और वाइल्डकार्ड होस्ट पोर्ट बाइंड (0.0.0.0, ::) पर ज़ीरो-ट्रस्ट फ़ायरवॉल बायपास ऑडिटिंग।
WireGuard ऑर्केस्ट्रेटर और विज़ुअल हब: क्रिप्टोग्राफ़िक की हाइजीन, पीयर एंडपॉइंट कॉन्फ़िगरेशन, और डुअल-स्टैक IPv4/IPv6 CIDR ओवरलैप डिटेक्शन।
ऑम्निबार कीबोर्ड-चालित UX: पूर्ण कीबोर्ड नेविगेशन और म्यूटेशन पैलेट (/trace, /rollback <zone>, /wg peer <term>, /zone add), मैचिंग कंसोल पर सर्वर-साइड डिस्पैच के साथ।
हार्डन्ड पहचान और एक्सेस (RBAC): अकाउंट एक्सपायरी चेक (pam_acct_mgmt) के साथ Linux PAM फ़ॉलबैक, SSSD D-Bus ग्रुप रिज़ॉल्यूशन, CRL चेक के साथ X.509 क्लाइंट सर्टिफ़िकेट mTLS, और CSRF सुरक्षा।
प्रोडक्शन ऑब्ज़र्वेबिलिटी: WebSockets पर लाइव systemd जर्नल स्ट्रीमिंग, NOTIFY_SOCKET के माध्यम से नेटिव वॉचडॉग इंटीग्रेशन, और संरचित ऑडिट लॉगिंग।

त्वरित शुरुआत

पूर्वापेक्षाएँ

Fedora Linux/RHEL 9+ (या systemd-आधारित Linux डिस्ट्रीब्यूशन)
Crystal कंपाइलर (v1.21+)
libsystemd डेवलपमेंट हेडर (systemd-devel)
firewalld और NetworkManager सक्रिय डेमन
SQLite3 और OpenSSL

इंस्टॉलेशन और स्थानीय सेटअप

# 1. Clone repository & install shard dependencies
git clone https://gitlab.com/renich/pared.git
cd pared
shards install

# 2. Provision host system Polkit rules & seed default database
make setup
make seed

# 3. Compile and launch development server
make build
make run

नियंत्रण प्लेन वेब डैशबोर्ड http://localhost:3636 पर उपलब्ध है।

डिफ़ॉल्ट डेमो क्रेडेंशियल

make seed के माध्यम से सीड किए जाने पर, डिफ़ॉल्ट क्रेडेंशियल हैं:

ईमेल: [email protected]
पासवर्ड: password

(UID ≥ 1000 वाले स्थानीय सिस्टम PAM उपयोगकर्ता खाते भी सीधे प्रमाणित कर सकते हैं)।

परीक्षण और गुणवत्ता आश्वासन

Pared व्यापक यूनिट और E2E ब्राउज़र टेस्ट सूट के साथ सख्त गुणवत्ता मानकों को लागू करता है:

# Run unit & integration test suite (200 examples)
make spec

# Run headless Selenium E2E browser test suite (16 examples)
make test-browser

# Run static analysis (Ameba)
bin/ameba

# Run security vulnerability scan (Flaw)
bin/flaw scan .

# Run reStructuredText documentation linter (crstlint)
find docs -name "*.rst" -exec crstlint {} +

प्रोडक्शन डिप्लॉयमेंट और Systemd सर्विस

एक प्रोडक्शन-हार्डन्ड systemd यूनिट फ़ाइल scripts/pared.service पर प्रदान की गई है, जो कर्नेल सैंडबॉक्सिंग, वॉचडॉग पिंगिंग, और क्षमता प्रतिबंधों को लागू करती है:

# Build production release binary
make release

# Install binary and systemd service
sudo install -m 755 bin/pared /usr/local/bin/pared
sudo install -m 644 scripts/pared.service /etc/systemd/system/pared.service

# Enable and start service
sudo systemctl daemon-reload
sudo systemctl enable --now pared.service

# Inspect service status and watchdog health
sudo systemctl status pared.service

दस्तावेज़ीकरण और संदर्भ पुस्तकालय

व्यापक आर्किटेक्चरल विशिष्टताएँ और निर्णय रिकॉर्ड docs/ निर्देशिका में बनाए रखे गए हैं:

स्थानीय रूप से Sphinx HTML दस्तावेज़ बनाने के लिए:

sphinx-build -b html -W docs docs/_build/html

रिपॉज़िटरी और मिरर

प्राथमिक कैनोनिकल रिपॉज़िटरी: GitLab
आधिकारिक मिरर: Codeberg

मेंटेनर

Rénich Bon Ćirić (@renich) — निर्माता और लीड आर्किटेक्ट
GNU General Public License v3.0 या बाद का (GPL-3.0-or-later) के अंतर्गत जारी।

pared

सबसे लोकप्रिय