Ghid de configurare UA Pro

Import, export și configurare la distanță

Salvarea, transferul și scrierea manuală a configurației, precum și încărcarea ei de la o adresă la distanță.

Se aplică versiunii: UA Pro 1.5.0

Acest ghid se aplică UA Pro 1.5.0 și explică salvarea, transferul și scrierea manuală a configurației, precum și încărcarea ei de la o adresă la distanță. Noua versiune folosește un format de instantaneu complet: version al fișierului de configurare este 2.

Înainte de import, exportă o copie de siguranță în browserul de destinație. Fiecare import înlocuiește regula globală, întregul set de reguli de domeniu, ambele biblioteci UA și comutatorul pentru alternativa pe domeniul resursei cu instantaneul complet din fișier; intrările nu se îmbină individual. "globalRule": null înseamnă ștergerea regulii globale din browserul de destinație.

01Exportul configurației

  1. Apasă pictograma UA Pro din bara de instrumente a browserului.
  2. Deschide „Mai mult” → „Importă sau exportă configurația”.
  3. Apasă „Exportă configurația” și salvează fișierul .json descărcat.
  4. Numele fișierului seamănă cu ua-switcher-config-2026-11-16.json. Data din nume este generată în UTC și poate diferi cu o zi față de data locală.

Fișierul conține următoarele setări persistente:

  • Regula globală și starea ei activată sau întreruptă.
  • Întregul set de reguli de domeniu și starea lor activată sau întreruptă.
  • Categorii și intrări UA personalizate.
  • Categorii și intrări de text adăugat.
  • Comutatorul „Alternativă pe domeniul resursei”.

Fișierul nu conține reguli de filă, asocierile UA aleatorii deja selectate, filele deschise, limba interfeței, tema și setările suprapunerii. Aceste elemente nu vor fi restaurate din copie după import; importul nu șterge nici regulile de filă existente în browserul de destinație, care pot continua să aibă prioritate față de regulile de domeniu sau cea globală.

Fișierul exportat este JSON lizibil în text simplu. Păstrează copia în siguranță dacă UA-urile personalizate sau categoriile conțin informații pe care nu dorești să le divulgi.

02Importul dintr-un fișier local

  1. În browserul de destinație deschide UA Pro → „Mai mult” → „Importă sau exportă configurația”.
  2. Apasă mai întâi „Exportă configurația” pentru a păstra configurația inițială a browserului de destinație, în caz că trebuie restaurată.
  3. Apasă „Importă configurația” și selectează fișierul .json.
  4. Citește avertismentul de înlocuire și verifică numărul regulilor și al listelor. Apasă „Afișează conținutul configurației” pentru a examina întregul JSON înainte de confirmare. Alegerea „Anulează” nu scrie nimic. După confirmare, așteaptă mesajul „Configurația a fost importată!”. Dacă setările se schimbă în timpul confirmării, extensia va solicita repetarea operației.
  5. Verifică regulile globale și de domeniu, listele personalizate și comutatorul alternativei pe domeniul resursei; verifică și dacă regulile de filă existente au prioritate față de ele. Reîncarcă paginile pe care vrei să le testezi, apoi verifică UA-ul.

Extensia verifică mai întâi fișierul, încearcă apoi să instaleze regulile și în final scrie configurația persistentă. Dacă instalarea sau scrierea eșuează, încearcă să restaureze regulile salvate în acel moment în browser. Dacă raportează că restaurarea nu este posibilă, verifică setările reale. Când sincronizarea browserului sau altă fereastră modifică simultan configurația, procesul nu trebuie considerat o tranzacție între dispozitive.

03Încărcarea de la o adresă la distanță

Configurația la distanță folosește același conținut JSON ca o copie locală. Este o încărcare și un import manual unic, nu un abonament actualizat automat.

  1. Mai întâi exportă o copie de siguranță a configurației sau pregătește un fișier JSON conform instrucțiunilor de mai jos.
  2. Plasează fișierul pe un serviciu HTTPS accesibil browserului de destinație și obține o adresă completă care returnează direct conținutul JSON, de exemplu https://example.com/ua-pro/config.json. Adresa este doar un exemplu; înlocuiește-o cu adresa ta reală.
  3. În UA Pro, deschide „Mai mult” → „Importă sau exportă configurația”, extinde „Configurație la distanță”, lipește adresa și apasă „Încarcă”.
  4. După încărcarea și verificarea formatului, extensia afișează un dialog de confirmare și numele gazdei de la distanță. Apasă „Afișează conținutul configurației” pentru a examina întregul JSON descărcat efectiv. Confirmarea actualizează setările după aceleași reguli ca importul local; anularea nu importă nimic.
  5. După modificarea fișierului pe server, introdu din nou adresa, încarcă și confirmă pentru a folosi noul conținut. Adresa nu este păstrată automat la redeschiderea panoului.

Sunt acceptate numai linkuri HTTPS directe; nu sunt acceptate HTTP, nume de utilizator sau parole în adresă și fragmente URL, iar redirecționările nu sunt urmate. Cererea nu conține cookie-uri ale browserului sau date de autentificare, nu trimite Referer și ocolește memoria cache; prin urmare, serviciile care necesită cookie-uri de autentificare nu sunt potrivite. UA Pro nu aplică acestei cereri regulile UA configurate în extensie, dar alte extensii sau dispozitive de rețea o pot modifica. Adresa poate conține parametri de interogare; protejează o adresă cu token de acces ca pe o parolă. Folosește o adresă de încredere și asigură-te că răspunsul este direct un fișier JSON, nu o pagină de autentificare sau o pagină HTML care afișează cod.

Fișierele locale și răspunsurile de la distanță sunt limitate fiecare la 128 KiB; citirea de la distanță are o limită de 10 secunde și se contorizează conținutul citit efectiv. Stocarea sincronizată a browserului are și o cotă mai mică pentru fiecare element, astfel încât un fișier sub 128 KiB poate totuși să nu fie salvat dacă regulile sau o bibliotecă individuală sunt prea mari. În caz de eroare, verifică dacă serverul returnează starea 200 și JSON valid, dacă certificatul este valid, dacă adresa redirecționează și dacă rețeaua este accesibilă.

04Exemplu JSON complet

Exemplul următor poate fi salvat ca config.json cu codare UTF-8. Domeniile și valorile UA din exemplu sunt doar ilustrative; salvează configurația existentă înainte de înlocuire. JSON distinge majusculele de minuscule: folosește ghilimele duble pentru șiruri, nu adăuga virgulă după ultimul element și nu scrie comentarii în 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
  }
}

Exemplul setează un UA global încorporat și patru reguli de domeniu. Regulile de subdomeniu mai specifice, precum app.example.com, au prioritate față de example.com. Regulile întrerupte nu participă la potrivirea activă, astfel că poate intra în vigoare o regulă a domeniului părinte sau regula globală. Recunoașterea UA-ului din exemplu depinde de site-ul real.

05Câmpuri de nivel superior și înlocuire

Câmp Exemplu Rol
version 2 Obligatoriu. Noua versiune acceptă doar valoarea numerică 2.
type "ua-switcher-config" Obligatoriu. Identificatorul tipului de configurație; trebuie să coincidă exact cu acest șir.
timestamp "2026-11-16T06:00:00.000Z" Obligatoriu. Timp UTC cu milisecunde și Z; este doar pentru evidență și nu stabilește când intră regulile în vigoare.
data { ... } Obligatoriu. Obiectul care conține configurația completă, inclusiv toate câmpurile din tabelul de mai jos.
Câmpuri din data Format corect Comportamentul importului în această versiune
globalRule Un obiect de regulă sau null Un obiect de regulă înlocuiește regula globală existentă; null o șterge.
domainRules { "域名": 规则对象 } Întregul obiect înlocuiește regulile de domeniu anterioare; {} le șterge.
userCustomData { "分类": ["UA", ...] } Întregul obiect înlocuiește biblioteca anterioară de UA personalizate; {} o golește.
userAppendData { "分类": ["追加文本", ...] } Întregul obiect înlocuiește biblioteca anterioară de text adăugat; {} o golește.
resourceDomainFallback true sau false Valoare booleană JSON: activează sau dezactivează alternativa pe domeniul resursei.

Toate cele cinci câmpuri sunt obligatorii; null se poate folosi numai pentru globalRule. Câmpurile lipsă sau necunoscute și cheile JSON duplicate sunt respinse; nici configurațiile parțiale sau din versiuni vechi nu sunt importate. Regulile de domeniu și cele două biblioteci sunt înlocuite ca seturi complete: de exemplu, un domainRules cu un singur domeniu înlocuiește celelalte reguli de domeniu existente în browserul de destinație. Recomandăm editarea unui fișier exportat efectiv de noua versiune și păstrarea integrală a elementelor necesare.

Alternativa pe domeniul resursei poate aplica o regulă în funcție de domeniul de destinație al cererii resursei numai când pagina principală nu are un UA activ dintr-o regulă de filă, domeniu sau globală. Nu înseamnă că toate resursele din alte domenii au prioritate față de regula paginii principale.

06Cum se scriu obiectele de reguli

Regula globală și fiecare regulă de domeniu folosesc aceeași structură:

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

enabled: true înseamnă activată, iar false întreruptă. mode determină câmpurile din params:

6.1 UA încorporat: builtin

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

os și uaKey trebuie să coincidă exact cu cheile interne ale presetărilor din această versiune a extensiei; nu sunt neapărat identice cu textele traduse afișate în interfață. Cel mai sigur este să selectezi presetarea în interfață, să exporți configurația și să copiezi params corespunzător. Verifică din nou când lista presetărilor se schimbă între versiuni.

6.2 UA personalizat: custom

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

value este șirul UA complet. category este folosit pentru categorisire și editare în interfață; se recomandă includerea valorii și în categoria cu același nume din userCustomData. Regula activă citește propriul value; importul manual al unei reguli nu adaugă automat valoarea în biblioteca personalizată.

6.3 Adăugarea textului: append

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

Extensia adaugă un spațiu după UA-ul original al browserului curent, apoi adaugă value. Se recomandă păstrarea textului și în categoria cu același nume din userAppendData; importul regulii nu completează automat lista.

6.4 UA aleatoriu: random

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

strategy trebuie să fie "page" (selecție la fiecare încărcare completă a paginii) sau "tab" (păstrare în funcție de regulă și filă). Selecțiile aleatorii se pot repeta; două rezultate identice consecutive nu înseamnă neapărat că nu a avut loc o nouă selecție.

Valori uzuale pentru pool:

Valoare Sursa selecției aleatorii
all Toate UA-urile încorporate, personalizate și generate din textul adăugat
builtin Toate UA-urile încorporate
builtin_desktop, builtin_mobile, builtin_legacy Categorii încorporate pentru desktop, dispozitive mobile sau vechi
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social Categoria încorporată corespunzătoare
custom UA-uri din toate categoriile personalizate
custom:分类名 UA-uri din categoria indicată în userCustomData
append_all UA-uri corespunzătoare tuturor textelor adăugate
append:分类名 UA-uri corespunzătoare textului adăugat din categoria indicată în userAppendData

Numele categoriei după două puncte trebuie să corespundă unei chei din bibliotecă. O regulă aleatorie activată trebuie să aibă candidați disponibili, altfel fișierul va fi respins.

07Verificări la editarea manuală

  • Folosește nume de domenii drept chei în domainRules, de exemplu example.com sau shop.example.com; nu include https://, căi, porturi sau spații. Regulile de domeniu se potrivesc și subdomeniilor. În această versiune, *.example.com include și example.com însuși; nu înseamnă „doar subdomenii”.
  • Numele categoriilor pot conține caractere chinezești și trebuie să fie șiruri nevide, fără caractere de control sau controale periculoase pentru text bidirecțional; __proto__, prototype și constructor nu pot fi nume de categorii. Pentru UA și textul adăugat se recomandă caractere ASCII imprimabile; nu sunt permise caractere de linie nouă, tabulatoare sau alte caractere de control. Un UA poate avea cel mult 4096 de caractere. Ghilimelele duble și barele oblice inverse din text trebuie escapate conform regulilor JSON.
  • Fiecare categorie corespunde unui tablou de șiruri, de exemplu "常用": ["Agent/1.0", "Agent/2.0"]. Păstrează parantezele pătrate chiar și pentru un singur element. O categorie goală poate fi scrisă ca [].
  • Nu pune true, false și null între ghilimele duble; "false" este un șir, nu o valoare booleană.
  • Fișierul trebuie să fie UTF-8 și JSON valide, fără chei duplicate. Extensia verifică și structura, tipurile câmpurilor, regulile, numele presetărilor și grupurile de UA-uri pentru selecția aleatorie; sintaxa corectă nu garantează că o regulă poate fi folosită.

Un fișier de configurare poate schimba UA-ul trimis site-urilor de browser. HTTPS protejează transferul, dar nu garantează că configurația furnizată de server corespunde intențiilor tale. Importă doar fișiere din surse de încredere, examinează conținutul înainte de confirmare și verifică efectul real după reîncărcarea paginii de destinație.

08Întrebări frecvente

Problemă Ce să verifici
Este raportat un format de fișier incorect Verifică UTF-8, sintaxa JSON, cheile duplicate, versiunea, câmpurile obligatorii și tipurile de reguli. Folosește ca șablon un fișier exportat de noua versiune.
Încărcarea de la distanță eșuează Verifică certificatul HTTPS, linkul direct, rețeaua și conținutul răspunsului. Redirecționările, autentificarea prin cookie și HTTP nu sunt permise.
Lipsesc reguli după import Regulile de domeniu și cele două biblioteci sunt înlocuite ca seturi complete. Restaurează copia de dinaintea importului sau adaugă în noul fișier toate elementele pe care vrei să le păstrezi.
A fost importată o regulă globală goală, dar pagina folosește în continuare alt UA Verifică regulile de filă existente sau regulile de domeniu potrivite; acestea pot avea prioritate față de regula globală.
Importul a reușit, dar UA-ul este greșit Verifică dacă regula este activată, conținutul este valid, grupul de UA-uri pentru selecția aleatorie are elemente disponibile și dacă există o regulă de filă sau domeniu cu prioritate mai mare; apoi reîncarcă pagina.
Eroare de stocare la importul multor date Atât fișierul, cât și stocarea sincronizată a browserului au limite de dimensiune. Redu regulile sau listele și încearcă din nou, apoi verifică configurația existentă.
Extensia nu se schimbă după modificarea fișierului de la distanță Încărcarea de la distanță este un import manual unic. Introdu din nou adresa, încarcă și confirmă.