iOS / iPadOS PWA गाइड

iPhone या iPad पर Marinara Engine इस्तेमाल करें। Apple इन डिवाइस पर Marinara सर्वर चलने नहीं देता, इसलिए आप किसी दूसरे डिवाइस पर चल रहा सर्वर Safari में खोलते हैं। फिर उसे PWA के रूप में अपनी Home Screen (होम स्क्रीन) पर सेव कर सकते हैं। PWA (Progressive Web App) एक ऐसी वेबसाइट है जो ऐप की तरह अपनी अलग विंडो में खुलती है।

झटपट तरीका

किसी कंप्यूटर, होम सर्वर या Android फ़ोन पर Marinara इंस्टॉल करके शुरू करें (नीचे की लिस्ट देखें)। उसे चालू रहने दें।
उस कंप्यूटर पर लॉगिन सेट करें। देखें रिमोट एक्सेस।
उस कंप्यूटर का IP पता निकालें (नीचे देखें)।
अपने iPhone या iPad पर Safari खोलें और http://, फिर वह IP पता और फिर :7860 लिखकर उस पते पर जाएँ।

iPhone या iPad पर 127.0.0.1 इस्तेमाल न करें। उस पते का मतलब खुद iPhone है।

सर्वर कहाँ चलता है

सर्वर इन पर चल सकता है:

Windows PC: Windows इंस्टॉलेशन गाइड।
Mac या Linux कंप्यूटर: macOS / Linux इंस्टॉलेशन गाइड।
Termux वाला Android फ़ोन: Android (Termux) इंस्टॉलेशन गाइड।
Docker या Podman कंटेनर: कंटेनर से चलाना।

Safari से कनेक्ट करें

शुरू करने से पहले: सर्वर चालू होना चाहिए और आपके डिवाइस को अंदर आने देना चाहिए, आम तौर पर लॉगिन के ज़रिए। देखें रिमोट एक्सेस।

सर्वर वाले डिवाइस और अपने iPhone या iPad को एक ही नेटवर्क पर रखें, जैसे घर का Wi-Fi। कहीं और से कनेक्ट करने के लिए Tailscale इस्तेमाल करें। यह एक मुफ़्त टूल है जो इंटरनेट के ज़रिए आपके डिवाइस को एक प्राइवेट नेटवर्क में जोड़ देता है।
सर्वर वाले डिवाइस का IP पता निकालें। सर्वर कंप्यूटर पर टर्मिनल (वह विंडो जिसमें कमांड टाइप करते हैं) में एक कमांड चलाएँ और पता पढ़ें। वह 192.168.1.42 जैसा दिखता है।

Windows (Command Prompt): ipconfig। IPv4 Address पढ़ें।
Linux: hostname -I।
macOS: ipconfig getifaddr en0।

Safari खोलें और इस पते पर जाएँ। <host-ip> की जगह वह IP पता लिखें। डिफ़ॉल्ट पोर्ट 7860 है।

http://<host-ip>:7860

Marinara की होम स्क्रीन लोड हो जाती है।

साइन-इन पेज दिखे, तो सर्वर के यूज़रनेम और पासवर्ड से साइन इन करें। सेटअप पेज दिखे, तो सर्वर के लॉग से एक बार वाला सेटअप कोड टाइप करें और यूज़रनेम और पासवर्ड चुनें। देखें रिमोट एक्सेस।

अगर यह काम नहीं किया: जाँचें कि सर्वर अब भी चल रहा है और दोनों डिवाइस एक ही नेटवर्क या Tailscale पर हैं। IP पता और पोर्ट जाँचें। देखें Marinara Engine की समस्याएँ सुलझाना।

Home Screen पर जोड़ें

अपना Marinara सर्वर Safari में खोलें।
Share बटन पर टैप करें, यानी वह चौकोर आइकन जिसमें ऊपर की तरफ़ तीर बना है।
शेयर शीट में नीचे स्क्रॉल करें और Add to Home Screen पर टैप करें।
चाहें तो नाम बदल लें, फिर Add पर टैप करें।

आपकी Home Screen पर Marinara का आइकन आ जाता है। उस पर टैप करने से Marinara, Safari के एड्रेस बार के बिना अपनी अलग विंडो में खुलता है।

ऐप ठीक से न चले तो HTTPS इस्तेमाल करें

PWA सबसे अच्छी तरह HTTPS पर चलता है, यानी ऐसा सुरक्षित कनेक्शन जो https:// से शुरू होता है। सादा http:// पता Safari में काम करता है। लेकिन iOS और iPadOS के कुछ वर्ज़न सादे http:// पते पर Home Screen ऐप को सीमित कर देते हैं। ऐसा हो, तो Marinara को HTTPS पर चलाएँ, या उसे Safari बुकमार्क के रूप में ही रखें।

अकेला Tailscale किसी पते को HTTPS नहीं बनाता। ऐसा Tailscale सेटअप इस्तेमाल करें जो HTTPS देता हो, या सर्वर के मालिक से कहें कि Marinara को HTTPS के पीछे रखें। देखें रिमोट एक्सेस।

PWA हटाकर दोबारा इंस्टॉल करना

कभी-कभी Safari ऐप का पुराना वर्ज़न रखे रहता है, या सेव किया हुआ ऐप अटक जाता है। उसे दोबारा इंस्टॉल करने से यह आम तौर पर ठीक हो जाता है। आपकी चैट, कैरेक्टर और सेटिंग्स सर्वर पर हैं, इसलिए दोबारा इंस्टॉल करने से वे डिलीट नहीं होतीं।

अपनी Home Screen पर Marinara के आइकन को दबाकर रखें।
ऐप हटाने वाले विकल्प पर टैप करें, फिर पुष्टि करें।
अपने iPhone या iPad पर Settings (सेटिंग्स) ऐप खोलें।
Safari पर टैप करें। iOS और iPadOS के नए वर्ज़न में यह Apps, फिर Safari के अंदर हो सकता है।
Advanced पर टैप करें, फिर Website Data पर।
अपने Marinara पते वाली एंट्री ढूँढें। अगर वह न दिखे, तो Show All Sites पर टैप करें।
उस एंट्री पर बाईं तरफ़ स्वाइप करें और Delete पर टैप करें।
ऊपर दिए स्टेप अपनाकर Marinara को Safari में दोबारा खोलें और उसे फिर से Home Screen पर जोड़ें।

समस्या-समाधान

Safari में पेज लोड नहीं होता। जाँचें कि सर्वर चल रहा है, दोनों डिवाइस एक ही नेटवर्क या Tailscale पर हैं, और IP पता और पोर्ट 7860 सही हैं। देखें रिमोट एक्सेस और Marinara Engine की समस्याएँ सुलझाना।

अपडेट के बाद Safari साइन-इन या सेटअप पेज दिखाता है।

/login पर सर्वर के यूज़रनेम और पासवर्ड से साइन इन करें।
कोई लॉगिन न हो, तो सर्वर लॉग से मिला एक बार वाला सेटअप कोड सेटअप पेज पर टाइप करें।
सर्वर कोई कोड न छापे, तो सर्वर वाले डिवाइस पर Settings → Advanced → Access (सेटिंग्स → एडवांस्ड → एक्सेस) में लॉगिन सेट करें।
403 का मतलब हो सकता है कि आपका iPhone IP_ALLOWLIST में नहीं है। वह लिस्ट सर्वर का मालिक बदलता है।
PWA सर्वर का लॉगिन रीसेट नहीं कर सकता। सर्वर का मालिक सर्वर पर Marinara फ़ोल्डर में node scripts/reset-login.mjs चलाता है (Docker में: docker exec <container> node scripts/reset-login.mjs), या .env में सेट किया गया लॉगिन बदलता है।

देखें अपडेट के बाद लॉक आउट हो जाना।

Safari पुराना बिल्ड ही दिखाता रहता है। पेज रीलोड करें। फिर भी पुराना लगे, तो ऊपर दिए स्टेप से PWA दोबारा इंस्टॉल करें।

जेनरेशन के दौरान Home Screen ऐप बंद हो जाता है या खाली हो जाता है। उसे फिर से खोलें और चैट पर लौटें। ठीक चल रहा सर्वर काम करता रहता है: चैट के जवाब और Illustrator की इमेज रिक्वेस्ट सर्वर पर चलती रहती हैं, और काम पूरा होने पर दोबारा खोली गई चैट रिफ़्रेश हो जाती है। Stop अब भी चुनी हुई चैट की जेनरेशन रद्द करता है। खाली स्क्रीन बार-बार आए, तो अपनी Support Diagnostics के साथ इसकी रिपोर्ट करें।

लाल बैनर कहता है कि सेव चुपचाप फ़ेल हो जाएँगे। यह सर्वर की तरफ़ से नेटवर्क ट्रस्ट की चेतावनी है, आपके iPhone या iPad की दिक्कत नहीं। सर्वर के मालिक को आपके पते पर भरोसा जताना होगा। देखें रिमोट एक्सेस।

खास अधिकार वाले काम ब्लॉक हो जाते हैं। रखरखाव के कुछ कामों के लिए सर्वर के मालिक से एडमिन सीक्रेट (एक दूसरा पासवर्ड) चाहिए होता है। उसे अपने iPhone या iPad पर Settings → Advanced → Admin Access (सेटिंग्स → एडवांस्ड → एडमिन एक्सेस) में सेव करें। देखें रिमोट एक्सेस।

मिलती-जुलती गाइड

रिमोट एक्सेस: लॉगिन और IP अलाउलिस्ट
अक्सर पूछे जाने वाले सवाल
Marinara Engine की समस्याएँ सुलझाना
Android (Termux) इंस्टॉलेशन गाइड