الطرفية
صدفة 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
خمس طرق لاستخدام الطرفية
الطرفية تتكيف مع طريقة عملك. نفّذ الأوامر عبر HTTP، بثّ عمليات البناء عبر WebSocket، تعاون في الوقت الفعلي.
الأوامر عبر 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
> ]
كل أمر هو استدعاء API
أرسل أمراً عبر POST، واحصل على JSON منظم مع stdout وstderr ورمز الخروج وبيانات التوقيت. متزامن أو غير متزامن.
عرض جميع نقاط النهاية# 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
# }
مبني لسير العمل الحقيقية
الطرفية تغطي النطاق الكامل لسيناريوهات المطور والأتمتة.
التطوير عن بُعد
ادخل إلى حاويتك عبر SSH من أي جهاز بمتصفح. وصول كامل للصدفة مع جلسات مستمرة — واصل من حيث توقفت.
تنسيق وكيل الذكاء الاصطناعي
الوكلاء ينفّذون أوامر الصدفة عبر HTTP API. بناء، اختبار، نشر — Terminal API يمنح وكلاء الذكاء الاصطناعي وصولاً منظماً.
تصحيح أخطاء الفريق
شارك عنوان URL للطرفية مع فريقك لتصحيح الأخطاء متعدد اللاعبين. الجميع يرى نفس المخرجات ويمكنه الكتابة.
التطبيقات الرسومية
شغّل أي تطبيق رسومي من الطرفية. Firefox، VS Code، GIMP — terminal-N يربط تلقائياً بـ display-N.
تكامل CI/CD
شغّل خطوات البناء، نفّذ الاختبارات، انشر المنتجات — كل ذلك عبر HTTP. ادمج الطرفية في أي خط أنابيب CI.
المراقبة الحية
إحصائيات CPU والذاكرة والقرص والشبكة الفورية عبر API. سرد العمليات الجارية، إرسال الإشارات، فحص المنافذ.
19 نقطة نهاية، تحكم كامل
أربعة مجالات: تنفيذ الأوامر، إدارة الجلسات، البث الحي عبر WebSocket، ومراقبة النظام.
إدارة الجلسات
7 endpointscurl .../sessions → [{terminal_id: "1", shell: "bash"}]
النظام والبيانات الوصفية
6 endpointscurl .../system/resources → {cpu: 45%, mem: 8GB}
تنفيذ الأوامر
4 endpointscurl -X POST .../execute -d '{"command":"npm test"}'
البث الحي
2 endpointsWS .../sessions/1/ws → real-time stdout frames
كل شيء مدمج
كل ميزة متاحة بلا ضبط. الطرفية جاهزة للاستخدام فور تشغيل حاويتك.
جلسات مستمرة
دليل العمل، متغيرات البيئة، سجل الصدفة — كل شيء يبقى بعد إغلاق المتصفح وإعادة الاتصال.
اختيار الصدفة
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. أنشئ عملاء مكتوبين بأي لغة تلقائياً.
مستعد للاستكشاف؟
الطرفية هي واحدة من 14 خدمة Kit تأتي مع كل حاوية Hoody. بلا تثبيت، بلا ضبط — استكشفها فوراً.