Ten przewodnik dotyczy UA Pro 1.5.0. Opisuje tworzenie kopii zapasowych, przenoszenie i ręczne przygotowywanie konfiguracji oraz wczytywanie jej ze zdalnego adresu. Nowa wersja używa formatu pełnej migawki: version pliku konfiguracji ma wartość 2.
Przed importem wyeksportuj kopię zapasową w przeglądarce docelowej. Każdy import zastępuje regułę globalną, cały zestaw reguł domen, obie biblioteki UA oraz przełącznik zapasowych reguł domeny zasobu pełną migawką z pliku; poszczególne wpisy nie są scalane. "globalRule": null oznacza usunięcie reguły globalnej w przeglądarce docelowej.
01Eksportowanie konfiguracji
- Kliknij ikonę UA Pro na pasku narzędzi przeglądarki.
- Otwórz „Więcej” → „Importowanie i eksportowanie konfiguracji”.
- Kliknij „Eksportuj konfigurację” i zapisz pobrany plik
.json. - Nazwa pliku przypomina
ua-switcher-config-2026-11-16.json. Data w nazwie jest tworzona według UTC i może różnić się o dzień od daty lokalnej.
Plik zawiera następujące trwałe ustawienia:
- Regułę globalną i jej stan: włączona lub wstrzymana.
- Cały zestaw reguł domen i ich stan: włączone lub wstrzymane.
- Kategorie i wpisy własnych UA.
- Kategorie i wpisy dołączanego tekstu.
- Przełącznik „Zapasowe reguły domeny zasobu”.
Plik nie zawiera reguł kart, wcześniej wylosowanych przypisań UA, aktualnie otwartych kart, języka interfejsu, motywu ani ustawień nakładki. Po imporcie te elementy nie zostaną przywrócone z kopii; import nie usuwa również istniejących reguł kart w przeglądarce docelowej, więc mogą one nadal mieć pierwszeństwo przed regułami domen lub regułą globalną.
Wyeksportowany plik to czytelny JSON zapisany jawnym tekstem. Jeśli własne UA lub kategorie zawierają informacje, których nie chcesz ujawniać, przechowuj kopię w bezpiecznym miejscu.
02Importowanie z pliku lokalnego
- W przeglądarce docelowej otwórz UA Pro → „Więcej” → „Importowanie i eksportowanie konfiguracji”.
- Najpierw kliknij „Eksportuj konfigurację”, aby zachować pierwotną konfigurację przeglądarki docelowej na wypadek potrzeby jej przywrócenia.
- Kliknij „Importuj konfigurację” i wybierz plik
.json. - Przeczytaj ostrzeżenie o zastąpieniu oraz sprawdź liczby reguł i list. Kliknij „Pokaż zawartość konfiguracji”, aby przed potwierdzeniem przejrzeć cały JSON. Wybranie „Anuluj” niczego nie zapisuje. Po potwierdzeniu poczekaj na komunikat „Konfiguracja zaimportowana!”. Jeśli ustawienia zmienią się podczas potwierdzania, rozszerzenie poprosi o ponowne wykonanie operacji.
- Sprawdź reguły globalne i domen, własne listy oraz przełącznik zapasowych reguł domeny zasobu; sprawdź też, czy istniejące reguły kart nie mają przed nimi pierwszeństwa. Odśwież strony, które chcesz przetestować, i sprawdź UA.
Rozszerzenie najpierw sprawdza plik, następnie próbuje zainstalować reguły, a na końcu zapisuje trwałą konfigurację. Jeśli instalacja lub zapis się nie powiedzie, próbuje przywrócić reguły obecnie zapisane w przeglądarce. Jeśli pojawi się komunikat, że przywrócenie nie jest możliwe, sprawdź rzeczywiste ustawienia. Gdy synchronizacja przeglądarki lub inne okno jednocześnie zmienia konfigurację, nie należy traktować tego procesu jako transakcji między urządzeniami.
03Wczytywanie ze zdalnego adresu
Konfiguracja zdalna używa tej samej zawartości JSON co lokalna kopia zapasowa. Jest to jednorazowe ręczne wczytanie i import, a nie automatycznie aktualizowana subskrypcja.
- Najpierw wyeksportuj kopię konfiguracji albo przygotuj plik JSON zgodnie z poniższymi wskazówkami.
- Umieść plik w usłudze HTTPS dostępnej dla przeglądarki docelowej i uzyskaj pełny adres zwracający bezpośrednio zawartość JSON, na przykład
https://example.com/ua-pro/config.json. To tylko przykładowy adres; zastąp go własnym rzeczywistym adresem. - W UA Pro otwórz „Więcej” → „Importowanie i eksportowanie konfiguracji”, rozwiń „Konfiguracja zdalna”, wklej adres i kliknij „Wczytaj”.
- Po pomyślnym wczytaniu i sprawdzeniu formatu rozszerzenie wyświetli okno potwierdzenia oraz nazwę zdalnego hosta. Kliknij „Pokaż zawartość konfiguracji”, aby sprawdzić cały faktycznie pobrany JSON. Potwierdzenie aktualizuje ustawienia według tych samych zasad co import lokalny; anulowanie nie powoduje importu.
- Po zmianie pliku na serwerze ponownie wpisz adres, wczytaj i potwierdź, aby użyć nowej zawartości. Po ponownym otwarciu panelu adres nie jest automatycznie zachowywany.
Akceptowane są wyłącznie bezpośrednie łącza HTTPS. Nie są akceptowane HTTP, nazwa użytkownika ani hasło w adresie oraz fragmenty URL; przekierowania nie są obsługiwane. Żądanie nie zawiera plików cookie przeglądarki ani danych logowania, nie wysyła nagłówka Referer i omija pamięć podręczną; usługi wymagające logowania za pomocą cookie nie są więc odpowiednie. UA Pro nie stosuje do tego żądania reguł UA skonfigurowanych w tym rozszerzeniu, ale inne rozszerzenia lub urządzenia sieciowe nadal mogą je zmodyfikować. Adres może zawierać parametry zapytania; adres zawierający token dostępu należy chronić jak hasło. Używaj zaufanego adresu i upewnij się, że odpowiedź jest bezpośrednio plikiem JSON, a nie stroną logowania lub stroną HTML wyświetlającą kod.
Plik lokalny i odpowiedź zdalna mają limit po 128 KiB; odczyt zdalny jest ograniczony do 10 sekund, a liczy się faktycznie odczytana zawartość. Synchronizowana pamięć przeglądarki ma również mniejszy limit pojedynczego elementu, więc plik poniżej 128 KiB może nie zostać zapisany, jeśli reguły lub pojedyncza biblioteka są zbyt duże. W razie błędu sprawdź, czy serwer zwraca status 200 i poprawny JSON, czy certyfikat jest ważny, czy adres przekierowuje oraz czy sieć jest dostępna.
04Pełny przykład JSON
Poniższy przykład można zapisać jako config.json w kodowaniu UTF-8. Przykładowe domeny i wartości UA służą wyłącznie do ilustracji; przed zastąpieniem obecnej konfiguracji utwórz jej kopię zapasową. JSON rozróżnia wielkość liter: ciągi zapisuj w podwójnych cudzysłowach, nie stawiaj przecinka po ostatnim elemencie i nie umieszczaj komentarzy w 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
}
}
Ten przykład ustawia jeden wbudowany globalny UA i cztery reguły domen. Bardziej szczegółowe reguły subdomen, takie jak app.example.com, mają pierwszeństwo przed example.com. Wstrzymane reguły nie uczestniczą w dopasowaniu aktywnych reguł, więc może zadziałać reguła domeny nadrzędnej lub globalna. To, czy rzeczywista witryna rozpozna przykładowy UA, zależy od niej samej.
05Pola najwyższego poziomu i zastępowanie danych
| Pole | Przykład | Funkcja |
|---|---|---|
version |
2 |
Wymagane. Nowa wersja akceptuje wyłącznie wartość liczbową 2. |
type |
"ua-switcher-config" |
Wymagane. Identyfikator typu konfiguracji; musi dokładnie odpowiadać temu ciągowi. |
timestamp |
"2026-11-16T06:00:00.000Z" |
Wymagane. Czas UTC z milisekundami i Z; służy wyłącznie do zapisu informacji, nie określa czasu działania reguł. |
data |
{ ... } |
Wymagane. Obiekt zawierający pełną konfigurację, w tym wszystkie pola z poniższej tabeli. |
Pola w data |
Poprawny format | Zachowanie importu w tej wersji |
|---|---|---|
globalRule |
Jeden obiekt reguły lub null |
Obiekt reguły zastępuje istniejącą regułę globalną; null ją usuwa. |
domainRules |
{ "域名": 规则对象 } |
Cały obiekt zastępuje dotychczasowe reguły domen; {} je usuwa. |
userCustomData |
{ "分类": ["UA", ...] } |
Cały obiekt zastępuje dotychczasową bibliotekę własnych UA; {} ją opróżnia. |
userAppendData |
{ "分类": ["追加文本", ...] } |
Cały obiekt zastępuje dotychczasową bibliotekę dołączanego tekstu; {} ją opróżnia. |
resourceDomainFallback |
true lub false |
Wartość logiczna JSON: włącza lub wyłącza zapasowe reguły domeny zasobu. |
Wszystkie pięć pól jest wymaganych; null można użyć tylko w globalRule. Brakujące i nieznane pola oraz zduplikowane klucze JSON są odrzucane; konfiguracje częściowe lub ze starszych wersji również nie są importowane. Reguły domen i obie biblioteki są zastępowane w całości: na przykład domainRules z tylko jedną domeną zastąpi pozostałe istniejące reguły domen w przeglądarce docelowej. Zalecamy edycję rzeczywistego pliku wyeksportowanego przez nową wersję i zachowanie wszystkich potrzebnych elementów.
Zapasowa reguła domeny zasobu może zastosować regułę według domeny docelowej żądania zasobu tylko wtedy, gdy strona główna nie ma aktywnego UA z reguły karty, domeny ani globalnej. Nie oznacza to, że wszystkie zasoby między domenami zastępują regułę strony głównej.
06Jak tworzyć obiekty reguł
Reguła globalna i każda reguła domeny mają tę samą strukturę:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
enabled: true oznacza włączenie, a false wstrzymanie. mode określa pola obiektu params:
6.1 Wbudowany UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
os i uaKey muszą dokładnie odpowiadać wewnętrznym kluczom ustawień wstępnych tej wersji rozszerzenia; nie muszą być takie same jak przetłumaczone nazwy w interfejsie. Najbezpieczniej wybrać ustawienie w interfejsie, wyeksportować konfigurację i skopiować odpowiedni params. Sprawdź je ponownie, gdy lista ustawień zmieni się między wersjami.
6.2 Własny UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
value to pełny ciąg UA. category służy do kategoryzacji i edycji w interfejsie; zalecamy umieszczenie tej wartości również w kategorii o tej samej nazwie w userCustomData. Działająca reguła odczytuje własne value; ręczny import reguły nie dodaje tej wartości automatycznie do własnej biblioteki.
6.3 Dołączany tekst: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
Rozszerzenie dodaje spację po oryginalnym UA bieżącej przeglądarki, a następnie dołącza value. Zalecamy zachowanie tego tekstu także w kategorii o tej samej nazwie w userAppendData; import reguły nie wypełnia listy automatycznie.
6.4 Losowy UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
strategy musi mieć wartość "page" (losowanie przy każdym pełnym załadowaniu strony) lub "tab" (utrzymanie według reguły i karty). Losowania mogą się powtarzać; dwa identyczne wyniki z rzędu nie muszą oznaczać braku nowego losowania.
Typowe wartości pool:
| Wartość | Źródło losowania |
|---|---|
all |
Wszystkie wbudowane i własne UA oraz UA utworzone z dołączanego tekstu |
builtin |
Wszystkie wbudowane UA |
builtin_desktop, builtin_mobile, builtin_legacy |
Wbudowane kategorie komputerów, urządzeń mobilnych lub starszych |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
Odpowiednia wbudowana kategoria |
custom |
UA ze wszystkich własnych kategorii |
custom:分类名 |
UA z kategorii wskazanej w userCustomData |
append_all |
UA odpowiadające wszystkim dołączanym tekstom |
append:分类名 |
UA odpowiadające dołączanym tekstom z kategorii wskazanej w userAppendData |
Nazwa kategorii po dwukropku musi odpowiadać kluczowi w bibliotece. Włączona reguła losowa musi mieć dostępnych kandydatów; w przeciwnym razie plik zostanie odrzucony.
07Kontrola przy ręcznej edycji
- Jako klucze w
domainRuleswpisuj nazwy domen, na przykładexample.comlubshop.example.com; nie wpisujhttps://, ścieżek, portów ani spacji. Reguły domen obejmują także subdomeny. W tej wersji*.example.comobejmuje również samoexample.com; nie oznacza „tylko subdomen”. - Nazwy kategorii mogą zawierać znaki chińskie i muszą być niepustymi ciągami bez znaków sterujących ani niebezpiecznych znaków sterujących tekstem dwukierunkowym;
__proto__,prototypeiconstructornie mogą być nazwami kategorii. W UA i dołączanym tekście zaleca się stosowanie drukowalnych znaków ASCII. UA i dołączany tekst nie mogą zawierać znaków nowej linii, tabulatorów ani innych znaków sterujących. Pojedynczy UA może mieć maksymalnie 4096 znaków. Podwójne cudzysłowy i ukośniki odwrotne w tekście należy zapisać ze znakami ucieczki zgodnie z zasadami JSON. - Każdej kategorii odpowiada tablica ciągów, na przykład
"常用": ["Agent/1.0", "Agent/2.0"]. Zachowaj nawiasy kwadratowe nawet dla jednego elementu. Pustą kategorię można zapisać jako[]. - Nie ujmuj
true,falseaninullw podwójne cudzysłowy;"false"jest ciągiem, a nie wartością logiczną. - Plik musi być poprawnym UTF-8 i JSON, bez zduplikowanych kluczy. Rozszerzenie sprawdza też strukturę, typy pól, reguły, nazwy ustawień wstępnych i pule losowania; poprawna składnia nie gwarantuje, że reguła nadaje się do użycia.
Plik konfiguracji może zmienić UA wysyłany przez przeglądarkę do witryn. HTTPS chroni transmisję, ale nie gwarantuje, że konfiguracja serwera odpowiada Twoim zamiarom. Importuj tylko pliki z zaufanych źródeł, przed potwierdzeniem sprawdź zawartość i po odświeżeniu strony docelowej sprawdź rzeczywisty efekt.
08Częste pytania
| Problem | Co sprawdzić |
|---|---|
| Komunikat o nieprawidłowym formacie pliku | Sprawdź UTF-8, składnię JSON, zduplikowane klucze, wersję, wymagane pola i typy reguł. Jako szablonu użyj pliku wyeksportowanego przez nową wersję. |
| Niepowodzenie wczytania zdalnego | Sprawdź certyfikat HTTPS, bezpośredni link, sieć i zawartość odpowiedzi. Przekierowania, logowanie przez cookie i HTTP nie są dozwolone. |
| Po imporcie brakuje reguł | Reguły domen i obie biblioteki są zastępowane w całości. Przywróć kopię sprzed importu albo uzupełnij nowy plik o wszystkie elementy, które chcesz zachować. |
| Zaimportowano pustą regułę globalną, ale strona nadal używa innego UA | Sprawdź istniejące reguły kart lub pasujące reguły domen; mogą mieć pierwszeństwo przed regułą globalną. |
| Import się powiódł, ale UA jest nieprawidłowy | Sprawdź, czy reguła jest włączona, jej zawartość jest poprawna, pula losowania zawiera dostępne elementy i czy nie ma reguły karty lub domeny o wyższym priorytecie; następnie odśwież stronę. |
| Błąd pamięci przy imporcie dużej ilości danych | Zarówno plik, jak i synchronizowana pamięć przeglądarki mają limity rozmiaru. Zmniejsz liczbę reguł lub list i spróbuj ponownie, a następnie sprawdź istniejącą konfigurację. |
| Rozszerzenie nie zmienia się po zmianie pliku zdalnego | Wczytanie zdalne to jednorazowy import ręczny. Ponownie wpisz adres, wczytaj i potwierdź. |