دليل النشر

NetBox على VPS: إدارة عناوين IP وجرد الشبكة على خادمك

انشر على VPS Cloud ←

NetBox على VPS: إدارة عناوين IP وجرد الشبكة على خادمك

جدول عناوين IP يحتوي دائمًا على سطر خاطئ: عنوان مُسند مرتين، أو خادم أُزيل ولم يُحذف، أو شبكة VLAN لم يعد أحد يعرف سببها. يستبدل NetBox هذا الملف بمصدر حقيقة: كل بادئة وكل عنوان وكل خزانة وكل كابل عنصر مرتبط بغيره، يُتصفح من المتصفح ويُدار عبر API. يثبّته هذا الدليل على VPS باستخدام Docker Compose، ويغلقه أمام الزوار المجهولين، وينشره عبر HTTPS خلف nginx، ويربطه بنصوصك البرمجية وبـ Ansible.

6 دقائق للقراءةعدد الخطوات: 3
المحتويات· ما الذي يفعله NetBox1/11
  1. 01ما الذي يفعله NetBox
  2. 02ما يقدمه لك NetBox
  3. 03جدول بيانات أم NetBox على خادمك
  4. 04قبل أن تبدأ
  5. 05تثبيت NetBox باستخدام Docker Compose
  6. 06لا تغيّر السرّين بعد ذلك أبدًا
  7. 07نشر NetBox عبر HTTPS خلف nginx
  8. 08الخطوات الأولى: الموقع والبادئات والعناوين
  9. 09الأتمتة عبر API وAnsible
  10. 10النسخ الاحتياطي والتحديث
  11. 11NetBox بنقرة واحدة على ServOrbit

ما الذي يفعله NetBox

يوثّق NetBox الشبكة والبنية التحتية التي تحملها. في جانب إدارة العناوين (IPAM) يدير البادئات الهرمية ونطاقات وعناوين IP وشبكات VLAN وVRF، ويحسب المساحة الحرة لكل شبكة. وفي جانب مراكز البيانات (DCIM) يصف المواقع والخزائن ومخططاتها والأجهزة ومنافذها والكابلات والتغذية الكهربائية. ويلتقي الجانبان: عنوان IP ينتمي إلى منفذ جهاز مركّب في خزانة داخل موقع.

يصدر المشروع بترخيص Apache-2.0. وتعتمد حزمة Docker الرسمية netbox-docker على PostgreSQL وعلى Valkey (أو Redis) للتخزين المؤقت وطابور المهام الخلفية. على VPS، يستهلك التطبيق وعملية المهام أقل من 1 غيغابايت من الذاكرة في حالة الخمول.

ما يقدمه لك NetBox

  • مصدر حقيقة واحد — الحالة المقصودة للشبكة، بدل عشرة ملفات يناقض بعضها بعضًا.
  • إدارة عناوين تحسب — المساحة الحرة لكل بادئة، والعنوان المتاح التالي، وكشف التكرار.
  • مخطط خزائنك — كل جهاز في مكانه، مع منافذه وكابلاته.
  • واجهة API لكل عنصر — REST وGraphQL، مع توثيق OpenAPI يقدمه المثيل نفسه.
  • سجل التغييرات — من غيّر ماذا ومتى، مع الحالة قبل التغيير وبعده.
  • الأتمتة — خطافات ويب ونصوص مخصصة ومخزون ديناميكي لـ Ansible.

جدول بيانات أم NetBox على خادمك

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

جدول بيانات مشتركNetBox على خادمك
عنوان مُسند مرتينلا شيء يمنعهيُنبَّه إليه عند الإدخال
المساحة الحرة لشبكةتُعدّ يدويًا من جديدتُحسب لكل بادئة
الربط بين العنوان والجهاز والخزانةأعمدة منسوخةعناصر مترابطة
سجل التغييراتنسخ الملفسجل لكل عنصر
القراءة من نصوصك البرمجيةتصدير CSVواجهة REST وGraphQL

قبل أن تبدأ

خصص خادم VPS بنظام Ubuntu 24.04 بذاكرة 2 غيغابايت على الأقل، و4 غيغابايت لفريق، ومعالجين افتراضيين و20 غيغابايت من القرص، مع تثبيت Docker وإضافة Compose. وتحتاج أيضًا إلى اسم مضيف يشير إلى الخادم، مثل netbox.example.com: لا يقبل NetBox النماذج، بما فيها نموذج الدخول، إلا من الأصل المعلن في CSRF_TRUSTED_ORIGINS، وسيُقدَّم عبر HTTPS.

تثبيت NetBox باستخدام Docker Compose

  1. تحضير المجلد وملف ‎.env

    يحمل هذا الملف أسرار المثيل. يجب أن يتكون كل من SECRET_KEY وAPI_TOKEN_PEPPER_1 من 50 حرفًا على الأقل: الأول يوقّع الجلسات، والثاني يُستخدم في تجزئة رموز API.

    mkdir -p /opt/netbox && cd /opt/netbox
    cat > .env <<EOF
    DB_PASSWORD=$(openssl rand -hex 16)
    REDIS_PASSWORD=$(openssl rand -hex 16)
    SECRET_KEY=$(openssl rand -hex 32)
    API_TOKEN_PEPPER_1=$(openssl rand -hex 32)
    SUPERUSER_PASSWORD=$(openssl rand -hex 16)
    DOMAIN=netbox.example.com
    EOF
    chmod 600 .env
  2. كتابة ملف docker-compose.yml

    أربع خدمات: PostgreSQL، وValkey محمي بكلمة مرور، وNetBox، وعملية المهام الخلفية. يُنشر المنفذ على الواجهة المحلية فقط: وحده nginx سيواجه الإنترنت.

    x-netbox: &netbox
      image: netboxcommunity/netbox:v4.7.5-5.1.2
      restart: unless-stopped
      user: "netbox:root"
      environment: &netbox-env
        DB_HOST: postgres
        DB_NAME: netbox
        DB_USER: netbox
        DB_PASSWORD: "${DB_PASSWORD}"
        REDIS_HOST: redis
        REDIS_PASSWORD: "${REDIS_PASSWORD}"
        REDIS_CACHE_HOST: redis
        REDIS_CACHE_PASSWORD: "${REDIS_PASSWORD}"
        REDIS_CACHE_DATABASE: "1"
        SECRET_KEY: "${SECRET_KEY}"
        API_TOKEN_PEPPER_1: "${API_TOKEN_PEPPER_1}"
        SKIP_SUPERUSER: "false"
        SUPERUSER_NAME: admin
        SUPERUSER_PASSWORD: "${SUPERUSER_PASSWORD}"
        LOGIN_REQUIRED: "true"
        CSRF_TRUSTED_ORIGINS: "https://${DOMAIN}"
      volumes:
        - netbox-media:/opt/netbox/netbox/media
    
    services:
      postgres:
        image: postgres:18.7-alpine
        restart: unless-stopped
        environment:
          POSTGRES_DB: netbox
          POSTGRES_USER: netbox
          POSTGRES_PASSWORD: "${DB_PASSWORD}"
        volumes:
          - netbox-postgres:/var/lib/postgresql
    
      redis:
        image: valkey/valkey:9.1.3-alpine
        restart: unless-stopped
        command: ["valkey-server", "--appendonly", "yes", "--requirepass", "${REDIS_PASSWORD}"]
        volumes:
          - netbox-redis:/data
    
      netbox:
        <<: *netbox
        depends_on: [postgres, redis]
        ports:
          - "127.0.0.1:8080:8080"
    
      netbox-worker:
        <<: *netbox
        depends_on: [netbox]
        command: ["/opt/netbox/venv/bin/python", "/opt/netbox/netbox/manage.py", "rqworker"]
    
    volumes:
      netbox-postgres: {}
      netbox-redis: {}
      netbox-media: {}
  3. التشغيل والتحقق

    يطبّق التشغيل الأول جميع ترحيلات قاعدة البيانات وينشئ الحساب admin: احسب من خمس إلى عشر دقائق على خادم صغير. يجب أن تجيب صفحة الدخول بالرمز 200، ويعرض الأمر الأخير كلمة مرور المسؤول.

    docker compose up -d
    docker compose logs -f netbox    # wait for "Initialisation is done"
    curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/login/
    grep SUPERUSER_PASSWORD .env

لا تغيّر السرّين بعد ذلك أبدًا

قيمة جديدة لـ SECRET_KEY تُخرج الجميع من جلساتهم، وقيمة جديدة لـ API_TOKEN_PEPPER_1 تُبطل كل رموز API الصادرة، فتتعطل نصوصك في الوقت نفسه. احفظ ملف .env مع قاعدة البيانات. وكذلك لا يُستخدم SUPERUSER_PASSWORD إلا عند التشغيل الأول: غيّر كلمة المرور بعد ذلك من ملفك الشخصي.

نشر NetBox عبر HTTPS خلف nginx

يستمع NetBox عبر HTTP على 127.0.0.1:8080، وينهي nginx اتصال TLS ويمرر إليه الطلبات. احتفظ بالترويسة X-Forwarded-Proto ليعرف التطبيق أنه يُقدَّم عبر HTTPS، وبقيمة client_max_body_size كافية للمرفقات وعمليات الاستيراد.

server {
    listen 443 ssl;
    server_name netbox.example.com;
    ssl_certificate     /etc/letsencrypt/live/netbox.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/netbox.example.com/privkey.pem;
    client_max_body_size 25m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

إذا لم يطابق الأصل قيمة CSRF_TRUSTED_ORIGINS يفشل الدخول بالخطأ 403 «CSRF verification failed»: تحقق من البادئة https:// ومن الاسم الدقيق.

الخطوات الأولى: الموقع والبادئات والعناوين

سجّل الدخول على https://netbox.example.com/login/ بالحساب admin. ابدأ بإنشاء موقع، ثم البادئات التي تستخدمها (قسم IPAM، البادئات): يرتبها NetBox هرميًا تلقائيًا ويعرض نسبة إشغال كل منها. ثم أضف أجهزتك (قسم الأجهزة) ومنافذها وعناوين IP الخاصة بها.

لنقل جدول موجود، تتيح كل قائمة الاستيراد بصيغة CSV أو YAML: الصق الأسطر، فيتحقق NetBox من كل حقل ويرفض الاستيراد كله إذا كان سطر واحد خاطئًا، ما يجنّب عمليات النقل غير المكتملة.

الأتمتة عبر API وAnsible

أنشئ رمزًا من ملفك الشخصي، قائمة رموز API. يُستخدم في الترويسة Authorization: Bearer، ويُقدَّم التوثيق التفاعلي على /api/schema/swagger-ui/.

export NETBOX_TOKEN='nbt_xxxxxxxx.yyyyyyyyyyyyyyyy'
curl -s -H "Authorization: Bearer $NETBOX_TOKEN" -H "Accept: application/json" \
  "https://netbox.example.com/api/ipam/prefixes/?status=active"

# Reserve the next free address of a prefix (id 1) in one request
curl -s -X POST -H "Authorization: Bearer $NETBOX_TOKEN" -H "Content-Type: application/json" \
  -d '{"description": "web-01"}' \
  "https://netbox.example.com/api/ipam/prefixes/1/available-ips/"

في جانب Ansible، توفر المجموعة netbox.netbox مخزونًا ديناميكيًا: تأتي خوادمك ومجموعاتها من NetBox، دون ملف يُحدَّث يدويًا. ويُمرَّر الرمز في متغير البيئة NETBOX_TOKEN.

# netbox_inventory.yml — ansible-galaxy collection install netbox.netbox
plugin: netbox.netbox.nb_inventory
api_endpoint: https://netbox.example.com
validate_certs: true
group_by: [sites, device_roles]

النسخ الاحتياطي والتحديث

عنصران يجب نسخهما: قاعدة PostgreSQL ووحدة تخزين المرفقات، دون نسيان ملف .env.

cd /opt/netbox
docker compose exec -T postgres pg_dump -U netbox netbox | gzip > netbox-$(date +%F).sql.gz
docker run --rm -v netbox_netbox-media:/media -v "$PWD":/backup alpine \
  tar czf /backup/netbox-media-$(date +%F).tar.gz -C /media .

للتحديث، غيّر وسم الصورة في docker-compose.yml ثم نفّذ docker compose pull وdocker compose up -d: تُطبَّق الترحيلات عند التشغيل. اقرأ ملاحظات الإصدار قبل الانتقال إلى إصدار رئيسي جديد، وخذ نسخة احتياطية قبله مباشرة.

NetBox بنقرة واحدة على ServOrbit

يثبّت متجر ServOrbit هذه الحزمة نفسها: صورة netbox-docker الرسمية وPostgreSQL وValkey وعملية المهام، ومنفذ منشور على 127.0.0.1 فقط، وأسرار مولّدة، وحساب admin منشأ، وتسجيل دخول إلزامي، وHTTPS مضبوط على نطاقك أو على النطاق الفرعي المجاني للخادم. وتظهر كلمة مرور المسؤول في مساحة العميل.

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