हा मार्गदर्शक 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 चुकीचा आहे | नियम सक्षम आहे का, सामग्री वैध आहे का, यादृच्छिक पूलमध्ये पर्याय आहेत का आणि उच्च प्राधान्याचा टॅब किंवा डोमेन नियम आहे का तपासा, मग पृष्ठ रिफ्रेश करा. |
| मोठा डेटा इम्पोर्ट करताना स्टोरेज त्रुटी | फाइल आणि ब्राउझर सिंक स्टोरेज दोन्हींना आकार मर्यादा आहे; नियम किंवा याद्या कमी करून पुन्हा प्रयत्न करा आणि विद्यमान कॉन्फिगरेशन तपासा. |
| रिमोट फाइल बदलल्यानंतर एक्सटेंशन बदलत नाही | रिमोट लोड एकदाचे मॅन्युअल इम्पोर्ट आहे; पत्ता पुन्हा प्रविष्ट करून लोड करा आणि पुष्टी करा. |