انتقل إلى المحتوى
الرئيسية / Kit / الطرفية
Terminalخدمة Kit

الطرفية

صدفة Linux مستمرة مكشوفة كنقطة نهاية HTTPS. شغّل الأوامر عبر API، اتصل من أي متصفح، أو بثّ المخرجات عبر WebSocket.

البدء السريع

# Get your token

$ curl https://your-terminal.hoody.com/token

> eyJhbG...

 

# Run your first command

$ curl -X POST .../api/v1/terminal/execute \

-H "Authorization: Bearer $TOKEN" \

-d '["command":"echo Hello from Hoody!","wait":true]'

> ["success":true,"stdout":"Hello from Hoody!\n","duration_ms":3]

 

# Share the URL — anyone can connect

https://proj-dev-terminal-1.server.containers.hoody.com

الرئيسية / Kit / الطرفية / الميزات
كيف يعمل

خمس طرق لاستخدام الطرفية

الطرفية تتكيف مع طريقة عملك. نفّذ الأوامر عبر HTTP، بثّ عمليات البناء عبر WebSocket، تعاون في الوقت الفعلي.

terminal-1

الأوامر عبر HTTP

أرسل أمر صدفة إلى أي جلسة طرفية عبر POST. احصل على JSON منظم مع stdout وstderr ورمز الخروج والتوقيت.

# قبل / بعد

- ssh user@server 'ls -la /app' 2>/dev/null

+ curl -X POST terminal.hoody.com/api/v1/terminal/execute -d '["command":"ls -la /app"]'

$ curl -X POST /api/v1/terminal/execute \

-d '["command": "npm test", "wait": true]'

 

> HTTP/1.1 200 OK

> [

> "success": true,

> "exit_code": 0,

> "stdout": "24 passed, 0 failed",

> "duration_ms": 12

> ]

التنفيذ1/5
الرئيسية / Kit / الطرفية / API
HTTP API

كل أمر هو استدعاء API

أرسل أمراً عبر POST، واحصل على JSON منظم مع stdout وstderr ورمز الخروج وبيانات التوقيت. متزامن أو غير متزامن.

عرض جميع نقاط النهاية
terminal-api.sh

# Execute a command via Terminal HTTP API

curl -X POST \

https://proj-dev-terminal-1.hoody.com/api/v1/terminal/execute \

-H "Content-Type: application/json" \

-H "Authorization: Bearer $TOKEN" \

-d '{

"command": "ls -la /app",

"wait": true

}'

 

# Response:

# {

# "success": true,

# "exit_code": 0,

# "stdout": "total 48\ndrwxr-xr-x ...",

# "stderr": "",

# "duration_ms": 12

# }

الرئيسية / Kit / الطرفية / المزيد
حالات الاستخدام

مبني لسير العمل الحقيقية

الطرفية تغطي النطاق الكامل لسيناريوهات المطور والأتمتة.

التطوير عن بُعد

ادخل إلى حاويتك عبر SSH من أي جهاز بمتصفح. وصول كامل للصدفة مع جلسات مستمرة — واصل من حيث توقفت.

تنسيق وكيل الذكاء الاصطناعي

الوكلاء ينفّذون أوامر الصدفة عبر HTTP API. بناء، اختبار، نشر — Terminal API يمنح وكلاء الذكاء الاصطناعي وصولاً منظماً.

تصحيح أخطاء الفريق

شارك عنوان URL للطرفية مع فريقك لتصحيح الأخطاء متعدد اللاعبين. الجميع يرى نفس المخرجات ويمكنه الكتابة.

التطبيقات الرسومية

شغّل أي تطبيق رسومي من الطرفية. Firefox، VS Code، GIMP — terminal-N يربط تلقائياً بـ display-N.

تكامل CI/CD

شغّل خطوات البناء، نفّذ الاختبارات، انشر المنتجات — كل ذلك عبر HTTP. ادمج الطرفية في أي خط أنابيب CI.

المراقبة الحية

إحصائيات CPU والذاكرة والقرص والشبكة الفورية عبر API. سرد العمليات الجارية، إرسال الإشارات، فحص المنافذ.

الرئيسية / Kit / الطرفية / نقاط النهاية
HTTP API

19 نقطة نهاية، تحكم كامل

أربعة مجالات: تنفيذ الأوامر، إدارة الجلسات، البث الحي عبر WebSocket، ومراقبة النظام.

إدارة الجلسات

7 endpoints

curl .../sessions → [{terminal_id: "1", shell: "bash"}]

GET
/api/v1/terminal/sessionsسرد الجلسات النشطة
POST
/api/v1/terminal/sessionsإنشاء جلسة جديدة
DELETE
/api/v1/terminal/sessions/:idإنهاء الجلسة
POST
/api/v1/terminal/sessions/:id/resizeتغيير حجم الطرفية
POST
/api/v1/terminal/sessions/:id/writeالكتابة إلى الجلسة
GET
/api/v1/terminal/sessions/:id/statusحالة الجلسة
POST
/api/v1/terminal/sessions/:id/signalإرسال إشارة إلى الجلسة

النظام والبيانات الوصفية

6 endpoints

curl .../system/resources → {cpu: 45%, mem: 8GB}

GET
/api/v1/system/resourcesالمعالج، الذاكرة، القرص، الشبكة
GET
/api/v1/system/processesالعمليات الجارية
POST
/api/v1/system/process/signalإرسال إشارة إلى PID
GET
/api/v1/system/envمتغيرات البيئة
GET
/api/v1/system/infoمعلومات النظام
GET
/api/v1/terminal/rawتصدير المخرجات الخام

تنفيذ الأوامر

4 endpoints

curl -X POST .../execute -d '{"command":"npm test"}'

POST
/api/v1/terminal/executeتنفيذ الأمر (متزامن/غير متزامن)
GET
/api/v1/terminal/result/:idاستطلاع نتيجة غير متزامنة
GET
/api/v1/terminal/history/:idسجل الأوامر
GET
/api/v1/terminal/screenshotالتقاط كـ PNG/JPEG/GIF

البث الحي

2 endpoints

WS .../sessions/1/ws → real-time stdout frames

WS
/api/v1/terminal/sessions/:id/wsبث في الوقت الفعلي
GET
/api/v1/terminal/sessions/:id/bufferقراءة مخزن المخرجات
الرئيسية / Kit / الطرفية / المزيد
القدرات

كل شيء مدمج

كل ميزة متاحة بلا ضبط. الطرفية جاهزة للاستخدام فور تشغيل حاويتك.

جلسات مستمرة

دليل العمل، متغيرات البيئة، سجل الصدفة — كل شيء يبقى بعد إغلاق المتصفح وإعادة الاتصال.

اختيار الصدفة

bash، zsh، fish، tmux، sh — بدّل الصدفات عبر معامل URL. مثبتة ومستعدة.

جسر tmux

جلسات tmux مشتركة بين الويب والوصول عبر SSH. terminal-3 في المتصفح يربط بجلسة tmux 3 عبر SSH.

لقطات الطرفية

التقط حالة الطرفية كـ PNG أو JPEG أو GIF عبر API. ألوان وحجم خط قابلة للضبط للتوثيق.

إعادة تعيين الجلسة

اقتل جميع العمليات، امسح البيئة، أعد تعيين دليل العمل بمعامل URL واحد. بداية نظيفة فوراً.

مواصفة OpenAPI

API موثّقة ذاتياً على /api/v1/terminal/openapi.json. أنشئ عملاء مكتوبين بأي لغة تلقائياً.

الرئيسية / Kit / الطرفية / البدء

مستعد للاستكشاف؟

الطرفية هي واحدة من 14 خدمة Kit تأتي مع كل حاوية Hoody. بلا تثبيت، بلا ضبط — استكشفها فوراً.

اقرأ التوثيق