تثبيت خادم RoqueOS

قم بتحويل RoqueOS إلى منصة حوسبة سحابية قوية ومستضافة ذاتياً. قم بالتثبيت باستخدام Docker لفتح محطة Linux (Terminal)، متصفح عن بعد، متجر تطبيقات Docker، مدير ملفات، والمزيد.

---

المتطلبات الأساسية

المتطلبات

ستحتاج إلى جهاز يعمل بنظام Linux (يوصى بـ Ubuntu/Debian) أو macOS/Windows مع تثبيت Docker و Docker Compose.

ليس لديك Docker؟ قم بتثبيت Docker Engine قبل المتابعة.

---

الخيار 1: التثبيت التلقائي (موصى به)

الطريقة الأسهل والأسرع. سيقوم البرنامج النصي (Script) بتنزيل وتكوين كل شيء من أجلك.

Linux / macOS

curl -fsSL https://roqueos.com.br/install.sh | bash

Windows

iwr -useb https://roqueos.com.br/install.ps1 | iex

بعد التنفيذ، سيكون الخادم قيد التشغيل وجاهزاً لاستقبال الاتصالات من الواجهة الأمامية.

---

الخيار 2: التثبيت اليدوي

لأولئك الذين يفضلون إدارة الحاويات بأنفسهم.

1. تنزيل الصور من DockerHub

docker pull roqueribeiro1988/roqueos-server:latest
docker pull roqueribeiro1988/roqueos-server-ubuntu:latest

2. إنشاء ملف docker-compose.yml

version: '3.8'

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    container_name: roqueos-server
    restart: unless-stopped
    ports:
      - '27021:27021'
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Riyadh

3. تشغيل الخادم

docker compose up -d

---

التحقق من التثبيت

curl http://localhost:27021/health

النتيجة المتوقعة:

{ "status": "ok", "timestamp": "2026-03-05T00:00:00.000Z", "version": "2.1.0" }

---

لوحة الإدارة

بعد التثبيت، يمكن الوصول إلى لوحة الإدارة (Admin Panel) عبر:

http://localhost:27021/api

في اللوحة، يمكنك:

• إنشاء وإدارة مفاتيح API لتوصيل الواجهة الأمامية
• مراقبة الحاويات والخدمات قيد التشغيل
• تكوين أنفاق Cloudflare للوصول الخارجي الآمن

---

الاتصال بالواجهة الأمامية

1. افتح RoqueOS من خلال roqueos.com.br أو في التطبيق الأصلي.
2. اذهب إلى الإعدادات → الخادم.
3. أدخل رابط الخادم (مثال: http://localhost:27021 أو https://your-tunnel.trycloudflare.com).
4. الصق مفتاح API الذي تم إنشاؤه في لوحة الإدارة.
5. انقر فوق اتصال.

---

الخطوات التالية

• VPS والسحابة — التثبيت على خادم بعيد للوصول على مدار الساعة 24/7
• المجلدات (الأقراص) — تعيين مجلداتك المحلية في مدير الملفات
• متجر تطبيقات Docker — تثبيت تطبيقات Docker بنقرة واحدة