التوثيقشغّل عقدة اتحاد

شغّل عقدة اتحاد

شغّل عقدة سيادية.

تشارك عقدة الاتحاد في تناقل المناعة عبر الأجهزة دون أن ترى يومًا بيانات مستخدم خام. اختياري — لكن كلما زادت العُقد، زادت لامركزية الشبكة.

01

ماذا تفعل العقدة

تستقبل العقدة بثوث الأنماط المجزّأة من الأجهزة في منطقتها، وتشغّل بروتوكول النصاب مع العُقد الأقران، وتعيد بثّ الأنماط المؤكَّدة إلى أجهزتها المتصلة. لا تستقبل أو تخزّن أبدًا أي شيء يحدّد هوية مستخدم.

خصوصية بالبناء
تحمل طبقة البروتوكول تجزئات SHA-256 ونطاقات منطقة واسعة فقط. لا يوجد مسار شيفرة كي تستقبل عقدة IP أو بريدًا إلكترونيًا أو إحداثيًا جغرافيًا. هذا مفروض باختبار آلي يُفشِل البناء إذا اخترِق الحدّ.
02

متطلبات العتاد

العقدة خفيّ Rust إضافةً إلى مثيل PostgreSQL 16. الحدّ الأدنى:

  • 4 vCPU، و16 غيغابايت RAM، و200 غيغابايت SSD
  • اتصال موثوق، ومنفذ عام يمكن الوصول إليه (8443 افتراضيًا)
  • YubiHSM 2 أو ما يعادله لمفتاح هوية القرين (مُوصى به)
  • متزامن الوقت (NTP) — بروتوكول النصاب حسّاس لانحراف الساعة
03

التثبيت

shell# 1. PostgreSQL 16 (skipped if you already have one)
sudo apt-get install -y postgresql-16

# 2. The federation daemon
curl -L -o lydos-fed-2026.06.r1.tar.gz \
  https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/lydos-fed.tar.gz
curl -L -o release.manifest.json \
  https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/release.manifest.json

# 3. Verify the bundle (the same protocol as the phone image)
./verify-bundle.sh --bundle lydos-fed-2026.06.r1.tar.gz --manifest release.manifest.json
# expects: signatures 3 / 3, hash match

# 4. Install
sudo tar -xzf lydos-fed-2026.06.r1.tar.gz -C /opt/lydos-fed
sudo /opt/lydos-fed/install.sh
04

مراسم مفتاح هوية القرين

يوقّع مفتاح هوية القرين كل بثٍّ تصدره العقدة. ولّده داخل YubiHSM ضمن مراسم ضباط M-of-N. ثلاثة ضباط، اثنان من ثلاثة لتوقيع مفاتيح جديدة. وثّق المراسم في سجلّك الداخلي.

shell/opt/lydos-fed/bin/lydos-fed key generate --hsm yubihsm \
  --slot 1 --label fed-peer-2026.06 \
  --officers 2-of-3
تحذير المفتاح الساخن
لا تولّد هذا المفتاح على محطة عمل. يجب ألّا يظهر النصف الخاص أبدًا في أي ذاكرة عملية لا تتحكّم بها. يفرض HSM ذلك.
05

انضم إلى سجلّ الأقران

shell# Submit your node's public identity to the registry
/opt/lydos-fed/bin/lydos-fed join \
  --registry https://registry.lydos.ailydian.com \
  --pubkey-path /opt/lydos-fed/keys/fed-peer-2026.06.pub

يوقّع السجلّ قيدك ويعيد بثّه. ستتواصل العُقد الأخرى وتُكمِل المصافحة. يستغرق الانضمام عادةً 10–30 دقيقة.

06

المراقبة

يكشف الخفيّ مقاييس Prometheus على /metrics ولقطة صحة JSON على /health. اربطه بلوحتك القائمة أو استعلمه مباشرةً.

shellcurl https://your-node.example/health
# {
#   "version": "2026.06.r1",
#   "peers_online": "11/11",
#   "quorum": "ok",
#   "audit_chain_head": "3571a6c8…",
#   "uptime_seconds": 123456
# }
07

النسخ الاحتياطي والاستعادة

حجم PostgreSQL هو المكوّن الوحيد ذو الحالة الذي تحتاج إلى نسخه احتياطيًا. تعيش المفاتيح في HSM ولا يمكن إعادة بنائها إلا بالمراسم. إعداد الخفيّ قابل لإعادة الإنتاج من /etc/lydos-fed.

الاستعادة سريعة
تنضمّ عقدة جديدة إلى الاتحاد، وتسأل الأقران عن رأس السلسلة الحالي، وتلحق بالركب. أطول لحاق رصدناه في الإنتاج هو 18 دقيقة من البدء البارد إلى دخول النصاب.