جديد 📢 الجمعة البيضاء: ينتهي عرض الإطلاق في 30 نوفمبر. خصم حتى 70% على شهرك الأول في كل لعبة.عرض الباقات
الجمعة البيضاءخصم حتى 70% على شهرك الأول، حتى 30 نوفمبرينتهي خلال 9 يوم 02 ساعة 49 دقيقةالجمعة البيضاءخصم حتى 70% على شهرك الأول، حتى 30 نوفمبرينتهي خلال 9 يوم 02 ساعة 49 دقيقةالجمعة البيضاءخصم حتى 70% على شهرك الأول، حتى 30 نوفمبرينتهي خلال 9 يوم 02 ساعة 49 دقيقة

كيف تستضيف بوت Discord4J على مدار الساعة 24/7

استضافة بوتات Discordحُدّث في 6 نوفمبر 202611 دقائق للقراءة

لاستضافة بوت Discord4J على مدار الساعة 24/7 تشغّله على جهاز يبقى يعمل دائمًا: إما VPS لينكس فيه خدمة systemd تعيد تشغيله حين يتوقف، وإما خطة بوتات على استضافة بوتات Discord من PlayNHost (من US$1.99 شهريًا)، حيث ترفع ملف jar واحدًا قابلًا للتشغيل وتلصق الرمز وتضغط على تشغيل. في اختبارنا استخدم بوت Discord4J 3.3.3 نحو 126 ميجابايت من الذاكرة على Java 21 وجاءه رد Discord بعد 2.6 ثانية من تشغيله. Discord4J مكتبة وليس برنامجًا، لذلك تبني بوتك أولًا في ملف jar على حاسوبك. الخطوات على PlayNHost:

  1. في صفحة استضافة بوتات Discord اضغط أنشئ سيرفرًا على خطة. في نافذة الطلب أجب عن لأي منصة بوتك؟ باختيار Discord ثم اختر Java.
  2. على حاسوبك ابنِ البوت باستخدام pom.xml الموجود أدناه: الأمر mvn package يكتب target/bot.jar وبداخله Discord4J.
  3. افتح خادمك في اللوحة. تفتح بطاقة إعداد بوتك في نظرة عامة عند الخطوة الاتصال بـ Discord. ينبغي أن تقول خطوتها الأولى ما الذي يعمل العبارة يشغّل هذا البوت Java Bot.؛ انقر هذه الخطوة للتحقق منها ثم انقر متابعة.
  4. عند الاتصال بـ Discord الصق رمزك في الصق رمز بوتك، واضغط الاتصال، ثم نعم، متابعة.
  5. عند الأذونات حدّد كودي يستخدم هذا فقط للـ intents المميزة التي يطلبها كودك (البوت أدناه لا يحتاج أيًّا منها)، واضغط إضافة إلى خادم Discord، ثم متابعة.
  6. عند كودك اضغط رفع الملفات وارفع bot.jar إلى المجلد الرئيسي.
  7. في صفحة بوت، لوحة الكود، تأكد أن ملف البدء هو bot.jar وأن بيئة التشغيل هي Java 21 (recommended)، أو Java 17 أو 25. إذا غيّرت ملف البدء فاضغط حفظ بجانبه؛ أما بيئة التشغيل الجديدة فتُحفظ فور اختيارها.
  8. اضغط تشغيل البوت وراقب Console. عندما يطبع بوتك Logged in as ... تعرض البطاقة بوتك متصل في Discord.

إنشاء البوت ورمزه مشروح في كيف تنشئ بوت Discord وتحصل على رمزه، ونوع بوت Java بوجه عام في كيف تستضيف بوت Discord بلغة Java. هذه الصفحة عن Discord4J نفسه: ما الذي يستهلكه على السيرفر وما يجب أن تعرفه قبل استضافته.

ما الذي قسناه

المكتبةالإصدارالذاكرة بعد التشغيلمن التشغيل إلى رد Discordحجم jar
Discord4J3.3.3126 ميجابايت2.6 ث37 ميجابايت
JDA6.7.091 ميجابايت1.5 ث19 ميجابايت
Java 21 وحدها، بلا مكتبة21.0.12.138 ميجابايتلا يوجد0.0 ميجابايت

الطريقة: على عقدتنا الخاصة، داخل حاوية مؤقتة مضبوطة مثل خطة بوتات بحجم 1 جيجابايت (صورة Java 21 وأمر java نفسه الذي يستخدمه نوع بوت Java لدينا)، سجّل كل بوت الدخول برمز مزيف رفضه Discord؛ الذاكرة هي الذاكرة المقيمة بعد 15 ثانية من ذلك الرد، ووقت البدء يُحسب من التشغيل حتى الرد، وكل رقم هو وسيط التشغيلات من 2 إلى 4.

هذه حدود دنيا: لا سيرفرات، ولا أعضاء في الذاكرة المؤقتة، ولا جلسة gateway مفتوحة بعد. يُضاف إليها كودك الخاص وعدد السيرفرات التي يوجد فيها بوتك، ويسمح سكربت البدء لكومة Java (heap) بالنمو حتى 80 بالمئة من الخطة (انظر أدناه). قارن الأرقام بخطط استضافة بوتات Discord واختر بحسب ما يفعله بوتك.

بوت Discord4J بسيط

يسجّل أمر سلاش /ping ويرد عليه بـ Pong! ويقرأ الرمز من DISCORD_TOKEN (الاسم الذي تعطيه اللوحة له) ويطبع سطر الجاهزية. لا يحتاج إلى أي intent مميز. ملفان:

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>bot</artifactId>
  <version>1.0</version>
  <properties>
    <maven.compiler.release>17</maven.compiler.release>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
  <dependencies>
    <dependency>
      <groupId>com.discord4j</groupId>
      <artifactId>discord4j-core</artifactId>
      <version>3.3.3</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>bot</finalName>
    <plugins>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>3.7.1</version>
        <configuration>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
          <appendAssemblyId>false</appendAssemblyId>
          <archive>
            <manifest>
              <mainClass>Bot</mainClass>
            </manifest>
          </archive>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

src/main/java/Bot.java

import discord4j.core.DiscordClient;
import discord4j.core.event.domain.interaction.ChatInputInteractionEvent;
import discord4j.core.event.domain.lifecycle.ReadyEvent;
import discord4j.discordjson.json.ApplicationCommandRequest;
import discord4j.rest.http.client.ClientException;
import reactor.core.publisher.Mono;

public class Bot {
    public static void main(String[] args) {
        String token = System.getenv("DISCORD_TOKEN");
        if (token == null || token.isBlank()) {
            System.out.println("No DISCORD_TOKEN found. Paste your bot token on the Bot page, then restart.");
            System.exit(1);
        }

        ApplicationCommandRequest ping = ApplicationCommandRequest.builder()
                .name("ping")
                .description("Replies with Pong!")
                .build();

        try {
            DiscordClient.create(token).withGateway(gateway -> {
                // Creating a command that already exists updates it, so this is safe on every start.
                Mono<Void> register = gateway.getRestClient().getApplicationId()
                        .flatMap(appId -> gateway.getRestClient().getApplicationService()
                                .createGlobalApplicationCommand(appId, ping))
                        .then();

                Mono<Void> ready = gateway.on(ReadyEvent.class, event -> Mono.fromRunnable(() ->
                        System.out.println("Logged in as " + event.getSelf().getUsername())))
                        .then();

                Mono<Void> commands = gateway.on(ChatInputInteractionEvent.class, event -> {
                    if (event.getCommandName().equals("ping")) {
                        return event.reply("Pong!");
                    }
                    return Mono.empty();
                }).then();

                return register.and(ready).and(commands);
            }).block();
        } catch (RuntimeException e) {
            if (ClientException.isStatusCode(401).test(e)) {
                System.out.println("Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart.");
            } else {
                e.printStackTrace();
            }
            System.exit(1);
        }
    }
}

ابنِه باستخدام Maven 3.9 وJDK 17 أو أحدث:

mvn package
java -jar target/bot.jar

السطر الثاني اختبار على حاسوبك: بلا رمز يطبع No DISCORD_TOKEN found. ويتوقف، وهذا يثبت أن ملف jar يبدأ ويجد فئته الرئيسية. ارفع target/bot.jar. الإعداد jar-with-dependencies في maven-assembly-plugin يضع Discord4J وكل ما يحتاجه في ملف jar الواحد هذا؛ ومستخدمو Gradle يحصلون على النتيجة نفسها بإضافة Shadow. والقيمة maven.compiler.release 17 تنتج ملف jar يعمل على إصدارات Java الثلاثة التي تتيحها اللوحة.

السطر Logged in as ... هو ما يحوّل الشارة في نظرة عامة إلى متصل في Discord. ادعُ البوت عبر إضافة إلى خادم Discord قبل أن تجرب /ping: كيف تدعو بوت Discord إلى سيرفر.

إذا كان الرمز خاطئًا

في اختبارنا، مع رمز مزيف، فشل تسجيل دخول Discord4J بهذا الخطأ:

ClientException: GET /gateway/bot returned 401 Unauthorized with response {code=0, message=401: Unauthorized}

البوت أعلاه يلتقط الرمز المرفوض (HTTP 401) ويطبع Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart. بدل تتبّع الأخطاء، ثم يتوقف برمز الخروج 1. وعندما شغّلناه برمز مزيف ظهرت أولًا ثلاثة أسطر تحذير SLF4J: يبدأ أولها بـ SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".؛ وهي تخص التسجيل وليس الرمز (انظر السجلات أدناه). للإصلاح افتح Discord Developer Portal ثم تطبيقك ثم Bot واضغط Reset Token؛ يعرض Discord الرمز الجديد مرة واحدة فقط. في صفحة بوت لدينا، لوحة Discord، اضغط استبدال الرمز والصقه، ثم اضغط حفظ الرمز، ثم إعادة التشغيل الآن. وعندما يرفض Discord فحص الرمز المحفوظ تعرض اللوحة لم يقبله Discord.

ما يجب معرفته عن Discord4J على السيرفر

  • الإصدارات: صدر Discord4J 3.3.3 في 19 أغسطس 2026. فرع 3.3 هو الحالي، أما 3.2 فيتلقى الصيانة فقط. Discord4J 3.3.3 مترجم لـ Java 8، لذلك تشغّله أي بيئة التشغيل تتيحها اللوحة (Java 17 أو 21 أو 25)؛ ابنِه بقيمة release لا تزيد على البيئة التي تختارها.
  • ملف jar واحد ولا شيء يُثبَّت على السيرفر. نوع بوت Java ليس له مصدر Git ولا حقل الحزم: يشغّل java -jar على ملف البدء لديك، لذلك يجب أن يكون كل ما يستخدمه بوتك داخل ملف jar. ولتحديث البوت ارفع ملف jar جديدًا.
  • حد الذاكرة: يشغّل سكربت البدء Java بالخيار -XX:MaxRAMPercentage=80.0 ومجمّع النفايات G1، فيمكن للـ heap استخدام حتى 80 بالمئة من ذاكرة خطتك ويبقى للعملية مجال. وإذا امتلأ الـ heap تطبع Java الرسالة java.lang.OutOfMemoryError وتعرض اللوحة نفدت ذاكرة بوتك.
  • الـ intents: يتصل Discord4J بكل الـ intents غير المميزة ما لم تختر غيرها. مثال !ping في README الخاص بـ Discord4J يقرأ نص الرسائل، وهذا يتطلب الـ intent المميز Message Content: فعّله في Developer Portal واطلبه في الكود بـ DiscordClient.create(token).gateway().setEnabledIntents(IntentSet.nonPrivileged().or(IntentSet.of(Intent.MESSAGE_CONTENT))) وحدّد كودي يستخدم هذا له في خطوة الأذونات لدينا. بدونه يرسل Discord إلى البوت نص رسالة فارغًا، إلا في الرسائل المباشرة والرسائل التي تذكر البوت. وأمر السلاش، كما في الأعلى، لا يحتاج إلى شيء من هذا. انظر إصلاح خطأ «Used disallowed intents» في بوت Discord.
  • السجلات: يسجّل Discord4J عبر Reactor الذي يستخدم SLF4J حين يكون SLF4J داخل ملف jar، وDiscord4J يجلب SLF4J معه. وبلا مكتبة تسجيل خلفه، كما في pom.xml أعلاه، يطبع SLF4J ثلاثة أسطر تحذير عند البدء، آخرها SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.، ثم يتخلص من أسطر سجل Discord4J نفسه بما فيها الأخطاء. أما أسطر System.out لديك فتظهر في Console كالمعتاد. ولرؤية أسطر Discord4J أضف مكتبة تسجيل؛ وتوصي وثائق Discord4J بـ Logback.
  • اجعل main() ينتظر. Discord4J تفاعلي: تسجيل دخوله هو Mono لا يتصل إلا حين يشترك فيه شيء. أمثلة README الخاصة به تنهي main() بـ gateway.onDisconnect().block() أو بـ block() على withGateway(...)، وكلاهما ينتظر ما دام البوت متصلًا. والبوت أعلاه يستخدم withGateway(...).block().
  • تسجيل الأوامر عند كل تشغيل لا مشكلة فيه. يعامل Discord إنشاء أمر باسم يستخدمه تطبيقك بالفعل على أنه تحديث لذلك الأمر، لذا لا يكدّس البوت أعلاه نسخًا من /ping.
  • الأعطال: عندما يخرج البوت، كما يفعل البوت أعلاه مع رمز مرفوض، تشغّله اللوحة من جديد فورًا. وإذا توقف مرة أخرى خلال دقيقة من ذلك يبقى متوقفًا وتوضح Console السبب.

استضفه بنفسك على VPS لينكس

لا يحتاج VPS إلا إلى بيئة Java، لأنك تبني ملف jar على حاسوبك. على Debian 13 أو Ubuntu 24.04 ثبّت Java 21؛ أما Debian 12 فيأتي بـ Java 17 التي تشغّل ملف jar أعلاه أيضًا:

sudo apt update
sudo apt install openjdk-21-jre-headless
java -version

أنشئ مستخدمًا للبوت وانسخ ملف jar إلى السيرفر (مثلًا بالأمر scp) ثم إلى مجلده:

sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp bot.jar /opt/mybot/
sudo chown -R mybot: /opt/mybot

أبقِ الرمز خارج كودك، في ملف لا يقرؤه إلا root:

sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env

أنشئ الملف /etc/systemd/system/mybot.service:

[Unit]
Description=Discord4J bot
Wants=network-online.target
After=network-online.target

[Service]
User=mybot
WorkingDirectory=/opt/mybot
EnvironmentFile=/etc/mybot.env
ExecStart=/usr/bin/java -XX:MaxRAMPercentage=80.0 -jar /opt/mybot/bot.jar
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

شغّله الآن وعند كل إقلاع، ثم تابع مخرجاته:

sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f

الإعداد Restart=always يشغّل البوت من جديد بعد 5 ثوانٍ من خروجه أو انهياره، لكن ليس بعد أن توقفه بالأمر systemctl stop. وعلى VPS فإن -XX:MaxRAMPercentage نسبة من ذاكرة الجهاز كله، فخفّضه إذا كانت هناك برامج أخرى تعمل عليه. وللتحديث انسخ ملف jar الجديد فوق القديم ونفّذ sudo systemctl restart mybot.

الاستضافة الذاتية أم خطة بوتات

على VPS تديره بنفسك يقع عليك:

  • تحديثات نظام التشغيل وأمانه، وترقيات Java.
  • نسخ كل ملف jar جديد، وملف الخدمة، وملف الرمز وأذوناته.
  • قراءة journalctl لمعرفة سبب توقف البوت.
  • النسخ الاحتياطية لكل ما يخزنه بوتك.

وفي المقابل يشغّل VPS أي شيء تثبّته عليه.

وعلى خطة بوتات من PlayNHost تقوم اللوحة بهذا نيابة عنك:

  • Java 17 أو 21 أو 25 من قائمة اختيار، مع ضبط حد الـ heap ومجمّع النفايات.
  • الرمز، يُفحص مع Discord قبل حفظه ويُخزَّن مشفرًا ويُسلَّم إلى كودك باسم DISCORD_TOKEN.
  • رابط دعوة بالأذونات التي تختارها، وبطاقة الأذونات المميزة (Privileged intents) تتحقق من المفعّل منها في Developer Portal لديك.
  • إعادة تشغيل البوت بعد الانهيار، ولافتة فوق Console حين تنفد ذاكرته.
  • الرفع من المتصفح والنسخ الاحتياطية من اللوحة.

أسئلة يطرحها الناس

بوت Discord4J الخاص بي متصل لكن !ping لا يفعل شيئًا. لماذا؟

لأن نص الرسالة فارغ. يطلب Discord4J افتراضيًا الـ intents غير المميزة فقط، وقراءة نص الرسائل في السيرفرات تتطلب Message Content وهو intent مميز. فعّله في Developer Portal واطلبه بالطريقة setEnabledIntents كما هو مبين أعلاه، أو استخدم أمر سلاش مثل /ping في البوت الموجود في هذه الصفحة، وهو لا يحتاج إلى intent مميز.

Discord4J أم JDA على PlayNHost؟

كلاهما يعمل على نوع بوت Java نفسه ومن نوع ملف jar نفسه. الجدول أعلاه يضم الذاكرة التي قسناها لكل منهما. الفرق الحقيقي في الأسلوب: Discord4J مبني على Reactor، فتسلسل Mono وFlux، بينما تستخدم JDA المستمعين والـ callbacks. اختر ما تجد كوده أسهل قراءة. خطوات JDA: كيف تستضيف بوت Discord بلغة Java.

أي إصدار من Java أختار لـ Discord4J؟

Java 21، وهو الموصى به، إلا إذا احتاج كودك إلى 25. يعمل Discord4J نفسه من Java 8 فما فوق، لذلك الحد هو قيمة release التي تبني بها: ملف jar مبني لإصدار Java أحدث من الذي يشغّله السيرفر يتوقف بالخطأ UnsupportedClassVersionError. اختر بيئة التشغيل أحدث، أو ابنِ بقيمة release أقل.

لماذا ملف jar لـ Discord4J كبير جدًا؟

لأنه يحوي كل شيء: يجلب Discord4J معه Reactor وNetty وJackson ووحدات الصوت الخاصة به، والبناء بـ jar-with-dependencies يضمها كلها. وكان حجم ملف jar في اختبارنا 37 ميجابايت. هذه مساحة قرص من خطتك؛ أما الذاكرة التي استخدمها البوت أثناء التشغيل فهي في الجدول أعلاه.

هل أنت مستعد لتشغيل بوت Discord4J طوال الوقت؟ اطلع على الخطط في استضافة بوتات Discord.

بوتك مستضاف في مكان آخر بالفعل؟ انقله إلينا

أحدث مقالات المدونة