Panduan konfigurasi UA Pro

Impor, ekspor, dan konfigurasi jarak jauh

Cadangkan, pindahkan, tulis konfigurasi secara manual, dan muat konfigurasi dari alamat jarak jauh.

Berlaku untuk: UA Pro 1.5.0

Panduan ini berlaku untuk UA Pro 1.5.0 dan menjelaskan cara mencadangkan, memindahkan, menulis konfigurasi secara manual, serta memuatnya dari alamat jarak jauh. Versi baru menggunakan format snapshot lengkap; version pada file konfigurasi bernilai 2.

Sebelum mengimpor, ekspor cadangan di browser tujuan. Setiap impor mengganti aturan global, seluruh aturan domain, kedua pustaka UA, dan sakelar fallback domain sumber daya dengan snapshot lengkap dalam file, tanpa menggabungkannya satu per satu. "globalRule": null berarti menghapus aturan global browser tujuan.

01Ekspor konfigurasi

  1. Klik ikon UA Pro di bilah alat browser.
  2. Buka “Lebih lanjut” → “Impor atau ekspor konfigurasi”.
  3. Klik “Ekspor konfigurasi” dan simpan file .json yang diunduh.
  4. Nama file menyerupai ua-switcher-config-2026-11-16.json. Tanggal pada nama file dibuat berdasarkan UTC dan dapat berbeda satu hari dari tanggal setempat.

File berisi konfigurasi yang disimpan secara persisten berikut:

  • Aturan global beserta status aktif atau dijedanya.
  • Seluruh aturan domain beserta status aktif atau dijeda masing-masing.
  • Kategori dan entri UA kustom.
  • Kategori dan entri teks tambahan.
  • Sakelar “Fallback domain sumber daya”.

File tidak berisi aturan tab, ikatan UA acak yang sudah dipilih, tab yang sedang terbuka, bahasa antarmuka, tema, dan pengaturan overlay mengambang. Setelah impor, item ini tidak dipulihkan dari cadangan; aturan tab yang sudah ada di browser tujuan juga tidak dihapus oleh impor sehingga dapat terus mengesampingkan aturan domain atau global.

File ekspor adalah JSON teks biasa yang dapat dibaca. Jika UA kustom atau kategori memuat informasi yang tidak ingin dipublikasikan, simpan cadangan dengan aman.

02Impor dari file lokal

  1. Di browser tujuan, buka UA Pro → “Lebih lanjut” → “Impor atau ekspor konfigurasi”.
  2. Klik “Ekspor konfigurasi” terlebih dahulu untuk menyimpan konfigurasi awal browser tujuan agar dapat dipulihkan jika perlu.
  3. Klik “Impor konfigurasi”, lalu pilih file .json.
  4. Baca peringatan penggantian serta jumlah aturan dan daftar; klik “Lihat isi konfigurasi” untuk memeriksa JSON lengkap sebelum mengonfirmasi. Memilih “Batalkan” tidak akan menulis data. Setelah konfirmasi, tunggu pesan “Konfigurasi diimpor!”. Jika pengaturan berubah selama konfirmasi, ekstensi akan meminta Anda mengulangi operasi.
  5. Periksa aturan global dan domain, daftar kustom, serta sakelar fallback domain sumber daya; periksa apakah aturan tab yang ada mengesampingkannya. Muat ulang halaman yang akan diuji, lalu periksa UA.

Ekstensi memeriksa file terlebih dahulu, kemudian mencoba memasang aturan, dan terakhir menulis konfigurasi persisten. Jika pemasangan atau penulisan gagal, ekstensi akan mencoba memulihkan aturan yang saat ini tersimpan di browser; jika muncul pesan bahwa pemulihan gagal, periksa pengaturan sebenarnya. Saat sinkronisasi browser atau jendela lain mengubah konfigurasi secara bersamaan, proses ini tidak boleh dianggap sebagai transaksi lintas perangkat.

03Muat dari alamat jarak jauh

Konfigurasi jarak jauh menggunakan konten JSON yang sama dengan cadangan lokal. Ini adalah pemuatan dan impor manual satu kali, bukan langganan yang diperbarui otomatis.

  1. Ekspor cadangan konfigurasi terlebih dahulu, atau siapkan file JSON sesuai petunjuk di bawah.
  2. Tempatkan file pada layanan HTTPS yang dapat diakses browser tujuan, lalu dapatkan alamat lengkap yang langsung mengembalikan konten JSON, misalnya https://example.com/ua-pro/config.json. Alamat ini hanya contoh; ganti dengan alamat Anda yang sebenarnya.
  3. Di UA Pro, buka “Lebih lanjut” → “Impor atau ekspor konfigurasi”, bentangkan “Konfigurasi jarak jauh”, tempel alamat, lalu klik “Muat”.
  4. Setelah pemuatan dan pemeriksaan format berhasil, ekstensi menampilkan dialog konfirmasi dan nama host jarak jauh; klik “Lihat isi konfigurasi” untuk memeriksa JSON lengkap yang benar-benar diunduh. Konfirmasi memperbarui pengaturan dengan aturan yang sama seperti impor lokal; pembatalan tidak mengimpor apa pun.
  5. Setelah file di server berubah, masukkan kembali alamat, muat, dan konfirmasi untuk menggunakan konten baru. Alamat tidak otomatis dipertahankan saat panel dibuka kembali.

Hanya tautan langsung HTTPS yang diterima; HTTP, nama pengguna atau kata sandi dalam alamat, serta fragmen URL tidak diterima, dan pengalihan tidak diikuti. Permintaan tidak membawa Cookie browser atau kredensial login, tidak mengirim Referer, dan melewati cache; karena itu layanan yang memerlukan Cookie login tidak cocok. UA Pro tidak menerapkan aturan UA yang dikonfigurasi dalam ekstensi ini pada permintaan tersebut, tetapi ekstensi lain atau perangkat jaringan masih dapat mengubahnya. Alamat dapat memuat parameter kueri; perlakukan alamat yang berisi token akses seperti kata sandi. Gunakan alamat tepercaya dan pastikan responsnya langsung berupa file JSON, bukan halaman login atau halaman HTML yang menampilkan kode.

File lokal dan respons jarak jauh masing-masing dibatasi 128 KiB; pembacaan jarak jauh dibatasi 10 detik dan menghitung konten yang benar-benar dibaca. Penyimpanan sinkronisasi browser memiliki kuota per item yang lebih kecil, sehingga file di bawah 128 KiB pun mungkin gagal disimpan jika aturan atau satu pustaka terlalu besar. Jika terjadi kesalahan, periksa apakah server mengembalikan status 200 dan JSON yang valid, sertifikat valid, alamat mengalami pengalihan, dan jaringan dapat dijangkau.

04Contoh JSON lengkap

Contoh berikut dapat disimpan sebagai config.json dengan encoding UTF-8. Domain dan nilai UA dalam contoh hanya untuk ilustrasi; cadangkan konfigurasi saat ini sebelum menggantinya. JSON membedakan huruf besar dan kecil; gunakan tanda kutip ganda ASCII untuk string, jangan tambahkan koma setelah elemen terakhir, dan jangan tulis komentar di dalam 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
  }
}

Contoh ini menetapkan satu UA global bawaan dan empat aturan domain. Aturan subdomain yang lebih spesifik seperti app.example.com lebih diutamakan daripada example.com; aturan yang dijeda tidak ikut dalam pencocokan yang berlaku, dan aturan domain induk atau global masih dapat mengambil alih. Kemampuan situs sebenarnya mengenali UA contoh bergantung pada situs tersebut.

05Field tingkat teratas dan perilaku penggantian

Field Contoh Fungsi
version 2 Wajib. Versi baru hanya menerima angka 2.
type "ua-switcher-config" Wajib. Penanda jenis konfigurasi yang harus sama persis dengan string ini.
timestamp "2026-11-16T06:00:00.000Z" Wajib. Gunakan waktu UTC dengan milidetik dan Z; hanya untuk catatan, tidak menentukan waktu berlakunya aturan.
data { ... } Wajib. Objek yang menyimpan konfigurasi lengkap dan memuat seluruh field pada tabel berikut.
Field dalam data Format yang benar Perilaku impor dalam versi ini
globalRule Satu objek aturan atau null Objek aturan menggantikan aturan global yang ada; null menghapus aturan global yang ada.
domainRules { "域名": 规则对象 } Seluruh objek menggantikan aturan domain sebelumnya; {} mengosongkannya.
userCustomData { "分类": ["UA", ...] } Seluruh objek menggantikan pustaka UA kustom sebelumnya; {} mengosongkannya.
userAppendData { "分类": ["追加文本", ...] } Seluruh objek menggantikan pustaka teks tambahan sebelumnya; {} mengosongkannya.
resourceDomainFallback true atau false Nilai Boolean JSON: mengaktifkan atau menonaktifkan fallback domain sumber daya.

Kelima field wajib diisi; selain globalRule, tidak boleh menggunakan null. Field yang hilang atau tidak dikenal dan kunci JSON duplikat akan ditolak; konfigurasi versi lama atau parsial juga tidak diimpor. Aturan domain dan kedua pustaka masing-masing diganti seluruhnya: misalnya domainRules yang hanya memuat satu domain akan mengganti aturan domain lain yang sudah ada di browser tujuan. Sebaiknya sunting berdasarkan file yang benar-benar diekspor dari versi baru dan pertahankan semua item yang diperlukan.

Fallback domain sumber daya hanya dapat menerapkan aturan berdasarkan domain tujuan permintaan sumber daya ketika halaman utama tidak memiliki UA tab, domain, atau global yang aktif; ini tidak berarti semua sumber daya lintas domain mengesampingkan aturan halaman utama.

06Cara menulis objek aturan

Aturan global dan setiap aturan domain menggunakan struktur yang sama:

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

enabled: true berarti aktif, false berarti dijeda. mode menentukan field dalam params:

6.1 UA bawaan: builtin

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

os dan uaKey harus sama persis dengan kunci preset internal pada versi ekstensi tersebut; nilainya tidak selalu sama dengan teks terjemahan yang ditampilkan di antarmuka. Cara paling aman adalah memilih preset di antarmuka, mengekspor konfigurasi, lalu menyalin params yang sesuai. Periksa kembali ketika daftar preset berubah antarversi.

6.2 UA kustom: custom

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

value adalah string UA lengkap. category digunakan untuk pengelompokan dan penyuntingan di antarmuka; sebaiknya sertakan nilai ini juga dalam kategori bernama sama di userCustomData. Saat aturan berlaku, yang dibaca adalah value milik aturan itu sendiri; mengimpor aturan secara manual tidak otomatis menambahkan nilai tersebut ke pustaka kustom.

6.3 Teks tambahan: append

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

Ekstensi menambahkan satu spasi setelah UA asli browser saat ini, lalu menambahkan value. Sebaiknya simpan teks ini juga dalam kategori bernama sama di userAppendData; impor aturan tidak otomatis mengisi daftar.

6.4 UA acak: random

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

strategy harus berupa "page" (dipilih setiap kali halaman dimuat penuh) atau "tab" (dipertahankan per aturan dan tab). Pemilihan acak dapat menghasilkan nilai yang sama; dua hasil berturut-turut yang sama tidak selalu berarti tidak ada pemilihan ulang.

Nilai pool yang umum:

Nilai Sumber acak
all Semua UA bawaan, UA kustom, dan UA yang dihasilkan dari teks tambahan
builtin Semua UA bawaan
builtin_desktop, builtin_mobile, builtin_legacy Kategori bawaan desktop, seluler, atau perangkat lama
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social Kategori bawaan yang sesuai
custom UA dalam semua kategori kustom
custom:分类名 UA dalam kategori yang ditentukan di userCustomData
append_all UA yang sesuai dengan semua teks tambahan
append:分类名 UA yang sesuai dengan teks tambahan pada kategori yang ditentukan di userAppendData

Nama kategori setelah titik dua harus sama dengan kunci dalam pustaka. Aturan acak yang aktif harus memiliki kandidat yang tersedia; jika tidak, file akan ditolak.

07Pemeriksaan saat menyunting manual

  • Kunci domainRules harus berupa domain, misalnya example.com, shop.example.com; jangan tulis https://, jalur, port, atau spasi. Aturan domain juga cocok dengan subdomain di bawahnya; pada versi saat ini *.example.com juga mencakup example.com itu sendiri, bukan “hanya subdomain”.
  • Nama kategori boleh menggunakan bahasa Mandarin, harus berupa string tidak kosong, dan tidak boleh mengandung karakter kontrol atau karakter kontrol teks dua arah yang berbahaya; __proto__, prototype, constructor tidak boleh digunakan sebagai nama kategori. Sebaiknya gunakan karakter ASCII yang dapat dicetak untuk UA dan teks tambahan; jangan sertakan baris baru, tab, atau karakter kontrol lain; satu UA maksimal 4096 karakter. Tanda kutip ganda ASCII dan garis miring terbalik dalam teks harus di-escape sesuai aturan JSON.
  • Setiap kategori terkait dengan array string, misalnya "常用": ["Agent/1.0", "Agent/2.0"]. Pertahankan tanda kurung siku meskipun hanya ada satu item. Kategori kosong dapat ditulis [].
  • true, false, dan null tidak boleh diberi tanda kutip ganda; "false" adalah string, bukan nilai Boolean.
  • File harus berupa UTF-8 dan JSON yang valid; kunci duplikat tidak diizinkan. Ekstensi juga memeriksa struktur, jenis field, aturan, nama preset, dan kumpulan acak; sintaks yang benar tidak menjamin aturan dapat digunakan.

File konfigurasi dapat mengubah UA yang dikirim browser ke situs. HTTPS melindungi transmisi, tetapi tidak menjamin konfigurasi dari server sesuai keinginan Anda; impor hanya file dari sumber tepercaya, periksa isinya sebelum mengonfirmasi, dan verifikasi hasil sebenarnya setelah memuat ulang halaman tujuan.

08Pertanyaan umum

Gejala Cara memeriksa
Pesan format file tidak valid Periksa UTF-8, sintaks JSON, kunci duplikat, versi, field wajib, dan jenis aturan; gunakan file ekspor versi baru sebagai templat.
Pemuatan jarak jauh gagal Periksa sertifikat HTTPS, tautan langsung, jaringan, dan konten respons; pengalihan, login Cookie, dan HTTP tidak diizinkan.
Aturan berkurang setelah impor Aturan domain dan kedua pustaka masing-masing diganti seluruhnya; pulihkan dari cadangan yang dibuat sebelum impor atau tambahkan item yang perlu dipertahankan ke file baru.
Aturan global kosong diimpor tetapi halaman masih menggunakan UA lain Periksa aturan tab yang ada atau aturan domain yang cocok; aturan tersebut dapat lebih diutamakan daripada aturan global.
Berhasil tetapi UA salah Periksa apakah aturan aktif, kontennya valid, kumpulan acak memiliki item yang tersedia, dan ada tidaknya aturan tab atau domain dengan prioritas lebih tinggi, lalu muat ulang halaman.
Kesalahan penyimpanan saat mengimpor banyak data File dan penyimpanan sinkronisasi browser sama-sama memiliki batas ukuran; ringkas aturan atau daftar, coba lagi, dan periksa konfigurasi yang ada.
Ekstensi tidak berubah setelah file jarak jauh diubah Pemuatan jarak jauh adalah impor manual satu kali; masukkan kembali alamat, muat, dan konfirmasi.