التوثيق/الاتصال/لوحتك الخاصة/العُقد والعملاء·2 / 9

العُقد والعملاء

العقدة أمر واحد على خادم اللوحة: يدخل إلى الخادم عبر SSH ويضع Veli والبروتوكولات ويربط العقدة باللوحة. والعميل رابط له مدة وعدد أجهزة، واحد لكل العُقد.

أضف عقدة

اسم العقدة وعنوان خادمها والبروتوكولات بجانب Veli:

على خادم اللوحة
sudo veli nodes add de1 --ssh root@203.0.113.5 --protocols veli,reality,trojan

على الشاشة: بصمة SSH للخادم وسؤال عن الوثوق به — قارن البصمة بما في لوحة المضيف. ثم خطوات التثبيت و«العقدة تعمل». إن تعثّر شيء بقي الخادم كما كان — شغّل الأمر من جديد.

منفذ البروتوكول بعد نقطتين: ‎--protocols veli,trojan:2083. Hysteria2 وTUIC على x86-64 فقط.

الدخول إلى الخادم

-i
ملف المفتاح الخاص. بدونه يجرّب الأمر مفاتيح ‎~/.ssh ثم يسأل عن كلمة المرور
--password-stdin
كلمة مرور SSH من الإدخال — للسكربتات
--fingerprint
بصمة الخادم مسبقًا، ‎SHA256:… — فلا يُطرح السؤال
--from, --node-from
خذ veli والعقدة المبنيين من القرص — لخادم لا يفتح عليه موقعنا

من جهاز آخر

الأوامر نفسها تعمل من حاسوب محمول أو خادم عمل عليه veli. الرمز بصلاحية all يوضع في متغير لا في سطر الأمر.

على خادم اللوحة: يطبع الرمز وعنوان API
sudo veli token add laptop --rights all --days 7
على الجهاز الآخر: الرمز في متغير
export VELI_PANEL_TOKEN=…
الأمر نفسه مع عنوان API للوحة
veli nodes add de1 --panel <عنوان API> --ssh root@203.0.113.5 --protocols veli,reality,trojan

دفعة وuser-data

خوادم من ملف الواحد بعد الآخر. السطر: الاسم ‎[المستخدم@]العنوان[:المنفذ] [البروتوكولات] [key=ملف] [fingerprint=SHA256:…]
sudo veli nodes add --file servers.txt
بدل SSH يطبع نصًّا لحقل «user-data» عند المضيف: يثبّت الخادم Veli عند إنشائه ويرتبط باللوحة بنفسه
sudo veli nodes add de2 --protocols veli,trojan --cloud-init

نص «user-data» فيه رمز العقدة: عامله كأنه كلمة مرور والصقه في نموذج المضيف فقط.

القائمة والبروتوكولات والإزالة

العُقد ومتى أرسلت كل منها تقريرها الأخير
sudo veli nodes
أضف بروتوكولًا إلى عقدة؛ و‎--remove يزيل بروتوكولًا
sudo veli nodes protocols de1 --ssh root@203.0.113.5 --add hysteria2
أزل العقدة وأعد الخادم كما كان. بلا ‎--ssh تغادر اللوحة فقط؛ ومع ‎--keep يبقى Veli على الخادم
sudo veli nodes remove de1 --ssh root@203.0.113.5

العملاء

العميل رابط له مدة وعدد أجهزة: واحد لكل عُقد اللوحة.

عميل جديد: يطبع الرابط ورمز QR. مع ‎--speed 50 — سرعة Veli بالميغابت/ث
sudo veli users add anna --days 30 --devices 3
العملاء: الأجهزة والمدة والبيانات
sudo veli users
الرابط ورمز QR مرة أخرى
sudo veli users link anna
تمديد المدة
sudo veli users extend anna --days 30
إزالة: تقطع العُقد اتصال العميل في نصف دقيقة، ويبقى العميل في سلة المحذوفات 30 يومًا
sudo veli users remove anna

يلصق العميل الرابط في Veli («إضافة» ← لصق) أو يفتحه في المتصفح: تدلّه الصفحة على بقية التطبيقات.

الانتقال من لوحة أخرى

عملاء Remnawave وMarzban و3x-ui وHiddify وجدول CSV ينتقلون بمددهم وحدودهم وأجهزتهم. بدون ‎--yes يفحص الأمر فقط ولا يكتب شيئًا؛ وضع «-» مكان الرمز أو كلمة المرور يجعل الأمر يسأل عنه بنفسه.

فحص. Marzban — ‎--user و‎--password، وHiddify — ‎--key
sudo veli panel import remnawave https://old.example.com --token -
فحص من ملف قاعدة بيانات 3x-ui منسوخ إلى خادم اللوحة
sudo veli panel import 3x-ui --file x-ui.db
الانتقال من جدول: بلا المنتهين، مع إبقاء الروابط القديمة
sudo veli panel import csv --file clients.csv --skip-expired --redirect --yes
كل العملاء في جدول — يمكن تحميله من جديد؛ و‎--links يضيف الروابط (احفظ هذا الملف كأنه كلمة مرور)
sudo veli panel export --format csv --out clients.csv

أعلام أخرى: ‎--rename — الاسم المأخوذ يصير «الاسم-2»، ‎--skip-disabled — بلا المعطَّلين، ‎--devices N — عدد الأماكن لعملاء بلا حد أجهزة (3 افتراضيًا)، ‎--redirect — الروابط القديمة تقود إلى الجديدة. أعمدة الجدول يعرضها panel export.