> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# VPN إلى بيتك على Raspberry Pi مع WireGuard
- URL: https://arabroot.io/articles/vpn-الى-بيتك-على-raspberry-pi-مع-wireguard/
- Published: 2026-11-19T05:43:26.000Z
- Updated: 2026-11-19T06:42:31.000Z
- Description: سيرفر WireGuard على Raspberry Pi تبنيه بملف إعداد واحد، يدخلك إلى شبكة البيت من الهاتف والحاسوب بنفق كامل أو جزئي مع DNS البيت.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الهوم لاب: مختبرك في البيت, هوم لاب, لينكس والسيرفرات, الاستضافة الذاتية, WireGuard

أنت خارج البيت، في مقهى أو في سفر، وتريد أن تفتح صفحة Home Assistant لتطفئ المكيف الذي نسيته، أو أن تنسخ ملفاً من الـ NAS، أو أن تتصفح من شبكة Wi-Fi عامة لا تثق بها. والطريقة التي يلجأ إليها كثيرون هي أن يفتحوا في الـ Router منفذاً لكل خدمة، فيصبح لكل لوحة في البيت باب على الإنترنت يطرقه كل من يمسح العناوين، وكل باب منها يحتاج أن تحدثه وتراقبه. والحل الأنسب هو باب واحد صغير لا يرد على أحد لا يعرفه، تدخل منه إلى شبكة البيت Home LAN كأنك جالس فيها، وهذا بالضبط ما يفعله WireGuard، وRaspberry Pi مكان مناسب جداً له، لأنه يعمل طوال اليوم بكهرباء قليلة، وWireGuard لا يحتاج من المعالج CPU إلا القليل.

وقد شرحنا في [مقال ما هو VPN](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-vpn-%D8%B4%D8%B1%D8%AD-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/) فكرة النفق Tunnel والنفق الكامل Full Tunnel والجزئي وتسرب DNS، وفي [دليل WireGuard مع wg-easy](https://arabroot.io/articles/%D8%B4%D8%A8%D9%83%D8%A9-%D8%AE%D8%A7%D8%B5%D8%A9-%D9%85%D8%B9-wireguard-%D9%88-wg-easy/) كيف تشغله بواجهة ويب على VPS، وفي [مقارنة شبكات VPN](https://arabroot.io/articles/%D9%85%D9%82%D8%A7%D8%B1%D9%86%D8%A9-wireguard-%D9%88-openvpn-%D9%88-ipsec-%D9%88%D8%A7%D8%AF%D9%88%D8%A7%D8%AA-mesh/) سرعته مقارنة بـ OpenVPN وIPsec وأدوات Mesh، فلن نكرر ذلك هنا. وإنما نبني في هذا المقال سيرفر WireGuard بيدنا على Raspberry Pi في البيت، دون واجهة ودون Container، بملف `wg0.conf` نكتبه سطراً سطراً، لأن هذا هو الطريق الذي تفهم منه ما تفعله أي واجهة نيابة عنك، ثم نوصل به هاتفاً وحاسوباً محمولاً حقيقيين في Containers، ونقيس السرعة، ونفتعل الأخطاء الشائعة ونصلحها. وسوف نناقش في هذا المقال ما يلي:

- هل تستطيع أصلاً أن تصل إلى بيتك من الخارج؟ توجيه المنفذ Port Forwarding وCGNAT، والبدائل Tailscale وHeadscale.
- كيف يعمل WireGuard من الداخل: المفاتيح، وجدول التوجيه بالمفاتيح Cryptokey Routing، والمصافحة Handshake.
- المختبر: سيرفر على Raspberry Pi OS في QEMU، وRouter في البيت، وPi-hole أو AdGuard Home وNAS على شبكة البيت، وهاتف وحاسوب محمول على «الإنترنت».
- المفاتيح، والملف `wg0.conf`، وتمرير الحركة Forwarding وترجمة العناوين NAT على الـ Pi.
- النفق الكامل للهاتف والنفق الجزئي Split Tunnel للحاسوب، وDNS عبر AdGuard Home في البيت، وإعداد الهاتف برمز QR QR Code مع qrencode.
- قياس السرعة مع iperf3، وتغيير المفاتيح Key Rotation، وثلاثة أعطال حقيقية: AllowedIPs مكررة، وشبكة البيت ناقصة، والـ MTU.

## قبل أي شيء: هل يصل إليك أحد من الخارج؟

سيرفر WireGuard في البيت ينتظر حزم UDP على منفذ واحد، وهو افتراضياً 51820، والهاتف في الخارج يرسل إليه على عنوان البيت العام، أي عنوان الـ Router. والـ Router لا يعرف أي جهاز في البيت يقصده الهاتف، لذلك تحتاج قاعدة توجيه منفذ Port Forwarding تقول له: كل ما يصل على المنفذ 51820/udp أرسله إلى الـ Pi. وقد شرحنا كيف تعمل هذه الترجمة في [شرح NAT للمبتدئين](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-nat-%D8%B4%D8%B1%D8%AD-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/)، وكيف تفتح المنفذ بالطريقة الصحيحة في [دليل تشغيل خادمك من إنترنت المنزل](https://arabroot.io/articles/%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%AE%D8%A7%D8%AF%D9%85%D9%83-%D9%85%D9%86-%D8%A5%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D9%85%D9%86%D8%B2%D9%84/). وهناك ثلاثة أشياء يجب أن تتحقق منها قبل أن تكتب سطراً واحداً في الـ Pi:

1. **عنوان ثابت للـ Pi داخل البيت**: احجز له عنواناً في DHCP الخاص بالـ Router، والسبب أن قاعدة توجيه المنفذ تشير إلى عنوان، فإذا تغير عنوان الـ Pi بعد انقطاع الكهرباء توقف الـ VPN دون أن يتغير شيء في إعداده.
2. **اسم لعنوان البيت العام**: أغلب المزودين يغيرون عنوان البيت من وقت لآخر، فإذا كتبت العنوان نفسه في ملف الهاتف توقف الاتصال يوم يتغير، والحل اسم DDNS يتبع العنوان كما في [دليل DDNS](https://arabroot.io/articles/%D8%A7%D9%84-dns-%D8%A7%D9%84%D8%AF%D9%8A%D9%86%D8%A7%D9%85%D9%8A%D9%83%D9%8A-ddns-%D9%84%D8%B9%D9%86%D9%88%D8%A7%D9%86-%D9%85%D9%86%D8%B2%D9%84%D9%83/)، وتكتب الاسم في الحقل `Endpoint`.
3. **هل لديك عنوان عام أصلاً؟** هذا هو السؤال الأهم، فإذا كان مزودك يضعك خلف CGNAT فلن تصل أي حزمة واردة إلى الـ Router أصلاً، مهما فتحت من منافذ. وطريقة الاكتشاف أن تقارن عنوان WAN في صفحة الـ Router بعنوانك كما يراه الإنترنت، فإذا اختلفا، أو كان عنوان WAN بين 100.64.0.0 و100.127.255.255، وهو النطاق الذي خصصته [RFC 6598](https://datatracker.ietf.org/doc/html/rfc6598?ref=arabroot.io) لهذا الغرض، فأنت خلف CGNAT، والتفصيل في [قسم CGNAT](https://arabroot.io/articles/%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%AE%D8%A7%D8%AF%D9%85%D9%83-%D9%85%D9%86-%D8%A5%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D9%85%D9%86%D8%B2%D9%84/#cgnat) من دليل الوصول من الخارج.

والصورة التالية تبين الطريق كاملاً في الحالتين:

![مخطط بحالتين: في الأعلى هاتف على الإنترنت يرسل حزمة UDP إلى عنوان البيت العام على المنفذ 51820، فيوجهها الـ Router إلى Raspberry Pi بقاعدة توجيه المنفذ، ويصل الهاتف إلى شبكة البيت. وفي الأسفل نفس الهاتف يرسل إلى عنوان CGNAT عند المزود فتسقط الحزمة لأن المزود لا يعرف أي مشترك يقصد، والحل اتصال صادر من البيت إلى نقطة وسيطة مثل Tailscale أو VPS](https://arabroot.io/content/images/2026/11/raspberry-pi-wireguard-01-reachability-1.webp)

مع عنوان عام يكفي توجيه منفذ واحد، وخلف CGNAT يجب أن يبدأ البيت الاتصال إلى الخارج

### إذا كنت خلف CGNAT: ثلاثة طرق

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

- **اطلب عنواناً عاماً من مزودك**: بعض المزودين يعطونه مجاناً عند الطلب، وبعضهم بمبلغ شهري، وهو أبسط الحلول إذا توفر، لأن كل ما في هذا المقال يعمل بعده كما هو.
- **VPS صغير وسيطاً**: تشغل سيرفر WireGuard على VPS بعنوان عام، ويتصل به الـ Pi من البيت كأنه عميل، وتتصل به أنت من الهاتف، فتمر الحركة عبر الـ VPS. وهذا ما شرحناه في [دليل wg-easy](https://arabroot.io/articles/%D8%B4%D8%A8%D9%83%D8%A9-%D8%AE%D8%A7%D8%B5%D8%A9-%D9%85%D8%B9-wireguard-%D9%88-wg-easy/) وفي الطريقة السادسة من دليل الوصول من الخارج، وكلفته اشتراك VPS شهري، وكل الحركة تمر بمكان تملكه.
- **Tailscale أو Headscale**: [Tailscale](https://tailscale.com/?ref=arabroot.io) شبكة Mesh مبنية على WireGuard نفسه، وكل جهاز فيها يتصل بخادم تنسيق Coordination Server ليتبادل المفاتيح والعناوين، ثم يحاول أن يفتح اتصالاً مباشراً بين الجهازين عبر تقنيات العبور من NAT، كما تشرح الشركة في [مقال How NAT traversal works](https://tailscale.com/blog/how-nat-traversal-works?ref=arabroot.io)، فإذا فشل الاتصال المباشر مرت الحركة مشفرة عبر خوادم Relay اسمها DERP. وفيها ميزتان تعوضان ما في هذا المقال: الموجه الفرعي [Subnet Router](https://tailscale.com/kb/1019/subnets?ref=arabroot.io) الذي يجعل الـ Pi باباً لشبكة البيت كلها، ونقطة الخروج [Exit Node](https://tailscale.com/kb/1103/exit-nodes?ref=arabroot.io) التي تخرج حركة الهاتف من إنترنت البيت، أي ما يعادل النفق الكامل. وإذا أردت أن يكون خادم التنسيق Coordination Server نفسه عندك فـ [Headscale](https://headscale.net/stable/?ref=arabroot.io) بديل مفتوح المصدر له، وقد شرحناه في [دليل Headscale](https://arabroot.io/articles/headscale-%D8%AE%D8%A7%D8%AF%D9%85-%D8%AA%D8%AD%D9%83%D9%85-tailscale-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83/).

وقد يتساءل البعض: إذا كان Tailscale يعمل خلف CGNAT ودون فتح أي منفذ، فلماذا نتعب أنفسنا بـ WireGuard اليدوي؟ والإجابة أن الحلين مختلفان في من يملك المفاتيح والتنسيق: في WireGuard اليدوي لا يوجد أي طرف ثالث، فالـ Pi والهاتف يعرف كل منهما مفتاح الآخر فقط، ولا يتوقف شيء إذا توقفت خدمة خارجية، ولكنك تحتاج عنواناً عاماً ومنفذاً مفتوحاً وتدير المفاتيح بنفسك. أما Tailscale فيحل لك العبور من NAT وتوزيع المفاتيح، ولكن خادم التنسيق عندهم، أو عندك على VPS إذا استخدمت Headscale. لذلك إذا كان لديك عنوان عام فابدأ بـ WireGuard اليدوي كما في هذا المقال، وإذا كنت خلف CGNAT ولا تريد VPS فـ Tailscale هو الطريق الأقصر.

## كيف يعمل WireGuard من الداخل؟

WireGuard واجهة شبكة Network Interface عادية مثل `eth0`، اسمها في العادة `wg0`، وكل ما يدخلها يخرج من الطرف الآخر مشفراً داخل حزمة UDP. والفرق بينه وبين OpenVPN أو IPsec أنه لا توجد فيه شهادات ولا أسماء مستخدمين ولا خيارات تشفير تختار منها، فكل جهاز له زوج مفاتيح من نوع Curve25519: مفتاح خاص Private Key لا يخرج من الجهاز، ومفتاح عام Public Key تعطيه للطرف الآخر، والأجهزة تعرف بعضها بالمفتاح العام وحده، كما تعرف SSH جهازك بالمفتاح الذي في `authorized_keys`. وفي [ورقة WireGuard](https://www.wireguard.com/papers/wireguard.pdf?ref=arabroot.io) يشرح المؤلف أن هذا مقصود، فالبروتوكول اختار خوارزمياته مرة واحدة، وإذا ظهر فيها ضعف يوماً فالحل إصدار جديد وليس خياراً تضبطه.

### جدول التوجيه بالمفاتيح Cryptokey Routing

أهم فكرة في WireGuard، وأكثرها سبباً للأخطاء، هي أن كل طرف Peer في الإعداد له قائمة عناوين `AllowedIPs`، وهذه القائمة تعمل في الاتجاهين، كما يشرح [موقع المشروع](https://www.wireguard.com/?ref=arabroot.io):

- **عند الإرسال** تعمل كجدول توجيه: إذا أراد الـ Pi أن يرسل حزمة إلى `10.66.66.2`، فإنه يبحث عن الطرف الذي في قائمته هذا العنوان، ويشفر الحزمة Packet بمفتاحه ويرسلها إلى عنوانه الأخير المعروف.
- **عند الاستقبال** تعمل كقائمة سماح: إذا وصلت حزمة مشفرة بمفتاح الهاتف، وكان عنوان المصدر بعد فك التشفير ليس في قائمة الهاتف، يرميها WireGuard بصمت.

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

![جدول التوجيه بالمفاتيح على Raspberry Pi: الطرف phone بمفتاحه العام وقائمة AllowedIPs فيها 10.66.66.2/32، والطرف laptop بقائمة 10.66.66.3/32، وسهم إرسال يبحث في القائمة عن عنوان الوجهة ليختار المفتاح، وسهم استقبال يتحقق أن عنوان المصدر في قائمة المفتاح الذي فك الحزمة وإلا يرميها](https://arabroot.io/content/images/2026/11/raspberry-pi-wireguard-02-cryptokey-1.webp)

القائمة نفسها تختار المفتاح عند الإرسال، وترفض الحزمة عند الاستقبال إذا جاءت من عنوان ليس لصاحب المفتاح

### المصافحة Handshake، ولماذا لا يرد على أحد

قبل أن تمر أي بيانات يتبادل الطرفان رسالتين فقط، ويشتقان منهما مفاتيح الجلسة، وبحسب [صفحة البروتوكول](https://www.wireguard.com/protocol/?ref=arabroot.io) يعيد البادئ المصافحة كل دقيقتين ما دامت هناك حركة، فتتغير مفاتيح الجلسة باستمرار دون أن تفعل شيئاً، ولذلك ترى في `wg show` السطر `latest handshake` يتجدد. والشيء الذي يجعل WireGuard مناسباً جداً لجهاز في البيت أنه لا يرد على أي حزمة لا تحمل مفتاحاً يعرفه، فمن يمسح المنافذ على عنوان بيتك لا يرى إلا منفذاً صامتاً، لا يعرف هل هو مغلق أم مفتوح، وهذا عكس صفحة دخول على HTTPS تعلن عن نفسها لكل من يطرقها.

وللصمت ثمن يجب أن تعرفه: لأن WireGuard لا يرد على الحزم الخاطئة فإنه لا يرسل أي رسالة خطأ أيضاً، فإذا كان المفتاح خاطئاً أو المنفذ مغلقاً فلن ترى إلا أن السطر `latest handshake` غير موجود، وأن عداد `received` صفر. والجهة الأخرى أنه لا يرسل شيئاً إذا لم تكن هناك حركة، فإذا كان الهاتف خلف NAT ولم يرسل شيئاً لفترة فقد ينسى الـ Router جلسة UDP، ولذلك يوجد الخيار `PersistentKeepalive = 25` الذي يرسل حزمة فارغة كل 25 ثانية، وتضعه على الطرف الذي خلف NAT وليس على السيرفر.

## المختبر Lab: بيت كامل على جهاز واحد

نريد أن نرى كل شيء كما يحدث في البيت، لذلك بنينا المختبر من خمسة أجزاء، والصورة التالية تبينها بعناوينها الحقيقية:

![مخطط المختبر: على اليسار شبكة الإنترنت 172.29.71.0/24 فيها الهاتف 172.29.71.21 بنفق كامل والحاسوب المحمول 172.29.71.22 بنفق جزئي وسيرفر ويب 172.29.71.80 يرد بعنوان من يسأله، وفي الوسط الـ Router بعنوان البيت العام 172.29.71.10 يوجه المنفذ 51820/udp إلى Raspberry Pi OS بعنوان 10.0.2.15 وواجهة wg0 بعنوان 10.66.66.1، وعلى اليمين شبكة البيت 172.29.72.0/24 فيها NAS بعنوان 172.29.72.20 وAdGuard Home بعنوان 172.29.72.53](https://arabroot.io/content/images/2026/11/raspberry-pi-wireguard-03-lab-1.webp)

هاتف وحاسوب على «الإنترنت»، وRouter يوجه منفذاً واحداً، وRaspberry Pi يفتح الطريق إلى شبكة البيت

- **Raspberry Pi**: نفس جهاز مقال تجهيز Raspberry Pi كسيرفر، أي صورة Raspberry Pi OS Lite arm64 الرسمية في QEMU على لوحة `virt` بمعالج Cortex-A76، وقد ثبتنا فيه WireGuard من مستودع Debian نفسه.
- **الـ Router**: هو QEMU نفسه داخل Container على شبكة «الإنترنت» بعنوان `172.29.71.10`، ويوجه المنفذ `51820/udp` إلى الـ Pi بالخيار `hostfwd`، وهو ما يفعله توجيه المنفذ في Router البيت.
- **شبكة البيت**: AdGuard Home يحجب الإعلانات ويعرف الاسم `nas.home.arpa`، وجهاز NAS صغير يرد بصفحة نصية، وكلاهما لا يصل إليه أحد من «الإنترنت».
- **الهاتف والحاسوب**: Containers من Alpine فيها `wireguard-tools`، ويتصلان كما يتصل تطبيق WireGuard على الهاتف، فالبروتوكول والملف واحد.
- **سيرفر ويب على «الإنترنت»**: يرد بعنوان من يسأله، فنعرف منه هل خرجت الحركة من البيت أم من الهاتف مباشرة.

ولاحظ شيئاً واحداً مختلفاً عن البيت الحقيقي: في البيت يكون الـ Pi على نفس شبكة الـ NAS، أما في المختبر فالـ Pi خلف الـ Router الافتراضي ويصل إلى شبكة البيت عبره، وهذا لا يغير شيئاً في إعداد WireGuard، لأن الـ Pi في الحالتين يمرر حركة النفق إلى واجهة الشبكة ويترجم عناوينها كما سيأتي.

## التثبيت Installation على Raspberry Pi OS

WireGuard جزء من نواة Linux منذ الإصدار 5.6، فلا تحتاج أن تثبت البروتوكول نفسه، وإنما أدوات إدارته من حزمة `wireguard-tools` في مستودع Debian، كما في [صفحة التثبيت الرسمية](https://www.wireguard.com/install/?ref=arabroot.io). ومعها ثلاث حزم نحتاجها في هذا المقال: `iptables` لترجمة العناوين، و`qrencode` لرمز QR، و`iperf3` لقياس السرعة:

```bash
sudo apt install wireguard-tools iptables qrencode iperf3
modinfo wireguard | head -1
```

```text
filename:       /lib/modules/6.12.117+deb13-arm64/kernel/drivers/net/wireguard/wireguard.ko.xz
```

الوحدة موجودة في النواة Kernel، وعلى الجهاز الحقيقي سوف ترى في المسار Path نواة Raspberry Pi بدل نواة Debian التي نستخدمها في المختبر، والفرق في الاسم فقط.

## المفاتيح Keys: زوج لكل جهاز

كل جهاز في الشبكة يحتاج زوج مفاتيح، والأمر `wg genkey` يولد المفتاح الخاص Private Key، و`wg pubkey` يحسب منه المفتاح العام، والعكس غير ممكن، أي أنك تستطيع أن تنشر المفتاح العام دون خوف. ونولد هنا المفاتيح الثلاثة على الـ Pi نفسه حتى يبقى المثال في مكان واحد، ومعها مفتاح مشترك إضافي PresharedKey لكل جهاز بالأمر `wg genpsk`، وهو طبقة إضافية تتفق عليها مع كل طرف، وتقول [صفحة البروتوكول](https://www.wireguard.com/protocol/?ref=arabroot.io) إنها تحمي الحركة المسجلة اليوم من أي اختراق مستقبلي لخوارزمية Curve25519 بالحواسيب الكمية Post-Quantum:

```bash
cd /etc/wireguard
umask 077
wg genkey | tee server.key | wg pubkey > server.pub
wg genkey | tee phone.key  | wg pubkey > phone.pub
wg genkey | tee laptop.key | wg pubkey > laptop.pub
wg genpsk > phone.psk; wg genpsk > laptop.psk
ls -l /etc/wireguard
cat server.pub phone.pub laptop.pub
```

```text
-rw------- 1 root root 45 Nov 19 02:02 laptop.key
-rw------- 1 root root 45 Nov 19 02:02 laptop.psk
-rw------- 1 root root 45 Nov 19 02:02 laptop.pub
-rw------- 1 root root 45 Nov 19 02:02 phone.key
-rw------- 1 root root 45 Nov 19 02:02 phone.psk
-rw------- 1 root root 45 Nov 19 02:02 phone.pub
-rw------- 1 root root 45 Nov 19 02:02 server.key
-rw------- 1 root root 45 Nov 19 02:02 server.pub
lLoJP5FuIlm55VXuEaPlLb+UIxnmXQWbWnaqMRHARD8=
zsMyfswpEaXr9dw8tJfDxG0we0DOq0iREPLJK2fibhA=
fTS5Qh39cgG44aCXojih/rGYx81IFqRl/YtRC4EiFCA=
```

في المخرج أعلاه لاحظ التالي:

- كل الملفات بالصلاحية `-rw-------`، أي أن root وحده يقرؤها، والسبب هو `umask 077` قبل التوليد، فلا تنسه، لأن المفتاح الخاص هو هوية الجهاز، ومن يقرؤه يتصل باسمه.
- كل مفتاح 44 حرفاً بترميز Base64، أي 32 بايتاً، وهذا كل ما تحتاجه الأجهزة لتعرف بعضها، فلا توجد شهادات ولا جهة توقيع كما في [OpenVPN](https://arabroot.io/articles/%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-openvpn-%D9%85%D9%86-%D8%A7%D9%84%D8%B5%D9%81%D8%B1-%D8%B4%D9%87%D8%A7%D8%AF%D8%A7%D8%AA-pki-%D9%88%D8%A5%D8%A8%D8%B7%D8%A7%D9%84-%D8%A7%D9%84%D8%A3%D8%AC%D9%87%D8%B2%D8%A9/).
- الأفضل في الواقع أن يولد كل جهاز مفتاحه الخاص بنفسه، وتطبيق WireGuard على الهاتف يفعل ذلك، فلا يخرج المفتاح من الهاتف أبداً، وتنقل أنت المفتاح العام وحده إلى الـ Pi. أما توليد الكل على الـ Pi ثم إرسال الملف برمز QR فهو الأسهل، وثمنه أن المفتاح الخاص يمر من الـ Pi إلى الهاتف مرة واحدة.

## ملف السيرفر wg0.conf سطراً سطراً

الأداة `wg-quick` تقرأ ملفاً واحداً في `/etc/wireguard/wg0.conf` وتنشئ منه الواجهة والعناوين والمسارات، وهذا هو الملف على الـ Pi بعد اختصار المفاتيح الخاصة:

```ini
[Interface]
Address = 10.66.66.1/24
ListenPort = 51820
PrivateKey = ICn3...
PostUp = iptables -t nat -A POSTROUTING -s 10.66.66.0/24 -o enp0s4 -j MASQUERADE
PostUp = iptables -A FORWARD -i %i -j ACCEPT
PostUp = iptables -A FORWARD -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
PostDown = iptables -t nat -D POSTROUTING -s 10.66.66.0/24 -o enp0s4 -j MASQUERADE
PostDown = iptables -D FORWARD -i %i -j ACCEPT
PostDown = iptables -D FORWARD -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT

# phone: full tunnel
[Peer]
PublicKey = zsMyfswpEaXr9dw8tJfDxG0we0DOq0iREPLJK2fibhA=
PresharedKey = xJTJ...
AllowedIPs = 10.66.66.2/32

# laptop: split tunnel
[Peer]
PublicKey = fTS5Qh39cgG44aCXojih/rGYx81IFqRl/YtRC4EiFCA=
PresharedKey = gWqm...
AllowedIPs = 10.66.66.3/32
```

في الإعداد أعلاه لاحظ التالي:

- `Address = 10.66.66.1/24` عنوان الـ Pi داخل النفق، والشبكة `10.66.66.0/24` يجب ألا تتعارض مع شبكة البيت ولا مع الشبكات التي يكون فيها هاتفك عادة، لذلك لا تختر `192.168.1.0/24`، لأن نصف شبكات المقاهي والفنادق بهذا الرقم، وقد شرحنا اختيار الشبكات في [مقال الشبكات الفرعية](https://arabroot.io/articles/%D8%A7%D9%84%D8%B4%D8%A8%D9%83%D8%A7%D8%AA-%D8%A7%D9%84%D9%81%D8%B1%D8%B9%D9%8A%D8%A9-subnets-%D9%88-cidr-%D9%88-vlsm/).
- `AllowedIPs` في كل قسم `[Peer]` على السيرفر عنوان واحد بقناع `/32`، أي أن الهاتف لا يستطيع أن يرسل إلا من `10.66.66.2`، وهذه هي قائمة السماح Allow List التي شرحناها في جدول التوجيه بالمفاتيح.
- السطور `PostUp` تعمل بعد إنشاء الواجهة، و`PostDown` تحذف نفس القواعد عند الإيقاف، و`%i` تستبدل باسم الواجهة `wg0`. والسطر الأول هو الأهم: ترجمة العناوين MASQUERADE تجعل الحركة القادمة من النفق تخرج إلى شبكة البيت بعنوان الـ Pi نفسه، فيعرف الـ NAS أين يرسل الرد دون أن تضيف مساراً في الـ Router.
- `enp0s4` هو اسم واجهة الشبكة في جهازنا، وعلى Raspberry Pi حقيقي بكابل يكون غالباً `eth0`، فاعرفه بالأمر `ip route show default` قبل أن تكتب الملف.

ثم نشغل الواجهة بخدمة systemd التي تأتي مع الحزمة، حتى تعود وحدها بعد كل إعادة تشغيل:

```bash
sudo systemctl enable --now wg-quick@wg0
sudo wg show wg0
ss -ulpn | grep 51820
```

```text
interface: wg0
  public key: lLoJP5FuIlm55VXuEaPlLb+UIxnmXQWbWnaqMRHARD8=
  private key: (hidden)
  listening port: 51820

peer: zsMyfswpEaXr9dw8tJfDxG0we0DOq0iREPLJK2fibhA=
  preshared key: (hidden)
  allowed ips: 10.66.66.2/32

peer: fTS5Qh39cgG44aCXojih/rGYx81IFqRl/YtRC4EiFCA=
  preshared key: (hidden)
  allowed ips: 10.66.66.3/32

UNCONN 0      0            0.0.0.0:51820      0.0.0.0:*
UNCONN 0      0               [::]:51820         [::]:*
```

الواجهة تعمل وتستمع على المنفذ 51820 في IPv4 وIPv6، ولا يوجد بعد أي سطر `endpoint` للطرفين، والسبب أن السيرفر لا يعرف عنوان الهاتف حتى يتصل به الهاتف أول مرة، وهذا ما يجعل الهاتف يتنقل بين Wi-Fi وشبكة الجوال دون أن تغير شيئاً في السيرفر، فالسيرفر يحدث العنوان من آخر حزمة صحيحة وصلته، وهذا ما تسميه صفحة المشروع التنقل Roaming.

## ملفات الهاتف والحاسوب

ملف الطرف الآخر هو صورة معكوسة لقسم `[Peer]` على السيرفر: مفتاحه الخاص هو، ومفتاح السيرفر العام، وعنوان البيت في `Endpoint`. والفرق بين الجهازين كله في سطر `AllowedIPs`، وهذا ملف الحاسوب:

```ini
[Interface]
PrivateKey = 2JI+...
Address = 10.66.66.3/32
DNS = 172.29.72.53

[Peer]
PublicKey = lLoJP5FuIlm55VXuEaPlLb+UIxnmXQWbWnaqMRHARD8=
PresharedKey = gWqm...
Endpoint = 172.29.71.10:51820
AllowedIPs = 10.66.66.0/24, 172.29.72.0/24
PersistentKeepalive = 25
```

وملف الهاتف هو نفسه بمفاتيحه، مع `Address = 10.66.66.2/32` و`AllowedIPs = 0.0.0.0/0`، أي نفق كامل. وفي البيت الحقيقي اكتب في `Endpoint` اسم DDNS الخاص بك بدل العنوان كما ذكرنا، و`DNS = 172.29.72.53` هو AdGuard Home في البيت، فيمر سؤال الأسماء أيضاً داخل النفق ويحجب الإعلانات على الهاتف خارج البيت كما يحجبها داخله.

## أول اتصال من الهاتف

على الهاتف الحقيقي تستورد الملف في تطبيق WireGuard وتفعل النفق، أما في المختبر فالهاتف Container فيه `wireguard-tools`، فنضع الملف في `/etc/wireguard/wg0.conf` ونشغل `wg-quick up wg0`. وهنا ظهرت أول مشكلة، وهي ليست في الـ Pi وإنما في نواة الجهاز الذي يمثل الهاتف:

```text
[#] wg set wg0 fwmark 51820
[#] ip -4 rule add not fwmark 51820 table 51820
[#] ip -4 rule add table main suppress_prefixlength 0
[#] ip -4 route add 0.0.0.0/0 dev wg0 table 51820
[#] nft -f /dev/fd/63
/dev/fd/63:5:70-83: Error: Could not process rule: No such file or directory

[#] ip link delete dev wg0
```

والمخرج يبين كيف يبني `wg-quick` النفق الكامل على Linux، كما في [دليل wg-quick](https://git.zx2c4.com/wireguard-tools/about/src/man/wg-quick.8?ref=arabroot.io): لا يغير المسار الافتراضي في الجدول الرئيسي، وإنما يعلم حزم WireGuard نفسها بعلامة `fwmark 51820`، ويضع كل ما عداها في جدول توجيه خاص رقمه 51820 فيه المسار الافتراضي عبر `wg0`، فلا تدخل حزم النفق في النفق نفسه. ثم يضيف قواعد nftables تستخدم تتبع الاتصال Connection Tracking بعلامة `ct mark`، وهذه هي التي فشلت، والسبب أن النواة في الجهاز الذي شغلنا عليه الـ Containers لا تحتوي دعم هذه العلامة. وعلى أي توزيعة Linux عادية لن ترى هذا الخطأ، أما إذا رأيته على نواة مصغرة، في جهاز مدمج أو بيئة مثل WSL2، فالحل الذي يذكره المشروع في صفحة [Routing & Network Namespace Integration](https://www.wireguard.com/netns/?ref=arabroot.io) أن تقسم الإنترنت إلى نصفين:

```ini
AllowedIPs = 0.0.0.0/1, 128.0.0.0/1
```

```text
[#] ip -4 route add 128.0.0.0/1 dev wg0
[#] ip -4 route add 0.0.0.0/1 dev wg0
0.0.0.0/1 dev wg0 scope link
default via 172.29.71.1 dev eth0
128.0.0.0/1 dev wg0 scope link
172.29.71.0/24 dev eth0 proto kernel scope link src 172.29.71.21

peer: lLoJP5FuIlm55VXuEaPlLb+UIxnmXQWbWnaqMRHARD8=
  endpoint: 172.29.71.10:51820
  allowed ips: 0.0.0.0/1, 128.0.0.0/1
  latest handshake: 3 seconds ago
  transfer: 92 B received, 180 B sent
```

النصفان معاً يغطيان كل العناوين، وكل منهما أدق من المسار الافتراضي `/0`، فيفوز عليه دون أن نحذفه، أما عنوان السيرفر نفسه فبقي في المختبر خارج النفق لأن شبكته المباشرة `172.29.71.0/24` أدق من النصفين، وعلى الإنترنت الحقيقي تضيف له مساراً صريحاً عبر الـ Router كما في الصفحة نفسها، وهذا هو عيب الطريقة الذي حله `wg-quick` بالعلامة `fwmark`. ولاحظ السطر `latest handshake: 3 seconds ago`: المصافحة نجحت، أي أن المفاتيح صحيحة والمنفذ مفتوح.

### مشكلة واجهتنا: النفق يعمل ولا يصل إلى البيت

المصافحة ناجحة، فلنجرب الـ Pi نفسه ثم الـ NAS ثم الإنترنت:

```bash
ping -c 3 -W 5 10.66.66.1
curl -s -m 20 http://172.29.72.20/
```

```text
3 packets transmitted, 3 received, 0% packet loss, time 2003ms
curl nas: exit 28
```

الـ Pi يرد، والـ NAS لا يرد، والرمز 28 في curl يعني انتهاء المهلة Timeout. والسبب أن الـ Pi يستقبل الحزمة من النفق ولكنه لا يمررها إلى واجهة أخرى، لأن Linux افتراضياً جهاز وليس Router، والقيمة التي رأيناها عند إنشاء الملف كانت `net.ipv4.ip_forward = 0`. وقاعدة MASQUERADE لا تفيد شيئاً إذا لم تمر الحزمة أصلاً. والحل ملف دائم في `/etc/sysctl.d`:

```bash
echo 'net.ipv4.ip_forward = 1' | sudo tee /etc/sysctl.d/99-wireguard.conf
sudo sysctl --system | grep -E 'wireguard|ip_forward'
```

```text
* Applying /etc/sysctl.d/99-wireguard.conf ...
net.ipv4.ip_forward = 1
```

وبعدها مباشرة، ودون أن نلمس النفق:

```bash
curl -s -m 30 http://172.29.72.20/
curl -s -m 30 http://nas.home.arpa/
dig +short doubleclick.net
ip route get 9.9.9.9
wg show wg0 transfer
```

```text
nas.home.arpa: family photos share is here
nas.home.arpa: family photos share is here
0.0.0.0
9.9.9.9 dev wg0 src 10.66.66.2 uid 0
lLoJP5FuIlm55VXuEaPlLb+UIxnmXQWbWnaqMRHARD8=	10288	6224
```

في المخرج أعلاه لاحظ التالي:

- الهاتف وصل إلى الـ NAS بالعنوان وبالاسم `nas.home.arpa`، والاسم لا يعرفه إلا AdGuard Home في البيت، أي أن سؤال DNS مر داخل النفق كما طلب السطر `DNS`.
- `doubleclick.net` رجع `0.0.0.0`، أي أن الحجب يعمل على الهاتف وهو خارج البيت، وهذا ما شرحناه عن إجابة الاسم المحجوب في [دليل AdGuard Home](https://arabroot.io/articles/adguard-home-%D8%AD%D8%AC%D8%A8-%D8%A8%D8%A7%D9%84-dns-%D9%85%D8%B9-%D8%AA%D8%B4%D9%81%D9%8A%D8%B1-doh-%D9%88-dot/)، ويعمل بنفس الطريقة مع [Pi-hole](https://arabroot.io/articles/%D8%AD%D8%AC%D8%A8-%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%D8%A7%D8%AA-%D9%84%D9%83%D9%84-%D8%A3%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%A8%D9%8A%D8%AA-%D9%85%D8%B9-pi-hole/).
- `ip route get 9.9.9.9` يقول إن أي عنوان على الإنترنت يخرج من `wg0`، أي من إنترنت البيت، وهذا هو النفق الكامل.

ومن سجل الاستعلامات في AdGuard Home ظهر شيء يجب أن تعرفه:

```text
23:08:12 172.29.72.2 example.com NotFilteredNotFound
23:08:11 172.29.72.2 doubleclick.net FilteredBlackList
23:08:11 172.29.72.2 nas.home.arpa Rewrite
```

كل الأسئلة تظهر من عنوان واحد، وهو عنوان الـ Pi في شبكة البيت، وليس عنوان الهاتف في النفق، والسبب قاعدة MASQUERADE نفسها. وهذا يعني أنك لا تستطيع أن تضع قاعدة حجب خاصة بالهاتف في AdGuard، ولا أن تعرف أي جهاز سأل عن ماذا. وإذا كان ذلك يهمك فاحذف ترجمة العناوين، وأضف في الـ Router مساراً ثابتاً Static Route للشبكة `10.66.66.0/24` عبر عنوان الـ Pi، فتصل الأسئلة بعناوين النفق الحقيقية.

### النفق الجزئي على الحاسوب

```text
[#] ip -4 route add 172.29.72.0/24 dev wg0
[#] ip -4 route add 10.66.66.0/24 dev wg0
nas.home.arpa: family photos share is here
9.9.9.9 via 172.29.71.1 dev eth0 src 172.29.71.22 uid 0
172.29.72.20 dev wg0 src 10.66.66.3 uid 0
```

الحاسوب أضاف مسارين فقط، شبكة النفق وشبكة البيت، فالـ NAS عبر `wg0`، والإنترنت من اتصال الحاسوب نفسه عبر `eth0`. وهذا هو الإعداد الأنسب لحاسوب العمل أو لشبكة سريعة تثق بها، لأن الحركة الثقيلة لا تمر برفع البيت Upload الذي يكون في أغلب الاشتراكات أبطأ بكثير من التنزيل، كما سيظهر في قياس السرعة.

![مقارنة بين الهاتف بنفق كامل AllowedIPs 0.0.0.0/0 حيث يخرج 9.9.9.9 والـ NAS وDNS كلها عبر wg0، والحاسوب بنفق جزئي AllowedIPs لشبكة النفق وشبكة البيت حيث يخرج 9.9.9.9 عبر eth0 والـ NAS وDNS عبر wg0](https://arabroot.io/content/images/2026/11/raspberry-pi-wireguard-04-full-split-1.webp)

نفس السيرفر ونفس المفاتيح، والفرق كله في سطر AllowedIPs على كل جهاز

## إعداد الهاتف برمز QR مع qrencode

كتابة مفتاح من 44 حرفاً على شاشة الهاتف ليست فكرة جيدة، وتطبيق WireGuard على Android وiOS يقرأ الملف كاملاً من رمز QR، والأداة [qrencode](https://fukuchi.org/works/qrencode/?ref=arabroot.io) تحول الملف إلى رمز يظهر في الطرفية نفسها، فتفتح التطبيق وتختار إضافة نفق بالمسح وتوجه الكاميرا إلى الشاشة:

```bash
sudo qrencode -t ansiutf8 < /etc/wireguard/phone.conf
sudo qrencode -t ansiutf8 < /etc/wireguard/phone.conf | wc -l
```

```text
35
```

الرمز 35 سطراً في الطرفية، ولن نعرضه هنا لأنه يحمل المفتاح الخاص للهاتف. وحتى نتأكد أن الرمز يحمل الملف كما هو بايتاً ببايت، حفظناه كصورة PNG بالخيار `-o`، ثم قرأناه بالأداة `zbarimg` في جهاز آخر وقارنا البصمة:

```bash
sudo qrencode -o /tmp/phone.png -s 6 < /etc/wireguard/phone.conf
sha256sum /etc/wireguard/phone.conf
zbarimg -q --raw phone.png > decoded.conf; sha256sum decoded.conf
```

```text
078393d204410ffd85d94cf32f33c3aac4aa13afb16b81732249ba820776f1de  phone.conf
078393d204410ffd85d94cf32f33c3aac4aa13afb16b81732249ba820776f1de  decoded.conf
```

البصمتان متطابقتان، أي أن الهاتف سوف يقرأ نفس الملف. ولاحظ أن `zbarimg` يضيف سطراً فارغاً في آخر ما يقرؤه، فحذفناه قبل المقارنة. وبعد أن يقرأ الهاتف الرمز احذف الصورة، والأفضل أن لا تحفظها أصلاً وأن تعرض الرمز في الطرفية فقط، والسبب أن الصورة نسخة من المفتاح الخاص في ملف يمكن أن ينسخه أي شيء، ومن يصورها يدخل شبكة بيتك.

🛑

رمز QR هو ملف الإعداد كاملاً بالمفتاح الخاص، فلا تعرضه في مكالمة فيديو ولا تصوره لترسله لأحد في البيت، وإذا رأى أحد الرمز فاعتبر المفتاح مكشوفاً وغيره كما في قسم تغيير المفاتيح.

## كم سرعة النفق؟ قياس iperf3

شغلنا `iperf3` كسيرفر على الـ Pi، ثم قسنا من الحاسوب مرتين: مرة مباشرة عبر منفذ موجه في الـ Router دون نفق، ومرة عبر النفق إلى `10.66.66.1`، كل مرة عشرين ثانية، ومعها `mpstat` على الـ Pi ليرينا أين يذهب المعالج:

```bash
iperf3 -s -D                                   # on the Pi
iperf3 -c 172.29.71.10 -t 20 -f m              # laptop: direct, no tunnel
iperf3 -c 10.66.66.1 -t 20 -f m                # laptop: through WireGuard
iperf3 -c 10.66.66.1 -t 20 -R -f m             # reverse: the Pi sends
mpstat -P ALL 10 1                             # on the Pi, during the test
```

```text
### direct (port forward, no tunnel)
[  5]   0.00-20.00  sec   256 MBytes   107 Mbits/sec                  receiver
### through WireGuard
[  5]   0.00-20.03  sec  63.1 MBytes  26.4 Mbits/sec                  receiver
### reverse (Pi sends)
[  5]   0.00-20.00  sec  18.9 MBytes  7.92 Mbits/sec                  receiver

Average:     CPU    %usr   %nice    %sys %iowait    %irq   %soft  %steal  %guest  %gnice   %idle
Average:     all    1.79    0.00   20.43    0.00    0.00   17.27    0.00    0.00    0.00   60.52
```

والصورة التالية تجمع الأرقام الثلاثة:

![رسم أعمدة لقياس iperf3 في المختبر المحاكى: 107 ميجابت في الثانية مباشرة دون نفق، و26.4 عبر WireGuard من الحاسوب إلى الـ Pi، و7.9 في الاتجاه العكسي من الـ Pi إلى الحاسوب، مع ملاحظة أن المحاكاة تترجم كل تعليمة Arm وأن الأرقام للمقارنة داخل المختبر وليست سرعة Raspberry Pi](https://arabroot.io/content/images/2026/11/raspberry-pi-wireguard-05-iperf-1.webp)

في المحاكاة Emulation كل شيء أبطأ، والمهم هو النسبة بين القياسات وأين يذهب المعالج

في المخرج أعلاه لاحظ التالي:

- هذه أرقام جهاز Arm محاكى بالكامل على حاسوب x86، فكل تعليمة في التشفير تترجم إلى تعليمات أخرى، وحتى الطريق المباشر دون نفق لم يتجاوز 107 ميجابت. لذلك لا تقرأها كسرعة Raspberry Pi، وإنما كمقارنة بين طريقين على نفس الجهاز: النفق أخذ حوالي ربع سرعة الطريق المباشر في المحاكاة.
- المعالج لم يكن مشغولاً بالكامل، فـ 60% منه خامل، ولكن الوقت كله في النواة: `%sys` و`%soft`، وهذا هو مكان WireGuard، فالتشفير وفك التشفير يحدثان في النواة وفي معالجة الحزم Softirq وليس في برنامج يعمل في مساحة المستخدم، وهذا سبب سرعته مقارنة بـ OpenVPN كما قسنا في [مقارنة شبكات VPN](https://arabroot.io/articles/%D9%85%D9%82%D8%A7%D8%B1%D9%86%D8%A9-wireguard-%D9%88-openvpn-%D9%88-ipsec-%D9%88%D8%A7%D8%AF%D9%88%D8%A7%D8%AA-mesh/).
- الاتجاه العكسي كان أبطأ، وفي المحاكاة يأتي ذلك من طريق الحزم عبر شبكة QEMU الافتراضية أكثر مما يأتي من WireGuard، فلا تبن عليه حكماً.

فما الذي يحدد السرعة في البيت الحقيقي؟ في أغلب الحالات ليس الـ Pi، وإنما سرعة الرفع Upload في اشتراك البيت، لأن كل ما تطلبه من الهاتف في الخارج يخرج من البيت رفعاً، فإذا كان اشتراكك 500 ميجابت تنزيلاً و50 رفعاً فالنفق لن يتجاوز 50 مهما كان المعالج. وPi 4 وPi 5 فيهما منفذ Gigabit Ethernet، وأنوية Cortex-A72 وCortex-A76، وتعليمات NEON التي يستخدمها تطبيق ChaCha20 في النواة، فإذا أردت رقماً لجهازك فشغل نفس الأوامر الثلاثة عليه، وقارن الطريق المباشر بالنفق كما فعلنا.

## ثلاثة أعطال حقيقية وكيف تقرؤها

شرحنا في [مقال ما هو VPN](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-vpn-%D8%B4%D8%B1%D8%AD-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/#demo-break) عطلين: مفتاح عام بحرف خاطئ، وجهاز يحاول انتحال عنوان، وفي [دليل wg-easy](https://arabroot.io/articles/%D8%B4%D8%A8%D9%83%D8%A9-%D8%AE%D8%A7%D8%B5%D8%A9-%D9%85%D8%B9-wireguard-%D9%88-wg-easy/) أشهر رسائل الخطأ في الواجهة، فلن نكررها. وإنما نفتعل هنا ثلاثة أعطال أخرى تظهر كثيراً عندما تكتب الملفات بيدك، والمشترك بينها أن المصافحة في الغالب تنجح، فتظن أن النفق سليم.

### العطل الأول: نفس العنوان لطرفين

عندما تضيف جهازاً جديداً فأسرع طريقة أن تنسخ قسم `[Peer]` لجهاز موجود وتغير المفتاح، وهنا يسهل أن تنسى تغيير العنوان. ولنفعل ذلك عمداً على الـ Pi، فنعطي الحاسوب عنوان الهاتف:

```bash
sudo wg set wg0 peer fTS5Qh39cgG44aCXojih/rGYx81IFqRl/YtRC4EiFCA= allowed-ips 10.66.66.2/32
sudo wg show wg0 allowed-ips
```

```text
zsMyfswpEaXr9dw8tJfDxG0we0DOq0iREPLJK2fibhA=	(none)
fTS5Qh39cgG44aCXojih/rGYx81IFqRl/YtRC4EiFCA=	10.66.66.2/32
```

لم يرفض `wg` الأمر ولم يحذر، وإنما نقل العنوان من الهاتف إلى الحاسوب، فصارت قائمة الهاتف `(none)`. والنتيجة على الهاتف:

```text
3 packets transmitted, 0 received, 100% packet loss, time 2064ms
curl: exit 6
```

الهاتف يرسل والـ Pi يستقبل ويفك التشفير، ثم يرمي الحزمة بصمت لأن مصدرها `10.66.66.2` ليس في قائمة مفتاح الهاتف، وحتى لو مرت فالرد إلى `10.66.66.2` سوف يشفر بمفتاح الحاسوب. والرمز 6 في curl يعني أن الاسم لم يحل أصلاً، لأن DNS نفسه يمر في النفق. وهذا العطل يحدث أيضاً عندما يكون الخطأ في الملف نفسه، فإذا كتبت نفس `AllowedIPs` في قسمين من `wg0.conf` فالقسم الأخير يأخذ العنوان. لذلك عندما يتوقف جهاز بعد إضافة جهاز آخر، فأول أمر تشغله هو `wg show wg0 allowed-ips`، فإذا وجدت `(none)` أمام طرف فقد أخذ غيره عنوانه. والإصلاح أن تعيد الملف كما هو دون أن توقف النفق:

```bash
sudo bash -c 'wg syncconf wg0 <(wg-quick strip wg0)'
sudo wg show wg0 allowed-ips
```

```text
zsMyfswpEaXr9dw8tJfDxG0we0DOq0iREPLJK2fibhA=	10.66.66.2/32
fTS5Qh39cgG44aCXojih/rGYx81IFqRl/YtRC4EiFCA=	10.66.66.3/32
```

والأمر `wg-quick strip` يحذف من الملف ما يخص `wg-quick` وحده، مثل `Address` و`PostUp`، ويترك ما يفهمه `wg`، ثم `wg syncconf` يطبق الفرق فقط، فلا تنقطع الأجهزة الأخرى، وهذه هي الطريقة الصحيحة لأي تعديل على سيرفر يعمل، بدل `systemctl restart` الذي يقطع الجميع.

### العطل الثاني: النفق الجزئي دون شبكة البيت

الخطأ الثاني في الاتجاه المعاكس، على ملف الجهاز، فإذا كتبت في النفق الجزئي شبكة النفق وحدها `AllowedIPs = 10.66.66.0/24` ونسيت شبكة البيت:

```text
[#] ip -4 route add 10.66.66.0/24 dev wg0
2 packets transmitted, 2 received, 0% packet loss, time 1002ms
172.29.72.20 via 172.29.71.1 dev eth0 src 172.29.71.22 uid 0
curl: exit 28
dns: no answer
```

الـ Pi يرد، ولكن الطريق إلى الـ NAS يخرج من `eth0` إلى الإنترنت وليس من النفق، فينتهي curl بالمهلة، ولا يجيب DNS لأن AdGuard نفسه في شبكة البيت. والأمر الذي يكشف ذلك في ثانية هو `ip route get` مع عنوان الجهاز الذي لا تصل إليه، فإذا رأيت `eth0` بدل `wg0` فالمشكلة في `AllowedIPs` على جهازك وليست في السيرفر.

### العطل الثالث: الـ MTU، الصفحات الصغيرة تعمل والكبيرة تتوقف

![رسم لحزمة WireGuard: رأس IPv4 بحجم 20 بايت ورأس UDP بحجم 8 ورأس WireGuard بحجم 16 والحزمة الأصلية المشفرة 1420 ووسم التحقق 16، فتصبح 1480 بايتاً مع IPv4 و1500 مع IPv6، ولذلك القيمة الافتراضية 1420، ومتى لا تكفي عندما يكون في الطريق رابط أصغر ويسقط شيء الأجزاء](https://arabroot.io/content/images/2026/11/raspberry-pi-wireguard-06-mtu-1.webp)

60 بايتاً لكل حزمة مع IPv4 و80 مع IPv6، ومنها جاءت القيمة 1420

رأينا في الصورة أعلاه أن WireGuard يضيف 60 بايتاً لكل حزمة مع IPv4، و80 مع IPv6\. ولنفرض أن في الطريق بين الهاتف والبيت رابطاً لا يمرر أكثر من 1280 بايتاً، مثل بعض شبكات الجوال أو نفق آخر، ولا يرسل رسالة ICMP تخبر الهاتف بذلك. وقد صنعنا هذا الرابط بأن جعلنا الـ MTU على منفذ الـ Router في المختبر 1280، والهاتف ما زال على 1420 لأن `wg-quick` حسبها من واجهته هو، وهي 1500:

```bash
ip link set eth0 mtu 1280                  # the router port in the lab
ping -c 2 -W 3 10.66.66.1                 # on the phone
ping -c 2 -W 3 -M do -s 1200 10.66.66.1
iperf3 -c 10.66.66.1 -t 10 -f m
```

```text
7: wg0: <POINTOPOINT,NOARP,UP,LOWER_UP> mtu 1420 qdisc noqueue state UNKNOWN mode DEFAULT group default qlen 1000
2 packets transmitted, 2 received, 0% packet loss, time 1002ms
## ping 1200 bytes, DF
2 packets transmitted, 0 received, 100% packet loss, time 1064ms
## iperf3 10 s
[  5]   0.00-1.00   sec  0.00 Bytes  0.00 Mbits/sec    2   1.34 KBytes
iperf3: error - control socket has closed unexpectedly
```

المصافحة تعمل، والـ ping الصغير يعمل، والحزمة الكبيرة تختفي، والنقل يتوقف بعد أول ثانية. وهذا هو الشكل الذي يصفه الناس بقولهم «الـ VPN متصل والمواقع لا تفتح»، أو «SSH يعمل وينقطع عند نقل ملف»، والسبب أن الحزمة المشفرة الكبيرة تسقط في الطريق ولا يعرف أحد. والخيار `-M do` في ping يمنع التقسيم Fragmentation، فهو الطريقة لتقيس أكبر حجم يمر، وعندما جربنا أحجاماً قريبة من الحد وجدنا شيئاً لم يكن في الحساب:

```text
## -s 1192
2 packets transmitted, 0 received, 100% packet loss, time 1046ms
```

بالحساب البسيط، 1192 بايتاً مع رأس ICMP و IP تصبح 1220، ومع 60 بايتاً من WireGuard تصبح 1280 بالضبط، فيجب أن تمر. ولكنها لم تمر، والسبب أن WireGuard يكمل طول الحزمة المشفرة إلى مضاعف 16 بايتاً كما في ورقة البروتوكول، فصارت 1232 ثم 1292 على الكابل. وهذا سبب إضافي لتترك هامشاً ولا تحسب الـ MTU على الحد. والحل أن تكتب الـ MTU في ملف الهاتف، والقيمة 1280 ناقص 80 أي 1200:

```ini
[Interface]
PrivateKey = 4AUg...
Address = 10.66.66.2/32
MTU = 1200
DNS = 172.29.72.53
```

```text
[#] ip link set mtu 1200 up dev wg0
## iperf3 10 s, MTU 1200
[  5]   0.00-10.02  sec  34.2 MBytes  28.7 Mbits/sec                  receiver
## -s 1172
2 packets transmitted, 2 received, 0% packet loss, time 1002ms
## -s 1180
2 packets transmitted, 0 received, +2 errors, 100% packet loss, time 1036ms
```

عاد النقل إلى سرعته، و`-s 1172` أي 1200 بايت داخل النفق تمر، أما `-s 1180` فيرفضها الهاتف نفسه قبل أن ترسل، وهذا معنى `+2 errors`، والسبب أن الحزمة أكبر من MTU الواجهة مع منع التقسيم، فالخطأ الآن محلي وواضح بدل أن يكون صامتاً في الطريق. والقاعدة العملية: إذا لم تعرف الطريق فلا تكتب MTU، ودع `wg-quick` يحسبها، فإذا ظهرت هذه الأعراض فجرب 1280 أو 1200 على الجهاز الذي في الشبكة الضعيفة، وهذا ما يقوله أيضاً قسم [الـ MTU في مقال ما هو VPN](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-vpn-%D8%B4%D8%B1%D8%AD-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/#mtu).

## تغيير المفاتيح Key Rotation

WireGuard يغير مفاتيح الجلسة وحده كل دقيقتين كما ذكرنا، ولكن المفتاح الثابت لكل جهاز لا يتغير أبداً حتى تغيره أنت، والحالات التي يجب أن تغيره فيها: ضياع الهاتف أو بيعه، أو ظهور الملف أو رمز QR لأحد، أو كجزء من صيانة سنوية. والخطوات على الـ Pi:

```bash
cd /etc/wireguard; umask 077
wg genkey | tee phone-2026-11.key | wg pubkey > phone-2026-11.pub
sed -i "s#PublicKey = zsMyfswpEaXr9dw8tJfDxG0we0DOq0iREPLJK2fibhA=#PublicKey = $(cat phone-2026-11.pub)#" wg0.conf
wg syncconf wg0 <(wg-quick strip wg0)
wg show wg0 allowed-ips
```

```text
fTS5Qh39cgG44aCXojih/rGYx81IFqRl/YtRC4EiFCA=	10.66.66.3/32
4kezsht0aRQ+Ik/lKCYlPaKkxFKLBeeK99vHj3CbWSk=	10.66.66.2/32
```

المفتاح القديم اختفى من السيرفر، والعنوان `10.66.66.2` صار للمفتاح الجديد. ثم جربنا الهاتف بملفه القديم، والحاسوب في نفس اللحظة:

```text
phone, old key:   3 packets transmitted, 0 received, 100% packet loss
  transfer: 0 B received, 444 B sent
laptop:           2 packets transmitted, 2 received, 0% packet loss
```

الهاتف بالمفتاح القديم يرسل محاولات المصافحة ولا يستقبل شيئاً، ولا يرى أي رسالة رفض، وهذا هو الصمت الذي شرحناه، فمن سرق الهاتف لا يعرف حتى أن الباب ما زال موجوداً. والحاسوب لم ينقطع، لأن `wg syncconf` غير طرفاً واحداً فقط. وبعد أن وصل الملف الجديد إلى الهاتف برمز QR جديد:

```text
3 packets transmitted, 3 received, 0% packet loss, time 2003ms
  latest handshake: 2 seconds ago
  transfer: 476 B received, 564 B sent
```

ولاحظ أننا أبقينا `PresharedKey` نفسه، والأفضل في حالة الهاتف المفقود أن تغيره أيضاً، لأنه موجود في الملف القديم. أما إذا كان المكشوف هو مفتاح السيرفر نفسه، فلا يوجد طريق مختصر: مفتاح جديد للسيرفر، وملف جديد لكل جهاز، لأن كل الأجهزة تعرف السيرفر بمفتاحه العام، وهذا سبب إضافي لتحمي `/etc/wireguard` على الـ Pi وتضعه في [النسخ الاحتياطي](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/) مشفراً.

## بعد إعادة التشغيل Reboot: مشكلة اسم الواجهة

بعد أن نقلنا الـ Pi إلى قرص SSD ونزعنا البطاقة، وهي الخطوات التي في مقال تجهيز Raspberry Pi كسيرفر، عادت الخدمة Service `wg-quick@wg0` وحدها، والمصافحة نجحت، والـ ping إلى `10.66.66.1` يعمل، ولكن لا الهاتف ولا الحاسوب يصلان إلى الـ NAS:

```text
2 packets transmitted, 2 received, 0% packet loss, time 1002ms
curl: (28) Connection timed out after 15001 milliseconds
```

وهذا هو نفس شكل عطل تمرير الحركة، ولكن `ip_forward` كان 1 هذه المرة، فقرأنا قاعدة الترجمة وعدادها:

```bash
ip route show default
sudo iptables -t nat -L POSTROUTING -v -n
```

```text
default via 10.0.2.2 dev enp0s3 proto dhcp src 10.0.2.15 metric 100

Chain POSTROUTING (policy ACCEPT 63 packets, 4592 bytes)
 pkts bytes target     prot opt in     out     source               destination
    0     0 MASQUERADE  all  --  *      enp0s4  10.66.66.0/24        0.0.0.0/0
```

الواجهة صار اسمها `enp0s3` بدل `enp0s4`، لأن نزع قرص البطاقة الافتراضي غير ترتيب الأجهزة على ناقل PCI في المحاكاة، والاسم في هذه الطريقة يبنى من مكان الجهاز. والقاعدة تطلب `-o enp0s4`، فعدادها صفر، أي أن الحركة تخرج إلى شبكة البيت بعناوين النفق دون ترجمة، فلا يعرف الـ NAS أين يرد. وعلى Raspberry Pi حقيقي يبقى الاسم `eth0` غالباً، ولكن نفس الشيء يحدث إذا انتقلت من الكابل إلى Wi-Fi، أي إلى `wlan0`، أو أضفت محول USB للشبكة. والحل أن لا تكتب اسم الواجهة أصلاً، وإنما تقول: ترجم كل ما يخرج من غير `wg0`:

```ini
PostUp = iptables -t nat -A POSTROUTING -s 10.66.66.0/24 ! -o %i -j MASQUERADE
PostDown = iptables -t nat -D POSTROUTING -s 10.66.66.0/24 ! -o %i -j MASQUERADE
```

```text
3 packets transmitted, 3 received, 0% packet loss, time 2002ms
nas.home.arpa: family photos share is here
  latest handshake: 29 seconds ago
```

وبعد `systemctl restart wg-quick@wg0` عاد الهاتف بعد أقل من نصف دقيقة دون أن نلمسه، والسبب `PersistentKeepalive = 25` الذي جعله يعيد المصافحة وحده، وهذا ما يحدث أيضاً عندما يعيد الـ Pi التشغيل بعد انقطاع الكهرباء.

## جدار حماية لكل جهاز: الحاسوب يصل إلى الـ NAS فقط

ذكرنا أن `AllowedIPs` في ملف الجهاز يقرر الطريق ولا يمنع شيئاً، فصاحب الحاسوب يستطيع أن يكتب فيه شبكة البيت كلها. فإذا كان الحاسوب لضيف، أو جهاز عمل لا تريد أن يرى كاميرات البيت، فالقيد يكون على الـ Pi، في سلسلة `FORWARD` التي تمر بها كل حركة من النفق إلى البيت. والمثال التالي يسمح للحاسوب بالـ NAS على المنفذ 80 وبسؤال DNS، ويمنع كل ما عدا ذلك، والترتيب مهم لأن iptables يأخذ أول قاعدة تطابق:

```bash
sudo iptables -I FORWARD 1 -i wg0 -s 10.66.66.3 -j DROP
sudo iptables -I FORWARD 1 -i wg0 -s 10.66.66.3 -d 172.29.72.53 -p udp --dport 53 -j ACCEPT
sudo iptables -I FORWARD 1 -i wg0 -s 10.66.66.3 -d 172.29.72.20 -p tcp --dport 80 -j ACCEPT
```

ثم جربنا من الحاسوب ثلاثة أشياء: صفحة الـ NAS، وواجهة AdGuard Home على المنفذ 80، وping إلى الـ NAS، وقرأنا العدادات على الـ Pi:

```text
nas.home.arpa: family photos share is here
curl: (28) Connection timed out after 10001 milliseconds
2 packets transmitted, 0 received, 100% packet loss, time 1067ms

num   pkts bytes target     prot opt in     out     source               destination
1        6   337 ACCEPT     tcp  --  wg0    *       10.66.66.3           172.29.72.20         tcp dpt:80
2        2   164 ACCEPT     udp  --  wg0    *       10.66.66.3           172.29.72.53         udp dpt:53
3        6   408 DROP       all  --  wg0    *       10.66.66.3           0.0.0.0/0
```

في المخرج أعلاه لاحظ التالي:

- الـ NAS فتح، والاسم حل عبر DNS، أي أن القاعدتين الأوليين عملتا، وعداداهما يبينان ذلك.
- واجهة AdGuard وping سقطا في القاعدة الثالثة، وعدادها 6 حزم: أربع محاولات اتصال TCP وحزمتا ping، ولم يصل للحاسوب أي رد، لأن DROP لا يرد على أحد، كما لا يرد WireGuard نفسه على من لا يعرفه.
- القواعد تطابق عنوان المصدر `10.66.66.3`، وهذا آمن هنا لأن WireGuard نفسه لا يسمح لأي مفتاح آخر أن يرسل من هذا العنوان، أي أن عنوان النفق هوية موثوقة، وهذا ما لا تملكه في شبكة عادية.
- هذه القواعد تختفي عند إعادة التشغيل، فضعها في `PostUp` و`PostDown` في `wg0.conf` بنفس الطريقة، حتى تعيش وتموت مع الواجهة.

## أخطاء شائعة

- **نسيان تمرير الحركة Forwarding أو ترجمة العناوين NAT على الـ Pi**: المصافحة تنجح، والهاتف يصل إلى `10.66.66.1`، ولكن لا يصل إلى أي جهاز آخر في البيت ولا إلى الإنترنت في النفق الكامل.
- **اسم الواجهة مكتوب في قاعدة الترجمة**: `-o eth0` يتوقف يوم يتغير الاسم إلى `wlan0` أو غيره، واكتب `! -o %i` بدله.
- **نفس العنوان في AllowedIPs لطرفين**: الطرف الأخير يأخذ العنوان، والأول يفقد اتصاله دون أي رسالة خطأ، وهذا يحدث غالباً عند نسخ قسم `[Peer]` لجهاز جديد.
- **ملف واحد على جهازين**: الجهازان يحملان نفس المفتاح، فيأخذ السيرفر آخر عنوان سمع منه، وينقطع أحدهما كلما اتصل الآخر.
- **اعتبار AllowedIPs في ملف الهاتف قيداً أمنياً**: صاحب الهاتف يستطيع أن يغيره، والقيد الحقيقي هو ما في قسم `[Peer]` على الـ Pi، وجدار الحماية Firewall على الـ Pi.
- **نسيان شبكة البيت في النفق الجزئي**: يتصل النفق، ويصل الجهاز إلى الـ Pi، ولا يصل إلى الـ NAS، لأن حركته إلى شبكة البيت تخرج من اتصاله العادي.
- **MTU أكبر من الطريق**: الصفحات الصغيرة تعمل، والتحميل الكبير يتوقف، وتظن أن المشكلة في الموقع.
- **إرسال ملف الإعداد في محادثة أو بريد**: الملف ورمز QR يحملان المفتاح الخاص، فمن يحصل عليهما يدخل شبكة البيت باسم ذلك الجهاز.
- **فتح منفذ لوحة الإدارة بدل الـ VPN**: إذا وضعت WireGuard فلا تحتاج أن تفتح أي منفذ آخر في الـ Router، فكل الخدمات تصل إليها من داخل النفق.

## WireGuard اليدوي أم wg-easy أم Tailscale؟

| حالتك                                                | الأنسب                                                                                                                                                                                                                                     | السبب                                                               |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |
| عنوان عام، وجهازان أو ثلاثة، وتريد أن تفهم ما يحدث   | WireGuard يدوي على الـ Pi كما في هذا المقال                                                                                                                                                                                                | ملف واحد، ولا طرف ثالث، ولا واجهة تحتاج حماية                       |
| عنوان عام، وأجهزة كثيرة للعائلة، وتريد إضافتها بنقرة | [wg-easy](https://arabroot.io/articles/%D8%B4%D8%A8%D9%83%D8%A9-%D8%AE%D8%A7%D8%B5%D8%A9-%D9%85%D8%B9-wireguard-%D9%88-wg-easy/)                                                                                                           | رموز QR وتعطيل الأجهزة من واجهة ويب، ولكن الواجهة نفسها تحتاج حماية |
| خلف CGNAT ولا تريد VPS                               | [Tailscale](https://tailscale.com/kb/1019/subnets?ref=arabroot.io) مع الـ Pi موجهاً فرعياً Subnet Router                                                                                                                                   | يعبر NAT وحده، وخادم التنسيق عند الشركة                             |
| خلف CGNAT وتريد كل شيء عندك                          | [Headscale](https://arabroot.io/articles/headscale-%D8%AE%D8%A7%D8%AF%D9%85-%D8%AA%D8%AD%D9%83%D9%85-tailscale-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83/) على VPS                                                           | نفس تطبيقات Tailscale وخادم تنسيق تملكه                             |
| تريد فقط صفحة واحدة من البيت على الإنترنت            | ليس VPN، وإنما نفق عكسي كما في [دليل الوصول من الخارج](https://arabroot.io/articles/%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%AE%D8%A7%D8%AF%D9%85%D9%83-%D9%85%D9%86-%D8%A5%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D9%85%D9%86%D8%B2%D9%84/) | الـ VPN يدخلك الشبكة كلها، وأنت تحتاج خدمة واحدة                    |

## قائمة تحقق Checklist قبل أن تعطي العائلة الرمز

| البند                              | كيف تتأكد                                                            |
| ---------------------------------- | -------------------------------------------------------------------- |
| عنوان البيت عام وليس CGNAT         | عنوان WAN في الـ Router يطابق عنوانك كما يراه الإنترنت               |
| للـ Pi عنوان ثابت وتوجيه منفذ واحد | حجز في DHCP، وقاعدة 51820/udp وحدها في الـ Router                    |
| اسم DDNS في Endpoint               | الاسم يحل إلى عنوان البيت الحالي                                     |
| تمرير الحركة دائم                  | sysctl net.ipv4.ip\_forward يعطي 1 بعد إعادة التشغيل                 |
| الخدمة تعود وحدها                  | systemctl is-enabled wg-quick@wg0 يعطي enabled                       |
| لكل جهاز مفتاح وعنوان مختلف        | wg show wg0 allowed-ips لا يوجد فيه (none)                           |
| DNS البيت يعمل من الخارج           | اسم محجوب يرجع 0.0.0.0 والاسم الداخلي يحل والهاتف على شبكة الجوال    |
| النقل الكبير لا يتوقف              | تنزيل ملف كبير من الـ NAS عبر النفق، وMTU = 1280 إذا توقف            |
| المفاتيح محمية ومنسوخة             | /etc/wireguard بصلاحية root فقط، وفي النسخة الاحتياطية Backup مشفراً |
| تعرف كيف توقف جهازاً مفقوداً       | جربت حذف طرف وwg syncconf دون أن ينقطع الآخرون                       |

## تدريب عملي

1. أضف طرفاً ثالثاً لجهاز لوحي بعنوان `10.66.66.4`، بمفتاح يولده الجهاز نفسه وليس الـ Pi، ثم طبق التعديل بالأمر `wg syncconf` وتأكد أن الهاتف لم ينقطع.
2. من شبكة الجوال، قس أكبر حجم يمر بالأمر `ping -M do -s` إلى `10.66.66.1`، واحسب منه الـ MTU المناسب لهاتفك، وتذكر أن WireGuard يكمل الحزمة إلى مضاعف 16.

## الخلاصة

- قبل أي إعداد تأكد أن لبيتك عنواناً عاماً، فخلف CGNAT لا يصل أي منفذ، والبدائل طلب عنوان من المزود أو VPS وسيط أو Tailscale وHeadscale.
- WireGuard يعرف الأجهزة بمفاتيحها العامة، و`AllowedIPs` جدول توجيه عند الإرسال وقائمة سماح عند الاستقبال، والعنوان الواحد لطرف واحد.
- السيرفر على الـ Pi ملف `wg0.conf` واحد، مع `ip_forward=1` وقاعدة MASQUERADE حتى تصل الأجهزة إلى شبكة البيت.
- النفق الكامل يخرج كل حركة الهاتف من البيت ويحجب الإعلانات عبر AdGuard Home أو Pi-hole، والجزئي يمرر شبكة البيت وحدها.
- في المختبر المحاكى أعطى النفق 26.4 ميجابت مقابل 107 للطريق المباشر، والوقت كله في النواة، وفي البيت يحدد السرعة غالباً رفع الاشتراك.
- ثلاثة أعطال صامتة: عنوان مكرر يظهر `(none)`، وشبكة بيت ناقصة يكشفها `ip route get`، وMTU كبير تكشفه `ping -M do` ويحله `MTU = 1200`.
- تغيير مفتاح جهاز يتم بتعديل الملف و`wg syncconf` دون قطع الآخرين، والمفتاح القديم يفشل بصمت.

[![](https://arabroot.io/content/images/2026/11/raspberry-pi-server-cover-cover.webp)دليلRaspberry Pi كسيرفر: الإقلاع من SSD والتبريد والطاقةكيف تنقل نظام Raspberry Pi من بطاقة microSD إلى قرص SSD وتقلل الكتابة وتختار المزود والتبريد وتفعل المراقب، مع مختبر حقيقي على Raspberry Pi OS.](https://arabroot.io/articles/%D8%AA%D8%AC%D9%87%D9%8A%D8%B2-raspberry-pi-%D9%83%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-ssd-%D9%88%D8%A7%D9%84%D8%AA%D8%A8%D8%B1%D9%8A%D8%AF-%D9%88%D8%A7%D9%84%D8%B7%D8%A7%D9%82%D8%A9/)[![](https://arabroot.io/content/images/2026/11/raspberry-pi-intro-cover-cover.webp)دليلRaspberry Pi للمبتدئين: أي طراز تختار وماذا تشغل عليه؟الطرازات الحالية من Raspberry Pi بأسعارها الرسمية وما يناسب كل منها في الهوم لاب، ثم صورة Raspberry Pi OS الحقيقية من التحقق إلى أول دخول SSH دون شاشة.](https://arabroot.io/articles/raspberry-pi-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D8%A7%D9%8A-%D8%B7%D8%B1%D8%A7%D8%B2-%D8%AA%D8%AE%D8%AA%D8%A7%D8%B1-%D9%88%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D8%B4%D8%BA%D9%84-%D8%B9%D9%84%D9%8A%D9%87/)[![](https://arabroot.io/content/images/2026/11/wireguard-cover-cover.webp)دليلشبكة خاصة مع WireGuard وواجهة wg-easyكيف تنشئ شبكة VPN خاصة مع WireGuard وواجهة wg-easy، فلا يصل إلى لوحات الإدارة على سيرفرك إلا أجهزة فريقك.](https://arabroot.io/articles/%D8%B4%D8%A8%D9%83%D8%A9-%D8%AE%D8%A7%D8%B5%D8%A9-%D9%85%D8%B9-wireguard-%D9%88-wg-easy/)[![](https://arabroot.io/content/images/2026/11/vpn-basics-cover-cover.webp)دليلما هو VPN؟ الشبكة الخاصة الافتراضية من المشكلة إلى الأنواعلماذا تحتاج شبكة خاصة افتراضية VPN، وكيف تغلف حزمك وتشفرها داخل نفق، وأي نوع منها يناسب فريقك.](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-vpn-%D8%B4%D8%B1%D8%AD-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/)[![](https://arabroot.io/content/images/2026/11/home-internet-cover-cover-1.webp)دليلتشغيل خادمك من إنترنت المنزل: كل طرق الوصول من الخارجكيف تصل إلى سيرفر في بيتك من الإنترنت حتى لو كنت خلف CGNAT، وما الطريقة المناسبة لك من بين ثماني طرق.](https://arabroot.io/articles/%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%AE%D8%A7%D8%AF%D9%85%D9%83-%D9%85%D9%86-%D8%A5%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D9%85%D9%86%D8%B2%D9%84/)[![](https://arabroot.io/content/images/2026/11/headscale-cover-cover.webp)دليلHeadscale: خادم التحكم Control Server لشبكة Tailscaleكيف تشغل خادم التحكم في Tailscale على سيرفرك مع Headscale، وتربط به تطبيقات Tailscale الرسمية، وتكتب سياسات الوصول، وتعرف ما تخسره مقارنة بالخدمة المدارة.](https://arabroot.io/articles/headscale-%D8%AE%D8%A7%D8%AF%D9%85-%D8%AA%D8%AD%D9%83%D9%85-tailscale-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83/)[![](https://arabroot.io/content/images/2026/11/pi-hole-ads-cover-cover.webp)دليلحجب الإعلانات لكل أجهزة البيت مع Pi-holeكيف يحجب Pi-hole الإعلانات والمتتبعات لكل أجهزة البيت عبر DNS، مع تجربة تصفح حقيقية لعشرة مواقع أخبار تقيس ما حجبه وما عطله وكيف تصلحه.](https://arabroot.io/articles/%D8%AD%D8%AC%D8%A8-%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%D8%A7%D8%AA-%D9%84%D9%83%D9%84-%D8%A3%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%A8%D9%8A%D8%AA-%D9%85%D8%B9-pi-hole/)

## سجل التحديثات

19 نوفمبر 2026: كتابة المقال، والمختبر على Raspberry Pi OS Lite arm64 بتاريخ 6 أكتوبر 2026 في QEMU 10.0 مع wireguard-tools 1.0.20210914 من Debian، والهاتف والحاسوب Containers من Alpine 3.24، وAdGuard Home v0.107.80 على شبكة البيت.