إعدادات WireGuard
يدعم Chute WireGuard كبروتوكول بروكسي صادر. يمكنك إما تكوين WireGuard مضمَّناً في القسم [Proxy]، أو تعريف قسم [WireGuard] مسمى والإشارة إليه.
قسم WireGuard
يعرف قسم [WireGuard] تكوين نفق WireGuard كامل يمكن الإشارة إليه بالاسم من خادم بروكسي WireGuard.
[WireGuard wg0]
private-key = base64_private_key
peer-public-key = base64_peer_public_key
self-ip = 10.0.0.2
self-ip-v6 = fd00::2
preshared-key = base64_preshared_key
server = example.com
port = 51820
wg-mtu = 1420
keepalive = 25
المعاملات
| المفتاح | مطلوب | الوصف |
|---|---|---|
private-key |
نعم | مفتاح WireGuard الخاص، مرمَّز بـ base64 |
peer-public-key |
نعم | مفتاح النظير العام، مرمَّز بـ base64 |
self-ip |
لا | عنوان IPv4 المحلي لواجهة WireGuard (الافتراضي: 10.0.0.2، لكل من WireGuard و AmneziaWG) |
self-ip-v6 |
لا | عنوان IPv6 المحلي لواجهة WireGuard |
preshared-key |
لا | مفتاح مشترك مسبقاً لمقاومة ما بعد الكم |
server |
نعم* | عنوان الخادم البعيد (يستخدم عندما لا يحدد سطر البروكسي عنواناً؛ سطر البروكسي له الأسبقية) |
port |
نعم* | منفذ الخادم البعيد (نفس أسبقية server) |
wg-mtu |
لا | MTU لواجهة WireGuard (الافتراضي: 1420). يُقرأ mtu داخل القسم على أنه wg-mtu، وتكون الأولوية لـ wg-mtu المكتوب صراحة |
keepalive |
لا | فاصل keepalive المستمر بالثواني. وإن غاب فلا يُرسل keepalive |
allowed-ips |
لا | الوجهات التي ينقلها النظير، بصيغة CIDR مفصولة بفواصل (مثل allowed-ips = 10.0.0.0/8, 192.168.1.0/24). والاتصال بعنوان خارجها يُرفض (TCP) أو يُسقَط (UDP). وغيابه، أو إدراجه 0.0.0.0/0 و ::/0 معاً، يعني كل الوجهات؛ والمدخل الذي ليس CIDR يُتجاهل مع تحذير، والقائمة التي لا مدخل صالحاً فيها لا تنقل شيئاً — فيُرفض كل اتصال عبر النظير |
reserved |
لا | البايتات المحجوزة الثلاثة التي تلي نوع الرسالة في ترويسة WireGuard (مثال reserved=0,1,2، وتُقبل أيضاً 0/1/2 وترميز base64 للبايتات الثلاثة)، وتُكتب في كل رسالة يرسلها النفق — وتستخدمها خوادم مثل Cloudflare WARP للتعرّف على العميل. والقيمة التي لا تعطي ثلاثة بايتات تُتجاهل مع تسجيل تحذير |
reserved-in-mac |
لا | مع reserved-in-mac = true تُكتب بايتات reserved في رسالة المصافحة قبل حساب رمز MAC الخاص بها (mac1)، فيشملها؛ أما افتراضياً فيُحسب mac1 وهي أصفار ثم تُكتب بعده. لا تفعّله إلا إذا كان النظير يحسب mac1 ويتحقق منه على ترويسة تحمل هذه البايتات مسبقاً؛ ولا يحتاجه WARP. لا يسري إلا مع reserved، وهو معطّل افتراضياً، ولا ينطبق على AmneziaWG |
* يجب أن يكون server و port موجودين إما في القسم أو على سطر [Proxy] المشير إليه؛ وإلا تُرفض السياسة باعتبارها غير مكتملة.
صيغة peer في Surge
يمكن للقسم أن يصف نظيره بالطريقة التي يتبعها Surge:
[WireGuard wg0]
private-key = base64_private_key
self-ip = 10.0.0.2
mtu = 1280
peer = (public-key = base64_peer_public_key, endpoint = example.com:51820, preshared-key = base64_preshared_key, keepalive = 25, client-id = 1/2/3, allowed-ips = "0.0.0.0/0, ::/0")
- يصبح
public-keyهوpeer-public-key، ويصبحendpoint(host:portأو[v6]:port) هوserverوport، ويصبحclient-id = a/b/cهوreserved، ويحتفظpreshared-keyوkeepaliveباسميهما. والمفتاح المكتوب مباشرة في القسم له الأولوية على القيمة نفسها داخلpeer. - لا يُستخدم إلا نظير واحد؛ أما الثاني فيُبلَّغ عنه كتنبيه ويُتجاهل.
- تُترجم
allowed-ipsوتُطبّق على TCP وUDP في WireGuard: يُرفض الهدف أو يُسقط إذا خرج عن شبكات CIDR الخاصة بالنظير، لأن ذلك النظير لا يستطيع توجيهه عائداً. أما مفتاحا Surgedns-serverوprefer-ipv6فيُحتفظ بهما دون أثر، ويظهران في تنبيه الخيارات المتجاهلة. - عند حفظ الإعدادات، يُكتب القسم مجدداً بالمفاتيح أعلاه بدلاً من سطر
peer = (…).
الاستخدام
الإشارة إلى القسم من خادم بروكسي:
[Proxy]
WG = wireguard, section-name=wg0
[Proxy Group]
WGGroup = select, WG
[Rule]
IP-CIDR,10.0.0.0/8,WGGroup
FINAL,DIRECT
يمكن تعريف عدة أقسام [WireGuard] لأنفاق مختلفة:
[WireGuard us]
private-key = ...
peer-public-key = ...
self-ip = 10.0.1.2
[WireGuard eu]
private-key = ...
peer-public-key = ...
self-ip = 10.0.2.2
ملاحظة: يعمل WireGuard عبر نفق UDP خاص به مع مكدس TCP/IP في مساحة المستخدم. الأسماء (مثال
wg0) حساسة لحالة الأحرف.ملاحظة: لا يمكن اختبار سياسة تأخذ إعداداتها من قسم
[WireGuard …]أو[AmneziaWG …]بـ اختبار الاتصال (Test Connection) في محرر السياسات. اكتب الإعدادات في سطر السياسة نفسه لاختبارها.
استيراد ملف wg-quick
يُقرأ ملف .conf يحمل [Interface] مع PrivateKey و [Peer] مع PublicKey كملف wg-quick، قبل أي كشف آخر لامتداد .conf. ويصبح سياسة واحدة مسماة باسم الملف وقسم [WireGuard <name>] — أو [AmneziaWG <name>] حين تحمل الواجهة Jc أو Jmin أو Jmax أو S1–S4 أو H1–H4 أو I1–I5:
- يصبح
Addressهوself-ipوself-ip-v6(أول عنوان من كل عائلة)؛ ويصبحEndpointهوserverوport؛ ويصبحAllowedIPsهوallowed-ips؛ ويصبحPersistentKeepaliveهوkeepalive؛ ويصبحMTUهوwg-mtu؛ ويصبحPreSharedKeyهوpreshared-key. - ولا يُستخدم إلا أول
[Peer]؛ وتُسقَط النظراء الإضافيون مع تحذير. ولا مقابل لـDNSوListenPortوTableوFwMarkوSaveConfigوخطافاتPreUp/PostUp/PreDown/PostDownفي السياسة، فتُسقَط مع تحذير. - ثم يكتب التطبيق قواعد من
AllowedIPs: فـ0.0.0.0/0، أو0.0.0.0/1و128.0.0.0/1معاً، أو غيابAllowedIPsكلياً، ترسل كل شيء عبر العقدة بواسطةFINAL؛ أما النفق المنقسم فيكتب قاعدةIP-CIDR/IP-CIDR6واحدة لكل شبكة عبر العقدة ثمFINAL,DIRECT. ويصبح العنوان المجرّد/32أو/128. و::/0وحده لا يحمل IPv4، فهو نفق منقسم أيضاً: يصبحIP-CIDR6,::/0,<node>ثمFINAL,DIRECT. - وبعد الاستيراد يعرض التطبيق Routing Rules Added، مبيناً هل تمر كل الحركة أم الشبكات المذكورة فقط عبر النفق، وأن ذلك يمكن تغييره في قواعد ملف الإعدادات. ويعرض Chute tvOS النص نفسه تحت Saved، أو تحت Upload received: واسم الملف للملف المُرسَل من صفحة الرفع عبر Wi-Fi.
ويصل الاستيراد إليه حيثما يصل إلى ملف إعدادات: ملف مُختار أو مفتوح، والاستيراد من رابط (Import from URL)، وعنوان اشتراك، والاستيراد من الحافظة (Import from Clipboard)، ورمز QR على iOS و Android، وصفحة الرفع عبر Wi-Fi، ومساعد الإعداد، وروابط chute://.
قسم AmneziaWG
يدعم Chute أيضاً AmneziaWG، وهو نسخة من WireGuard مع تمويه حركة المرور. يقبل القسم [AmneziaWG <name>] المفاتيح نفسها التي يقبلها قسم [WireGuard]، إضافةً إلى معاملات التمويه التالية:
jcوjminوjmax— عدد حزم البيانات المهملة ونطاق حجمها. وحين تتجاوزjcالصفر وجب ضبطjminوjmaxمعاً، ولا يجوز أن تكونjmaxأصغر منjmin، وإلا رُفض إنشاء النفق.s1وs2وs3وs4— بيانات مهملة تُضاف في بداية حزم init/response/cookie/transport. لا يجوز أن تتجاوزs1–s364 بايت (وs432)، ويجب أن يختلفs1 + 148عنs2 + 92، وإلا رُفض إنشاء النفق.h1وh2وh3وh4— قيم مخصصة لترويسة نوع الرسالة. كلٌّ منها عدد عشري أو مدىstart-endضمن 32 بت، ويجب أن يكون أكبر من 4، لأن 1–4 هي أنواع رسائل WireGuard نفسه؛ ولا يجوز أن تتداخل القيم الأربع، وإلا رُفض النفق.i1وi2وi3وi4وi5— تعريفات حزم البيانات المهملة الخاصة. والتعريف الذي يتعذّر تحليله يؤدي إلى رفض النفق. وتُفصل وسومه بمسافات، فاكتب التعريف بين علامتي تنصيص مزدوجتين، كما فيi1 = "<b 0xf6ab3267fa> <r 16>": فبدونهما تُحذف المسافات ويُرفض النفق.
ويُسجَّل أي جمع مرفوض من المعاملات على الشكل WireGuard: AmneziaWG parameters rejected: <reason>، ثم يفشل النفق برسالة Failed to create BoringTun tunnel.
تشير السياسة إلى القسم بالنوع amneziawg (الاسم البديل awg):
[AmneziaWG awg0]
private-key = base64_private_key
peer-public-key = base64_peer_public_key
self-ip = 10.0.0.2
server = example.com
port = 51820
jc = 4
jmin = 40
jmax = 70
s1 = 15
s2 = 60
h1 = 123456
h2 = 67543
h3 = 32345
h4 = 123123
[Proxy]
AWG = amneziawg, section-name=awg0
قواعد التحقق المتقاطع:
- وجود معاملات AmneziaWG داخل قسم
[WireGuard]عادي يُعد خطأ في الإعداد — استخدم قسم[AmneziaWG]بدلاً من ذلك. - لا يمكن استخدام
reservedداخل قسم[AmneziaWG]: فهو يكتب بايتات الترويسة نفسها التي يستبدلهاh4، لذا يُرفض هذا الجمع بوصفه خطأ. - يحصل قسم
[AmneziaWG]بلا أي معاملات تمويه على تنبيه إرشادي — إذ يتصرف مثل WireGuard العادي.
هذه الصفحة ترجمة للنسخة الإنجليزية. في حال وجود اختلاف، يُعتمد على النسخة الإنجليزية.
ملاحظة: التطبيق لا يدعم اللغة العربية حاليًا.