Mwongozo wa usanidi wa UA Pro

Kuingiza, kuhamisha na kupakia usanidi wa mbali

Hifadhi nakala, hamisha au andika usanidi kwa mkono, na uupakie kutoka anwani ya mbali.

Inatumika kwa UA Pro 1.5.0

Mwongozo huu unatumika kwa UA Pro 1.5.0 na unaeleza kuhifadhi nakala, kuhamisha na kuandika usanidi kwa mkono, na kuupakia kutoka anwani ya mbali. Toleo jipya hutumia muundo wa picha kamili ya usanidi: version ya faili ya usanidi ni 2.

Kabla ya kuingiza, hamisha nakala ya usanidi wa kivinjari lengwa kwenye faili. Kila uingizaji hubadilisha kanuni ya jumla, kanuni zote za vikoa, maktaba zote mbili za UA na swichi ya kanuni mbadala ya kikoa cha nyenzo kwa picha kamili iliyo kwenye faili; hauziunganishe moja moja. "globalRule": null hufuta kanuni ya jumla ya kivinjari lengwa.

01Hamisha usanidi kwenye faili

  1. Bofya ikoni ya UA Pro kwenye upau wa zana wa kivinjari.
  2. Fungua “Zaidi” → “Ingiza usanidi au uhamishe kwenye faili”.
  3. Bofya “Hamisha usanidi kwenye faili” na uhifadhi faili ya .json iliyopakuliwa.
  4. Jina la faili hufanana na ua-switcher-config-2026-11-16.json. Tarehe katika jina hutumia UTC na inaweza kutofautiana na tarehe ya eneo lako kwa siku moja.

Faili ina mipangilio ifuatayo ya kudumu:

  • Kanuni ya jumla na hali yake ya kuwashwa au kusitishwa.
  • Kanuni zote za vikoa na hali zao za kuwashwa au kusitishwa.
  • Kategoria na vipengee vya UA maalum.
  • Kategoria na vipengee vya maandishi ya kuongeza.
  • Swichi ya “Kanuni mbadala ya kikoa cha nyenzo”.

Faili haijumuishi kanuni za vichupo, uhusiano wa UA nasibu ambazo tayari zimechaguliwa, vichupo vilivyo wazi, lugha ya kiolesura, mandhari au mipangilio ya kidirisha kinachoelea. Vipengee hivyo havitarejeshwa kutoka nakala wakati wa kuingiza. Uingizaji pia haufuti kanuni za vichupo zilizopo kwenye kivinjari lengwa, hivyo zinaweza kuendelea kuchukua kipaumbele juu ya kanuni za kikoa au ya jumla.

Faili iliyohamishwa ni maandishi ya JSON yanayosomeka. Ikiwa UA maalum au kategoria zina taarifa zisizopaswa kuwekwa wazi, hifadhi nakala kwa usalama.

02Ingiza kutoka faili ya kifaa

  1. Katika kivinjari lengwa fungua UA Pro → “Zaidi” → “Ingiza usanidi au uhamishe kwenye faili”.
  2. Kwanza bofya “Hamisha usanidi kwenye faili” ili kuhifadhi usanidi wa awali wa kivinjari lengwa kwa ajili ya kuurejesha ikihitajika.
  3. Bofya “Ingiza usanidi” na uchague faili ya .json.
  4. Soma onyo la kubadilisha na idadi ya kanuni na orodha. Bofya “Tazama maudhui ya usanidi” ili kukagua JSON nzima kabla ya kuthibitisha. Kuchagua “Ghairi” hakuandiki mabadiliko. Baada ya kuthibitisha, subiri ujumbe “Usanidi umeingizwa!”. Mipangilio ikibadilika wakati wa uthibitisho, kiendelezi kitakuomba urudie hatua.
  5. Kagua kanuni za jumla na za vikoa, orodha maalum na swichi ya kanuni mbadala ya kikoa cha nyenzo. Angalia pia kama kanuni za vichupo zilizopo zinachukua kipaumbele. Onyesha upya kurasa za kujaribu kisha hakiki UA.

Kiendelezi kwanza hukagua faili, kisha hujaribu kusakinisha kanuni na mwishowe huandika usanidi wa kudumu. Usakinishaji au uandishi ukishindwa, hujaribu kurejesha kanuni zilizohifadhiwa sasa kwenye kivinjari; kikisema urejeshaji umeshindwa, kagua mipangilio halisi. Usichukulie mchakato huu kama muamala wa vifaa vingi wakati usawazishaji wa kivinjari au dirisha jingine linabadilisha usanidi kwa wakati mmoja.

03Pakia kutoka anwani ya mbali

Usanidi wa mbali hutumia maudhui yale yale ya JSON kama nakala ya kifaa. Ni upakiaji na uingizaji wa mkono wa mara moja, si usajili unaosasishwa kiotomatiki.

  1. Kwanza hamisha nakala kwenye faili au andaa faili ya JSON kwa kufuata maelekezo hapa chini.
  2. Weka faili kwenye huduma ya HTTPS inayofikiwa na kivinjari lengwa na upate anwani kamili inayorudisha maudhui ya JSON moja kwa moja, kwa mfano https://example.com/ua-pro/config.json. Hii ni mfano tu; badilisha kwa anwani yako halisi.
  3. Katika UA Pro, fungua “Zaidi” → “Ingiza usanidi au uhamishe kwenye faili”, panua “Usanidi wa mbali”, bandika anwani kisha ubofye “Pakia”.
  4. Upakiaji na ukaguzi wa muundo vikifaulu, kiendelezi huonyesha kisanduku cha uthibitisho na jina la seva ya mbali. Bofya “Tazama maudhui ya usanidi” kukagua JSON nzima iliyopakuliwa. Kuthibitisha husasisha mipangilio kwa kanuni zile zile za uingizaji wa faili ya kifaa; kughairi hakuingizi chochote.
  5. Faili ikibadilishwa kwenye seva, ili kutumia maudhui mapya ingiza anwani tena, pakia na uthibitishe. Anwani haihifadhiwi kiotomatiki unapofungua paneli tena.

Viungo vya moja kwa moja vya HTTPS pekee vinakubaliwa. HTTP, jina la mtumiaji au nenosiri ndani ya anwani, na kipande cha URL havikubaliwi; uelekezaji upya haufuatwi. Ombi halibebi vidakuzi au taarifa za kuingia za kivinjari, halitumi kichwa cha Referer na halitumii akiba. Kwa hiyo huduma inayohitaji kidakuzi cha kuingia haifai. UA Pro haitumii kanuni za UA za kiendelezi hiki kwa ombi hilo, lakini viendelezi vingine au vifaa vya mtandao vinaweza kulibadilisha. Anwani inaweza kuwa na vigezo vya hoja; hifadhi anwani yenye tokeni ya ufikiaji kama nenosiri. Tumia anwani inayoaminika na uhakikishe jibu ni faili ya JSON moja kwa moja, si ukurasa wa kuingia au ukurasa wa HTML unaoonyesha msimbo.

Faili ya kifaa na jibu la mbali vina kikomo cha 128 KiB; usomaji wa mbali una kikomo cha sekunde 10 na huhesabu maudhui yaliyosomwa kwa hakika. Hifadhi ya usawazishaji wa kivinjari ina kikomo kidogo zaidi kwa kipengee kimoja, hivyo hata faili chini ya 128 KiB inaweza kushindwa kuhifadhiwa kwa sababu ya ukubwa wa kanuni au maktaba moja. Hitilafu ikitokea, angalia kama seva inarudisha hali 200 na JSON halali, cheti ni halali, anwani inaelekeza upya na mtandao unafikika.

04Mfano kamili wa JSON

Mfano ufuatao unaweza kuhifadhiwa kama faili ya config.json yenye usimbaji UTF-8. Vikoa na thamani za UA ni mifano tu; hifadhi nakala ya usanidi uliopo kabla ya kuubadilisha. JSON hutofautisha herufi kubwa na ndogo; tumia alama za kunukuu mbili za kawaida kwa mifuatano, usiweke koma baada ya kipengee cha mwisho wala maoni ndani ya JSON.

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
  }
}

Mfano huu unaweka UA moja ya jumla iliyojengwa ndani na kanuni nne za vikoa. Kanuni maalum zaidi za vikoa vidogo kama app.example.com zina kipaumbele juu ya example.com. Kanuni zilizosimamishwa hazilinganishwi, hivyo kanuni ya kikoa kikuu au ya jumla inaweza kutumika. Kama tovuti itatambua UA ya mfano inategemea tovuti yenyewe.

05Sehemu za kiwango cha juu na ubadilishaji

Sehemu Mfano Kazi
version 2 Inahitajika. Toleo jipya linakubali thamani ya nambari 2 pekee.
type "ua-switcher-config" Inahitajika. Kitambulisho cha aina ya usanidi lazima kilingane kabisa na mfuatano huu.
timestamp "2026-11-16T06:00:00.000Z" Inahitajika. Wakati wa UTC wenye milisekunde na Z; kwa kumbukumbu tu, hauamui wakati kanuni zinaanza kutumika.
data { ... } Inahitajika. Objekti yenye usanidi kamili na sehemu zote za jedwali lifuatalo.
Sehemu katika data Muundo sahihi Tabia ya kuingiza katika toleo hili
globalRule Objekti moja ya kanuni au null Objekti ya kanuni hubadilisha kanuni ya jumla iliyopo; null huifuta.
domainRules { "域名": 规则对象 } Objekti nzima hubadilisha kanuni za vikoa zilizopo; {} huzifuta.
userCustomData { "分类": ["UA", ...] } Objekti nzima hubadilisha maktaba ya awali ya UA maalum; {} huiweka tupu.
userAppendData { "分类": ["追加文本", ...] } Objekti nzima hubadilisha maktaba ya awali ya maandishi ya kuongeza; {} huiweka tupu.
resourceDomainFallback true au false Thamani ya Boolean ya JSON: huwasha au kuzima kanuni mbadala ya kikoa cha nyenzo.

Sehemu zote tano zinahitajika; null hairuhusiwi isipokuwa kwa globalRule. Sehemu zinazokosekana au zisizojulikana na funguo za JSON zilizorudiwa hukataliwa; usanidi wa zamani au usiokamilika pia hauingizwe. Kanuni za vikoa na maktaba zote mbili hubadilishwa kwa makundi kamili: kwa mfano domainRules yenye kikoa kimoja tu itabadilisha pia kanuni nyingine za vikoa katika kivinjari lengwa. Inapendekezwa kuhariri faili halisi iliyohamishwa kutoka toleo jipya na kuhifadhi vipengee vyote vinavyohitajika.

Kanuni mbadala ya kikoa cha nyenzo inaweza kutumia kanuni kulingana na kikoa lengwa cha ombi la nyenzo tu ikiwa ukurasa mkuu hauna UA halali ya kichupo, kikoa au ya jumla. Haimaanishi kwamba nyenzo zote za vikoa vingine zitachukua nafasi ya kanuni ya ukurasa mkuu.

06Kuandika objekti ya kanuni

Kanuni ya jumla na kila kanuni ya kikoa hutumia muundo sawa:

JSON
{
  "enabled": true,
  "mode": "custom",
  "params": {
    "category": "常用",
    "value": "ExampleAgent/1.0"
  }
}

enabled: true humaanisha imewashwa, false imesitishwa. mode huamua sehemu za params:

6.1 UA iliyojengwa ndani: builtin

JSON
{
  "enabled": true,
  "mode": "builtin",
  "params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}

os na uaKey lazima zilingane kabisa na funguo za mipangilio ya awali ya ndani ya toleo hili la kiendelezi; si lazima zilingane na majina yaliyotafsiriwa kwenye kiolesura. Njia salama zaidi ni kuchagua mpangilio kwenye kiolesura, kuhamisha usanidi na kunakili params inayolingana. Kagua tena orodha ya mipangilio ikibadilika kati ya matoleo.

6.2 UA maalum: custom

JSON
{
  "enabled": true,
  "mode": "custom",
  "params": { "category": "常用", "value": "ExampleAgent/1.0" }
}

value ni mfuatano kamili wa UA. category hutumika kwa kategoria na kuhariri kwenye kiolesura; inapendekezwa kujumuisha thamani hiyo pia katika kategoria ya jina hilo hilo ndani ya userCustomData. Kanuni inayotumika husoma value yake yenyewe; kuingiza kanuni kwa mkono hakuongezi thamani hiyo kiotomatiki kwenye maktaba maalum.

6.3 Maandishi ya kuongeza: append

JSON
{
  "enabled": true,
  "mode": "append",
  "params": { "category": "应用标记", "value": "MyApp/1.0" }
}

Kiendelezi huongeza nafasi baada ya UA asili ya kivinjari, kisha huongeza value. Inapendekezwa kuhifadhi maandishi hayo pia katika kategoria ya jina hilo hilo ndani ya userAppendData; kuingiza kanuni hakujazi orodha kiotomatiki.

6.4 UA nasibu: random

JSON
{
  "enabled": true,
  "mode": "random",
  "params": { "pool": "custom:随机示例", "strategy": "page" }
}

strategy lazima iwe "page" (huchaguliwa kila ukurasa unapopakiwa kikamilifu) au "tab" (hudumishwa kwa kanuni na kichupo). Chaguo nasibu linaweza kujirudia; matokeo mawili sawa mfululizo hayamaanishi lazima kwamba uchaguzi haukurudiwa.

Thamani za kawaida za pool:

Thamani Chanzo cha uchaguzi nasibu
all UA zote zilizojengwa ndani, UA maalum na UA zinazotokana na maandishi ya kuongeza
builtin UA zote zilizojengwa ndani
builtin_desktop, builtin_mobile, builtin_legacy Kategoria zilizojengwa ndani za kompyuta, vifaa vya mkononi au vifaa vya zamani
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social Kategoria zinazolingana zilizojengwa ndani
custom UA katika kategoria zote maalum
custom:分类名 UA za kategoria iliyobainishwa katika userCustomData
append_all UA zinazolingana na maandishi yote ya kuongeza
append:分类名 UA zinazolingana na maandishi ya kuongeza katika kategoria iliyobainishwa katika userAppendData

Jina la kategoria baada ya koloni lazima lilingane na ufunguo kwenye maktaba. Kanuni nasibu iliyowashwa lazima iwe na chaguo zinazopatikana, vinginevyo faili itakataliwa.

07Ukaguzi wakati wa kuhariri kwa mkono

  • Kwa funguo za domainRules andika vikoa, kwa mfano example.com, shop.example.com, si https://, njia, bandari au nafasi. Kanuni za kikoa pia zinalingana na vikoa vidogo vya chini; katika toleo hili *.example.com inajumuisha example.com yenyewe, si vikoa vidogo pekee.
  • Majina ya kategoria yanaweza kutumia Kichina; lazima yawe mifuatano isiyo tupu bila herufi za udhibiti au herufi hatari za udhibiti wa maandishi ya pande mbili. __proto__, prototype na constructor haziwezi kuwa majina ya kategoria. Kwa UA na maandishi ya kuongeza, herufi za ASCII zinazochapishika zinapendekezwa; usijumuishe mistari mipya, tab au herufi nyingine za udhibiti. UA moja inaweza kuwa na herufi zisizozidi 4096. Alama za kunukuu mbili za kawaida na mikwaju nyuma katika maandishi lazima ziandikwe kwa kutumia escape kulingana na sheria za JSON.
  • Kila kategoria inalingana na safu ya mifuatano, kwa mfano "常用": ["Agent/1.0", "Agent/2.0"]. Weka mabano ya mraba hata ikiwa kuna kipengee kimoja tu. Kategoria tupu inaweza kuandikwa [].
  • true, false na null hazipaswi kuwekwa kwenye alama za kunukuu mbili; "false" ni mfuatano, si Boolean.
  • Faili lazima iwe UTF-8 na JSON halali bila funguo zilizorudiwa. Kiendelezi pia hukagua muundo, aina za sehemu, kanuni, majina ya mipangilio ya awali na makundi ya chaguo nasibu; sintaksia sahihi haihakikishi kwamba kanuni inatumika.

Faili ya usanidi inaweza kubadilisha UA inayotumwa na kivinjari kwa tovuti. HTTPS hulinda usafirishaji lakini haihakikishi kwamba usanidi wa seva unalingana na unavyotaka. Ingiza kutoka vyanzo vinavyoaminika tu, kagua maudhui kabla ya kuthibitisha na uhakiki matokeo halisi baada ya kuonyesha upya ukurasa lengwa.

08Maswali ya kawaida

Tatizo Ukaguzi
Ujumbe wa muundo wa faili usio sahihi Kagua UTF-8, sintaksia ya JSON, funguo zilizorudiwa, toleo, sehemu zinazohitajika na aina za kanuni; tumia faili iliyohamishwa kutoka toleo jipya kama kiolezo.
Upakiaji wa mbali umeshindwa Kagua cheti cha HTTPS, kiungo cha moja kwa moja, mtandao na maudhui ya jibu; uelekezaji upya, kuingia kwa kidakuzi na HTTP haviruhusiwi.
Kanuni zimepungua baada ya kuingiza Kanuni za vikoa na maktaba zote mbili hubadilishwa kwa ukamilifu; rejesha kutoka nakala iliyotengenezwa kabla ya kuingiza au ongeza vipengee vinavyohitajika kwenye faili mpya.
Kanuni tupu ya jumla imeingizwa lakini ukurasa bado unatumia UA nyingine Kagua kanuni za vichupo zilizopo au kanuni za vikoa zinazolingana; zinaweza kuwa na kipaumbele kuliko kanuni ya jumla.
Imeonyesha mafanikio lakini UA si sahihi Kagua kama kanuni imewashwa, maudhui ni halali, kundi la nasibu lina chaguo na kama kuna kanuni ya kichupo au kikoa yenye kipaumbele cha juu, kisha onyesha upya ukurasa.
Hitilafu ya hifadhi wakati wa kuingiza data nyingi Faili na hifadhi ya usawazishaji wa kivinjari zina vikomo vya ukubwa; punguza kanuni au orodha, jaribu tena na ukague usanidi uliopo.
Kiendelezi hakijabadilika baada ya faili ya mbali kubadilishwa Upakiaji wa mbali ni uingizaji wa mkono wa mara moja; ingiza anwani tena, pakia na uthibitishe.