> ## 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.

# بديل Cloudflare Tunnel على سيرفرك مع Pangolin
- URL: https://arabroot.io/articles/بديل-cloudflare-tunnel-على-سيرفرك-مع-pangolin/
- Published: 2026-11-19T19:43:33.000Z
- Updated: 2026-11-19T20:42:54.000Z
- Description: كيف تنشر خدمات البيت أو المكتب باسم نطاق وصفحة دخول دون فتح أي منفذ، عبر Pangolin على VPS تملكه بدل شبكة Cloudflare، وما يكلفه النفق وأين يتعطل.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الحوسبة السحابية وبدائلها, الشبكات والوصول, الاستضافة الذاتية, هوم لاب, Pangolin

إذا كان لديك جهاز في البيت أو المكتب يشغل خدمات داخلية، مثل ويكي الفريق أو Nextcloud أو لوحة مراقبة، ثم أردت أن تفتحها من خارج الشبكة، فأنت تصطدم غالباً بأحد أمرين: إما أن مزود الإنترنت يضعك خلف CGNAT فلا يوجد عنوان عام تفتح عليه منفذاً Port أصلاً، وإما أن فتح المنافذ في الـ Router يعني أن يرى العالم كله خدماتك. والحل الذي يختاره أغلب الناس اليوم هو Cloudflare Tunnel: برنامج صغير في البيت يتصل خارجاً بشبكة Cloudflare، والزائر يصل إلى اسم نطاقك عندهم، ولا يفتح أي منفذ. وهو حل ممتاز ومجاني، ولكن ثمنه أن Cloudflare تفك تشفير كل طلب عندها وتراه، وأن خدمتك صارت معلقة بحساب عند شركة أخرى، وأن بعض البروتوكولات لا تمر عبره كما تريد.

وقد شرحنا فكرة النفق العكسي Reverse Tunnel من الأساس في [مقال الأنفاق](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-%D8%A7%D9%84%D9%86%D9%81%D9%82-tunnel-%D9%81%D9%8A-%D8%A7%D9%84%D8%B4%D8%A8%D9%83%D8%A7%D8%AA/#reverse-tunnels)، وبنينا نفقاً يدوياً بأداتي frp وrathole على VPS في [دليل frp وrathole](https://arabroot.io/articles/frp-%D9%88-rathole-%D9%86%D8%B4%D8%B1-%D8%AE%D8%AF%D9%85%D8%A9-%D9%85%D9%86-%D8%AE%D9%84%D9%81-nat-%D8%AF%D9%88%D9%86-%D9%81%D8%AA%D8%AD-%D9%85%D9%86%D8%A7%D9%81%D8%B0/)، وشرحنا ما يقدمه Cloudflare Tunnel في [مقال خدمات Cloudflare](https://arabroot.io/articles/%D8%AE%D8%AF%D9%85%D8%A7%D8%AA-cloudflare-%D9%88%D8%A8%D8%AF%D8%A7%D8%A6%D9%84%D9%87%D8%A7-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1/#tunnel). أما هنا فنبني البديل الأقرب لتجربة Cloudflare Tunnel على سيرفرك، وهو [Pangolin](https://github.com/fosrl/pangolin?ref=arabroot.io): نفق مثل frp، ولكن معه Reverse Proxy بشهادات Certificates تلقائية، ولوحة تحكم Dashboard، وصفحة دخول قبل كل خدمة. وسوف نناقش في هذا المقال ما يلي:

- الأجزاء الأربعة في Pangolin: الخادم Server وGerbil وTraefik مع الإضافة Badger والموصل Newt، وأين يعمل كل منها.
- مختبر كامل في Docker: شبكة تمثل الإنترنت والـ VPS، وشبكة بيت معزولة لا طريق منها إلى الخارج، وخادم ACME محلي بدل Let's Encrypt حتى تكون الشهادات حقيقية.
- إنشاء الموقع Site وتشغيل Newt، ثم نشر خدمة البيت باسم نطاق خلف صفحة دخول، وقراءة الترويسات Headers التي تصل إلى الخدمة.
- كم يكلف النفق من زمن الاستجابة Latency والإنتاجية Throughput، بأرقام من التجربة.
- أربعة أعطال افتعلناها: توقف Newt، وإغلاق منفذ UDP، وسر خاطئ، وشهادة غير موثوقة، وما يراه الزائر في كل منها.
- المقارنة مع Cloudflare Tunnel، ونقاط القوة ونقاط الضعف، وكيف تشغله في الإنتاج، وجدول قرار وقائمة تحقق Checklist.

## قبل Pangolin: ما الخيارات المتاحة؟

لنشر خدمة من خلف NAT أربع طرق رئيسية، وكل واحدة منها تجيب عن سؤال مختلف، لذلك حدد سؤالك قبل أن تختار الأداة:

- شبكة خاصة افتراضية VPN مثل [WireGuard](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/) أو [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/): إذا كان مستخدمو الخدمة هم فريقك فقط، فالخدمة لا تحتاج أن تكون على الإنترنت أصلاً، وكل جهاز في الفريق يدخل الشبكة الخاصة.
- نفق عكسي بسيط مثل frp وrathole: ينقل منفذاً من البيت إلى VPS، دون صفحة دخول ودون إدارة مستخدمين، والحماية كلها على الخدمة نفسها.
- Cloudflare Tunnel: نفق ومعه Reverse Proxy وحماية وصفحة دخول اسمها Cloudflare Access، في شبكة Cloudflare.
- Pangolin: الشيء نفسه تقريباً، ولكن على VPS تملكه أنت، والشهادات والجلسات والسجلات Logs كلها عندك.

وقد يتساءل البعض: إذا كان Pangolin يجمع النفق والـ Reverse Proxy، فلماذا لا أضع [Traefik](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-traefik-reverse-proxy/) على الـ VPS مع frp وينتهي الأمر؟ والإجابة أن هذا ممكن فعلاً، وPangolin نفسه يستخدم Traefik في داخله، ولكنك عندها تكتب ملفات الإعداد بيدك لكل خدمة، وتبني صفحة الدخول بنفسك عبر [Forward Auth مع authentik](https://arabroot.io/articles/%D8%AD%D9%85%D8%A7%D9%8A%D8%A9-%D8%A3%D9%8A-%D8%AA%D8%B7%D8%A8%D9%8A%D9%82-%D8%A8%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-authentik-forward-auth/) مثلاً، وتدير أسرار الوكلاء يدوياً. أما Pangolin فيعطيك هذا كله من لوحة واحدة، مع عدد المواقع والمستخدمين والأدوار، وهذا ما يجعله مناسباً لمن يدير عدة مواقع أو يريد أن يعطي زملاءه الوصول دون أن يشرح لهم شيئاً.

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

Pangolin ليس برنامجاً واحداً، وإنما أربعة أجزاء تعمل معاً، كما يصفها [توثيق How Pangolin Works](https://docs.pangolin.net/about/how-pangolin-works?ref=arabroot.io). ثلاثة منها على الـ VPS وواحد في البيت، والصورة التالية تبينها:

![مخطط من ثلاثة أعمدة: الزائر ومتصفحه، ثم VPS بعنوان عام عليه Traefik مع Badger على المنافذ 443 و80 وخادم Pangolin وGerbil على UDP 51820 و21820، ثم البيت خلف NAT وفيه Newt والخدمة الخاصة، وتحتها ثلاث خطوات: Newt يتصل أولاً، والزائر يطلب الاسم، والطلب يعبر النفق](https://arabroot.io/content/images/2026/11/pangolin-01-flow.webp)

ثلاثة أجزاء على الـ VPS تقوم بدور شبكة Cloudflare، وموصل واحد في البيت يتصل خارجاً

وفي الصورة أعلاه لاحظ التالي:

- **خادم Pangolin:** تطبيق Node.js فيه اللوحة والواجهة البرمجية API وقاعدة البيانات Database، بنسخة SQLite افتراضياً أو PostgreSQL. هو العقل الذي يعرف المستخدمين والأدوار Roles والمواقع والموارد Resources، ولا يستقبل حركة الزوار مباشرة.
- **Traefik مع الإضافة Badger:** هو الـ Reverse Proxy الذي يستقبل الزوار على 443 ويصدر الشهادات من Let's Encrypt. ولا تكتب له ملفات الإعداد، وإنما يقرأ إعداده كل 5 ثوان من خادم Pangolin عبر مزود HTTP Provider، والإضافة [Badger](https://github.com/fosrl/badger?ref=arabroot.io) تسأل Pangolin قبل كل طلب: هل لهذا الزائر جلسة صالحة Session لهذا المورد؟
- **Gerbil:** برنامج صغير بلغة Go يدير واجهة WireGuard في نواة النظام Kernel على الـ VPS، ويستقبل عليها أنفاق المواقع، ولذلك يحتاج الصلاحية `NET_ADMIN`. ويعمل Traefik داخل شبكة Gerbil نفسها، فيرى عناوين النفق مباشرة.
- **Newt:** موصل الموقع Site Connector في البيت، يتصل خارجاً بخادم Pangolin عبر WebSocket على 443 ليأخذ إعداده، ثم يبني نفق WireGuard إلى Gerbil على UDP 51820، ويعمل WireGuard فيه في مساحة المستخدم Userspace دون الحاجة إلى صلاحيات خاصة، ثم يستقبل الطلبات من النفق ويفتح الاتصال الأخير إلى الخدمة.

وقد يتساءل البعض: لماذا يحتاج Newt قناتين، WebSocket وWireGuard، بدل نفق واحد؟ والإجابة أن لكل قناة عملاً مختلفاً. قناة WebSocket على 443 هي قناة التحكم Control Channel، يأخذ منها Newt مفاتيح WireGuard وعنوانه داخل النفق وقائمة الأهداف التي يجب أن يفتح لها منافذ، وتصله عليها التغييرات فوراً عندما تضيف مورداً أو تحذفه من اللوحة، وهي تمر في أي شبكة تسمح بالتصفح. أما نفق WireGuard على UDP فهو قناة البيانات Data Channel التي تمر فيها طلبات الزوار، واختار المشروع WireGuard لأنه سريع ومشفر ويتحمل تغير عنوان البيت دون أن ينقطع، وهو ما شرحناه في [دليل WireGuard](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/). وهذا الفصل نفسه هو ما سيظهر في قسم الأعطال، حين تبقى قناة التحكم متصلة وقناة البيانات متوقفة.

ويسمي Pangolin كل شبكة بعيدة موقعاً Site، وكل خدمة تنشرها مورداً Resource، والموارد نوعان: موارد عامة Public يصلها الزائر من المتصفح باسم نطاق، وموارد خاصة Private يصلها المستخدم عبر تطبيق Pangolin على جهازه كأنها شبكة خاصة. وهذا المقال عن الموارد العامة، لأنها ما يقابل Cloudflare Tunnel، أما الموارد الخاصة فهي أقرب إلى ما شرحناه في [دليل NetBird](https://arabroot.io/articles/netbird-%D8%B4%D8%A8%D9%83%D8%A9-mesh-%D9%85%D8%B3%D8%AA%D8%B6%D8%A7%D9%81%D8%A9-%D8%B0%D8%A7%D8%AA%D9%8A%D8%A7-%D8%A8%D9%84%D9%88%D8%AD%D8%A9-%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9/).

ولاحظ أن الموقع الجديد لا يكشف شيئاً بمجرد تشغيله، فـ Newt لا ينقل أي حركة حتى تنشئ مورداً وتحدد هدفه، وهذا سلوك صحيح يذكره التوثيق صراحة. وفي الإصدارات الحديثة يقترح Pangolin في لوحته برنامجاً أحدث اسمه Pangolin CLI بدل Newt، ويقول [توثيق تثبيت المواقع](https://docs.pangolin.net/manage/sites/install-site?ref=arabroot.io) إن Newt يبقى يعمل، وإنه الموصل الأصغر المستقل، وهو ما نستخدمه هنا.

## المتطلبات Requirements

- VPS بعنوان IPv4 عام، ويكفي معالج واحد وذاكرة 1 جيجابايت لعدد قليل من المواقع، فقد استهلك خادم Pangolin في التجربة 380 ميجابايت من الذاكرة RAM، وTraefik قرابة 55 ميجابايت، وGerbil 12 ميجابايت.
- نطاق Domain وسجل DNS عام Wildcard مثل `*.example.com` يشير إلى الـ VPS، حتى يعمل أي اسم فرعي تنشئه من اللوحة دون أن تعود إلى مزود DNS.
- المنافذ المفتوحة في الجدار الناري Firewall على الـ VPS: TCP 80 و443 للزوار والشهادات، وUDP 51820 لأنفاق المواقع، وUDP 21820 لاتصال تطبيقات العملاء Clients في الموارد الخاصة. ولا منفذ مفتوح في البيت إطلاقاً.
- Docker وDocker Compose على الـ VPS، وDocker أو ملف تنفيذي لـ Newt في البيت.

وPangolin بنسختين حسب [صفحة المشروع](https://github.com/fosrl/pangolin?ref=arabroot.io#licensing): نسخة المجتمع Community Edition برخصة AGPL-3، وهي ما نستخدمه، ونسخة المؤسسات Enterprise Edition برخصة تجارية اسمها Fossorial Commercial License، وهي مجانية للاستخدام الشخصي وللشركات التي يقل دخلها السنوي عن 100 ألف دولار، وفيها ميزات مثل صفحة دخول على نطاقك وقراءة وسوم Docker. وستجد بعض الأزرار في اللوحة تحمل عبارة «Enterprise Edition license is required»، فهذه ميزات النسخة الأخرى.

## التجربة العملية: VPS وبيت معزول على جهاز واحد

المشكلة الأولى في أي تجربة لـ Pangolin على جهازك هي الشهادات، فـ Traefik يطلبها من Let's Encrypt، وLet's Encrypt لا يصدر شهادة لنطاق `.test` ولا يصل إلى جهازك. والحل الذي اخترناه هو [Pebble](https://github.com/letsencrypt/pebble?ref=arabroot.io)، وهو خادم ACME صغير للاختبار من Let's Encrypt نفسها، يتكلم البروتوكول نفسه ويصدر شهادات حقيقية من جذر Root مؤقت يولده عند التشغيل. وبذلك يمر Traefik بالخطوات نفسها التي يمر بها في الإنتاج، ونرى في سجلاته طلب الشهادة والتحقق منها كما هي. والصورة التالية تبين شبكتي التجربة:

![شبكتان: sc4-pg-wan تمثل الإنترنت والـ VPS وفيها Gerbil مع Traefik وPangolin وPebble والزائر، وsc4-pg-home شبكة داخلية فيها خدمة wiki ولا طريق منها إلى الخارج، وNewt متصل بالشبكتين وعنوانه داخل النفق 100.89.128.4](https://arabroot.io/content/images/2026/11/pangolin-02-lab.webp)

شبكة البيت داخلية Internal، فلا يخرج منها شيء إلا عبر Newt

الإعداد `internal: true` في Docker يعني أن الشبكة لا تملك طريقاً Route إلى الخارج، وهو أقرب ما يكون إلى بيت خلف CGNAT لا يستطيع أحد أن يصل إليه من الخارج، بل أشد منه لأن البيت هنا لا يخرج أيضاً. وNewt وحده موصول بالشبكتين، فهو يمثل جهازاً في البيت له اتصال بالإنترنت.

### ملف Docker Compose

بنينا الملف على [دليل التثبيت اليدوي](https://docs.pangolin.net/self-host/manual/docker-compose?ref=arabroot.io)، مع ثلاثة تغييرات: إصدارات ثابتة بدل `latest`، وPebble بدل Let's Encrypt، وجانب البيت في الملف نفسه:

```yaml
name: sc4-pg
services:
  pebble:
    image: ghcr.io/letsencrypt/pebble:2.10.3
    container_name: sc4-pg-pebble
    environment:
      PEBBLE_VA_ALWAYS_VALID: "1"     # lab only: accept every HTTP-01 challenge
      PEBBLE_VA_NOSLEEP: "1"
    networks: [wan]

  pangolin:
    image: fosrl/pangolin:1.27.0
    container_name: sc4-pg-pangolin
    restart: unless-stopped
    volumes:
      - ./config:/app/config
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3001/api/v1/"]
      interval: "10s"
      timeout: "10s"
      retries: 15
    networks: [wan]

  gerbil:
    image: fosrl/gerbil:1.6.0
    container_name: sc4-pg-gerbil
    restart: unless-stopped
    depends_on:
      pangolin: { condition: service_healthy }
    command:
      - --reachableAt=http://gerbil:3004
      - --generateAndSaveKeyTo=/var/config/key
      - --remoteConfig=http://pangolin:3001/api/v1/
    volumes:
      - ./config/:/var/config
    cap_add: [NET_ADMIN, SYS_MODULE]
    ports:
      - "127.0.0.1:9643:443"           # the "public" HTTPS port of the VPS
      - "127.0.0.1:9680:80"
      - "127.0.0.1:9651:51820/udp"
    networks:
      wan:
        aliases: [pangolin.sc4.test, app.sc4.test, whoami.sc4.test]

  traefik:
    image: traefik:v3.7.19
    container_name: sc4-pg-traefik
    restart: unless-stopped
    network_mode: service:gerbil
    depends_on:
      pangolin: { condition: service_healthy }
    command: ["--configFile=/etc/traefik/traefik_config.yml"]
    environment:
      LEGO_CA_CERTIFICATES: /certs/pebble.minica.pem   # trust Pebble's ACME API
    volumes:
      - ./config/traefik:/etc/traefik:ro
      - ./config/letsencrypt:/letsencrypt
      - ./certs:/certs:ro

  newt:
    image: fosrl/newt:1.20.1
    container_name: sc4-pg-newt
    restart: unless-stopped
    environment:
      PANGOLIN_ENDPOINT: https://pangolin.sc4.test
      NEWT_ID: ${NEWT_ID:-}
      NEWT_SECRET: ${NEWT_SECRET:-}
      SSL_CERT_FILE: /certs/pebble-root.pem          # the ACME root fetched from Pebble after start
    volumes:
      - ./certs:/certs:ro
    networks: [wan, home]
    profiles: [site]

  wiki:
    image: traefik/whoami:v1.12.0
    container_name: sc4-pg-wiki
    command: ["--name", "home-wiki", "--port", "8080"]
    networks: [home]

networks:
  wan:
    name: sc4-pg-wan
  home:
    name: sc4-pg-home
    internal: true          # nothing on this network can reach the outside
```

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

- المنافذ كلها على Gerbil وليس على Traefik، لأن Traefik يعمل بالإعداد `network_mode: service:gerbil` داخل شبكة Gerbil، فيرى واجهة `wg0` ويصل إلى عناوين المواقع داخل النفق. وهذا يعني أيضاً أن إعادة إنشاء Gerbil تفصل Traefik عن الشبكة حتى تعيد تشغيله.
- ربطنا المنافذ بـ `127.0.0.1` لأنها تجربة، وفي الإنتاج تكون `80:80` و`443:443` و`51820:51820/udp` و`21820:21820/udp` كما في الدليل الرسمي.
- الخدمة `newt` عليها `profiles: [site]` حتى لا تعمل قبل أن ننشئ الموقع في اللوحة ونأخذ المعرف ID والسر Secret.
- الخدمة `wiki` هي `traefik/whoami`، وهي خدمة ويب صغيرة تطبع كل ما يصلها من ترويسات، وبها سنرى ما يضيفه Pangolin إلى الطلب.
- `PEBBLE_VA_ALWAYS_VALID` يجعل Pebble يقبل كل تحقق HTTP-01 دون أن يتصل بالنطاق فعلاً، وهذا للتجربة فقط، فهو يلغي التحقق من ملكية النطاق كله.

### ملف إعداد Pangolin وملف Traefik

الملف `config/config.yml`، والسر Secret فيه من `openssl rand -hex 32`:

```yaml
gerbil:
    start_port: 51820
    base_endpoint: "pangolin.sc4.test"

app:
    dashboard_url: "https://pangolin.sc4.test"
    log_level: "info"
    telemetry:
        anonymous_usage: false

domains:
    domain1:
        base_domain: "sc4.test"

server:
    secret: "<openssl rand -hex 32>"
    cors:
        origins: ["https://pangolin.sc4.test"]
        methods: ["GET", "POST", "PUT", "DELETE", "PATCH"]
        allowed_headers: ["X-CSRF-Token", "Content-Type"]
        credentials: false

flags:
    require_email_verification: false
    disable_signup_without_invite: true
    disable_user_create_org: false
    allow_raw_resources: true
```

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

- `base_endpoint` هو الاسم الذي يتصل به Newt لبناء نفق WireGuard، ويجب أن يشير إلى عنوان الـ VPS العام، و`dashboard_url` هو عنوان اللوحة وصفحات الدخول.
- `base_domain` هو النطاق الذي تنشئ تحته الموارد، فكل مورد يصير `<اسم>.sc4.test`.
- `anonymous_usage` صحيحة True في الدليل الرسمي، أي أن الخادم يرسل إحصائيات استخدام مجهولة، وجعلناها False. وهذا قرار يعود إليك، ولكن اعرف أنه موجود.
- `disable_signup_without_invite` يمنع أي شخص من إنشاء حساب في لوحتك دون دعوة، فلا تغيره.

أما `traefik_config.yml` فهو كما في الدليل، مع سطر واحد مختلف في مزود الشهادات:

```yaml
certificatesResolvers:
  letsencrypt:
    acme:
      httpChallenge:
        entryPoint: web
      email: "admin@sc4.test"
      storage: "/letsencrypt/acme.json"
      caServer: "https://pebble:14000/dir"       # lab: Pebble instead of Let's Encrypt
```

وفي الإعداد نفسه سطران يستحقان الانتباه: `api.insecure: true` يفتح لوحة Traefik على المنفذ 8080 داخل شبكة Gerbil دون كلمة مرور، وهي غير منشورة في ملف Compose، فلا تضف لها منفذاً أبداً. و`serversTransport.insecureSkipVerify: true` يعني أن Traefik لا يتحقق من شهادات الخدمات التي خلفه إذا كانت تعمل بـ HTTPS، وهذا مقبول لأن الاتصال إليها يمر داخل نفق WireGuard مشفر أصلاً.

### التشغيل الأول وشهادة اللوحة

```bash
docker compose -p sc4-pg up -d
docker logs sc4-pg-pangolin
```

والمخرج سوف يكون كما يلي، بعد حذف أسطر البداية:

```text
Running migrations...
Migrations completed successfully.
[warn]: Email SMTP configuration is missing. Emails will not be sent.
=== SETUP TOKEN GENERATED ===
Token: wpnh9y88xbstln4fozxwojzpeqdg3qd9
Use this token on the initial setup page
================================
[info]: Dashboard API server is running on http://localhost:3000
[info]: Internal API server is running on http://localhost:3001
[info]: AI gateway server is running on http://localhost:3005
[info]: Dashboard Web UI server is running on http://localhost:3002
[info]: Created new exit node Exit Node o8cczf0o with address 100.89.128.1/22 and port 51820
```

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

- توكن الإعداد Setup Token يطبع مرة واحدة، وهو ما يمنع أي شخص يصل إلى اللوحة قبلك من أن يصير مديرها، لذلك افتح صفحة الإعداد فور التشغيل.
- المنافذ 3000 و3001 و3002 داخلية: الأول ال API العامة للوحة، والثاني ال API الداخلية التي يسألها Traefik وBadger وGerbil، والثالث واجهة اللوحة. و3001 بالذات يجب ألا يصل إليه أحد من الخارج.
- السطر الأخير أنشأ عقدة الخروج Exit Node، وهي Gerbil بعنوان `100.89.128.1/22` داخل شبكة الأنفاق، أي أن المواقع تأخذ عناوينها من هذا النطاق.

وفي سجلات Gerbil:

```text
INFO: 2026/11/19 19:05:59 WireGuard interface wg0 created and configured
INFO: 2026/11/19 19:05:59 UDP server listening on :21820
INFO: 2026/11/19 19:05:59 Starting HTTP server on :3004
INFO: 2026/11/19 19:06:00 Loaded 0 initial proxy mappings
```

وفي سجلات Traefik طلب شهادة اللوحة من Pebble خطوة خطوة:

```text
INF Loading plugins... plugins=["badger"]
INF Plugins loaded. plugins=["badger"]
INF Testing certificate renew... acmeCA=https://pebble:14000/dir providerName=letsencrypt.acme
INF Registering the account. email=admin@sc4.test lib=lego
INF Obtaining bundled SAN certificate. domains=pangolin.sc4.test lib=lego
INF http01: Trying to solve HTTP-01. domain=pangolin.sc4.test lib=lego
INF The server validated our request. domain=pangolin.sc4.test lib=lego
INF Server responded with a certificate. domains=pangolin.sc4.test lib=lego
```

لاحظ أن Traefik ينزل الإضافة Badger من الإنترنت عند كل تشغيل، من سجل إضافات Traefik حسب `moduleName` و`version`، لذلك يحتاج الـ VPS اتصالاً خارجياً عند بدء Traefik، وإذا فشل التنزيل فلن تعمل أي حماية للموارد. بعد ذلك أخذنا جذر Pebble المؤقت من واجهته الإدارية، لأن Newt سيحتاجه ليثق بالشهادة، وتحققنا من الشهادة التي يقدمها Traefik:

```bash
docker exec sc4-pg-pangolin curl -sk https://pebble:15000/roots/0 > certs/pebble-root.pem
openssl x509 -in certs/pebble-root.pem -noout -subject
echo | openssl s_client -connect 127.0.0.1:9643 -servername pangolin.sc4.test -CAfile certs/pebble-root.pem
```

```text
subject=CN=Pebble Root CA 60a433
issuer=CN=Pebble Intermediate CA 597c25
Verify return code: 0 (ok)
```

ثم فتحنا `https://pangolin.sc4.test/auth/initial-setup` في المتصفح، وأدخلنا التوكن والبريد وكلمة المرور، فأنشأ Pangolin حساب مدير الخادم Server Admin، ثم طلب إنشاء منظمة Organization، وهي الوحدة التي تجمع المواقع والموارد والمستخدمين، فسميناها `home-office`. وحتى يفتح Chrome على جهازك أسماء `.sc4.test` دون أن تعدل ملف hosts، شغلناه بالخيار `--host-resolver-rules="MAP *.sc4.test:443 127.0.0.1:9643"`، فيرسل كل طلب لهذه الأسماء إلى منفذ التجربة.

## الموقع Site والموصل Newt

من القائمة Sites ثم Add Site، اختر النوع Pangolin Site، وسم الموقع، فتعرض اللوحة ثلاث قيم: عنوان الخادم Endpoint، والمعرف ID، والسر Secret، وأوامر التثبيت لكل نظام. والسر يظهر مرة واحدة فقط، فإذا أغلقت الصفحة قبل أن تنسخه فعليك أن تولد سراً جديداً من صفحة الموقع. والأمر الذي تقترحه اللوحة لـ Docker يستخدم Image اسمها `fosrl/pangolin-cli` بالمتغيرات `SITE_ID` و`SITE_SECRET`، أما Newt فيأخذ القيم نفسها بالمتغيرين `NEWT_ID` و`NEWT_SECRET`:

```bash
NEWT_ID=dw74cvfwh7wn3ml NEWT_SECRET=<secret from the dashboard> \
  docker compose -p sc4-pg --profile site up -d newt
docker logs sc4-pg-newt
```

```text
INFO: 2026/11/19 19:11:48 Newt version 1.20.1
DEBUG: 2026/11/19 19:11:48 Endpoint: https://pangolin.sc4.test
DEBUG: 2026/11/19 19:11:48 DNS: 9.9.9.9
DEBUG: 2026/11/19 19:11:48 MTU: 1280
INFO: 2026/11/19 19:11:48 Server version: 1.27.0
INFO: 2026/11/19 19:11:48 Saving config to: /root/.config/newt-client/config.json
INFO: 2026/11/19 19:11:48 Websocket connected
INFO: 2026/11/19 19:11:49 Connecting to endpoint: pangolin.sc4.test
INFO: 2026/11/19 19:11:49 Tunnel connection to server established successfully!
INFO: 2026/11/19 19:11:50 Client connectivity setup. Ready to accept connections from clients!
```

والمخرج يحكي ما شرحناه في قسم كيف يعمل: أولاً `Websocket connected` أي قناة التحكم على 443، ثم `Connecting to endpoint` أي بناء نفق WireGuard إلى `base_endpoint`، ثم `Tunnel connection ... established`. ولاحظ سطر MTU: حجم الحزمة Packet داخل النفق 1280 بايت، وهو رقم آمن يمر في أغلب الشبكات حتى بعد أن يضيف WireGuard ترويساته. وNewt يحفظ المعرف والسر في `/root/.config/newt-client/config.json`، فاجعل هذا المسار في Volume إذا أردت ألا تمرر السر في متغيرات البيئة كل مرة. والصورة التالية من صفحة Sites بعد الاتصال:

![صفحة Manage Sites في لوحة Pangolin 1.27.0: الموقع home-office بحالة Online وتوافر 100 بالمئة والموصل Newt v1.20.1 ومورد واحد](https://arabroot.io/content/images/2026/11/pangolin-06-sites.webp)

الموقع متصل Online عبر Newt 1.20.1، ومعه عدد الموارد والبيانات المنقولة

### هل البيت معزول فعلاً؟

قبل أن نصدق أن النفق هو الطريق الوحيد، وضعنا Container ثالثاً في شبكة البيت وسألناه:

```bash
docker run -d --name sc4-pg-homeprobe --network sc4-pg-home alpine:3.22 sleep infinity
docker exec sc4-pg-homeprobe sh -c 'ip -4 route; wget -q -T 3 -O- http://wiki:8080/ | head -3; ping -c1 -W2 172.21.0.4; wget -q -T 3 -O- http://example.com/'
```

```text
172.24.0.0/16 dev eth0 scope link  src 172.24.0.4
Name: home-wiki
Hostname: 1e76d867fc3a
IP: 127.0.0.1
PING 172.21.0.4 (172.21.0.4): 56 data bytes
ping: sendto: Network unreachable
wget: bad address 'example.com'
```

جدول التوجيه فيه سطر واحد لشبكة البيت ولا يوجد طريق افتراضي Default Route، فالخدمة تصل إلى wiki داخل البيت، ولا تصل إلى الـ VPS ولا إلى الإنترنت. فإذا وصل الزائر إلى wiki لاحقاً، فقد وصل عبر Newt وحده.

### ماذا يوجد داخل النفق؟

على الـ VPS، واجهة WireGuard التي أنشأها Gerbil:

```bash
docker exec sc4-pg-gerbil sh -c 'ip -d addr show wg0 | head -4; ss -lun; ip route'
```

```text
3: wg0: <POINTOPOINT,NOARP,UP,LOWER_UP> mtu 1280 qdisc noqueue state UNKNOWN group default
    wireguard numtxqueues 1 numrxqueues 1 gso_max_size 65536 gso_max_segs 65535
    inet 100.89.128.1/22 brd 100.89.131.255 scope global wg0
UNCONN 0      0            0.0.0.0:51820      0.0.0.0:*
UNCONN 0      0                  *:21820            *:*    users:(("gerbil",pid=1,fd=9))
100.89.128.0/22 dev wg0 proto kernel scope link src 100.89.128.1
```

الواجهة من نوع `wireguard` في النواة على المنفذ 51820، والمنفذ 21820 يستمع عليه برنامج Gerbil نفسه لتطبيقات العملاء. والأهم ما يقرؤه Traefik من خادم Pangolin بعد أن ننشئ المورد في القسم التالي، فقد طلبنا الإعداد مباشرة من ال API الداخلية:

```bash
docker exec sc4-pg-pangolin curl -s http://localhost:3001/api/v1/traefik-config
```

```json
"routers":{"1-Home-Wiki-router":{"entryPoints":["websecure"],"middlewares":["badger"],"service":"1-Home-Wiki-service","rule":"Host(`wiki.sc4.test`)","priority":100,"tls":{"certResolver":"letsencrypt"}}},
"services":{"1-Home-Wiki-service":{"loadBalancer":{"servers":[{"url":"http://100.89.128.4:51774"}]}}}
```

هنا تتضح الفكرة كلها: Traefik لا يعرف شيئاً عن `wiki:8080`، وإنما يرسل الطلب إلى `100.89.128.4:51774`، وهو عنوان Newt داخل النفق ومنفذ فتحه Newt لهذا الهدف، فيستقبل Newt الاتصال ويفتح اتصالاً جديداً إلى `wiki:8080` في شبكة البيت، وهذا ما تقوله سجلاته: `Started tcp proxy to wiki:8080`. وكل طلب يمر عبر الوسيطة Middleware المسماة `badger` قبل أن يصل إلى الخدمة.

## نشر الخدمة: المورد العام Public Resource

من القائمة Public Resources ثم Add Resource، اختر النوع HTTP(S)، واكتب اسماً للمورد والاسم الفرعي `wiki` تحت النطاق `sc4.test`، ثم أضف هدفاً Target: الموقع `home-office`، والعنوان `wiki` والمنفذ `8080`، أي العنوان كما يراه Newt في شبكة البيت، وليس كما يراه الـ VPS. والصورة التالية من النموذج قبل الحفظ:

![نموذج Create Public Resource في Pangolin: النوع HTTP(S)، والاسم Home Wiki، والاسم الفرعي wiki تحت sc4.test، وفي جدول الأهداف الموقع home-office والعنوان http://wiki:8080 وحالة الفحص Unknown والأولوية 100](https://arabroot.io/content/images/2026/11/pangolin-07-resource-form.webp)

الهدف يكتب كما يراه Newt في البيت، والاسم الفرعي هو ما يكتبه الزائر

وفي هذا النموذج مشكلة صغيرة واجهناها: زر Create Resource لم يفعل شيئاً عند الضغط عليه مباشرة بعد كتابة المنفذ، لأن النموذج يقرأ قيمة الحقل عند الخروج منه، فاخرج من الحقل بالمفتاح Tab أولاً. وبعد الحفظ بثوان، ظهر في سجلات Traefik طلب شهادة للاسم الجديد، فكل مورد يأخذ شهادته الخاصة تلقائياً:

```text
INF http01: Trying to solve HTTP-01. domain=wiki.sc4.test lib=lego
INF The server validated our request. domain=wiki.sc4.test lib=lego
INF Server responded with a certificate. domains=wiki.sc4.test lib=lego
```

وهذا يعني أن كل مورد جديد طلب جديد إلى Let's Encrypt في الإنتاج، فإذا كنت ستنشئ موارد كثيرة فانتبه لـ [حدود Let's Encrypt](https://letsencrypt.org/docs/rate-limits/?ref=arabroot.io)، أو استخدم شهادة Wildcard بالتحقق عبر ال DNS (DNS Challenge)، وقد شرحنا الفرق بين الطريقتين في [مقال SNI وشهادات SAN](https://arabroot.io/articles/%D8%B3%D9%8A%D8%B1%D9%81%D8%B1-%D9%88%D8%A7%D8%AD%D8%AF-%D9%88%D9%86%D8%B7%D8%A7%D9%82%D8%A7%D8%AA-%D9%83%D8%AB%D9%8A%D8%B1%D8%A9-sni-%D9%88%D8%B4%D9%87%D8%A7%D8%AF%D8%A9-san/).

### صفحة الدخول قبل الخدمة

افتراضياً يحمي Pangolin كل مورد جديد بالدخول الموحد Platform SSO، أي أن الزائر يجب أن يسجل الدخول بحساب في المنظمة قبل أن يصل إلى الخدمة. وعندما فتحنا `https://wiki.sc4.test` في متصفح دون جلسة، حوله Pangolin إلى العنوان `https://pangolin.sc4.test/auth/resource/a636c08c-…?redirect=https%3A%2F%2Fwiki.sc4.test%2F`، أي صفحة دخول على نطاق اللوحة تعرف المورد المطلوب وتعيد الزائر إليه بعد الدخول:

![صفحة Authentication Required من Pangolin مكتوب فيها You must authenticate to access Home Wiki، وفيها حقلا البريد وكلمة المرور وزر Log In وزر Use Security Key](https://arabroot.io/content/images/2026/11/pangolin-09-resource-login.webp)

الزائر يرى صفحة دخول Pangolin قبل أن يصل أي طلب منه إلى البيت

وتستطيع من تبويب Authentication في صفحة المورد أن تحدد الأدوار Roles والمستخدمين المسموح لهم، أو أن تضيف طرقاً أخرى بجانب SSO أو بدلها: رمز PIN، وكلمة مرور مشتركة Passcode، وقائمة بريد يصلها رمز لمرة واحدة، وترويسة ثابتة للبرامج Basic Header Auth، وشهادة عميل mTLS. ومن إعدادات المنظمة تستطيع أن تربط مزود هوية خارجي Identity Provider عبر OIDC، مثل authentik أو Keycloak، فيسجل فريقك الدخول بحساباتهم الحالية، وقد شرحنا البروتوكول في [مقال OAuth وOpenID Connect](https://arabroot.io/articles/%D8%B4%D8%B1%D8%AD-oauth-%D9%88-openid-connect-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/).

بعد الدخول وصلنا إلى الخدمة في البيت، وهذا ما طبعته `whoami` عن الطلب كما وصلها:

![مخرج خدمة whoami في المتصفح على wiki.sc4.test: الاسم home-wiki، وRemoteAddr 172.24.0.3، وترويسات Remote-Email وRemote-Role وRemote-User وRemote-User-Id، وX-Forwarded-For 172.21.0.1 وX-Forwarded-Proto https](https://arabroot.io/content/images/2026/11/pangolin-10-whoami.webp)

الخدمة في البيت تستقبل هوية المستخدم في ترويسات Remote-\*، وعنوان الزائر في X-Forwarded-For

```text
Name: home-wiki
RemoteAddr: 172.24.0.3:36374
GET / HTTP/1.1
Host: wiki.sc4.test
Remote-Email: admin@sc4.test
Remote-Role: Admin
Remote-User: admin@sc4.test
Remote-User-Id: 4ahl2i740ohkmbe
X-Forwarded-For: 172.21.0.1
X-Forwarded-Host: wiki.sc4.test
X-Forwarded-Port: 443
X-Forwarded-Proto: https
X-Real-Ip: 172.21.0.1
```

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

- `RemoteAddr: 172.24.0.3` هو عنوان Newt في شبكة البيت، فالخدمة ترى كل الاتصالات قادمة من Newt، كما في أي نفق عكسي. أما عنوان الزائر فيصل في `X-Forwarded-For` و`X-Real-Ip`، وهو هنا `172.21.0.1` لأن المتصفح على جهازنا يصل عبر بوابة Docker. فإذا كانت الخدمة تحظر العناوين أو تحد عدد المحاولات، فعلمها أن تقرأ هذه الترويسة من عنوان Newt وحده.
- الترويسات `Remote-User` و`Remote-Email` و`Remote-Role` أضافها Badger بعد أن تحقق من الجلسة، وتستطيع خدمات كثيرة أن تعتمد عليها لتسجيل الدخول تلقائياً، بشرط ألا تصل إليها أي طريق آخر يستطيع فيه الزائر أن يكتب هذه الترويسات بنفسه.
- لا يوجد في الطلب كوكي Cookie الجلسة، فقد حذفه Badger قبل التمرير، فلا تستطيع الخدمة في البيت أن تسرق جلسة اللوحة.

والصورة التالية تجمع مسار هذا الطلب من أوله:

![ست خطوات لطلب إلى مورد محمي: المتصفح يطلب wiki دون جلسة، وBadger يسأل Pangolin عبر verify-session، وصفحة الدخول على نطاق اللوحة، ثم جلسة للمورد مع ترويسة Remote-User، ثم Traefik يرسل إلى 100.89.128.4:51774 داخل النفق، ثم Newt يفتح الاتصال إلى wiki:8080](https://arabroot.io/content/images/2026/11/pangolin-03-request.webp)

Badger يقرر، وTraefik ينقل إلى عنوان داخل النفق، وNewt يكمل الطريق في البيت

### ولماذا يحصل curl على 401؟

عندما طلبنا المورد نفسه بالأداة curl من Container الزائر، كان الجواب:

```bash
curl -sS -i --cacert /certs/pebble-root.pem --resolve wiki.sc4.test:443:172.21.0.4 https://wiki.sc4.test/
```

```text
HTTP/2 401
content-type: text/plain; charset=utf-8
x-content-type-options: nosniff
content-length: 13

Unauthorized
```

ولا يوجد تحويل إلى صفحة الدخول. والغريب أن Chrome في وضع Headless حصل على الجواب نفسه في البداية، فالمتصفح الآلي الذي نلتقط به الصور يرسل في ترويسة User-Agent كلمة `HeadlessChrome`. ولما فعلنا سجلات Debug في Pangolin ظهر السبب:

```text
[debug]: No more auth to check, resource not allowed
[debug]: Redirecting to login at undefined
```

وفي [الكود المصدري لـ verifySession](https://github.com/fosrl/pangolin/blob/1.27.0/server/routers/badger/verifySession.ts?ref=arabroot.io) تعليق صريح: رابط الدخول يعطى فقط للعملاء الذين يبدون متصفحات تفاعلية حسب User-Agent، أما curl والسكربتات والروبوتات فتحصل على 401 مباشرة. وهذا سلوك معقول، ولكن اعرفه قبل أن تقضي ساعة في البحث عن خطأ في إعدادك، ولما غيرنا User-Agent المتصفح الآلي إلى قيمة Chrome عادية ظهرت صفحة الدخول. وإذا كان لديك برنامج يحتاج أن يصل إلى المورد، فاستخدم له Basic Header Auth أو رابط مشاركة Shareable Link، وليس جلسة متصفح.

### مورد دون حماية

أنشأنا مورداً ثانياً باسم `status.sc4.test` يشير إلى الخدمة نفسها، وأطفأنا Platform SSO من تبويب Authentication. والصورة التالية من قائمة الموارد بعد ذلك:

![قائمة Manage Public Resources في Pangolin: Home Wiki على wiki.sc4.test بحالة Protected، وStatus Page على status.sc4.test بحالة Not Protected، وكلاهما على موقع واحد من نوع HTTPS](https://arabroot.io/content/images/2026/11/pangolin-08-resources.webp)

عمود Authentication يبين كل مورد مفتوح للعالم بعلامة Not Protected

والآن يصل أي شخص في الإنترنت إلى الخدمة دون أي دخول، وهذا بالضبط ما تريده لصفحة عامة أو Webhook، وهو بالضبط ما لا تريده للوحة إدارة. والفرق بين الحالتين زر واحد، لذلك راجع هذا العمود بعد كل تعديل، فـ Pangolin يحمي الخدمة فقط بقدر ما تطلب منه.

## كم يكلف النفق؟ القياس

قسنا زمن الطلب الكامل، بما فيه مصافحة TLS جديدة لكل طلب، 31 مرة للمورد المفتوح عبر النفق، و31 مرة لل API الخاصة باللوحة، وهي تمر في Traefik نفسه ولكن دون نفق ودون Newt، ثم نزلنا ملفاً حجمه 100 ميجابايت عبر النفق ثلاث مرات، وقارناه بالتنزيل نفسه داخل شبكة البيت مباشرة:

```bash
for i in $(seq 1 31); do curl -s -o /dev/null $C -w '%{time_total}\n' https://status.sc4.test/; done | sort -n
curl -s -o /dev/null $C -w '%{time_total}s %{speed_download} B/s\n' "https://status.sc4.test/data?size=100&unit=MB"
```

```text
tunnel  (status.sc4.test/ -> Newt -> wiki):
median=0.059224 min=0.034830 max=0.094859 n=31
no tunnel (pangolin.sc4.test/api/v1/ -> pangolin container):
median=0.045634 min=0.027829 max=0.083973 n=31

3.941907s 26600729 B/s
3.178678s 32987801 B/s
3.274365s 32023796 B/s

inside the home network (wget wiki:8080, 100 MB): real 0m 0.61s / 0m 0.59s / 0m 0.56s
```

والقراءة الصحيحة لهذه الأرقام كما يلي:

- الطلب عبر النفق أبطأ بقرابة 14 ميلي ثانية في الوسيط من طلب لا يعبر النفق، وهذه المدة تشمل سؤال Badger لخادم Pangolin، والمرور في WireGuard، والمرحلة الإضافية في Newt. وعلى الإنترنت الحقيقي يضيع هذا الفرق أمام زمن الشبكة بين الزائر والـ VPS ثم بين الـ VPS والبيت.
- الإنتاجية عبر النفق بين 26 و33 ميجابايت في الثانية، أي قرابة 210 إلى 260 ميجابت، بينما نزل الملف نفسه داخل البيت في 0.6 ثانية تقريباً. والفرق الكبير سببه أن WireGuard في Newt يعمل في مساحة المستخدم، وأن كل بايت يمر في TLS عند Traefik. وفي [قياسات frp وrathole](https://arabroot.io/articles/frp-%D9%88-rathole-%D9%86%D8%B4%D8%B1-%D8%AE%D8%AF%D9%85%D8%A9-%D9%85%D9%86-%D8%AE%D9%84%D9%81-nat-%D8%AF%D9%88%D9%86-%D9%81%D8%AA%D8%AD-%D9%85%D9%86%D8%A7%D9%81%D8%B0/#measure) على الجهاز نفسه كانت الإنتاجية بين 1.5 و2.9 جيجابت، فـ Pangolin أبطأ بوضوح في الخدمات التي تنقل ملفات كبيرة.
- في الواقع الحد الحقيقي هو سرعة الرفع Upload في البيت أو المكتب، وهي في أغلب الاشتراكات أقل من 200 ميجابت، فلن تشعر بحد Pangolin إلا مع ألياف بسرعة رفع عالية.

أما الذاكرة، فقد كانت بعد التجربة كما يلي حسب `docker stats`:

```text
sc4-pg-pangolin 380.6MiB / 31.29GiB
sc4-pg-gerbil 12.12MiB / 31.29GiB
sc4-pg-traefik 55.41MiB / 31.29GiB
sc4-pg-newt 168.3MiB / 31.29GiB
sc4-pg-pebble 9.121MiB / 31.29GiB
```

ولاحظ أن Newt استهلك 168 ميجابايت بعد تنزيلات كبيرة عبره، وهذا رقم يستحق الانتباه إذا كنت ستشغله على Router أو جهاز صغير.

## ماذا يحدث إذا…؟ أربعة أعطال نفتعلها عن قصد

الصورة التالية تلخص الأعطال الأربعة، ثم نفصل كل واحد منها:

![أربعة أعطال: توقف Newt ويعطي 504 بعد 30 ثانية، وإغلاق UDP 51820 ويعطي 502 مع أن WebSocket متصل، وسر خاطئ مع الرسالة Secret is incorrect وإعادة المحاولة كل 3 ثوان، وجذر شهادة غير موثوق مع الرسالة x509 certificate signed by unknown authority](https://arabroot.io/content/images/2026/11/pangolin-04-failures.webp)

كل عطل له علامة واضحة، والمهم أن تعرف أين تبحث عنها

### توقف Newt في البيت

أوقفنا Newt، ثم طلبنا المورد المفتوح:

```bash
docker stop sc4-pg-newt
curl -sS -o /dev/null -w "code=%{http_code} time=%{time_total}\n" --max-time 100 https://status.sc4.test/
```

```text
code=504 time=30.040002
```

انتظر الزائر 30 ثانية كاملة ثم حصل على 504 Gateway Timeout، لأن Traefik ما زال يرسل إلى عنوان Newt داخل النفق، والعنوان لا يجيب، فينتظر حتى تنتهي مهلة الاتصال الافتراضية Timeout. وهذا أسوأ من خطأ سريع، لأن المستخدم يظن أن الخدمة بطيئة وليست متوقفة، لذلك اجعل الخدمات المهمة على موقعين إذا كانت متاحة من شبكتين، فـ Pangolin يدعم عدة أهداف للمورد الواحد مع فحص صحة Health Check، وراقب الخدمة عبر النفق نفسه وليس حالة Newt في اللوحة وحدها.

### منفذ UDP مغلق في الـ VPS

هذا خطأ شائع عند من ينقل إعداد Cloudflare Tunnel إلى Pangolin، فيفتح 80 و443 في الجدار الناري وينسى UDP. أغلقنا المنفذ 51820 داخل Gerbil بقاعدة iptables، ثم أعدنا تشغيل Newt:

```bash
docker exec sc4-pg-gerbil iptables -I INPUT -p udp --dport 51820 -j DROP
docker restart sc4-pg-newt
```

```text
INFO: 2026/11/19 19:36:24 Websocket connected
INFO: 2026/11/19 19:36:24 Connecting to endpoint: pangolin.sc4.test
INFO: 2026/11/19 19:36:56 SendMessageInterval timed out after 16 attempts for message type: newt/wg/get-config
WARN: 2026/11/19 19:37:05 Initial reliable ping failed, but continuing: all 5 ping attempts failed, last error: failed to read ICMP packet: i/o timeout
INFO: 2026/11/19 19:37:12 Started tcp proxy to wiki:8080
INFO: 2026/11/19 19:37:12 Client connectivity setup. Ready to accept connections from clients!
WARN: 2026/11/19 19:37:19 Ping attempt 2 failed: failed to read ICMP packet: i/o timeout
```

اقرأ المخرج بعناية لأنه يضلل: WebSocket متصل على 443، وNewt يقول `Ready to accept connections`، ولكن محاولات الـ ping داخل النفق كلها تفشل، لأن حزم WireGuard لا تصل إلى Gerbil. والزائر:

```text
HTTP/2 502
content-length: 11
```

لذلك إذا رأيت `Ping attempt … failed` في سجلات Newt فابحث في الجدار الناري عن UDP 51820 قبل أي شيء، وتذكر أن بعض شبكات الشركات والفنادق تمنع UDP الخارج كله، وهنا يتفوق Cloudflare Tunnel الذي يستطيع أن يعمل على HTTP/2 فوق TCP. وقد أزلنا القاعدة بعد ذلك بالأمر `iptables -D` نفسه.

### سر خاطئ

```text
ERROR: 2026/11/19 19:35:22 Failed to connect: failed to get token: failed to get token with status code: 400, body: {"data":null,"success":false,"error":true,"message":"Secret is incorrect","status":400,"stack":null}. Retrying in 3s...
```

الرسالة واضحة، ولكن انتبه إلى أن Newt يعيد المحاولة كل 3 ثوان إلى الأبد، فإذا ولدت سراً جديداً من اللوحة ونسيت أن تحدث جهازاً في فرع بعيد، فسيبقى يطرق الباب دون توقف، وتظهر محاولاته في سجلات الـ VPS.

### شهادة لا يثق بها Newt

شغلنا Newt بالمعرف والسر الصحيحين، ولكن دون `SSL_CERT_FILE` الذي يشير إلى جذر Pebble:

```text
ERROR: 2026/11/19 19:35:50 Failed to connect: failed to get token: failed to request new token: Post "https://pangolin.sc4.test/api/v1/auth/newt/get-token": tls: failed to verify certificate: x509: certificate signed by unknown authority. Retrying in 3s...
```

وهذا خبر جيد في الحقيقة، فـ Newt يتحقق من شهادة الخادم قبل أن يرسل السر، فلا يتسرب السر إلى VPS منتحل، على عكس frpc الذي لا يتحقق افتراضياً كما رأينا في [دليل frp](https://arabroot.io/articles/frp-%D9%88-rathole-%D9%86%D8%B4%D8%B1-%D8%AE%D8%AF%D9%85%D8%A9-%D9%85%D9%86-%D8%AE%D9%84%D9%81-nat-%D8%AF%D9%88%D9%86-%D9%81%D8%AA%D8%AD-%D9%85%D9%86%D8%A7%D9%81%D8%B0/#impostor). وفي الإنتاج مع Let's Encrypt لن تحتاج هذا المتغير، أما إذا كانت لديك شهادة من سلطة شهادات داخلية فأعط Newt جذرها بالطريقة نفسها.

## المقارنة مع Cloudflare Tunnel

شغلنا Cloudflare Tunnel في [تجربة frp وrathole](https://arabroot.io/articles/frp-%D9%88-rathole-%D9%86%D8%B4%D8%B1-%D8%AE%D8%AF%D9%85%D8%A9-%D9%85%D9%86-%D8%AE%D9%84%D9%81-nat-%D8%AF%D9%88%D9%86-%D9%81%D8%AA%D8%AD-%D9%85%D9%86%D8%A7%D9%81%D8%B0/#cloudflare)، والمقارنة هنا مبنية على تلك التجربة وعلى [توثيق Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/?ref=arabroot.io)، والصورة التالية تلخصها:

![جدول مقارنة بين Cloudflare Tunnel وPangolin على VPS: الموصل، ومكان انتهاء TLS، والنقل على المنفذ 7844 مقابل 443 وUDP 51820، والدخول قبل التطبيق، والحماية من الهجمات، والتكلفة، ومن يصون الخدمة](https://arabroot.io/content/images/2026/11/pangolin-05-cloudflare.webp)

الفكرة واحدة: موصل يتصل خارجاً، والفرق في من يملك الطرف الآخر

والفروق التي تحسم القرار في الغالب ثلاثة:

- **من يرى الحركة:** في Cloudflare Tunnel ينتهي TLS في شبكة Cloudflare، فهي ترى كل طلب وكل كلمة مرور تمر فيه، وهذا مقبول لأغلب المواقع وغير مقبول لبعض الجهات، وقد ناقشنا ذلك في [قسم الخصوصية من مقال خدمات Cloudflare](https://arabroot.io/articles/%D8%AE%D8%AF%D9%85%D8%A7%D8%AA-cloudflare-%D9%88%D8%A8%D8%AF%D8%A7%D8%A6%D9%84%D9%87%D8%A7-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1/#privacy-sovereignty). أما في Pangolin فينتهي TLS على سيرفرك.
- **الشبكة المطلوبة:** `cloudflared` يتصل خارجاً على المنفذ 7844 عبر QUIC أو HTTP/2 كما في [صفحة الجدار الناري](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/configure-tunnels/tunnel-with-firewall/?ref=arabroot.io)، فإذا منعت الشبكة UDP انتقل إلى TCP. أما Newt فيحتاج UDP 51820، وبدونه لا يعمل النفق كما رأيت.
- **ما يقف أمام الهجمات:** خلف Cloudflare شبكة Anycast ضخمة، أما Pangolin فهو VPS واحد، فهجوم DDoS متوسط يكفي لإيقافه، ولا يحميك منه إلا مزود الـ VPS أو أن تضع Cloudflare نفسها أمام Pangolin بوضع DNS only أو Proxied كما في [دليل إعداد Cloudflare](https://arabroot.io/articles/%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-cloudflare-%D9%85%D8%B9-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83-%D8%A8%D8%B4%D9%83%D9%84-%D8%B5%D8%AD%D9%8A%D8%AD/).

## نقاط القوة ونقاط الضعف

**نقاط القوة:**

- تجربة قريبة جداً من Cloudflare Tunnel وAccess على سيرفرك: نفق دون منافذ، وشهادات تلقائية، وصفحة دخول، ومستخدمون وأدوار، من لوحة واحدة.
- الشهادات والجلسات والسجلات عندك، وTLS ينتهي على VPS تملكه.
- Newt يتحقق من شهادة الخادم، والموقع لا يكشف شيئاً قبل أن تنشئ مورداً، والجلسة لا تصل إلى الخدمة.
- يدعم TCP وUDP العامين، والموارد الخاصة عبر تطبيق على الأجهزة، وعدة أهداف لمورد واحد.

**نقاط الضعف:**

- VPS واحد هو نقطة فشل واحدة، ولا توجد حماية من هجمات DDoS إلا ما يقدمه مزودك.
- الإنتاجية عبر النفق في التجربة أقل بوضوح من frp وrathole، بسبب WireGuard في مساحة المستخدم وTLS.
- يحتاج UDP 51820، ولا يوجد نقل بديل فوق TCP عند منع UDP.
- مشروع سريع التغير: الإصدار 1.27.0 صدر يوم تجربتنا، واللوحة تقترح الآن موصلاً آخر غير Newt، وبعض الميزات في نسخة المؤسسات فقط.
- Traefik ينزل الإضافة Badger من الإنترنت عند كل تشغيل.

## كيف تشغله في الإنتاج؟

1. ثبت الإصدارات في ملف Compose، فالدليل الرسمي يستخدم `latest`، وتحديث Pangolin يشغل ترحيلات Migrations على قاعدة البيانات عند البدء كما رأيت في السجلات، لذلك خذ نسخة احتياطية قبل كل تحديث، واقرأ [صفحة الإصدارات](https://github.com/fosrl/pangolin/releases?ref=arabroot.io).
2. النسخة الاحتياطية Backup هي المجلد `config` كله: `config.yml` وقاعدة `db/db.sqlite` والمفتاح `key` الخاص بـ Gerbil وملف الشهادات `letsencrypt/acme.json`. وإذا فقدت المفتاح فكل المواقع تحتاج أن تعيد الاتصال، وإذا فقدت القاعدة فكل المواقع تحتاج أسراراً جديدة.
3. الجدار الناري على الـ VPS: TCP 80 و443 وUDP 51820 و21820 فقط، ولا شيء غيرها، ولا تنشر المنفذ 3001 ولا لوحة Traefik. وقد شرحنا تأمين الـ VPS نفسه في [دليل تأمين VPS](https://arabroot.io/articles/%D8%AA%D8%A3%D9%85%D9%8A%D9%86-%D8%AE%D8%A7%D8%AF%D9%85-vps-%D9%85%D9%86-%D8%A3%D9%88%D9%84-%D8%AF%D8%AE%D9%88%D9%84/).
4. Newt في البيت خدمة دائمة بإعادة تشغيل تلقائية، بمستخدم دون صلاحيات Permissions إذا ثبته دون Docker، وسره في ملف لا يقرؤه غيره.
5. مزود هوية خارجي عبر OIDC لفريقك، مع مصادقة ثنائية MFA، بدل حسابات Pangolin المحلية، حتى يخرج الموظف من كل الخدمات حين يغادر.
6. مراقبة خارجية Monitoring تطلب مورداً حقيقياً عبر النفق كل دقيقة، فحالة Online في اللوحة لا تعني أن النفق ينقل الحركة، كما رأيت في عطل UDP.

وعند التحديث، غير رقم الإصدار في ملف Compose لواحد من المكونات في كل مرة، وابدأ بخادم Pangolin لأنه صاحب القاعدة، ثم Gerbil وTraefik، وأخيراً Newt في المواقع، والسبب أن Newt يطبع في أول سطر من سجلاته إصدار الخادم الذي اتصل به، كما رأيت في السطر `Server version: 1.27.0`، والفرق الكبير بين إصدار الموصل والخادم مصدر شائع للأعطال الغامضة. وإذا ظهرت مشكلة بعد التحديث، فارجع إلى رقم الإصدار السابق واستعد المجلد `config` من النسخة الاحتياطية، لأن الترحيلات التي تشغلها النسخة الجديدة على القاعدة لا ترجع وحدها.

## مشكلات شائعة وحلولها Troubleshooting

- **الصفحة تعطي 401 Unauthorized دون صفحة دخول:** العميل ليس متصفحاً في نظر Pangolin، أو أن المورد دون أي طريقة دخول. فعل `log_level: "debug"` وابحث عن `Redirecting to login at`.
- **الموقع Online والزائر يحصل على 502 أو 504:** UDP 51820 مغلق، أو Newt متوقف، أو الهدف خاطئ من جهة Newt. اقرأ سطور `Ping attempt` و`Started tcp proxy to` في سجلاته.
- **لا تصدر الشهادة:** سجل DNS لا يشير إلى الـ VPS، أو المنفذ 80 مغلق فيفشل التحقق عبر HTTP، أو أن حدود Let's Encrypt تجاوزتها بموارد كثيرة.
- **Newt يعيد المحاولة كل 3 ثوان:** السبب في الرسالة نفسها: `Secret is incorrect` أو `x509` أو خطأ في الاسم `PANGOLIN_ENDPOINT`.
- **زر الحفظ في النموذج لا يفعل شيئاً:** اخرج من آخر حقل كتبته بالمفتاح Tab، ثم اضغط مرة أخرى.
- **الخدمة تحظر الجميع:** كل الاتصالات تأتي من عنوان Newt، فاجعلها تقرأ `X-Forwarded-For` ومن عنوان Newt فقط.

## جدول القرار

| حالتك                                                            | الأنسب                                    | لماذا                                          |
| ---------------------------------------------------------------- | ----------------------------------------- | ---------------------------------------------- |
| موقع عام عادي، ولا تمانع أن ترى Cloudflare الحركة                | Cloudflare Tunnel                         | مجاني، دون VPS، ومعه حماية من DDoS             |
| خدمات داخلية لزملاء أو عملاء من المتصفح، وتريد TLS والجلسات عندك | Pangolin                                  | نفق وصفحة دخول وأدوار من لوحة واحدة على VPS لك |
| مستخدمو الخدمة فريقك فقط                                         | VPN مثل WireGuard أو Headscale أو NetBird | الخدمة لا تحتاج أن تكون على الإنترنت أصلاً     |
| نقل ملفات كبيرة أو أقصى إنتاجية                                  | frp أو rathole مع حماية في الخدمة         | أسرع بوضوح في القياس على الجهاز نفسه           |
| شبكة البيت أو العميل تمنع UDP الخارج                             | Cloudflare Tunnel أو frp فوق TCP          | Newt يحتاج UDP 51820                           |
| جهة تشترط بقاء البيانات داخل حدودها                              | Pangolin على VPS داخل البلد               | لا طرف ثالث يفك TLS                            |

## قائمة تحقق Checklist قبل النشر

- إصدارات ثابتة لـ Pangolin وGerbil وTraefik وNewt، ونسخة احتياطية من المجلد `config` قبل كل تحديث.
- توكن الإعداد استخدم فور التشغيل، والتسجيل دون دعوة معطل.
- الجدار الناري على الـ VPS: TCP 80 و443، وUDP 51820 و21820، ولا شيء غيرها.
- كل مورد عليه طريقة دخول، إلا ما قررت أنه عام فعلاً، وعمود Authentication مراجع.
- الخدمات خلف Newt تقرأ عنوان الزائر من `X-Forwarded-For`، ولا تثق بترويسات `Remote-*` إلا من Newt.
- Newt خدمة دائمة، وسره في ملف محمي، ومراقبة خارجية تطلب مورداً عبر النفق.
- مزود هوية مع MFA لفريقك، وحساب مدير الخادم بكلمة مرور قوية ومفتاح أمان.

## تدريب عملي

- أضف هدفاً ثانياً للمورد `wiki` على موقع آخر يشغل نسخة ثانية من الخدمة، ثم أوقف Newt الأول، وقارن ما يراه الزائر بنتيجة الـ 504 التي رأيتها في قسم الأعطال.
- فعل PIN على مورد `status` بدل SSO، ثم اطلبه بالأداة curl، ولاحظ هل يتغير جواب 401 الذي رأيته للبرامج التي ليست متصفحات.

## الخلاصة

- Pangolin يجمع ما تقدمه Cloudflare Tunnel وAccess على VPS لك: Traefik مع Badger للزوار والشهادات، وGerbil لأنفاق WireGuard، وخادم Pangolin للوحة والصلاحيات، وNewt في البيت يتصل خارجاً دون أي منفذ مفتوح.
- Traefik يرسل الطلب إلى عنوان Newt داخل النفق، وNewt يفتح الاتصال الأخير إلى الخدمة، فالخدمة ترى Newt مصدراً، وهوية المستخدم في ترويسات `Remote-*`، وعنوان الزائر في `X-Forwarded-For`.
- العملاء الذين ليسوا متصفحات يحصلون على 401 دون صفحة دخول، والمورد دون حماية مفتوح لكل الإنترنت بزر واحد.
- في التجربة أضاف النفق قرابة 14 ميلي ثانية للطلب، وكانت الإنتاجية بين 210 و260 ميجابت، أقل بوضوح من frp وrathole.
- توقف Newt يعني 504 بعد 30 ثانية، وإغلاق UDP 51820 يعني 502 مع لوحة تقول إن الموقع متصل، لذلك راقب الخدمة عبر النفق.
- اختر Cloudflare Tunnel للمواقع العامة وحماية DDoS، وPangolin حين يجب أن ينتهي TLS عندك، وVPN حين يكون المستخدمون فريقك فقط.

[![](https://arabroot.io/content/images/2026/11/tunnels-cover-cover.webp)دليلما هو النفق Tunnel في الشبكات؟ ومتى تحتاج إليهكيف تصل إلى قاعدة بيانات لا تراها من الإنترنت، وتنشر خدمة من خلف CGNAT دون فتح منافذ، ومتى تحتاج إلى VPN بدل النفق.](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-%D8%A7%D9%84%D9%86%D9%81%D9%82-tunnel-%D9%81%D9%8A-%D8%A7%D9%84%D8%B4%D8%A8%D9%83%D8%A7%D8%AA/)[![](https://arabroot.io/content/images/2026/11/frp-rathole-cover-cover.webp)دليلfrp وrathole: نشر خدمة من خلف NAT دون فتح منافذكيف تنشر خدمة من مكتب أو بيت خلف CGNAT عبر VPS بأداتي frp وrathole، وكم يكلف النفق فعلاً، وما المخاطر التي يفتحها، ومتى يكون Cloudflare Tunnel أنسب.](https://arabroot.io/articles/frp-%D9%88-rathole-%D9%86%D8%B4%D8%B1-%D8%AE%D8%AF%D9%85%D8%A9-%D9%85%D9%86-%D8%AE%D9%84%D9%81-nat-%D8%AF%D9%88%D9%86-%D9%81%D8%AA%D8%AD-%D9%85%D9%86%D8%A7%D9%81%D8%B0/)[![](https://arabroot.io/content/images/2026/11/cloudflare-services-cover-cover.webp)دليلخدمات Cloudflare بكلمات بسيطة وبدائلها مفتوحة المصدرما الذي تقدمه كل خدمة من Cloudflare، وما المتاح منها مجاناً، وما البديل مفتوح المصدر الذي تشغله على سيرفرك.](https://arabroot.io/articles/%D8%AE%D8%AF%D9%85%D8%A7%D8%AA-cloudflare-%D9%88%D8%A8%D8%AF%D8%A7%D8%A6%D9%84%D9%87%D8%A7-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1/)[![](https://arabroot.io/content/images/2026/11/cloudflare-setup-cover-cover.webp)دليلCloudflare أمام سيرفرك: الإعداد الصحيح خطوة بخطوةكيف تضع Cloudflare أمام سيرفرك بوضع Full (strict)، وتغلق سيرفرك على عناوين Cloudflare فقط، وتستعيد عنوان الزائر الحقيقي.](https://arabroot.io/articles/%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-cloudflare-%D9%85%D8%B9-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83-%D8%A8%D8%B4%D9%83%D9%84-%D8%B5%D8%AD%D9%8A%D8%AD/)[![](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/netbird-cover-cover.webp)دليلNetBird: شبكة Mesh مستضافة ذاتياً بلوحة إدارة Dashboardكيف تشغل NetBird على سيرفرك بلوحة إدارة ومزود هوية مدمج، وتربط الأجهزة بمجموعات وسياسات وصول، وتصل إلى شبكة المكتب، وكيف يقارن بHeadscale.](https://arabroot.io/articles/netbird-%D8%B4%D8%A8%D9%83%D8%A9-mesh-%D9%85%D8%B3%D8%AA%D8%B6%D8%A7%D9%81%D8%A9-%D8%B0%D8%A7%D8%AA%D9%8A%D8%A7-%D8%A8%D9%84%D9%88%D8%AD%D8%A9-%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9/)[![](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/authoritative-dns-cover-cover.webp)دليلخادم DNS لنطاقاتك على سيرفرك: PowerDNS أم Technitium؟كيف تشغل الخادم الموثوق لنطاقك بنفسك، بخادم أساسي وثانوي ونقل محمي بمفتاح TSIG وتوقيع DNSSEC، وما الأخطاء الصامتة التي تخفي نطاقك عن الزوار.](https://arabroot.io/articles/%D8%AE%D8%A7%D8%AF%D9%85-dns-%D9%84%D9%86%D8%B7%D8%A7%D9%82%D8%A7%D8%AA%D9%83-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83-powerdns-%D8%A7%D9%85-technitium/)[![](https://arabroot.io/content/images/2026/11/pomerium-authentik-cover-cover.webp)دليلبديل Cloudflare Access: Pomerium أم authentik؟كيف تضع صفحة دخول وسياسة لكل تطبيق أمام أدواتك الداخلية على سيرفرك، بـ Pomerium مع authentik أو بـ authentik وحده، وما يصل إلى التطبيق وأين يتعطل.](https://arabroot.io/articles/%D8%A8%D8%AF%D9%8A%D9%84-cloudflare-access-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83-pomerium-%D8%A7%D9%85-authentik/)

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

- 2026-11-19: كتابة المقال، وبناء التجربة العملية في Docker مع Pangolin 1.27.0 وGerbil 1.6.0 وTraefik 3.7.19 مع Badger 1.8.0 وNewt 1.20.1، وشهادات من Pebble 2.10.3، وقياس زمن الطلب والإنتاجية عبر النفق، وأربعة أعطال مقصودة.