Sliver GUI

تنزيل أحدث إصدار

Sliver GUI هو تطبيق سطح مكتب متعدد المنصات مبني على Electron لـ Sliver. وهو يجمع بين اتصالات الواجهة الخلفية، وعروض الحالة المباشرة، ومساحات عمل مخصصة، ووحدة تحكم Sliver أصلية في واجهة React مبنية باستخدام HeroUI وHeroUI Pro و Font Awesome.

الميزات

• نوافذ تطبيق متعددة مع إعدادات مشغّل محفوظة، واتصالات مشتركة للإعدادات المتطابقة، وحالة مساحة عمل مستقلة.
• عرض طوبولوجيا نظرة عامة، ولوحات معلومات Sessions وBeacons، ومساحات تفاعل مخصصة مع لوحات Files وProcesses وEnvironment وRegistry و Activity.
• عروض التوليد والبناء والملفات الشخصية، والمهام والمستمعين، وLoot، و Credentials.
• المواقع المستضافة مع إنشاء/حذف الموقع، وتحرير نصوص Monaco المستقل، واستيراد الملفات والمجلدات بشكل متكرر، واستبدال/حذف المحتوى، وتحديثات MIME، وإجراءات حفظ النسخ مباشرة من صفوف المحتوى أو معاينات المصدر. تقدّم معاينات المتصفح المحتوى الحالي وموارد الموقع من خادم HTTP محلي مؤقت. تظل عروض مصدر Monaco للقراءة فقط والعروض السداسية للبيانات الثنائية متاحة. راجع حدود الموقع وأمان المعاينة.
• وحدة تحكم Sliver مخصصة ونوافذ SSH مُدارة مع طرفيات Ghostty ذات علامات تبويب.
• عميل مستقل File → Remote Desktop مدعوم بـ IronRDP، مع اتصالات TLS مباشرة باستخدام NLA الافتراضي أو تسجيل الدخول إلى الشاشة البعيدة، وملفات تعريف محفوظة، ومراجعة الشهادات، وأسطح مكتب ذات علامات تبويب، وحافظة نصوص صريحة، وعارض لوحة قماشية معزول. يعمل دون إعدادات مشغّل أو اتصال بخادم Sliver. راجع استخدام RDP و البنية والتحقق.
• نوافذ منفصلة لـ Armory وNetwork وCloud Deployment، بما في ذلك تكامل حسابات AWS وAzure.
• مدير DNS لنشر السحابة لـ Route 53 وAzure DNS، مع عروض سجلات المنطقة وجميع المناطق وتحرير السجلات.
• اختصارات لوحة مفاتيح قابلة للتكوين، ومظهر التطبيق، وعناصر تحكم التحديث.
• تنقل لوحة الأوامر إلى الجلسات والمنارات المباشرة بالاسم، مع تفاصيل المضيف والمستخدم والمعرّف لتمييز الأسماء المتطابقة.

لا تنفّذ الواجهة الرسومية كل أمر أو خيار في المنبع. تستخدم اتصالات المشغّل mTLS؛ يتم التعرف على إعدادات مشغّل WireGuard ولكن لا يمكنها الاتصال. راجع تقرير تكافؤ المشغّل لمعرفة التغطية المتتبعة ومستندات الميزات أدناه للحدود المحددة.

التطوير

المتطلبات

• Node.js 24.15 أو أحدث ضمن سلسلة 24.x، أو Node.js 26 أو أحدث.
• npm 11.19 أو أحدث.
• rustup لمساعد RDP المضمّن؛ يقوم npm run setup:rdp بتثبيت سلسلة أدوات Rust 1.94.1 المثبّتة وأهداف المنصات.
• ترخيص HeroUI Pro ومصادقة لقطعة الحزمة الخاصة به، تحتاج إلى هذا الترخيص فقط إذا كنت تريد بناء الشيفرة من الصفر. يمكنك تنزيل ملفات ثنائية مبنية مسبقًا من إصدارات Github.

يتم تسجيل الإصدارات المدعومة والتبعيات المثبّتة في package.json وpackage-lock.json. تستخدم شيفرة التطبيق TypeScript الصارم؛ وتستخدم مساعدات البناء وحدات Node.js ES.

التشغيل محليًا

npm ci --strict-allow-scripts
npx heroui-pro login
npx heroui-pro install --yes
npm run setup:rdp
npm run dev

خطوات تسجيل الدخول/التثبيت الخاصة بـ HeroUI مطلوبة لإعداد محطة العمل الأولي؛ يمكن تخطيها عندما يكون HEROUI_AUTH_TOKEN مُهيأً بالفعل للتثبيت. أبقِ بيانات الاعتماد خارج الملفات المتتبَّعة.

يقوم npm run dev ببناء التطبيق الثابت وتشغيله على sliver://app/index.html، باستخدام سياسة أمان المحتوى الخاصة بالإنتاج. كما يبني مساعد RDP المضيف من نسخة IronRDP المتفرعة المثبَّتة. لا تتطلب عمليات بناء TypeScript العادية واختبارات الوحدة تجميع Rust. أعد تشغيل الأمر بعد تغييرات المصدر؛ سير العمل هذا لا يستخدم HMR.

يُثبَّت عميل TypeScript من حزمة npm المثبَّتة sliver-script. لا حاجة إلى نسخة محلية مجاورة من العميل. لا يتطلب تطوير التطبيق العادي نسخة محلية من مصدر Sliver؛ أما بناء الطرفية الأصلية فيتطلب ذلك.

الإعدادات والتكوينات المحلية

الجذر الافتراضي لعميل Sliver هو ~/.sliver-client؛ ويمكن لـ SLIVER_CLIENT_ROOT_DIR اختيار جذر آخر. تُحفظ تفضيلات التطبيق، بما في ذلك خيارات رسم Overview البياني، في gui/application-settings.json؛ ويُحفظ تكبير مساحة العمل في gui/workspace-zoom.json، وتفضيلات محرر النصوص في gui/text-editor-settings.json تحت ذلك الجذر. تكتشف الواجهة الرسومية تكوينات المشغّل الموجودة في configs/ وتحدّث منتقي الفتح عند حفظ تكوين صالح هناك. تحفظ التكوينات المختارة عبر Import كمراجع ملفات خاصة في gui/operator-configs.json. لا يقوم Import وForget بنسخ التكوينات المصدرية أو حذفها.

توجد ملفات تعريف سطح المكتب البعيد وتثبيتات شهادات نقاط النهاية في gui/rdp.json. تُحذف كلمات المرور افتراضيًا، ويمكن الاحتفاظ بها حتى خروج التطبيق، أو تشفيرها باستخدام التخزين الآمن لنظام التشغيل. تكون كلمات المرور الدائمة غير متاحة عندما يختار Linux مخزن مفاتيح غير مشفّر. نقل الحافظة صريح ومقتصر على النص؛ وإغلاق تبويب RDP يقطع الاتصال دون تسجيل الخروج من حساب Windows البعيد.

يقوم Settings → General → Appearance → Disable window transparency بإيقاف زجاج النافذة الأصلي فورًا عبر التطبيق بأكمله. المفتاح مُعطَّل افتراضيًا، لذا تبقى الشفافية مُفعَّلة حيثما كانت مدعومة. يُحفظ مع تفضيلات التطبيق الأخرى وله الأولوية على شفافية الطرفية.

تُهيَّأ ألوان الطرفية المتوافقة مع Ghostty في Settings → Terminal وتُحفظ في gui/ghostty/config. تنتمي السمات المخصصة إلى gui/ghostty/themes/؛ وتُكتشف سمات Ghostty الأصلية المثبَّتة تلقائيًا. راجع مظهر الطرفية وسمات Ghostty لمشاركة التكوين، ومحرر Monaco، ودعم الشفافية على المنصات، وحدود وقت التشغيل.

الأوامر

الأمر	الغرض
npm run typecheck	فحص مشاريع TypeScript الخاصة بالعملية الرئيسية/preload والعرض.
npm test	تشغيل اختبارات الوحدة والمكوّنات عبر Vitest.
npm run test:watch	تشغيل Vitest بشكل تفاعلي.
npm run test:e2e:electron	بناء Electron واختباره عبر العرض وpreload وIPC.
npm run protocol:check	التحقق من العميل المثبَّت والأساس المرجعي upstream ومخرجات التكافؤ.
npm run build	فحص الأنواع وبناء مخرجات التطبيق في dist/.
npm run build:console	بناء طرفية Sliver الأصلية المثبَّتة.
npm run build:rdp:host	بناء مساعد RDP والتحقق منه لهذا الجهاز.
npm run build:rdp	بناء هدف حزم RDP، بما في ذلك كلا شريحتي macOS.
npm run test:rdp:native	تشغيل اختبارات وقت تشغيل Rust.
npm run package	إنشاء تطبيق غير محزَّم تحت release/.
npm run dist	إنشاء مثبِّتات المنصة تحت release/.
npm run test:e2e:packaged	التحقق من تطبيق غير محزَّم موجود واختباره مقابل fixture محلي.

توجد اختبارات الوحدة والمكوّنات بجانب ملفات المصدر؛ وتوجد سيناريوهات Electron في src/e2e/. اختبارات الخادم الفعلي منفصلة، وهي فحوصات اختيارية تتطلب بنية تحتية قابلة للتخلص منها ومُهيأة. لا يُثبت اختبار fixture التوافق مع خادم حي أو حزمة مثبَّتة.

يستخدم فحص البروتوكول Go ويجلب المصدر الأولي المثبّت إلى دليل مؤقت. راجع توثيق البروتوكول للاطلاع على فحوصات المصدر واستخدام خط أساس محلي محدد صراحةً.

وحدة التحكم الأصلية والتغليف

تتطلب عمليات بناء وحدة التحكم والتوزيع Go 1.27.1 ونسخة نظيفة من Sliver عند الالتزام والشجرة المسجلين في مصدر وحدة تحكم Sliver. ضعها في sliver/ أو عيّن SLIVER_SOURCE_DIR. يتحقق بناء وحدة التحكم من المصدر؛ ولا يجلب ذلك النسخة أو يعدّلها.