ما الذي يفعله 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
تحضير المجلد وملف .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كتابة ملف 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: {}التشغيل والتحقق
يطبّق التشغيل الأول جميع ترحيلات قاعدة البيانات وينشئ الحساب
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