यह मार्गदर्शिका UA Pro 1.5.0 के लिए है। इसमें कॉन्फ़िगरेशन का बैकअप लेने, उसे स्थानांतरित करने, स्वयं लिखने और रिमोट पते से लोड करने का तरीका बताया गया है। नया संस्करण पूर्ण स्नैपशॉट प्रारूप इस्तेमाल करता है; कॉन्फ़िगरेशन फ़ाइल का version, 2 है।
आयात से पहले लक्ष्य ब्राउज़र में एक बैकअप निर्यात करें। हर आयात में फ़ाइल का पूरा स्नैपशॉट ग्लोबल नियम, डोमेन नियमों का पूरा समूह, दोनों UA लाइब्रेरी और संसाधन डोमेन फ़ॉलबैक स्विच बदल देता है; अलग-अलग प्रविष्टियाँ मर्ज नहीं होतीं। "globalRule": null का अर्थ लक्ष्य ब्राउज़र का ग्लोबल नियम हटाना है।
01कॉन्फ़िगरेशन निर्यात करें
- ब्राउज़र के टूलबार में UA Pro आइकन पर क्लिक करें।
- “अधिक” → “कॉन्फ़िगरेशन आयात/निर्यात” खोलें।
- “कॉन्फ़िगरेशन निर्यात करें” पर क्लिक करें और डाउनलोड की गई
.jsonफ़ाइल सहेजें। - फ़ाइल का नाम
ua-switcher-config-2026-11-16.jsonजैसा होता है। नाम में तारीख UTC के अनुसार बनती है और स्थानीय तारीख से एक दिन अलग हो सकती है।
फ़ाइल में स्थायी रूप से सहेजे जाने वाले ये कॉन्फ़िगरेशन होते हैं:
- ग्लोबल नियम और उसकी सक्षम या रुकी हुई स्थिति।
- डोमेन नियमों का पूरा समूह और प्रत्येक की सक्षम या रुकी हुई स्थिति।
- कस्टम UA श्रेणियाँ और प्रविष्टियाँ।
- जोड़े जाने वाले टेक्स्ट की श्रेणियाँ और प्रविष्टियाँ।
- “संसाधन डोमेन फ़ॉलबैक” स्विच।
फ़ाइल में टैब नियम, पहले चुने गए रैंडम UA के बंधन, वर्तमान में खुले टैब, इंटरफ़ेस की भाषा, थीम और फ़्लोटिंग ओवरले सेटिंग नहीं होतीं। आयात के बाद ये बैकअप से बहाल नहीं होंगी; लक्ष्य ब्राउज़र के मौजूदा टैब नियम भी आयात से नहीं मिटते और डोमेन या ग्लोबल नियमों से ऊपर प्रभावी रह सकते हैं।
निर्यात की गई फ़ाइल पढ़े जा सकने वाले सादे JSON टेक्स्ट में होती है। यदि कस्टम UA या श्रेणी में ऐसी जानकारी है जिसे सार्वजनिक नहीं करना चाहते, तो बैकअप सुरक्षित रखें।
02स्थानीय फ़ाइल से आयात करें
- लक्ष्य ब्राउज़र में UA Pro → “अधिक” → “कॉन्फ़िगरेशन आयात/निर्यात” खोलें।
- पहले “कॉन्फ़िगरेशन निर्यात करें” पर क्लिक कर लक्ष्य ब्राउज़र का मूल कॉन्फ़िगरेशन सहेजें, ताकि ज़रूरत पड़ने पर बहाल कर सकें।
- “कॉन्फ़िगरेशन आयात करें” पर क्लिक करें और
.jsonफ़ाइल चुनें। - प्रतिस्थापन की चेतावनी और नियमों व सूचियों की संख्या पढ़ें; पुष्टि से पहले पूरा JSON जाँचने के लिए “कॉन्फ़िगरेशन की सामग्री देखें” पर क्लिक करें। “रद्द करें” चुनने पर कुछ नहीं लिखा जाता। पुष्टि के बाद “कॉन्फ़िगरेशन आयात किया गया!” संदेश की प्रतीक्षा करें। पुष्टि के दौरान सेटिंग बदलने पर एक्सटेंशन दोबारा प्रक्रिया करने को कहेगा।
- ग्लोबल और डोमेन नियम, कस्टम सूचियाँ तथा संसाधन डोमेन फ़ॉलबैक स्विच जाँचें; देखें कि मौजूदा टैब नियम उनसे ऊपर प्रभावी तो नहीं हैं। परीक्षण वाले पृष्ठ को रीफ़्रेश करें, फिर UA जाँचें।
एक्सटेंशन पहले फ़ाइल जाँचता है, फिर नियम इंस्टॉल करने का प्रयास करता है और अंत में स्थायी कॉन्फ़िगरेशन लिखता है। इंस्टॉल या लिखना विफल होने पर वह ब्राउज़र में अभी सहेजे गए नियम बहाल करने का प्रयास करता है; बहाली असंभव होने का संदेश मिले तो वास्तविक सेटिंग जाँचें। ब्राउज़र सिंक या कोई अन्य विंडो एक साथ कॉन्फ़िगरेशन बदले तो इस प्रक्रिया को डिवाइसों के बीच लेन-देन नहीं मानना चाहिए।
03रिमोट पते से लोड करें
रिमोट कॉन्फ़िगरेशन में स्थानीय बैकअप जैसी ही JSON सामग्री इस्तेमाल होती है। यह एक बार का मैन्युअल लोड और आयात है, अपने-आप अपडेट होने वाली सदस्यता नहीं।
- पहले कॉन्फ़िगरेशन बैकअप निर्यात करें या नीचे के अनुसार JSON फ़ाइल तैयार करें।
- फ़ाइल को ऐसी HTTPS सेवा पर रखें जिसे लक्ष्य ब्राउज़र खोल सके और सीधे JSON सामग्री लौटाने वाला पूरा पता प्राप्त करें, जैसे
https://example.com/ua-pro/config.json। यह पता केवल उदाहरण है; इसे अपने वास्तविक पते से बदलें। - UA Pro में “अधिक” → “कॉन्फ़िगरेशन आयात/निर्यात” खोलें, “रिमोट कॉन्फ़िगरेशन” को विस्तृत करें, पता चिपकाएँ और “लोड करें” पर क्लिक करें।
- लोड और प्रारूप जाँच सफल होने पर एक्सटेंशन पुष्टि बॉक्स और रिमोट होस्टनाम दिखाता है; वास्तव में डाउनलोड हुआ पूरा JSON जाँचने के लिए “कॉन्फ़िगरेशन की सामग्री देखें” पर क्लिक करें। पुष्टि करने पर स्थानीय आयात जैसे नियमों से सेटिंग अपडेट होती हैं; रद्द करने पर आयात नहीं होता।
- सर्वर पर फ़ाइल बदलने के बाद नई सामग्री उपयोग करने के लिए पता फिर दर्ज करें, लोड करें और पुष्टि करें। पैनल दोबारा खोलने पर पता अपने-आप बना नहीं रहता।
केवल सीधे HTTPS लिंक स्वीकार हैं; HTTP, पते में उपयोगकर्ता नाम या पासवर्ड और URL फ़्रैगमेंट स्वीकार नहीं हैं तथा रीडायरेक्ट का अनुसरण नहीं होता। अनुरोध में ब्राउज़र Cookie या लॉगिन क्रेडेंशियल नहीं होते, Referer नहीं भेजा जाता और कैश बायपास होता है; इसलिए लॉगिन Cookie माँगने वाली सेवा उपयुक्त नहीं है। UA Pro इस एक्सटेंशन में सेट UA नियम इस अनुरोध पर लागू नहीं करता, लेकिन अन्य एक्सटेंशन या नेटवर्क उपकरण अनुरोध बदल सकते हैं। पते में क्वेरी पैरामीटर हो सकते हैं; एक्सेस टोकन वाले पते को पासवर्ड की तरह सुरक्षित रखें। विश्वसनीय पता इस्तेमाल करें और सुनिश्चित करें कि प्रतिक्रिया सीधे JSON फ़ाइल हो, लॉगिन पृष्ठ या कोड दिखाने वाला HTML पृष्ठ नहीं।
स्थानीय फ़ाइल और रिमोट प्रतिक्रिया दोनों की सीमा 128 KiB है; रिमोट पढ़ने की सीमा 10 सेकंड है और वास्तव में पढ़ी गई सामग्री गिनी जाती है। ब्राउज़र सिंक स्टोरेज में प्रति आइटम छोटी सीमा भी होती है, इसलिए फ़ाइल 128 KiB से छोटी होने पर भी बहुत बड़े नियम या एक लाइब्रेरी के कारण सहेजी नहीं जा सकती। त्रुटि पर जाँचें कि सर्वर स्थिति 200 और वैध JSON लौटाता है, प्रमाणपत्र वैध है, पता रीडायरेक्ट नहीं होता और नेटवर्क तक पहुँचा जा सकता है।
04पूरा JSON उदाहरण
नीचे का उदाहरण UTF-8 एन्कोडिंग वाली config.json फ़ाइल के रूप में सहेजा जा सकता है। उदाहरण के डोमेन और UA मान केवल समझाने के लिए हैं; बदलने से पहले मौजूदा कॉन्फ़िगरेशन का बैकअप लें। JSON बड़े और छोटे अक्षरों में अंतर करता है; स्ट्रिंग के लिए ASCII दोहरे उद्धरण चिह्न इस्तेमाल करें, अंतिम तत्व के बाद कॉमा न लगाएँ और JSON में टिप्पणियाँ न लिखें।
{
"version": 2,
"type": "ua-switcher-config",
"timestamp": "2026-11-16T06:00:00.000Z",
"data": {
"globalRule": {
"enabled": true,
"mode": "builtin",
"params": {
"os": "Windows",
"uaKey": "Edge 125 (Latest)"
}
},
"domainRules": {
"example.com": {
"enabled": true,
"mode": "custom",
"params": {
"category": "手机示例",
"value": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
}
},
"app.example.com": {
"enabled": true,
"mode": "append",
"params": {
"category": "测试标记",
"value": "MyApp/1.0"
}
},
"random.example.com": {
"enabled": true,
"mode": "random",
"params": {
"pool": "custom:随机示例",
"strategy": "page"
}
},
"paused.example.com": {
"enabled": false,
"mode": "custom",
"params": {
"category": "测试",
"value": "ExampleAgent/1.0"
}
}
},
"userCustomData": {
"手机示例": [
"Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
],
"随机示例": [
"ExampleAgent/1.0",
"ExampleAgent/2.0"
],
"测试": [
"ExampleAgent/1.0"
]
},
"userAppendData": {
"测试标记": [
"MyApp/1.0"
]
},
"resourceDomainFallback": false
}
}
यह उदाहरण एक बिल्ट-इन ग्लोबल UA और चार डोमेन नियम सेट करता है। app.example.com जैसे अधिक विशिष्ट सबडोमेन नियम example.com से प्राथमिक होते हैं; रुके हुए नियम प्रभावी मिलान में भाग नहीं लेते और मूल डोमेन या ग्लोबल नियम उनकी जगह लागू हो सकता है। वास्तविक वेबसाइट उदाहरण UA को पहचानती है या नहीं, यह वेबसाइट पर निर्भर है।
05शीर्ष-स्तरीय फ़ील्ड और प्रतिस्थापन का व्यवहार
| फ़ील्ड | उदाहरण | उद्देश्य |
|---|---|---|
version |
2 |
अनिवार्य। नया संस्करण केवल संख्या 2 स्वीकार करता है। |
type |
"ua-switcher-config" |
अनिवार्य। कॉन्फ़िगरेशन प्रकार का पहचानकर्ता; इस स्ट्रिंग से बिल्कुल मेल खाना चाहिए। |
timestamp |
"2026-11-16T06:00:00.000Z" |
अनिवार्य। मिलीसेकंड और Z सहित UTC समय इस्तेमाल करें; यह केवल रिकॉर्ड के लिए है, नियम लागू होने का समय तय नहीं करता। |
data |
{ ... } |
अनिवार्य। पूरा कॉन्फ़िगरेशन रखने वाला ऑब्जेक्ट, जिसमें नीचे की तालिका के सभी फ़ील्ड हों। |
data में फ़ील्ड |
सही प्रारूप | इस संस्करण में आयात का व्यवहार |
|---|---|---|
globalRule |
एक नियम ऑब्जेक्ट या null |
नियम ऑब्जेक्ट मौजूदा ग्लोबल नियम बदलता है; null मौजूदा ग्लोबल नियम हटाता है। |
domainRules |
{ "域名": 规则对象 } |
पूरा ऑब्जेक्ट पुराने डोमेन नियम बदलता है; {} उन्हें खाली कर देता है। |
userCustomData |
{ "分类": ["UA", ...] } |
पूरा ऑब्जेक्ट पुरानी कस्टम UA लाइब्रेरी बदलता है; {} उसे खाली कर देता है। |
userAppendData |
{ "分类": ["追加文本", ...] } |
पूरा ऑब्जेक्ट पुराने अतिरिक्त टेक्स्ट की लाइब्रेरी बदलता है; {} उसे खाली कर देता है। |
resourceDomainFallback |
true या false |
JSON बूलियन मान: संसाधन डोमेन फ़ॉलबैक चालू या बंद करता है। |
पाँचों फ़ील्ड अनिवार्य हैं; globalRule के अलावा null का उपयोग नहीं किया जा सकता। गायब या अज्ञात फ़ील्ड और दोहराई गई JSON कुंजियाँ अस्वीकार होंगी; पुराने संस्करण या आंशिक कॉन्फ़िगरेशन भी आयात नहीं होंगे। डोमेन नियम और दोनों लाइब्रेरी पूरे समूह के रूप में बदले जाते हैं: उदाहरण के लिए एक ही डोमेन वाला domainRules लक्ष्य ब्राउज़र के अन्य मौजूदा डोमेन नियम भी बदल देगा। नए संस्करण से वास्तव में निर्यात की गई फ़ाइल पर आधारित संपादन करें और आवश्यक सभी आइटम बनाए रखें।
संसाधन डोमेन फ़ॉलबैक केवल तब संसाधन अनुरोध के लक्ष्य डोमेन के आधार पर नियम लागू कर सकता है जब मुख्य पृष्ठ पर कोई प्रभावी टैब, डोमेन या ग्लोबल UA न हो; इसका अर्थ यह नहीं कि सभी क्रॉस-डोमेन संसाधन मुख्य पृष्ठ के नियम को बदल देंगे।
06नियम ऑब्जेक्ट कैसे लिखें
ग्लोबल नियम और हर डोमेन नियम की संरचना समान है:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
enabled: true का अर्थ सक्षम और false का अर्थ रुका हुआ है। mode, params के फ़ील्ड तय करता है:
6.1 बिल्ट-इन UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
os और uaKey का उस एक्सटेंशन संस्करण के आंतरिक प्रीसेट की कुंजियों से बिल्कुल मेल खाना आवश्यक है; वे इंटरफ़ेस में अनूदित दिखाई देने वाले पाठ के समान हों, यह ज़रूरी नहीं। सबसे भरोसेमंद तरीका इंटरफ़ेस में प्रीसेट चुनकर कॉन्फ़िगरेशन निर्यात करना और संबंधित params कॉपी करना है। संस्करण के साथ प्रीसेट सूची बदले तो फिर जाँचें।
6.2 कस्टम UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
value पूरी UA स्ट्रिंग है। category श्रेणी और इंटरफ़ेस में संपादन के लिए है; यह मान userCustomData की उसी नाम वाली श्रेणी में भी रखना उचित है। नियम लागू होने पर उसी नियम का value पढ़ा जाता है; नियम मैन्युअल आयात करने से मान कस्टम लाइब्रेरी में अपने-आप नहीं जुड़ता।
6.3 अतिरिक्त टेक्स्ट: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
एक्सटेंशन वर्तमान ब्राउज़र के मूल UA के बाद एक स्पेस और फिर value जोड़ता है। यह टेक्स्ट userAppendData की उसी नाम वाली श्रेणी में भी रखें; नियम आयात करने से सूची अपने-आप नहीं भरती।
6.4 रैंडम UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
strategy का मान "page" (हर पूर्ण पृष्ठ लोड पर चयन) या "tab" (नियम और टैब के अनुसार बनाए रखना) होना चाहिए। रैंडम चयन में दोहराव संभव है, इसलिए लगातार दो समान परिणामों का अर्थ यह नहीं कि फिर से चयन नहीं हुआ।
सामान्य pool मान:
| मान | रैंडम स्रोत |
|---|---|
all |
सभी बिल्ट-इन UA, कस्टम UA और अतिरिक्त टेक्स्ट से बने UA |
builtin |
सभी बिल्ट-इन UA |
builtin_desktop, builtin_mobile, builtin_legacy |
बिल्ट-इन डेस्कटॉप, मोबाइल या पुराने उपकरण की श्रेणियाँ |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
संबंधित बिल्ट-इन श्रेणियाँ |
custom |
सभी कस्टम श्रेणियों के UA |
custom:分类名 |
userCustomData में निर्दिष्ट श्रेणी के UA |
append_all |
सभी अतिरिक्त टेक्स्ट से संबंधित UA |
append:分类名 |
userAppendData में निर्दिष्ट श्रेणी के अतिरिक्त टेक्स्ट से संबंधित UA |
कोलन के बाद श्रेणी का नाम लाइब्रेरी की कुंजी से मेल खाना चाहिए। सक्षम रैंडम नियम में उपलब्ध विकल्प होना चाहिए, अन्यथा फ़ाइल अस्वीकार होगी।
07मैन्युअल संपादन के समय जाँच
domainRulesकी कुंजी में डोमेन लिखें, जैसेexample.com,shop.example.com;https://, पथ, पोर्ट या स्पेस न लिखें। डोमेन नियम नीचे के सबडोमेन से भी मेल खाते हैं; वर्तमान संस्करण में*.example.comमें स्वयंexample.comभी शामिल है, यह केवल सबडोमेन नहीं है।- श्रेणी नाम में चीनी इस्तेमाल हो सकती है, वह खाली स्ट्रिंग नहीं होना चाहिए और उसमें नियंत्रण वर्ण या खतरनाक द्विदिश टेक्स्ट नियंत्रण वर्ण नहीं होने चाहिए;
__proto__,prototype,constructorश्रेणी नाम नहीं हो सकते। UA और अतिरिक्त टेक्स्ट में प्रिंट किए जा सकने वाले ASCII वर्ण इस्तेमाल करने की सलाह है; नई पंक्ति, टैब या अन्य नियंत्रण वर्ण न रखें; एक UA अधिकतम 4096 वर्ण का हो सकता है। टेक्स्ट में ASCII दोहरे उद्धरण और बैकस्लैश को JSON नियमों के अनुसार एस्केप करना होगा। - हर श्रेणी स्ट्रिंग के ऐरे से संबंधित है, जैसे
"常用": ["Agent/1.0", "Agent/2.0"]। केवल एक आइटम हो तब भी वर्ग कोष्ठक रखें। खाली श्रेणी[]लिखी जा सकती है। true,falseऔरnullको दोहरे उद्धरण में न रखें;"false"स्ट्रिंग है, बूलियन नहीं।- फ़ाइल वैध UTF-8 और JSON होनी चाहिए; दोहराई गई कुंजियाँ स्वीकार नहीं हैं। एक्सटेंशन संरचना, फ़ील्ड प्रकार, नियम, प्रीसेट नाम और रैंडम पूल भी जाँचता है; सही सिंटैक्स से नियम के उपयोग योग्य होने की गारंटी नहीं मिलती।
कॉन्फ़िगरेशन फ़ाइल वेबसाइट को ब्राउज़र द्वारा भेजा गया UA बदल सकती है। HTTPS ट्रांसमिशन की रक्षा करता है, लेकिन सर्वर का कॉन्फ़िगरेशन आपकी इच्छा के अनुरूप होगा इसकी गारंटी नहीं देता; केवल विश्वसनीय स्रोत की फ़ाइल आयात करें, पुष्टि से पहले सामग्री देखें और लक्ष्य पृष्ठ रीफ़्रेश कर वास्तविक परिणाम जाँचें।
08अक्सर पूछे जाने वाले प्रश्न
| समस्या | जाँचने का तरीका |
|---|---|
| फ़ाइल का प्रारूप गलत बताया जाता है | UTF-8, JSON सिंटैक्स, दोहरी कुंजियाँ, संस्करण, अनिवार्य फ़ील्ड और नियम प्रकार जाँचें; नए संस्करण की निर्यात फ़ाइल को टेम्पलेट बनाएँ। |
| रिमोट लोड विफल | HTTPS प्रमाणपत्र, सीधा लिंक, नेटवर्क और लौटाई गई सामग्री जाँचें; रीडायरेक्ट, Cookie लॉगिन और HTTP अनुमत नहीं हैं। |
| आयात के बाद नियम कम हो गए | डोमेन नियम और दोनों लाइब्रेरी पूरे समूह के रूप में बदलते हैं; आयात से पहले का बैकअप बहाल करें या आवश्यक आइटम नई फ़ाइल में जोड़ें। |
| खाली ग्लोबल नियम आयात किया लेकिन पृष्ठ दूसरा UA इस्तेमाल करता है | मौजूदा टैब नियम या मेल खाने वाले डोमेन नियम जाँचें; वे ग्लोबल नियम से प्राथमिक हो सकते हैं। |
| सफलता दिखती है लेकिन UA गलत है | नियम सक्षम है या नहीं, सामग्री वैध है या नहीं, रैंडम पूल में विकल्प है या नहीं और अधिक प्राथमिकता वाला टैब या डोमेन नियम है या नहीं जाँचें, फिर पृष्ठ रीफ़्रेश करें। |
| बहुत डेटा आयात करने पर स्टोरेज त्रुटि | फ़ाइल और ब्राउज़र सिंक स्टोरेज दोनों की आकार सीमा है; नियम या सूचियाँ कम करके दोबारा प्रयास करें और मौजूदा कॉन्फ़िगरेशन जाँचें। |
| रिमोट फ़ाइल बदलने के बाद एक्सटेंशन में बदलाव नहीं | रिमोट लोड एक बार का मैन्युअल आयात है; पता फिर दर्ज करें, लोड करें और पुष्टि करें। |