انتقل إلى الدليل

الوثائق 9.6.24

الترخيص والتحديث

احتفظ بالترخيص سريًا واحذف الرموز من لقطات الشاشة.

على الخادم فقط#

استخدم server.cfg. لا تضع الترخيص في إعداد مشترك أو NUI أو أحداث العميل أو المستودعات العامة. رموز الرفع لا تستبدل ترخيص الخادم.

اقرأ دليل Cfx الرسمي

جدّد المفاتيح القديمة#

استبدل الملفات بحزمة 9.6.24 وأعد تشغيل الموارد أثناء الصيانة. قد تكون الإصدارات القديمة أرسلت مفاتيح طويلة الأجل للعملاء. أوقف جميع النسخ القديمة، ثم جدّد التراخيص ومفاتيح اللوحة/API القديمة المتأثرة بالتنسيق مع المسؤول. حدّث الإعدادات وتحقق من الاتصال. تثبيت التحديث وحده لا يلغي المفاتيح التي كُشفت سابقًا.

مفتاح الترخيص إلزامي#

الحزم التي نُزّلت اعتبارًا من 7 أكتوبر 2026 لا تشغّل مكافح الغش دون مفتاح ترخيص هذا الخادم. بدون مفتاح، أو بمفتاح خادم آخر، يرفض الخادم اللاعبين ويفصل المتصلين ويكتب السبب في وحدة التحكم.

انسخ المفتاح من صفحة الخوادم في اللوحة وأضفه إلى server.cfg قبل أسطر ensure: set tosun_ac_license "ترخيص_الخادم". يعمل حقل licenseKey في configs/anticheat_server.lua أيضًا. المفتاح المُدخل لاحقًا (سطر متأخر في server.cfg أو set في وحدة التحكم) يفتح الخادم دون إعادة تشغيل.

إذا جدّدت الترخيص في اللوحة فلن تطابق الحزمة القديمة المفتاح الجديد؛ نزّل الحزمة وثبّتها من جديد.

اختيار بيانات الاعتماد المناسبة#

رخصة Tosun تعرّف الخادم المسجل وتختلف عن sv_licenseKey في FiveM. قد تملك مفاتيح المكونات نطاقات صلاحيات منفصلة. بيانات رفع الأدلة قصيرة العمر ومخصصة للرفع؛ لا تمنح إدارة اللوحة أو تشغيل جسر القاعدة.

اختر الخادم في Servers وضع رخصته الحالية باستخدام set في server.cfg. استبدل النص التجريبي بقيمتك. لا تضعها في NUI أو Lua المشترك أو الخاص بالعميل أو مستودع عام. يستخدم الجسر الرخصة نفسها، وتظل إجراءات اللوحة محتاجة لصلاحيات الحساب.

set tosun_ac_license "YOUR_SERVER_LICENSE"

التحقق من النسخة التي تعمل فعلياً#

انسخ المورد والإعدادات، نزّل الحزمة الصحيحة وقارن تعليمات التكامل، واستبدلها أثناء الصيانة. تأكد من وجود نسخة نشطة واحدة؛ وضع ملفات جديدة في مجلد آخر لا يوقف المورد القديم.

فحص الصيغة المحلي أو license-lock ليس دليلاً على الدفع. عند الإبلاغ عن حساب غير نشط أو خادم موقوف راجع الاشتراك والحالة الفعلية. لا تخفِ خطأ التوثيق بإيقاف الحماية.

  1. قارن إصدار manifest ورسائل البدء بالحزمة التي نزّلتها.
  2. انقل الإعدادات المدعومة واختبر النقل والمخزون وأدوات الموظفين.
  3. بدءًا من 9.6.14 يكون اتصال اللوحة وتعديل أرصدة اللاعبين المتصلين مفعّلين افتراضيًا. تُتجاهل الأسطر القديمة set tosun_db_bridge_enabled وset tosun_db_bridge_money_write ويمكن حذفها؛ الحزم الأقدم من 9.6.14 ما زالت تحتاجها. إذا كنت قد أوقفت الاتصال أو تعديل الأرصدة سابقًا فاستخدم «Disable connection» في بطاقة Tosun Connect للخادم أو الوضع اليدوي (set tosun_db_bridge_manual "1") الذي تُطبَّق فيه قيم server.cfg كما في السابق. تحقق من الاتصال بقراءة صغيرة واختبر اللعب العادي قبل أن يعدّل الموظفون الأرصدة.

تغيير المفتاح المكشوف#

الملفات الجديدة لا تلغي رخصة منشورة أو مرسلة سابقاً للعملاء. أعد توليد الرخصة في Servers وحدّث الإعداد المحمي وتحقق من الاتصال. نسّق تغيير مفاتيح اللوحة وAPI الأخرى مع المسؤول.

عند التأخر راجع الفاتورة وإجراء الدفع في Billing. تغيير المفتاح لا يصلح الدفع. إذا كانت نتيجة المزود غير واضحة افحص الفاتورة قبل الدفع مجدداً؛ أرسل المرجع والخطأ المنقح دون الرخصة.

  • حدّد جميع النسخ والتكاملات التي تستخدم المفتاح وأوقف القديمة قبل تغييره.
  • أزل الأسرار من التاريخ العام والصور والنسخ المفتوحة ومرفقات الدعم حيث أمكن.
  • احفظ المفتاح الحالي في الإعداد الضروري فقط، دون أوامر تشخيص مشتركة.
  • سجّل ID الخادم والوقت والخطأ المنقح؛ راجع الخادم والاشتراك قبل طلب مفتاح آخر.

خطّط لتجديد المفتاح ضمن الصيانة#

طابق اسم الخادم ومعرّفه المحددين في اللوحة مع التثبيت الجاري. دوّن وقت بدء الخطأ وإصدار المورد والأشخاص الذين يمكنهم قراءة إعداداته. تأخر الاشتراك واختيار خادم آخر وفشل الشبكة أسباب مختلفة تحتاج إلى حلول مختلفة. فشل الاتصال وحده لا يثبت تسرب المفتاح، ولا يستدعي إنشاء مفاتيح متتابعة.

عند الحاجة استخدم تجديد الترخيص للسجل المحدد في قسم الخوادم. يتغير مفتاح السجل نفسه؛ لا تحتاج إلى إنشاء خادم إضافي واستهلاك الحصة. أوقف النسخ والتكاملات الخاصة التي تستخدم القيمة القديمة، وحدّث server.cfg المحمي ثم أعد التشغيل وفق خطة الصيانة. لا تضع القيمة طويلة الأجل في شيفرة المتصفح أو الملفات العامة.

احتفظ بهوية الخادم عند إعادة التثبيت#

إعادة تثبيت ملفات المورد تختلف عن حذف سجل الخادم من اللوحة. عند تلف الملفات نزّل حزمة الخادم الموجود الصحيح مرة أخرى، واحتفظ بنسخة مستقلة من الإعدادات القابلة للتعديل. ضع المجلد القديم خارج مسار الموارد النشطة؛ تشغيل نسختين يصعّب معرفة الإعداد المستخدم فعلياً.

قارن إصدار ملف manifest وترتيب الاعتماديات والإعداد المحلي. بعد التشغيل راجع حالة الخادم المقابل في اللوحة. إذا كان جسر البيانات مفعلاً تكفي قراءة صغيرة للتحقق من التفويض؛ لا تعدّل رصيداً لهذا الغرض. اقبل التثبيت بعد تأكيد السجل الصحيح ونسخة نشطة واحدة والإصدار المتوقع وإتمام سيناريوهات اللعب المعتادة.

سجّل مشكلة الاتصال دون أسرار#

أضف إلى طلب الدعم معرّف الخادم والإصدار ووقت أول خطأ وآخر اتصال ناجح وتسلسل التغييرات. ميّز رفض التفويض من تعذر الشبكة. احذف الترخيص وترويسات Authorization وسلاسل اتصال قاعدة البيانات والمعلومات الشخصية قبل مشاركة السجل. أرسل المقطع الضروري بدلاً من نسخة احتياطية خاصة كاملة.

لا تُعد استخدام المفتاح القديم المسرب بعد التجديد. عند التراجع عن الملفات انقل المفتاح الساري إلى الإعداد المستعاد. أصلح مصدر التسرب أيضاً، مثل مستودع عام؛ تغيير المفتاح مع إبقاء المصدر مكشوفاً يعيد المشكلة. اختم بملاحظة مؤرخة تؤكد الاتصال وإيقاف النسخ القديمة وإزالة صلاحيات الوصول غير الضرورية.

اقرأ جلسات الترخيص عند نقل الجهاز#

أوقف النسخة القديمة قبل النقل. قارن البصمة وآخر IP والإصدار والنشاط في جلسات صفحة التنزيل بسجل النقل. هذه تثبيتات الخادم لا جلسات اللاعبين. تحرير صف خاطئ يؤثر في تثبيت آخر؛ لا تحذف الجميع لوجود عدة صفوف. إضافة خادم لوحة لا تستبدل إدارة الجلسة وقد تستهلك حصة مختلفة.

بعد الإيقاف حرر الجلسة القديمة الصحيحة من اللوحة. النسخة المستمرة قد تسجل مجدداً لاحقاً، لذا الإيقاف مهم. السياسة الحالية قد تفرغ جلسات نشطة بلا اتصال بعد قرابة عشرين دقيقة؛ الملغاة صراحة لا تنتهي تلقائياً. في seat_taken افحص الاستخدام والصف الصحيح دون خلط license_rotated أو الاشتراك. تحقق من الجهاز الجديد بالبداية والجلسة والاتصال الطبيعي.

الحزم التي نُزّلت قبل 7 أكتوبر 2026 قد ترسل بصمة خادم مختلفة في كل فحص للترخيص. فيعدّ الخادم جلسته جلسةَ خادم ثانٍ، ويتلقى seat_taken، ويتوقف عن قبول اللاعبين بعد دقائق من كل تشغيل ("Lisans dogrulanamadi"). خدمة الترخيص تقبل هذه الحزم مجددًا حتى 5 نوفمبر 2026: أعد تشغيل المورد مرة واحدة، ثم نزّل الحزمة من جديد قبل هذا التاريخ للحصول على عميل الترخيص المصحح.

افهم Build ID وlicense_rotated معاً#

Build ID يحدد الحزمة الموزعة لا الترخيص. طابق إصدار الملف وبادئة Build ID مع السجل. حزمة خادم آخر لا تصبح صحيحة باسم مشابه. unknown_build وrevoked وlicense_mismatch وlicense_rotated فحوص ربط مختلفة؛ إنشاء مفتاح لكل رسالة يخفي السبب. احتفظ بالنتيجة الدقيقة دون معلومات خاصة.

التجديد في الخوادم يترك الحزم القديمة مرتبطة بملخص الترخيص السابق. تغيير server.cfg وحده لا يحدث الرابط. نزّل حزمة حالية من سجل الخادم الصحيح نفسه وحدّث الإعداد المحمي. لا تفترض صلاحية حزمة مفتاح قديم عند الرجوع. السجل يتتبع التوزيع ولا يثبت شخصاً شاركها. افحص الحزمة والمفتاح والنتيجة الحالية معاً والفوترة منفصلة.

فهم حدود طبقات الحماية#

لا تتطلب الحزمة حساب Tebex أو Asset Escrow؛ ترخيص خادم Cfx.re المعتاد شرط منفصل. يحمي AES-256-GCM ملف ZIP المخزن، ولا يخفي الملفات عن مالك خادم اللعبة بعد تنزيلها.

يتحقق Ed25519 من ردود الترخيص الموقّعة، ولا يُوزع مفتاح التوقيع الخاص. يكشف SHA-256 التغييرات ولا يشفّر المحتوى. تمويه Lua قابل للعكس. يساعد Build ID في تحديد سجل التوزيع لكنه لا يثبت هوية من سرّب الحزمة. تعطل الشبكة ليس رفض ترخيص موثّقاً.

تجهيز التحديث والعودة#

احفظ نسخة خاصة من configs وadmins وeditable وbridge وملفات اللغة وserver.cfg. نزّل للخادم نفسه. قد تحتفظ حزمة مخبأة صالحة بنفس Build ID؛ التنزيل لا يجدد الاشتراك ولا يبدّل الترخيص.

قارن الإعدادات ولا تستبدل الملف المشترك الجديد بالكامل بالقديم. أبق الأسرار على الخادم ولا تعدّل النواة المحمية. اختبر التشغيل ودخول لاعب عادي وقراءة صغيرة من اللوحة. بعد تبديل الترخيص قد تبقى الحزمة القديمة غير صالحة حتى مع تحديث server.cfg.

انسخ ترخيص Tosun للخادم الصحيح#

افتح قسم الخوادم في TosunDev واختر خادم FiveM الخاص بك ثم انسخ ترخيص Tosun AC لهذا السجل. القيمة tac_live_ ليست ترخيص Cfx.re أو sv_licenseKey أو رمز Discord أو مفتاح API للوحة.

  1. استبدل YOUR_SERVER_LICENSE داخل علامتي الاقتباس في server.cfg بترخيصك.
  2. ضع tosun_ac_license قبل ensure tosun-ac؛ استخدم set فقط، وليس setr أو sets.
  3. يمكن بدلاً من ذلك ضبط credentials.licenseKey في configs/anticheat_server.lua. لقيمة convar غير الفارغة الأولوية.
  4. لا تنشر الترخيص في الصور أو المحادثات أو shared config أو ملفات العميل.
set tosun_ac_license "YOUR_SERVER_LICENSE"
# Alternative: configs/anticheat_server.lua
# credentials.licenseKey = "YOUR_SERVER_LICENSE"