========================================
  دليل إضافة سيرفر بعيد (Remote Server)
  Remote Server Setup Guide
========================================

📡 إضافة سيرفر SSH/FTP/SFTP للتحميل
   Add SSH/FTP/SFTP server for downloads

========================================
  🎯 عبر واجهة البانل | Via Panel
========================================

1. افتح البانل:
   Open panel:
   http://YOUR_IP/VOD/

2. سجل دخول:
   Login:
   admin / admin

3. اذهب إلى:
   Go to:
   Remote Servers → Add Remote Server

4. املأ البيانات:
   Fill the form:

   ┌─────────────────────────────────────┐
   │ Name: اسم السيرفر (مثال: Server1)   │
   │ Type: SSH / FTP / SFTP             │
   │ Host: عنوان IP أو Domain           │
   │ Port: 22 (SSH) / 21 (FTP)         │
   │ Username: اسم المستخدم             │
   │ Password: كلمة المرور               │
   │ Remote Path: /var/www/html/media  │
   │ Local Path: /var/www/html/VOD/media│
   └─────────────────────────────────────┘

5. اختبر الاتصال:
   Test connection:
   انقر "Test Connection"

6. احفظ:
   Save:
   انقر "Save"

========================================
  💻 عبر قاعدة البيانات | Via Database
========================================

إضافة سيرفر SSH:
Add SSH server:

mysql -u root -pAdmin@123 vod_import << EOF

INSERT INTO remote_servers (
    name, type, host, port,
    username, password,
    remote_path, local_path,
    is_active, priority
) VALUES (
    'My Remote Server',
    'ssh',
    '192.168.1.100',
    22,
    'root',
    'your_password',
    '/media',
    '/var/www/html/VOD/media',
    1,
    1
);

EOF

========================================
  🔑 أنواع السيرفرات | Server Types
========================================

1️⃣ SSH (موصى به)
   Recommended
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Port: 22
   Features:
   ✅ آمن ومشفر | Secure & encrypted
   ✅ سريع | Fast
   ✅ يدعم sshpass و SSH keys
   ✅ الأفضل للسيرفرات Linux

   مثال:
   Name: Production Server
   Type: ssh
   Host: 192.168.1.100
   Port: 22
   Username: root
   Password: your_password

2️⃣ SFTP (آمن)
   Secure FTP
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Port: 22
   Features:
   ✅ آمن ومشفر | Secure
   ✅ يعمل عبر SSH
   ✅ مناسب لـ Windows/Linux

   مثال:
   Name: Backup Server
   Type: sftp
   Host: backup.example.com
   Port: 22
   Username: backupuser
   Password: backup_pass

3️⃣ FTP (غير آمن)
   Not Secure
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Port: 21
   Features:
   ⚠️ غير مشفر | Not encrypted
   ✅ متوافق مع معظم السيرفرات

   مثال:
   Name: Old Server
   Type: ftp
   Host: ftp.example.com
   Port: 21
   Username: ftpuser
   Password: ftp_pass

4️⃣ Local (محلي)
   Local Path
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Features:
   ✅ بدون اتصال شبكة
   ✅ مثالي للتخزين المحلي

   مثال:
   Name: Local Storage
   Type: local
   Local Path: /mnt/storage

========================================
  🔧 إعداد SSH (موصى به)
  SSH Setup (Recommended)
========================================

خطوة 1: تثبيت sshpass
Step 1: Install sshpass

sudo apt-get update
sudo apt-get install -y sshpass

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

خطوة 2: اختبار الاتصال
Step 2: Test connection

sshpass -p 'PASSWORD' \
  ssh -o StrictHostKeyChecking=no \
  USERNAME@HOST 'ls -la'

مثال:
sshpass -p 'mypassword' \
  ssh -o StrictHostKeyChecking=no \
  root@192.168.1.100 'ls -la'

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

خطوة 3: اختبار التحميل
Step 3: Test download

sshpass -p 'PASSWORD' \
  scp USERNAME@HOST:/path/to/file.mkv \
  /tmp/test.mkv

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

خطوة 4: إضافة في البانل
Step 4: Add in panel

Name: My SSH Server
Type: ssh
Host: 192.168.1.100
Port: 22
Username: root
Password: mypassword
Remote Path: /media
Local Path: /var/www/html/VOD/media

========================================
  🔐 استخدام SSH Keys (أكثر أماناً)
  Using SSH Keys (More Secure)
========================================

خطوة 1: توليد SSH Key
Step 1: Generate SSH key

ssh-keygen -t rsa -b 4096 -f ~/.ssh/vod_key -N ""

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

خطوة 2: نسخ المفتاح للسيرفر البعيد
Step 2: Copy key to remote server

ssh-copy-id -i ~/.ssh/vod_key.pub \
  USERNAME@HOST

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

خطوة 3: اختبار
Step 3: Test

ssh -i ~/.ssh/vod_key USERNAME@HOST 'ls'

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

خطوة 4: إضافة في البانل
Step 4: Add in panel

Name: Secure SSH Server
Type: ssh
Host: 192.168.1.100
Port: 22
Username: root
Private Key: (انسخ محتوى ~/.ssh/vod_key)

========================================
  ✅ اختبار السيرفر | Test Server
========================================

بعد إضافة السيرفر، اختبره:
After adding server, test it:

1. في واجهة البانل:
   In panel interface:
   Remote Servers → Test Connection

2. يدوياً عبر SSH:
   Manually via SSH:

   sshpass -p 'PASSWORD' \
     ssh USERNAME@HOST 'echo OK'

3. فحص الحالة في قاعدة البيانات:
   Check status in database:

   mysql -u root -pAdmin@123 vod_import -e \
     "SELECT name, host, status, last_check \
      FROM remote_servers;"

========================================
  📁 المسارات | Paths
========================================

المسار البعيد (Remote Path):
   المكان الذي ستحمل منه الملفات
   Where files will be downloaded from

   أمثلة:
   /media
   /var/www/html/videos
   /storage/series

المسار المحلي (Local Path):
   المكان الذي ستحفظ فيه الملفات
   Where files will be saved

   أمثلة:
   /var/www/html/VOD/media
   /var/www/html/VOD/series
   /mnt/storage

========================================
  🔍 فحص السيرفرات | Check Servers
========================================

عرض السيرفرات المضافة:
List added servers:

mysql -u root -pAdmin@123 vod_import -e "
  SELECT id, name, type, host, port,
         is_active, status, last_check
  FROM remote_servers;
"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

تحديث حالة السيرفر:
Update server status:

mysql -u root -pAdmin@123 vod_import -e "
  UPDATE remote_servers
  SET status = 'online',
      last_check = NOW()
  WHERE id = 1;
"

========================================
  🛠️ حل المشاكل | Troubleshooting
========================================

المشكلة: Permission denied
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
الحل:
1. تحقق من اسم المستخدم وكلمة المرور
2. تحقق من صلاحيات SSH:
   chmod 600 ~/.ssh/vod_key
3. تحقق من المسار البعيد:
   ssh USERNAME@HOST 'ls -la /media'

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

المشكلة: Connection refused
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
الحل:
1. تحقق من عنوان IP والبورت
2. تحقق من Firewall:
   sudo ufw allow 22/tcp
3. تحقق من SSH service:
   systemctl status ssh

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

المشكلة: Timeout
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
الحل:
1. تحقق من الشبكة:
   ping HOST
2. تحقق من SSH:
   telnet HOST 22
3. جرب port مختلف

========================================
  📊 السيرفر الموجود حالياً
  Current Server
========================================

لديك سيرفر واحد مضاف:
You have one server added:

ID: 2
Name: intro
Type: ssh
Host: 45.154.207.45
Port: 22
Status: online ✅

لإضافة سيرفر جديد:
To add new server:

1. عبر البانل:
   http://YOUR_IP/VOD/
   → Remote Servers
   → Add Server

2. عبر قاعدة البيانات:
   استخدم الأمثلة أعلاه
   Use examples above

========================================
  💡 نصائح | Tips
========================================

✅ استخدم SSH بدلاً من FTP (أسرع وأأمن)
✅ Use SSH instead of FTP (faster & secure)

✅ اختبر الاتصال قبل الحفظ
✅ Test connection before saving

✅ استخدم SSH keys للأمان
✅ Use SSH keys for security

✅ حدد المسارات الصحيحة
✅ Set correct paths

✅ تأكد من الصلاحيات على السيرفر البعيد
✅ Check permissions on remote server

========================================

تم التحديث: 2025-11-25
Updated: 2025-11-25

========================================