chrome.proxy

الوصف

الأذونات

البيان

يجب الإفصاح عن إذن "الخادم الوكيل" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات الخاصة بإعدادات الخادم الوكيل. على سبيل المثال:

{
  "name": "My extension",
  ...
  "permissions": [
    "proxy"
  ],
  ...
}

العناصر والخصائص

يتم تحديد إعدادات الخادم الوكيل في كائن proxy.ProxyConfig. استنادًا إلى إعدادات الخادم الوكيل في Chrome، قد تحتوي الإعدادات على proxy.ProxyRules أو proxy.PacScript.

أوضاع الخادم الوكيل

تحدّد السمة mode لكائن ProxyConfig السلوك العام لمتصفّح Chrome فيما يتعلّق باستخدام الخادم الوكيل. يمكن أن تتضمّن القيم التالية:

direct

في وضع direct، يتم إنشاء جميع عمليات الربط مباشرةً، بدون أي خادم وكيل. لا يسمح هذا الوضع بإضافة أي مَعلمات أخرى في العنصر ProxyConfig.

auto_detect

في وضع auto_detect، يتم تحديد إعدادات الخادم الوكيل من خلال نص برمجي لملف PAC يمكن تنزيله من http://wpad/wpad.dat. لا يسمح هذا الوضع بإضافة المزيد من المَعلمات في العنصر ProxyConfig.

pac_script

في وضع pac_script، يتم تحديد إعدادات الخادم الوكيل من خلال نص برمجي لملف PAC يتم إما استرداده من عنوان URL المحدّد في العنصر proxy.PacScript أو أخذه حرفيًا من العنصر data المحدّد في العنصر proxy.PacScript. بالإضافة إلى ذلك، لا يسمح هذا الوضع بإضافة أي مَعلمات أخرى في العنصر ProxyConfig.

fixed_servers

في وضع fixed_servers، يتم ترميز إعدادات الخادم الوكيل في عنصر proxy.ProxyRules. يمكن الاطّلاع على بنية هذه القواعد في قواعد الخادم الوكيل. بالإضافة إلى ذلك، لا يسمح الوضع fixed_servers بإضافة أي معلَمات أخرى في الكائن ProxyConfig.

system

في وضع system، يتم استخراج إعدادات الخادم الوكيل من نظام التشغيل. لا يسمح هذا الوضع بإضافة أي مَعلمات أخرى إلى عنصر ProxyConfig. يُرجى العِلم أنّ وضع system يختلف عن عدم ضبط أي إعدادات للخادم الوكيل. في الحالة الأخيرة، يعود Chrome إلى إعدادات النظام فقط في حال عدم تأثير أي خيارات سطر أوامر في إعدادات الخادم الوكيل.

قواعد الخادم الوكيل

يمكن أن يحتوي العنصر proxy.ProxyRules على السمة singleProxy أو مجموعة فرعية من proxyForHttp وproxyForHttps وproxyForFtp وfallbackProxy.

في الحالة الأولى، يتم توجيه حركة بيانات HTTP وHTTPS وFTP عبر خادم وكيل محدّد. ويتم إرسال أنواع حركة المرور الأخرى مباشرةً. في الحالة الأخيرة، يكون السلوك أكثر دقة قليلاً: إذا تم ضبط خادم وكيل لبروتوكول HTTP أو HTTPS أو FTP، سيتم توجيه حركة البيانات المعنية عبر الخادم المحدّد. في حال عدم تحديد خادم وكيل من هذا النوع أو إذا كانت الزيارات تستخدم بروتوكولاً مختلفًا عن HTTP أو HTTPS أو FTP، يتم استخدام fallbackProxy. إذا لم يتم تحديد سمة fallbackProxy، يتم إرسال حركة البيانات مباشرةً بدون خادم وكيل.

عناصر الخادم الوكيل

يتم إعداد خادم وكيل في عنصر proxy.ProxyServer. يستخدم الاتصال بالخادم الوكيل (المحدّد بواسطة السمة host) البروتوكول المحدّد في السمة scheme. إذا لم يتم تحديد scheme، يكون الإعداد التلقائي لاتصال الخادم الوكيل هو http.

إذا لم يتم تحديد port في عنصر proxy.ProxyServer، يتم استخلاص المنفذ من المخطط. المنافذ التلقائية هي:

قائمة الاستثناءات

يمكن استبعاد خوادم فردية من استخدام bypassList كخادم وكيل. قد تحتوي هذه القائمة على الإدخالات التالية:

[SCHEME://]HOST_PATTERN[:PORT]

مطابقة جميع أسماء المضيفين التي تتطابق مع النمط HOST_PATTERN يتم تفسير "." في المقدّمة على أنّه "*.".

أمثلة: "foobar.com", "*foobar.com", "*.foobar.com", "*foobar.com:99", "https://x.*.y.com:99".

النمط	أعواد ثقاب	لا يطابق
".foobar.com"	"www.foobar.com"	"foobar.com"
"*.foobar.com"	"www.foobar.com"	"foobar.com"
"foobar.com"	"foobar.com"	"www.foobar.com"
"*foobar.com"	‫"foobar.com"، "www.foobar.com"، "foofoobar.com"

[SCHEME://]IP_LITERAL[:PORT]

مطابقة عناوين URL التي تكون قيمًا ثابتة لعناوين IP وهذا يشبه الحالة الأولى من الناحية النظرية، ولكن مع حالات خاصة للتعامل مع تحديد عنوان URL الأساسي الحرفي لبروتوكول الإنترنت. على سبيل المثال، التطابق مع "[0:0:0::1]" هو نفسه التطابق مع "[::1]" لأنّ عملية تحديد عنوان URL الأساسي لعنوان الإصدار السادس من بروتوكول الإنترنت (IPv6) تتم داخليًا.

أمثلة: 127.0.1، [0:0::1]، [::1]:80، https://[::1]:443

IP_LITERAL/PREFIX_LENGTH_IN_BITS

مطابقة أي عنوان URL يحتوي على قيمة حرفية لعنوان IP (IP_LITERAL) ضمن النطاق المحدّد يتم تحديد نطاق عناوين IP (PREFIX_LENGTH_IN_BITS) باستخدام تدوين CIDR.

مطابقة أي عنوان URL يحتوي على قيمة حرفية لعنوان IP ضمن النطاق المحدّد يتم تحديد نطاق عناوين IP باستخدام ترميز CIDR. أمثلة: "192.168.1.1/16", "fefe:13::abc/33"

<local>

تطابق السلسلة الحرفية <local> أسماء المضيفين البسيطة. اسم المضيف البسيط هو الاسم الذي لا يحتوي على نقاط وليس عبارة عن عنوان IP حرفي. على سبيل المثال، example وlocalhost هما اسمَا مضيف بسيطَين، بينما example.com وexample. و[::1] ليست كذلك.

مثلاً: "<local>"

أمثلة

يضبط الرمز التالي خادم وكيل SOCKS 5 لعمليات اتصال HTTP بجميع الخوادم باستثناء foobar.com، ويستخدم عمليات اتصال مباشرة لجميع البروتوكولات الأخرى. تنطبق الإعدادات على النوافذ العادية ونوافذ التصفّح المتخفي، لأنّ نوافذ التصفّح المتخفي ترث الإعدادات من النوافذ العادية. يُرجى أيضًا الرجوع إلى مستندات Types API.

var config = {
  mode: "fixed_servers",
  rules: {
    proxyForHttp: {
      scheme: "socks5",
      host: "1.2.3.4"
    },
    bypassList: ["foobar.com"]
  }
};
chrome.proxy.settings.set(
  {value: config, scope: 'regular'},
  function() {}
);

يضبط الرمز التالي نص PAC مخصّصًا.

var config = {
  mode: "pac_script",
  pacScript: {
    data: "function FindProxyForURL(url, host) {\n" +
          "  if (host == 'foobar.com')\n" +
          "    return 'PROXY blackhole:80';\n" +
          "  return 'DIRECT';\n" +
          "}"
  }
};
chrome.proxy.settings.set(
  {value: config, scope: 'regular'},
  function() {}
);

يستعلم مقتطف الرمز البرمجي التالي عن إعدادات الخادم الوكيل السارية حاليًا. يمكن تحديد إعدادات الخادم الوكيل السارية من خلال إضافة أخرى أو سياسة. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Types API.

chrome.proxy.settings.get(
  {'incognito': false},
  function(config) {
    console.log(JSON.stringify(config));
  }
);

يُرجى العِلم أنّ العنصر value الذي تم تمريره إلى set() ليس مطابقًا للعنصر value الذي تم تمريره إلى دالّة رد الاتصال get(). سيحتوي الأخير على عنصر rules.proxyForHttp.port.

chrome.proxy.onProxyError.addListener(
  callback: function,
)