mkdev

स्थानीय डेवलपमेंट के लिए वास्तविक HTTPS — TUI और LAN शेयरिंग के साथ।

---

mkdev *.local पर विश्वसनीय HTTPS चलाता है। एक ही Go बाइनरी: सर्टिफिकेट अथॉरिटी + रिवर्स प्रॉक्सी + /etc/hosts + mDNS ब्रॉडकास्ट + एक पूर्ण TUI।

क्या चीज़ इसे अलग बनाती है:

• LAN शेयरिंग किसी रूट को शेयर्ड चिह्नित करें, अपने फ़ोन या उसी Wi-Fi पर किसी भी डिवाइस से https://app.local खोलें।
• सिर्फ CLI नहीं, TUI भी। लाइव रूट टेबल, रिक्वेस्ट लॉग, सर्टिफिकेट निरीक्षण, हेल्थ डॉक्टर। बिना तर्कों के mkdev चलाने पर सीधे TUI में पहुँचते हैं।
• सख्त विशेषाधिकार सीमा। किसी भी एलिवेटेड कॉल से पहले sudo हेल्पर बाइनरी पर स्वामित्व, लिखने योग्यता और सिमलिंक जाँच (internal/safeexec)। कोई PATH-आधारित शैडोइंग नहीं, कोई ग्रुप-राइटेबल शॉर्टकट नहीं।
• प्रति-SNI सर्टिफिकेट जारी करना। लीफ सर्टिफिकेट माँग पर जारी होते हैं और एक स्पष्ट knownHost अनुमति-सूची द्वारा नियंत्रित होते हैं। न वाइल्डकार्ड, न पहले से बनाए गए।

यह क्या करता है

mkdev install                    # CA + trust + daemon service + menu bar autostart
mkdev add myapp localhost:3000   # routes https://myapp.local → localhost:3000
curl https://myapp.local         # 200 from your local app

install एक-शॉट है: CA जनरेट करता है, सिस्टम स्टोर में उसे विश्वसनीय बनाता है, डेमन यूज़र-सर्विस (launchd / systemd) इंस्टॉल और सक्षम करता है, लॉगिन पर लॉन्च होने के लिए मेन्यू बार पंजीकृत करता है, और GUI सत्र मौजूद होने पर बार को तुरंत स्पॉन करता है। डेमन प्रॉक्सी का मालिक है; TUI (mkdev बिना तर्क) और mkdev add | remove | list उससे ~/.mkdev/daemon.sock के ज़रिए संवाद करते हैं।

LAN शेयरिंग

mkdev की मुख्य विशेषता। असली TLS के साथ उसी Wi-Fi पर किसी भी डिवाइस के साथ रूट साझा करें — कोई चेतावनी नहीं, कोई टनल सेवा नहीं।

1. TUI के Domains टैब में, कोई रूट चुनें और SHARE कॉलम को LAN पर बदलने के लिए s दबाएँ।
2. रूट mDNS के ज़रिए <name>.local → इस मशीन के LAN IP के रूप में विज्ञापित होता है।
3. फ़ोन / दूसरे लैपटॉप पर, https://<name>.local पर जाएँ। एक बार डिवाइस mkdev CA पर भरोसा कर ले (एक-बार), तो कोई चेतावनी नहीं।

सावधानियाँ

• सिर्फ .local रूट mDNS पर ब्रॉडकास्ट होते हैं। अन्य TLD अभी भी प्रॉक्सी किए जाते हैं लेकिन नाम से LAN पर पहुँच योग्य नहीं होते।
• कॉर्पोरेट / क्लाउड Wi-Fi अक्सर मल्टीकास्ट ब्लॉक करता है। घर और ऑफिस का Wi-Fi काम करता है।
• s टॉगल करना लाइव है — mDNS विज्ञापन और LAN-साइड ACL अगली रिक्वेस्ट पर अपडेट होते हैं। कोई रीस्टार्ट नहीं।
• गैर-शेयर्ड रूट डिफेंस-इन-डेप्थ के तौर पर नॉन-लूपबैक रिक्वेस्ट को 403 करते हैं।
• LAN पर कोई भी आपके शेयर्ड रूट तक पहुँच सकता है। अविश्वसनीय Wi-Fi पर इसे चालू न करें।

इंस्टॉल

Homebrew (macOS, Linux)

brew install venkatkrishna07/tap/mkdev

बाद में अपग्रेड करें:

brew update
brew upgrade mkdev

Go

go install github.com/venkatkrishna07/mkdev/cmd/mkdev@latest

किसी विशिष्ट संस्करण में अपग्रेड करें:

go install github.com/venkatkrishna07/mkdev/cmd/[email protected]

सीधा डाउनलोड

macOS (Intel + Apple Silicon), Linux (amd64 + arm64) और Windows (amd64) के लिए पहले से निर्मित बाइनरीज़ Releases पेज पर प्रकाशित होती हैं। हर रिलीज़ में checksums.txt के साथ-साथ एक cosign कीलेस सिग्नेचर (checksums.txt.sig + .pem) शामिल होता है — वेरिफाई कमांड के लिए SECURITY.md#verifying-releases देखें।

macOS पर, यदि Gatekeeper सीधे डाउनलोड की गई बाइनरी को ब्लॉक करता है:

xattr -d com.apple.quarantine ./mkdev

सोर्स से

git clone https://github.com/venkatkrishna07/mkdev.git
cd mkdev
task build
cp bin/mkdev ~/bin/        # or /usr/local/bin

आवश्यकता: Go 1.25+।

पहली बार चलाना

mkdev install   # CA, trust, daemon service, bar autostart — one command
mkdev           # launch TUI

install के बाद, डेमन पृष्ठभूमि में चलता है और मेन्यू बार प्रकट होता है (macOS, Linux GNOME/KDE, Windows)। बार डेमन स्थिति, रूट सूची और प्रति-रूट सक्षम / LAN-शेयर टॉगल दिखाता है; Quit डेमन को रोके बिना बार से बाहर निकलता है।

मेन्यू बार

बार हमेशा-चालू UI है। यह सिस्टम ट्रे में रहता है और ~/.mkdev/daemon.sock के ज़रिए डेमन से संवाद करता है। लॉगिन पर लॉन्च होता है (install द्वारा पंजीकृत ऑटोस्टार्ट); mkdev bar के साथ फोरग्राउंड में भी चलाया जा सकता है।

यह क्या दिखाता है:

• स्थिति बिंदु — हरा चालू, लाल बंद, पीला जाँच, ग्रे ऑफ। डेमन की सेहत दर्शाता है।
• हेडर — mkdev v0.4.0 + डेमन PID + अपटाइम + सुन रहा प्रॉक्सी पोर्ट।
• रूट्स — स्टोर में हर रूट, ऊपर से नीचे। हर प्रविष्टि name.tld → target के साथ सफ़िक्स बैज दिखाती है ( · disabled, · LAN)।

यह क्या करता है (रूट पर क्लिक करने पर):

• ब्राउज़र में खोलें — सिस्टम डिफ़ॉल्ट हैंडलर से https://name.tld खोलता है।
• URL कॉपी करें — प्रॉक्सी URL को क्लिपबोर्ड पर कॉपी करता है (pbcopy / wl-copy / xclip / clip.exe)।
• सक्षम / अक्षम करें — रूट का Enabled फ़्लैग बदलता है। अक्षम रूट स्टोर में रहते हैं लेकिन प्रॉक्सी होना बंद कर देते हैं।
• LAN पर शेयर करें — mDNS विज्ञापन + LAN-साइड ACL टॉगल करता है।

बार-स्तरीय क्रियाएँ:

• डेमन रोकें — पहले DisableUnit कॉल करता है ताकि launchd / systemd KeepAlive उसे तुरंत पुनः स्पॉन न करे, फिर सॉकेट पर शटडाउन भेजता है।
• बाहर निकलें — केवल बार प्रोसेस से बाहर निकलता है। डेमन और प्रॉक्सी चलते रहते हैं।

नोट:

• दो बार इंस्टेंस एक साथ नहीं चल सकते (PID-फ़ाइल लॉक; दूसरा तुरंत बाहर निकल जाता है)।
• डेमन के रीस्टार्ट होने पर बार स्वतः पुनः जुड़ जाता है। बिना मैन्युअल रिफ्रेश के स्थिति बिंदु अपडेट हो जाता है।
• केवल बार (और mkdev daemon stop) पर्यवेक्षित डेमन को साफ़ तरीके से रोक सकते हैं — डेमन प्रोसेस को सीधे मारने पर launchd / systemd उसे पुनः स्पॉन कर देगा।

अपग्रेड करना

बाइनरी बदलें (brew upgrade / go install ...@latest / नया डाउनलोड)। अगली बार जब आप कोई mkdev सबकमांड चलाएँगे, तो बाइनरी उन हिस्सों को समेटती है जो इसके बाहर रहते हैं: डेमन plist / systemd यूनिट और बार ऑटोस्टार्ट प्रविष्टि को नई बाइनरी की ओर इंगित करने के लिए फिर से लिखती है, सक्षम रूट्स के लिए /etc/hosts को फिर से स्थापित करती है और यदि CA हटा दिया गया हो तो उसे फिर से विश्वसनीय बनाती है। Sudo प्रॉम्प्ट इनलाइन चलते हैं। यदि आपके पास केवल डेमन चल रहा है और CLI को कभी नहीं छूते, तो डेमन अपने स्टार्टअप पर सुरक्षित (बिना-sudo) काम करता है और बाकी को अगले CLI कमांड तक कतार में रखता है।

mkdev install को दोबारा चलाना यही काम स्पष्ट रूप से करता है और हमेशा सुरक्षित है — हर चरण इडेम्पोटेंट है।

प्लेटफ़ॉर्म समर्थन

प्लेटफ़ॉर्म	ट्रस्ट स्टोर	एलिवेशन
macOS	System Keychain (security add-trusted-cert)	sudo / osascript
Linux	update-ca-trust / update-ca-certificates / trust extract-compat	sudo / pkexec
Windows	ROOT system store via crypt32.dll	UAC (PowerShell RunAs)

पहचाने जाने वाले Linux डिस्ट्रो: Debian/Ubuntu (/usr/local/share/ca-certificates), RHEL/Fedora (/etc/pki/ca-trust/source/anchors), Arch (/etc/ca-certificates/trust-source/anchors), openSUSE (/usr/share/pki/trust/anchors)।

Firefox अपना खुद का NSS स्टोर उपयोग करता है और अभी तक कवर नहीं है — सिस्टम Chrome/Safari/Edge/curl/wget सभी काम करते हैं।

कमांड्स