الاستضافة الذاتية

Selenium Grid على VPS: اختبارات المتصفح لخطوط CI

تحتاج اختبارات الواجهة الشاملة إلى متصفح حقيقي. تثبيت Chrome ومشغّله على كل جهاز CI يستهلك وقتًا في كل بناء، ويتغيّر الإصدار من جهاز لآخر. يحل Selenium Grid المشكلة بطريقة أخرى: خادم WebDriver يعمل باستمرار ويمنح اختباراتك متصفحًا عند الطلب. يثبّته هذا الدليل على خادم VPS بصورة docker-selenium الرسمية، ويحميه بكلمة مرور، وينشره عبر HTTPS خلف nginx، ويربط به اختبارات Python وJavaScript وGitHub Actions.

انشر على VPS Cloud ←
7 دقائق للقراءةعدد الخطوات: 5
المحتويات· ما الذي يفعله Selenium Grid1/11
  1. 01ما الذي يفعله Selenium Grid
  2. 02ما الذي تمنحك إياه الشبكة
  3. 03Chrome مثبّت على جهاز CI أم شبكة Selenium على خادمك
  4. 04تحضير الخادم
  5. 05تثبيت Selenium Grid باستخدام Docker Compose
  6. 06لا تفتح الشبكة أبدًا دون كلمة مرور
  7. 07ربط اختباراتك بالشبكة
  8. 08تشغيل الاختبارات من GitHub Actions أو GitLab CI
  9. 09متابعة جلسة وتحرير الشبكة
  10. 10السعة والذاكرة والمتصفحات الأخرى
  11. 11تثبيت Selenium Grid بنقرة واحدة من متجر ServOrbit

ما الذي يفعله Selenium Grid

Selenium Grid هو خادم مشروع Selenium، المنشور برخصة Apache-2.0. يتحدث بروتوكول WebDriver الذي وحّده W3C: يطلب منه اختبار مكتوب بـ Java أو Python أو JavaScript أو C# أو Ruby جلسة، فتشغّل الشبكة متصفحًا، وتنفّذ الأوامر (فتح صفحة، نقر، ملء حقل، قراءة نص) وتعيد النتائج.

ينشر مشروع docker-selenium صورًا جاهزة للاستخدام. تجمع صورة standalone في حاوية واحدة الموجّه (مدخل HTTP) وطابور الجلسات وعقدة تحمل المتصفح. على خادم VPS هذه هي الصيغة الأبسط: حاوية واحدة، ومنفذ واحد، ولا مشغّل يجب تثبيته على المضيف. وتستخدم الشبكات الموزعة الكبيرة، بمحور وعشرات العقد، الصور نفسها مقسّمة بشكل آخر.

على عكس خدمة اختبار عبر الإنترنت تُفوتر بالدقيقة، الشبكة ملكك: تبقى الصفحات المختبَرة وحسابات الاختبار ولقطات الشاشة على خادمك.

ما الذي تمنحك إياه الشبكة

  • متصفح ثابت — تختبر كل مجموعاتك إصدار Chromium نفسه، أيًّا كان جهاز CI.
  • عمليات بناء أقصر — لا تثبيت للمتصفح ولا للمشغّل في كل تشغيل.
  • نقطة وصول قياسية — يتصل بها أي عميل WebDriver دون تغيير كود الاختبارات.
  • جلسات متوازية — عدة اختبارات في الوقت نفسه، ضمن حدود ذاكرة الخادم.
  • عرض مباشر — تعرض واجهة الشبكة المتصفح أثناء عمله.
  • شبكة مشتركة — يمكن لعدة مشاريع وعدة أنظمة CI استهداف العنوان نفسه.

Chrome مثبّت على جهاز CI أم شبكة Selenium على خادمك

مرّر الجدول أفقيًا

Chrome على كل جهاز CISelenium Grid على خادمك
تثبيت المتصفحفي كل بناءمرة واحدة على الخادم
الإصدار المختبَريتغيّر من جهاز لآخرواحد لكل المجموعات
ذاكرة جهاز CIمشتركة مع البناءمتاحة للبناء
مراقبة اختبارلقطات بعد انتهائهعرض مباشر في الواجهة
المشاركة بين المشاريعغير ممكنةعنوان واحد للجميع

تحضير الخادم

خصّص خادم VPS بنظام Ubuntu 24.04 بذاكرة 2 غيغابايت و2 vCPU: تستهلك الشبكة وحدها أقل من 300 ميغابايت في وضع الخمول، لكن كل جلسة Chromium تحتاج إلى عدة مئات أثناء الاختبار. انتقل إلى 4 غيغابايت لتشغيل جلستين باستمرار. تكفي 10 غيغابايت من القرص، فحجم الصورة يزيد قليلًا على غيغابايت.

ثبّت Docker مع إضافة Compose وnginx وcertbot. تحتاج أيضًا إلى اسم نطاق (أو نطاق فرعي) يشير إلى الخادم: ستتصل خطوط CI بالشبكة من الخارج عبر HTTPS. في الأمثلة، العنوان هو grid.example.com.

تثبيت Selenium Grid باستخدام Docker Compose

  1. تحضير المجلد وكلمة المرور

    يحمل ملف .env اسم المستخدم وكلمة مرور الشبكة. وتحمي كلمة المرور هذه العرض المباشر أيضًا.

    mkdir -p /opt/selenium-grid && cd /opt/selenium-grid
    cat > .env <<EOF
    ADMIN_USER=admin
    ADMIN_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. كتابة ملف docker-compose.yml

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

    services:
      selenium:
        image: selenium/standalone-chromium:4.53.0-20261120
        restart: unless-stopped
        shm_size: 2gb
        environment:
          SE_ROUTER_USERNAME: ${ADMIN_USER:-admin}
          SE_ROUTER_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD manquant}
          SE_VNC_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD manquant}
          SE_NODE_MAX_SESSIONS: "2"
          SE_NODE_OVERRIDE_MAX_SESSIONS: "true"
          SE_NODE_SESSION_TIMEOUT: "300"
        ports:
          - "127.0.0.1:4444:4444"
  3. تشغيل الشبكة والتحقق منها

    تتضمن الصورة فحص صحة خاصًا بها: يعيد --wait التحكم عندما تصبح الشبكة جاهزة. يجب أن تجيب صفحة /status بالقيمة true.

    docker compose up -d --wait
    . ./.env
    curl -s -u "admin:$ADMIN_PASSWORD" http://127.0.0.1:4444/status | jq .value.ready
  4. نشر الشبكة خلف nginx

    تسمح الترويستان Upgrade وConnection بمرور websockets الخاصة بالعرض المباشر، وتغطي مهلة القراءة الأوامر الطويلة.

    server {
        server_name grid.example.com;
        location / {
            proxy_pass http://127.0.0.1:4444;
            proxy_http_version 1.1;
            proxy_set_header Host $host;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection upgrade;
            proxy_read_timeout 300s;
        }
    }
  5. تفعيل HTTPS

    تنتقل كلمة مرور الشبكة مع كل طلب: لا تكشفها إلا عبر HTTPS. من دون بيانات الدخول، يجب أن تجيب /status بالرمز 401.

    certbot --nginx -d grid.example.com
    curl -s -o /dev/null -w '%{http_code}\n' https://grid.example.com/status

لا تفتح الشبكة أبدًا دون كلمة مرور

شبكة Selenium يمكن الوصول إليها دون مصادقة هي متصفح يستطيع أي شخص التحكم فيه من خادمك: زيارة مواقع، وملء نماذج، والالتفاف على تصفية حسب عنوان IP. والروبوتات التي تمسح الإنترنت تبحث تحديدًا عن المنفذ 4444. احتفظ بـ SE_ROUTER_PASSWORD، واترك المنفذ على 127.0.0.1، ولا تفتح للعموم إلا المنفذ 443 الخاص بـ nginx.

ربط اختباراتك بالشبكة

في جهة الاختبار، لا يتغيّر إلا تشغيل المتصفح: بدل مشغّل محلي، تنشئ RemoteWebDriver يشير إلى عنوان الشبكة مع بيانات الدخول. ويبقى باقي الاختبار كما هو. بلغة Python:

from selenium import webdriver

options = webdriver.ChromeOptions()
driver = webdriver.Remote(
    command_executor="https://admin:[email protected]",
    options=options,
)
driver.get("https://example.com")
print(driver.title)
driver.quit()

وبلغة JavaScript مع selenium-webdriver، المبدأ نفسه. تستجيب عقدة Chromium لاسم المتصفح chrome. وتعمل أيضًا العملاء القديمة التي تضيف /wd/hub إلى العنوان، فالشبكة تقبل الصيغتين.

const { Builder } = require("selenium-webdriver");

const driver = await new Builder()
  .usingServer("https://admin:[email protected]")
  .forBrowser("chrome")
  .build();

تشغيل الاختبارات من GitHub Actions أو GitLab CI

احفظ كلمة المرور في أسرار CI وكوّن العنوان عند تشغيل المهمة. تقرأ اختباراتك SELENIUM_URL بدل تشغيل متصفح محلي:

- name: Tests de bout en bout
  env:
    SELENIUM_URL: https://admin:${{ secrets.SELENIUM_PASSWORD }}@grid.example.com
  run: pytest tests/e2e

ينطبق النمط نفسه على GitLab CI (متغير مقنَّع) وJenkins (مدير بيانات الاعتماد) وGitea Actions. يجب أن يكون الموقع المختبَر قابلًا للوصول من الخادم: تصلح بيئة ما قبل الإنتاج العامة أو المحمية بكلمة مرور، ولا يصلح خادم تطوير يعمل داخل جهاز CI، إلا إذا كشفته عبر نفق.

متابعة جلسة وتحرير الشبكة

تعرض الواجهة https://grid.example.com/ui/ الجلسات الجارية. انقر على جلسة ثم على أيقونة الكاميرا لمشاهدة المتصفح؛ كلمة المرور المطلوبة هي كلمة مرور الشبكة. الاختبار الذي يتعطل دون استدعاء quit() يُبقي خانته مشغولة حتى انتهاء مهلة SE_NODE_SESSION_TIMEOUT (خمس دقائق هنا). لتحرير جلسة عالقة فورًا:

curl -s -u "admin:$ADMIN_PASSWORD" http://127.0.0.1:4444/status \
  | jq '.value.nodes[].slots[] | select(.session != null) | .session.sessionId'
curl -s -u "admin:$ADMIN_PASSWORD" -X DELETE http://127.0.0.1:4444/session/<id>

تكشف سجلات الحاوية (docker compose logs -f selenium) سبب رفض الجلسة: قدرة مطلوبة غير معروفة، أو طابور ممتلئ، أو متصفح لا يبدأ.

السعة والذاكرة والمتصفحات الأخرى

تفتح الإعدادات أعلاه جلستين متوازيتين. وما يزيد على ذلك ينتظر في الطابور ثم يفشل بعد SE_SESSION_REQUEST_TIMEOUT (300 ثانية افتراضيًا). للتوسّع، زد ذاكرة الخادم قبل SE_NODE_MAX_SESSIONS: متصفح Chromium الذي تنقصه الذاكرة لا يتباطأ، بل يتعطل.

تُستخدم صورتا standalone-firefox وstandalone-edge بالطريقة نفسها تمامًا؛ لا تُنشر Edge وGoogle Chrome إلا لمعالجات x86-64، بينما يتوفر Chromium وFirefox أيضًا لمعالجات ARM. لاختبار عدة متصفحات، شغّل خدمة لكل صورة على منافذ مختلفة.

تثبيت Selenium Grid بنقرة واحدة من متجر ServOrbit

يثبّت متجر ServOrbit هذه الإعدادات نفسها على خادمك: الصورة الرسمية مع Chromium، وشبكة محمية بالمستخدم admin وكلمة مرور مولَّدة، ومنفذ منشور على الحلقة المحلية، ووكيل عكسي nginx عبر HTTPS. يتطلب Selenium Grid نطاقًا لأن خطوط CI تتصل به من الخارج: اختر نطاقًا فرعيًا من أحد نطاقاتك، أو النطاق الفرعي المجاني للخادم مع HTTPS. تظهر كلمة المرور في مساحة العميل.

شارك هذا المقالservorbit.com/ma-ar/المدونة/استضافة-selenium-grid-على-vps

شبكة Selenium الخاصة بك، على خادمك

الأسعار المعروضة قبل الضريبة، مع سعر التجديد.