منصوبے کے بارے میں

RootGuard ایک خود میزبان DNS تحفظ سٹیک ہے جو Docker Compose کے ذریعے ڈپلائے کیا جاتا ہے۔ یہ نیٹ ورک بھر کی DNS فلٹرنگ کے لیے AdGuard Home اور ایک نجی recursive Unbound resolver کے ساتھ جوڑا گیا ہے جو DNS ہائرارکی سے query کرتا ہے اور DNSSEC کی تصدیق کرتا ہے۔ نیٹ ورک پر موجود ڈیوائسز سٹیک کے DNS endpoint کی طرف اشارہ کرتی ہیں، اس لیے ٹی وی، فونز، گیم کنسولز، کمپیوٹرز اور دیگر کلائنٹس پر بغیر کسی ایکسٹینشن یا ایپ انسٹال کیے اشتہارات اور معلوم ٹریکرز کو بلاک کیا جا سکتا ہے۔ README جرمن اور انگریزی زبان میں شائع کیا گیا ہے۔ پروجیکٹ ایک مونوریپو ہے جس میں کئی آزادانہ buildable components شامل ہیں: - RootGuard WebApp: لاگ ان، ڈیش بورڈ اور رہنمائی شدہ مینجمنٹ۔ - RootGuard Core: ارڈینیشن اور validated configuration تبدیلیاں۔ - RootGuard Updater: coordinated Core/WebApp اپڈیٹس rollback کے ساتھ۔ - AdGuard Home: نیٹ ورک بھر میں DNS فلٹرنگ۔ - Unbound: recursive DNS resolution اور DNSSEC validation۔ - rootguard-unbound: hardened Unbound image۔ - rootguard-blockpage: بلاک شدہ requests کے لیے landing page۔ - rootguard-attestation-proxy: cosign attestation checks کے لیے egress proxy۔ پہلے الگ repositories archived ہیں لیکن تاریخ اور پرانی issues کے لیے ابھی بھی readable ہیں؛ active development اب صرف اس مونوریپو میں ہوتا ہے۔ شروع کرنے کے لیے Docker Compose v2 درکار ہے۔ release-candidate phase میں ready-made amd64 اور arm64 images شائع ہوتی ہیں، اس لیے local build کی ضرورت نہیں ہوتی۔ documented flow کے مطابق compose.release.yaml اور .env.release.example tag کے لیے ڈاؤن لوڈ کریں، openssl rand -hex 32 کے ساتھ دو independent secrets جنریٹ کریں، مضبوط admin password اور الگ API اور recovery tokens .env میں سیٹ کریں، اور docker compose کے ساتھ سٹیک start کریں۔ پھر صارفین port 8080 پر ویب GUI کھولتے ہیں اور guided setup follow کرتے ہیں، جو recommended Stable channel اور experimental AdGuard Home Beta channel پیش کرتی ہے۔ README میں بتایا گیا ہے کہ beta میں bugs ہو سکتے ہیں اور جب منتخب کیا جائے تو DNS resolution اور blocking کو fail-safe نہیں سمجھا جانا چاہیے۔ Requirements، router configuration، upgrades اور troubleshooting آن لائن handbook میں covered ہیں۔ ویب interface configuration، اپڈیٹس، health checks، diagnostics اور rollbacks کو بھی handle کرتی ہے، اور raw Unbound files edit کیے بغیر local records، private domains، conditional forwarding اور RFC1918 reverse zones کے لیے guided local DNS management فراہم کرتی ہے۔ RootGuard 1.0 سے پہلے public release-candidate testing میں ہے، اور maintainers کا کہنا ہے کہ یہ abhi production network میں واحد DNS service کے طور پر recommended نہیں ہے۔ repository میں architecture اور trust boundaries، current project state، roadmap، changelog، image digests اور retention policy، verified installation platforms، performance اور memory baseline، اور accessibility اور security review کی دستاویزات موجود ہیں۔ quality assurance میں human code review اور ایک AI-assisted tool شامل ہے جو bugs اور security risks تلاش کرتی ہے؛ findings کی تصدیق انسان کرتی ہے before fix کی جاتی ہے، اور audit rounds publicly logged ہوتی ہیں۔ Contributions contributor guide، good first issue اور help wanted labels کے ذریعے خوش آمدید ہیں، جبکہ security problems کو privately report کرنا چاہیے۔ software AGPL-3.0-or-later کے تحت licensed ہے، RootGuard اور Foxly IT ناموں اور logos کے لیے ایک الگ trademark policy ہے۔ README میں screenshots ایک isolated test host پر verified deployment سے لیے گئے ہیں جہاں documented default account استعمال کیا گیا ہے۔