المقدمة

تعرف على BotHosting Pro وكيف يعمل

مرحباً بك في BotHosting Pro — منصة احترافية لاستضافة وتشغيل بوتات ديسكورد على مدار الساعة (24/7). نوفر لك بيئة متكاملة لإدارة بوتك بكل سهولة، من رفع الكود إلى مراقبة السجلات مباشرة.

كيف تعمل المنصة؟

تعمل BotHosting Pro على تزويدك بخادم افتراضي مخصص لتشغيل بوت ديسكورد الخاص بك. كل بوت يعمل في بيئة معزولة有自己的 موارد مخصصة (RAM، CPU، مساحة تخزين) لضمان عدم تأثر البوتات الأخرى.

  1. تقوم بإنشاء حساب على المنصة (عبر الإدارة)
  2. تشترك في الخطة المناسبة لاحتياجاتك
  3. تنشئ بوتاً جديداً وتضيف التوكن
  4. ترفع ملفات البوت أو ترفع ملف ZIP
  5. تُعيّن الملف الرئيسي وتشغّل البوت
  6. تتابع السجلات وتحكم في البوت من الكونسول

اللغات المدعومة

ندعم مجموعة متنوعة من لغات البرمجة لاستضافة بوتات ديسكورد:

  • Node.js — باستخدام discord.js v14+
  • Python — باستخدام discord.py 2.x
  • Java — باستخدام JDA 5
  • C# — باستخدام Discord.NET
  • Go — باستخدام Discordgo
  • Rust — باستخدام Serenity

المميزات الرئيسية

  • إعادة تشغيل تلقائي — إذا توقف البوت، يتم إعادة تشغيله فوراً
  • سجلات مباشرة — مراقبة مخرجات البوت في الوقت الحقيقي
  • مدير ملفات — رفع وتعديل الملفات من المتصفح
  • كونسول مباشر — تنفيذ أوامر مباشرة
  • متغيرات البيئة — إدارة متغيرات ENV بسهولة
  • إشعارات — تنبيهات عبر البريد والديسكورد
ملاحظة: إذا واجهتك أي مشكلة، يمكنك التواصل مع فريق الدعم عبر سيرفر الديسكورد.

إنشاء حساب

كيفية إنشاء حساب على BotHosting Pro

في BotHosting Pro، يتم إنشاء الحسابات من قبل الإدارة. هذا يضمن التحكم في جودة الخدمة ودعم المستخدمين بشكل أفضل.

خطوات إنشاء الحساب

  1. تواصل معنا عبر ديسكورد — قم بزيارة سيرفر الديسكورد الخاص بنا وأرسل رسالة للإدارة
  2. قدم بياناتك — أرسل اسم المستخدم المطلوب والبريد الإلكتروني
  3. انتظر التفعيل — سيتم إنشاء حسابك وإرسال بيانات الدخول عبر رسالة خاصة (DM) على ديسكورد والبريد الإلكتروني
  4. سجّل الدخول — استخدم بيانات الدخول للوصول إلى لوحة التحكم
مهم: لا تشارك بيانات الدخول مع أي شخص آخر. إذا نسيت كلمة المرور، تواصل مع الإدارة للحصول على كلمة مرور جديدة.

الوصول إلى لوحة التحكم

بعد تفعيل الحساب، يمكنك تسجيل الدخول من خلال صفحة /login. سيتم توجيهك إلى لوحة التحكم حيث يمكنك:

  • إنشاء بوتات جديدة
  • إدارة الملفات
  • مراقبة السجلات
  • تعديل إعدادات البوت

استضافة بوت

الخطوات لإنشاء واستضافة بوت ديسكورد

بعد تسجيل الدخول إلى لوحة التحكم، يمكنك إنشاء واستضافة بوت ديسكورد في بضع خطوات بسيطة.

الخطوة 1: إنشاء بوت جديد

  1. من لوحة التحكم، اضغط على زر "بوت جديد"
  2. أدخل اسم البوت (اسم للتمييز فقط)
  3. أدخل توكن البوت (Token) — يمكنك الحصول عليه من Discord Developer Portal
  4. اضغط "إنشاء"
نصيحة: للحصول على التوكن، أنشئ تطبيقاً جديداً في Discord Developer Portal، ثم اذهب إلى قسم "Bot" واضغط "Reset Token".

الخطوة 2: رفع ملفات البوت

بعد إنشاء البوت، انتقل إلى تبويب "الملفات" وارفع ملفات مشروعك. يمكنك رفع ملفات فردية أو ملف ZIP يحتوي على المشروع بالكامل.

الخطوة 3: تعيين الملف الرئيسي

بعد رفع الملفات، يجب تعيين الملف الرئيسي الذي سيُشغّل البوت:

  • لـ Node.js: عادةً index.js أو bot.js
  • لـ Python: عادةً main.py أو bot.py

الخطوة 4: تشغيل البوت

اضغط على زر "تشغيل" وسيبدأ البوت فوراً. يمكنك متابعة السجلات من تبويب "الكونسول" للتأكد من أن البوت يعمل بشكل صحيح.

تم! بوتك الآن يعمل على مدار الساعة (24/7) مع إعادة تشغيل تلقائي إذا توقف.

رفع الملفات

طرق رفع وإدارة ملفات البوت

يوفر BotHosting Pro مدير ملفات متكامل يسمح لك برفع وتعديل وحذف ملفات البوت مباشرة من المتصفح.

طرق الرفع

1. رفع ملفات فردية

  1. انتقل إلى تبويب "الملفات" في لوحة التحكم
  2. اضغط على زر "رفع"
  3. اختر الملف أو الملفات المراد رفعها
  4. انتظر حتى يكتمل الرفع

2. رفع ملف ZIP

يمكنك تجميع ملفات مشروعك في ملف ZIP واحد ورفعه مباشرة:

  1. قم بتعبئة ملفات المشروع في ملف .zip
  2. اسحب وأفلت ملف ZIP في منطقة الرفع
  3. أو استخدم زر الرفع واختر ملف ZIP
  4. سيتم فك الضغط تلقائياً واستخراج الملفات

3. السحب والإفلات

يمكنك سحب الملفات من جهازك وإفلتها مباشرة في منطقة الملفات في لوحة التحكم.

إدارة الملفات

  • عرض الملفات — اضغط على أي ملف لفتحه في المحرر
  • تعديل الملف — عدّل محتوى الملف مباشرة من المتصفح واحفظ
  • تعيين كرئيسي — اختر الملف الرئيسي الذي سيُشغّل البوت
  • حذف ملف — احذف أي ملف لا تحتاجه
تنبيه: تأكد من أن الملف الرئيسي مُعيّن قبل تشغيل البوت. بدون ملف رئيسي، لن يتمكن البوت من التشغيل.

إعداد Node.js bot

كيفية إعداد بوت ديسكورد بلغة Node.js

في هذا الدليل، سنشرح كيفية إعداد بوت ديسكورد باستخدام Node.js و discord.js ثم استضافته على BotHosting Pro.

المتطلبات

  • بوت ديسكورد تم إنشاؤه من Discord Developer Portal
  • التوكن (Token) الخاص بالبوت
  • حساب على BotHosting Pro

إنشاء مشروع Node.js

الملف 1: package.json

أنشئ ملف package.json في الجذر:

{
  "name": "my-discord-bot",
  "version": "1.0.0",
  "description": "My Discord Bot",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "discord.js": "^14.16.3"
  }
}
ملاحظة: سيتم تثبيت المكتبات تلقائياً عند التشغيل إذا كان ملف node_modules غير موجود.

الملف 2: index.js

أنشئ الملف الرئيسي index.js:

const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent
  ]
});

client.once('ready', () => {
  console.log(`✅ Logged in as ${client.user.tag}`);
});

client.on('messageCreate', (message) => {
  if (message.content === '!ping') {
    message.reply('Pong! 🏓');
  }
});

client.login(process.env.TOKEN);

الخطوات على BotHosting Pro

  1. ارفع ملفتي package.json و index.js عبر مدير الملفات
  2. عيّن index.js كملف رئيسي
  3. أضف متغير البيئة TOKEN بقيمة توكن البوت (انظر متغيرات البيئة)
  4. اضغط "تشغيل"
تم! بوت Node.js الخاص بك يعمل الآن. تحقق من الكونسول للتأكد من تسجيل الدخول بنجاح.

إعداد Python bot

كيفية إعداد بوت ديسكورد بلغة Python

في هذا الدليل، سنشرح كيفية إعداد بوت ديسكورد باستخدام Python و discord.py ثم استضافته على BotHosting Pro.

المتطلبات

  • بوت ديسكورد تم إنشاؤه من Discord Developer Portal
  • التوكن (Token) الخاص بالبوت
  • حساب على BotHosting Pro

إنشاء مشروع Python

الملف 1: requirements.txt

أنشئ ملف requirements.txt لتحديد المكتبات المطلوبة:

discord.py>=2.3.0
ملاحظة: سيتم تثبيت المكتبات المذكورة في requirements.txt تلقائياً عند التشغيل.

الملف 2: main.py

أنشئ الملف الرئيسي main.py:

import os
import discord
from discord.ext import commands

intents = discord.Intents.default()
intents.message_content = True

bot = commands.Bot(command_prefix='!', intents=intents)

@bot.event
async def on_ready():
    print(f'✅ Logged in as {bot.user}')

@bot.command()
async def ping(ctx):
    await ctx.send('Pong! 🏓')

bot.run(os.getenv('TOKEN'))

الخطوات على BotHosting Pro

  1. ارفع ملفتي requirements.txt و main.py عبر مدير الملفات
  2. عيّن main.py كملف رئيسي
  3. أضف متغير البيئة TOKEN بقيمة توكن البوت
  4. تأكد من أن أمر التشغيل هو python main.py
  5. اضغط "تشغيل"
تم! بوت Python الخاص بك يعمل الآن. تحقق من الكونسول للتأكد من الاتصال.

متغيرات البيئة

إدارة متغيرات البيئة (Environment Variables) للبوت

متغيرات البيئة (Environment Variables) هي طريقة آمنة لتخزين القيم الحساسة مثل التوكنات ومفاتيح API بدلاً من كتابتها في الكود مباشرة.

لماذا تستخدم متغيرات البيئة؟

  • الأمان: تمنع تسريب التوكنات والمفاتيح السرية
  • المرونة: يمكنك تغيير القيم بدون تعديل الكود
  • التنظيم: تفصل بين الإعدادات والكود

كيف تضيف متغيرات البيئة

  1. انتقل إلى تبويب "الإعدادات" في لوحة التحكم
  2. ابحث عن قسم "متغيرات البيئة"
  3. اضغط على "إضافة متغير"
  4. أدخل المفتاح (Key) — مثل: TOKEN
  5. أدخل القيمة (Value) — مثل: MTIzNDU2Nzg5...
  6. اضغط "حفظ"

الوصول إلى المتغيرات في الكود

في Node.js

// باستخدام process.env
const token = process.env.TOKEN;
client.login(token);

// أو باستخدام dotenv
require('dotenv').config();
client.login(process.env.TOKEN);

في Python

import os

# باستخدام os.getenv
token = os.getenv('TOKEN')
bot.run(token)

# أو باستخدام python-dotenv
from dotenv import load_dotenv
load_dotenv()
bot.run(os.getenv('TOKEN'))

أمثلة شائعة

المفتاح الوصف
TOKEN توكن البوت من Discord Developer Portal
DATABASE_URL رابط قاعدة البيانات
API_KEY مفتاح API لخدمة خارجية
OWNER_ID معرف مالك البوت
تنبيه: لا تشارك قيم متغيرات البيئة مع أي شخص. هذه القيم حساسة وتعادل كلمة المرور.

الكونسول والسجلات

مراقبة البوت وتحكم عبر الكونسول المباشر

يوفر BotHosting Pro واجهة كونسول مباشرة تربطك بعمليات البوت في الوقت الحقيقي عبر اتصال WebSocket.

الكونسول المباشر

من تبويب "الكونسول" في لوحة التحكم، يمكنك:

  • عرض السجلات — مراقبة مخرجات البوت فوراً مع ألوان مميزة لكل نوع
  • إرسال أوامر — إدخال أوامر مباشرة للبوت عبر حقل الإدخال
  • مسح السجلات — مسح محتوى الكونسول

أنواع السجلات

النوع اللون الوصف
stdout أخضر المخرجات العادية للبرنامج
stderr أحمر رسائل الأخطاء
system أصفر رسائل النظام (بدء/إيقاف)
info أزرق معلومات إضافية

الاتصال عبر WebSocket

يتصل الكونسول بالخادم عبر WebSocket للحصول على تحديثات فورية. عند فتح تبويب الكونسول:

  1. يتم إنشاء اتصال WebSocket تلقائياً
  2. يظهر مؤشر اتصال أخضر عند الاتصال بنجاح
  3. تظهر السجلات الجديدة فوراً عند وصولها
  4. يمكنك إدخال أوامر في حقل الإدخال وإرسالها

نصائح

  • إذا حدث خطأ، تحقق من السجلات الحمراء لتحديد السبب
  • تأكد من تعيين ملف رئيسي صحيح قبل التشغيل
  • تأكد من إضافة متغيرات البيئة المطلوبة
  • إذا توقف البوت، سيتم إعادة تشغيله تلقائياً
ملاحظة: اتصال WebSocket يستخدم المسار /ws/console مع رمز مصادقة (JWT Token) للوصول الآمن.

الأسئلة الشائعة

إجابات على الأسئلة الأكثر تكراراً

كيف أحصل على حساب؟

تواصل مع الإدارة عبر سيرفر الديسكورد. سيتم إنشاء حسابك وإرسال بيانات الدخول عبر رسالة خاصة (DM) والبريد الإلكتروني.

ما هي اللغات المدعومة؟

ندعم Node.js، Python، Java، C#، Go، وRust. يمكنك استخدام أي لغة مدعومة لبناء بوت ديسكورد.

هل يتم إعادة تشغيل البوت تلقائياً؟

نعم! إذا توقف البوت بسبب خطأ أو انهيار، يتم إعادة تشغيله تلقائياً فوراً. نضمن وقت تشغيل 24/7.

كيف أحصل على توكن البوت؟

  1. اذهب إلى Discord Developer Portal
  2. أنشئ تطبيقاً جديداً أو اختر تطبيقاً موجوداً
  3. انتقل إلى قسم "Bot"
  4. اضغط "Reset Token" ثم انسخ التوكن

كيف أضيف مكتبات إضافية؟

لـ Node.js: أضف المكتبة في ملف package.json ضمن قسم dependencies.

لـ Python: أضف اسم المكتبة في ملف requirements.txt.

ستتم تثبيت المكتبات تلقائياً عند التشغيل.

ماذا يحدث إذا توقف البوت؟

يتم إعادة تشغيل البوت تلقائياً. إذا توقف عدة مرات متتالية، قد يتوقف النظام عن إعادة التشغيل تلقائياً ويُرسل لك إشعار.

كيف أشاهد أخطاء البوت؟

اذهب إلى تبويب "الكونسول" في لوحة التحكم. ستظهر جميع الأخطاء بلون أحمر مع تفاصيل الخطأ.

هل يمكنني تعديل ملفات البوت بعد الرفع؟

نعم! يمكنك تعديل أي ملف مباشرة من مدير الملفات في لوحة التحكم. افتح الملف في المحرر وعدّله واحفظ.

كيف أغير توكن البوت؟

اذهب إلى إعدادات البوت، عدّل قيمة متغير البيئة TOKEN، ثم أعد تشغيل البوت.

ما هو الحد الأقصى لحجم الملفات؟

الحد الأقصى لرفع ملف واحد هو 50 MB. إذا كان مشروعك أكبر، يمكنك تقسيمه أو استخدام ملف ZIP.

لم تجد إجابتك؟ تواصل معنا عبر سيرفر الديسكورد وسنأسعد بمساعدتك!