كيف تبدأ نفق WireGuard كخدمة systemd

لديك ملف تعريف WireGuard في /etc/wireguard/wg0.conf وتريد تشغيله دون كتابة wg-quick up يدويًا بعد كل إعادة تشغيل۔ قالب systemd المرفق يفعل ذلك تمامًا: [email protected] يشغّل wg-quick لملف التعريف المسمّى wg0۔ كما يثبّت العناوين والمسارات وDNS وأي خطافات يعلنها ملف التعريف، وهذا أكثر من مجرد تحميل مفتاح في النواة۔ تحقّق من وجود القالب على نظامك قبل أن تفترض وجوده۔

بقية هذا الدليل تتبع الترتيب الذي ستنفّذه فعليًا۔

اعثر على الوحدة وملف التعريف الذي تقرؤه

اسرد ملفات الوحدة باستخدام systemctl list-unit-files 'wg-quick*'۔ على التوزيعات التي تحزمها سترى [email protected]، مع أخذ اسم النسخة من ملف التعريف۔ تُحلّ النسخة إلى /etc/wireguard/<name>.conf، لذا يقرأ wg-quick@wg0 الملف wg0.conf ولا شيء غيره۔ إذا كانت القائمة فارغة فحزمة الأدوات غير مثبّتة، ولن يفيد أي قدر من التمكين۔

أبقِ ملف التعريف على الوضع 600 ومملوكًا لـroot۔ يحتوي على مفتاح خاص، وستعمل الوحدة عن طيب خاطر بأذونات أسوأ إن سمحت لها۔

شغّله واقرأ السجل

ابدأ النسخة بـsystemctl start wg-quick@wg0، ثم افحص systemctl status wg-quick@wg0 وjournalctl -u wg-quick@wg0 -b۔ الوحدة التي تبدأ وتخرج فورًا فيها عادةً خطأ في ملف التعريف، ويسمّي السجل السطر۔ تأكّد بـwg show من وجود الواجهة وأن آخر مصافحة حديثة۔ يسرد دليل wg-quick ما يفعله النص البرمجي خارج الواجهة نفسها۔

واجهة مُهيّأة بلا مصافحة هي مشكلة مسار أو مفتاح، لا مشكلة خدمة۔

أبقِ مديرًا واحدًا مسؤولًا

إذا كان NetworkManager أو عميل آخر يملك النفق بالفعل، فإن بدء وحدة systemd ينشئ مالكًا ثانيًا للواجهة والمسارات وDNS نفسها۔ الأعراض مربكة: يرتفع النفق ثم تختفي المسارات، أو يعود DNS إلى حاله بعد ثوانٍ۔ اختر مديرًا واحدًا وعطّل الآخر لذلك الملف۔ يُظهر السجل عادةً الاستيلاء كتغيّرات في المسارات أو المُحلِّل فور إعلان الوحدة النجاح۔

المديران لا يتشاركان الملكية۔ يكتب كل منهما فوق الآخر۔

اختبر الإيقاف وإعادة التشغيل والإقلاع

نفّذ systemctl stop wg-quick@wg0 وتأكّد من زوال الواجهة وإزالة المسارات۔ ثم ابدأها مجددًا وتحقق من عودة المسارات، لأن أخطاء التفكيك تظهر كمسارات متبقية لا كبدايات فاشلة۔ أخيرًا مكّنها عند الإقلاع بـsystemctl enable --now wg-quick@wg0 وأعد التشغيل مرة واحدة۔

عند الإقلاع يجب أن يُحلّ اسم الطرف الآخر قبل أن تعمل الوحدة۔ إذا لم يكن DNS جاهزًا بعد، تفشل الوحدة وتبقى فاشلة حتى تبدأها يدويًا۔

سجّل المالك

اكتب أي ملف تعريف تقرؤه الوحدة، وأي مدير يملك الواجهة، ومن أين جاء الملف۔ عندما يستورد أحدهم لاحقًا النفق نفسه في عميل سطح مكتب، فإن تلك الملاحظة هي الفرق بين عملية ترحيل ونشرين يتنازعان على عنوان واحد۔ سجّل اسم الواجهة أيضًا، لأن ملفين بأسماء متشابهة هما المصدر المعتاد للالتباس۔

نفق بمالكين اثنين يعمل حتى أول إعادة تشغيل، ثم يصبح لغزًا۔ لهذا تنتمي الملاحظة إلى المستودع لا إلى سلسلة محادثة۔