מדריך התצורה של UA Pro

ייבוא וייצוא תצורה ותצורה מרוחקת

גיבוי, העברה וכתיבה ידנית של תצורה וטעינתה מכתובת מרוחקת.

גרסה רלוונטית: UA Pro 1.5.0

מדריך זה חל על UA Pro 1.5.0 ומסביר כיצד לגבות, להעביר ולכתוב תצורה ידנית וכיצד לטעון אותה מכתובת מרוחקת. הגרסה החדשה משתמשת בפורמט תמונת מצב מלאה; הערך של version בקובץ התצורה הוא 2.

לפני הייבוא, יש לייצא גיבוי בדפדפן היעד. כל ייבוא מחליף את הכלל הגלובלי, קבוצת כללי המתחם כולה, שתי ספריות ה-UA ומתג החלופה לפי מתחם המשאב בתמונת המצב המלאה שבקובץ, ללא מיזוג פרטני. "globalRule": null פירושו מחיקת הכלל הגלובלי בדפדפן היעד.

01ייצוא תצורה

  1. לחצו על סמל UA Pro בסרגל הכלים של הדפדפן.
  2. פתחו את ״עוד״ ← ״ייבוא/ייצוא תצורה״.
  3. לחצו על ״ייצוא תצורה״ ושמרו את קובץ .json שהורד.
  4. שם הקובץ דומה ל-ua-switcher-config-2026-11-16.json. התאריך בשם נוצר לפי UTC ועשוי להיות שונה ביום אחד מהתאריך המקומי.

הקובץ כולל את ההגדרות הקבועות הבאות:

  • הכלל הגלובלי ומצבו: פעיל או מושהה.
  • כל קבוצת כללי המתחם ומצבו של כל כלל: פעיל או מושהה.
  • קטגוריות ופריטים של UA מותאם אישית.
  • קטגוריות ופריטים של טקסט להוספה.
  • המתג ״חלופה לפי מתחם המשאב״.

הקובץ אינו כולל כללי כרטיסיות, שיוכים של UA אקראי שכבר נבחר, כרטיסיות פתוחות, שפת ממשק, ערכת נושא והגדרות שכבה צפה. פריטים אלה לא ישוחזרו מהגיבוי לאחר הייבוא; גם כללי כרטיסיות קיימים בדפדפן היעד אינם נמחקים בייבוא ולכן עשויים להמשיך לגבור על כללי מתחם או על הכלל הגלובלי.

קובץ הייצוא הוא JSON בטקסט פשוט וקריא. אם UA מותאם אישית או קטגוריה מכילים מידע שאינכם רוצים לפרסם, שמרו על הגיבוי במקום בטוח.

02ייבוא מקובץ מקומי

  1. בדפדפן היעד פתחו את UA Pro ← ״עוד״ ← ״ייבוא/ייצוא תצורה״.
  2. תחילה לחצו על ״ייצוא תצורה״ כדי לשמור את התצורה המקורית של דפדפן היעד לשחזור בעת הצורך.
  3. לחצו על ״ייבוא תצורה״ ובחרו בקובץ .json.
  4. קראו את אזהרת ההחלפה ואת מספר הכללים והרשימות; לחצו על ״הצגת תוכן התצורה״ לבדיקת ה-JSON המלא לפני האישור. בחירה ב״בטל״ אינה כותבת נתונים. לאחר האישור המתינו להודעה ״התצורה יובאה!״. אם ההגדרות משתנות בזמן האישור, התוסף יבקש לבצע את הפעולה מחדש.
  5. בדקו את הכלל הגלובלי וכללי המתחם, הרשימות המותאמות ומתג החלופה לפי מתחם המשאב; בדקו אם כללי כרטיסיות קיימים גוברים עליהם. רעננו את דף הבדיקה ובדקו את ה-UA.

התוסף בודק תחילה את הקובץ, מנסה להתקין את הכללים ולבסוף כותב את התצורה הקבועה. אם ההתקנה או הכתיבה נכשלות, הוא מנסה לשחזר את הכללים השמורים כרגע בדפדפן; אם מופיעה הודעה שלא ניתן לשחזר, בדקו את ההגדרות בפועל. כאשר סנכרון הדפדפן או חלון אחר משנים את התצורה במקביל, אין לראות בתהליך עסקה בין מכשירים.

03טעינה מכתובת מרוחקת

התצורה המרוחקת משתמשת באותו תוכן JSON כמו הגיבוי המקומי. זו טעינה וייבוא ידניים חד-פעמיים, ולא מנוי שמתעדכן אוטומטית.

  1. ייצאו תחילה גיבוי תצורה או הכינו קובץ JSON לפי ההוראות להלן.
  2. הציבו את הקובץ בשירות HTTPS שדפדפן היעד יכול לגשת אליו, וקבלו כתובת מלאה שמחזירה ישירות תוכן JSON, למשל https://example.com/ua-pro/config.json. כתובת זו היא דוגמה בלבד; החליפו אותה בכתובת האמיתית שלכם.
  3. ב־⁨UA Pro⁩ פתחו את ״עוד״ ואז את ״ייבוא/ייצוא תצורה״, הרחיבו את ״תצורה מרוחקת״, הדביקו את הכתובת ולחצו על ״טען״.
  4. לאחר טעינה ובדיקת פורמט מוצלחות, התוסף מציג חלון אישור ואת שם המארח המרוחק; לחצו על ״הצגת תוכן התצורה״ כדי לבדוק את ה-JSON המלא שהורד בפועל. אישור מעדכן את ההגדרות לפי אותם כללים כמו בייבוא מקומי; ביטול אינו מייבא דבר.
  5. לאחר שינוי הקובץ בשרת, כדי להשתמש בתוכן החדש יש להזין שוב את הכתובת, לטעון ולאשר. הכתובת אינה נשמרת אוטומטית בפתיחה מחדש של החלונית.

מתקבלים רק קישורי HTTPS ישירים; HTTP, שם משתמש או סיסמה בכתובת ומקטע URL אינם מתקבלים, ואין מעקב אחר הפניות. הבקשה אינה כוללת Cookie של הדפדפן או פרטי התחברות, אינה שולחת Referer ועוקפת מטמון; לכן שירות הדורש Cookie להתחברות אינו מתאים. UA Pro אינו מחיל על בקשה זו את כללי ה-UA שהוגדרו בתוסף, אך תוספים אחרים או ציוד רשת עדיין עשויים לשנות אותה. הכתובת יכולה להכיל פרמטרי שאילתה; יש לשמור כתובת הכוללת אסימון גישה כמו סיסמה. השתמשו בכתובת מהימנה וודאו שהתגובה היא ישירות קובץ JSON ולא דף התחברות או דף HTML המציג קוד.

קובץ מקומי ותגובה מרוחקת מוגבלים כל אחד ל-128 KiB; הקריאה המרוחקת מוגבלת ל-10 שניות והתוכן שנקרא בפועל נספר. לאחסון הסנכרון של הדפדפן מכסה קטנה יותר לפריט, ולכן גם קובץ שקטן מ-128 KiB עלול שלא להישמר אם הכללים או ספרייה אחת גדולים מדי. במקרה של שגיאה, בדקו שהשרת מחזיר מצב 200 ו-JSON תקין, שהתעודה תקפה, שהכתובת אינה מפנה ושאפשר להגיע לרשת.

04דוגמת JSON מלאה

ניתן לשמור את הדוגמה הבאה כ-config.json בקידוד UTF-8. המתחמים וערכי ה-UA לדוגמה נועדו להמחשה בלבד; גבו את התצורה הקיימת לפני החלפה. JSON מבחין בין אותיות גדולות לקטנות; השתמשו במירכאות כפולות של ASCII למחרוזות, אל תוסיפו פסיק אחרי האיבר האחרון ואל תכתבו הערות בתוך 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
  }
}

דוגמה זו מגדירה UA גלובלי מובנה אחד וארבעה כללי מתחם. כלל לתת-מתחם מסוים יותר כגון app.example.com קודם ל-example.com; כללים מושהים אינם משתתפים בהתאמה הפעילה וכלל מתחם האב או הכלל הגלובלי עשויים לחול במקומם. זיהוי ה-UA לדוגמה באתר אמיתי תלוי באתר עצמו.

05שדות ברמה העליונה ואופן ההחלפה

שדה דוגמה תפקיד
version 2 חובה. הגרסה החדשה מקבלת רק את המספר 2.
type "ua-switcher-config" חובה. מזהה סוג התצורה חייב להתאים בדיוק למחרוזת זו.
timestamp "2026-11-16T06:00:00.000Z" חובה. השתמשו בזמן UTC עם אלפיות שנייה ו-Z; הוא לרישום בלבד ואינו קובע מתי הכלל חל.
data { ... } חובה. אובייקט המכיל את התצורה המלאה ואת כל השדות בטבלה הבאה.
שדות בתוך data פורמט תקין התנהגות בייבוא בגרסה זו
globalRule אובייקט כלל אחד או null אובייקט כלל מחליף את הכלל הגלובלי הקיים; null מוחק את הכלל הגלובלי הקיים.
domainRules { "域名": 规则对象 } האובייקט כולו מחליף את כללי המתחם הקודמים; {} מרוקן אותם.
userCustomData { "分类": ["UA", ...] } האובייקט כולו מחליף את ספריית ה-UA המותאמת הקודמת; {} מרוקן אותה.
userAppendData { "分类": ["追加文本", ...] } האובייקט כולו מחליף את ספריית הטקסט להוספה הקודמת; {} מרוקן אותה.
resourceDomainFallback true או false ערך בוליאני ב-JSON: הפעלה או כיבוי של החלופה לפי מתחם המשאב.

כל חמשת השדות נדרשים, ואי אפשר להשתמש ב-null מלבד ב-globalRule. שדות חסרים או לא מוכרים ומפתחות JSON כפולים נדחים; גם תצורה ישנה או חלקית לא תיובא. כללי המתחם וכל אחת משתי הספריות מוחלפים בשלמותם: למשל domainRules הכולל מתחם אחד בלבד יחליף גם כללי מתחם אחרים הקיימים בדפדפן היעד. מומלץ לערוך על בסיס קובץ שיוצא בפועל מהגרסה החדשה ולשמור את כל הפריטים הדרושים.

החלופה לפי מתחם המשאב עשויה להחיל כלל לפי מתחם היעד של בקשת המשאב רק כאשר לדף הראשי אין UA פעיל ברמת כרטיסייה, מתחם או גלובלית; אין פירוש הדבר שכל משאב חוצה מתחמים גובר על כלל הדף הראשי.

06כתיבת אובייקט כלל

הכלל הגלובלי וכל כלל מתחם משתמשים באותו מבנה:

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

enabled: true מציין פעיל ו-false מציין מושהה. mode קובע את השדות של params:

6.1 UA מובנה: builtin

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

os ו-uaKey חייבים להתאים בדיוק למפתחות המוגדרים מראש בתוך אותה גרסת תוסף; הם אינם בהכרח זהים לטקסט המתורגם המוצג בממשק. הדרך הבטוחה ביותר היא לבחור הגדרה מוכנה בממשק, לייצא תצורה ולהעתיק את params המתאים. יש לבדוק שוב כאשר רשימת ההגדרות המוכנות משתנה בין גרסאות.

6.2 UA מותאם אישית: custom

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

value הוא מחרוזת ה-UA המלאה. category משמש לקטגוריה ולעריכה בממשק; מומלץ לכלול ערך זה גם בקטגוריה בעלת אותו שם בתוך userCustomData. בעת החלת הכלל נקרא value של הכלל עצמו; ייבוא ידני של כלל אינו מוסיף אוטומטית את הערך לספרייה המותאמת.

6.3 טקסט להוספה: append

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

התוסף מוסיף רווח אחד אחרי ה-UA המקורי של הדפדפן הנוכחי ולאחריו את value. מומלץ לשמור את הטקסט גם בקטגוריה בעלת אותו שם בתוך userAppendData; ייבוא כלל אינו ממלא את הרשימה אוטומטית.

6.4 UA אקראי: random

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

strategy חייב להיות "page" (בחירה בכל טעינת דף מלאה) או "tab" (שמירה לפי כלל וכרטיסייה). בחירה אקראית מאפשרת חזרות, ולכן שתי תוצאות זהות ברצף אינן מוכיחות שלא התבצעה בחירה מחדש.

ערכי pool נפוצים:

ערך מקור הבחירה האקראית
all כל ה-UA המובנים, המותאמים ואלה שנוצרים מטקסט להוספה
builtin כל ה-UA המובנים
builtin_desktop, builtin_mobile, builtin_legacy קטגוריות מובנות של מחשב שולחני, נייד או מכשירים ישנים
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social הקטגוריות המובנות המתאימות
custom UA בכל הקטגוריות המותאמות
custom:分类名 UA בקטגוריה שצוינה ב-userCustomData
append_all UA המתאימים לכל הטקסטים להוספה
append:分类名 UA המתאים לטקסט להוספה בקטגוריה שצוינה ב-userAppendData

שם הקטגוריה אחרי הנקודתיים חייב להתאים למפתח בספרייה. לכלל אקראי פעיל חייבים להיות מועמדים זמינים, אחרת הקובץ יידחה.

07בדיקות בעריכה ידנית

  • כתבו מתחם כמפתח של domainRules, למשל example.com או shop.example.com; אל תכתבו https://, נתיב, פורט או רווח. כללי מתחם מתאימים גם לתת-מתחמים; בגרסה הנוכחית *.example.com כולל גם את example.com עצמו ואינו מוגבל לתת-מתחמים בלבד.
  • שם קטגוריה יכול להיות בסינית, חייב להיות מחרוזת לא ריקה ואסור שיכיל תווי בקרה או תווי בקרת טקסט דו-כיווני מסוכנים; __proto__, prototype ו-constructor אינם יכולים לשמש כשמות קטגוריה. מומלץ להשתמש בתווי ASCII ניתנים להדפסה ב-UA ובטקסט להוספה; אין לכלול ירידת שורה, טאב או תווי בקרה אחרים; כל UA מוגבל ל-4096 תווים. יש לבצע escaping למירכאות כפולות של 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 שגוי בדקו שהכלל פעיל, שהתוכן תקין, שיש אפשרויות זמינות במאגר האקראי ושאין כלל כרטיסייה או מתחם בעדיפות גבוהה יותר, ורעננו את הדף.
שגיאת אחסון בייבוא נתונים רבים לקובץ ולאחסון הסנכרון של הדפדפן יש מגבלות גודל; צמצמו כללים או רשימות, נסו שוב ובדקו את התצורה הקיימת.
התוסף לא השתנה לאחר שינוי הקובץ המרוחק טעינה מרוחקת היא ייבוא ידני חד-פעמי; הזינו שוב את הכתובת, טענו ואשרו.