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

كيف تحصل على privilege key جديد لمشرف خادم TeamSpeak

Mumble وسيرفرات الصوتحُدّث في 21 نوفمبر 20266 دقائق للقراءة

الجواب باختصار. يطبع خادم TeamSpeak الجديد ServerAdmin privilege key (سطر يبدأ بـ token=) في أول مرة يعمل فيها، في وحدة التحكم وفي سجل الخادم الافتراضي 1. المفتاح يعمل مرة واحدة فقط. لإنشاء مفتاح جديد في TeamSpeak 3 سجّل الدخول إلى ServerQuery باسم serveradmin ونفّذ privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0؛ وفي TeamSpeak 6 أرسل الأمر نفسه إلى استعلام HTTP مع مفتاح API. فقدت كلمة مرور ServerQuery أيضًا؟ شغّل TeamSpeak 3 مرة واحدة مع serveradmin_password=، أو TeamSpeak 6 مع --query-http-enable و--query-admin-api-key. أنشأنا مفاتيح جديدة بهذه الطريقة على TeamSpeak 3 server 3.13.8 وTeamSpeak 6 server v6.0.0-beta13.1 في 6 نوفمبر 2026. صدر TeamSpeak 6 server v6.0.0-beta14 في 17 نوفمبر 2026؛ ولم نكرر هذه الخطوات عليه.

ما هو privilege key

يقول دليل TeamSpeak نفسه (doc/privilegekey_guide.txt في تنزيل TeamSpeak 3) إن خادم TeamSpeak 3 لا يملك أسماء مستخدمين ولا كلمات مرور: فهو يتعرف على الأشخاص عبر معرّف فريد مأخوذ من زوج مفاتيح ينشئه عميلهم. لذلك يحتاج أول مشرف إلى تذكرة: هي privilege key. ويستخدم TeamSpeak 6 النوع نفسه من المفاتيح. لصقه في عميل TeamSpeak يضع تلك الهوية في مجموعة Server Admin في الخادم الافتراضي الذي أُنشئ المفتاح له. ويقول الدليل نفسه إن المفتاح لا يُستخدم إلا مرة واحدة.

اعثر على مفتاح التشغيل الأول

عند التشغيل الأول يطبع الإصداران السطرين نفسيهما:

ServerAdmin privilege key created, please use the line below
token=...
  • TeamSpeak 3 على Linux: يكتبه الخادم في سجل الخادم الافتراضي 1، وهو الملف في logs/ الذي ينتهي اسمه بـ _1.log:
    grep token= logs/*_1.log
  • TeamSpeak 6 مع Docker:
    docker logs teamspeak-server 2>&1 | grep token=
  • TeamSpeak 6 بدون Docker: الأمر grep نفسه كما في TeamSpeak 3، في مجلد logs/ الخاص بالخادم.

يطبع التشغيل الأول أيضًا بيانات دخول ServerQuery داخل إطار في وحدة التحكم: loginname= "serveradmin", password= "..." وapikey. احتفظ بها في مكان آمن. تُطبع في التشغيل الأول فقط، وهي ما تستخدمه لإنشاء مفتاح جديد.

أنشئ مفتاحًا جديدًا في TeamSpeak 3

نفّذ هذا على الجهاز الذي يعمل عليه الخادم. يستمع ServerQuery على المنفذ TCP رقم 10011، وينبغي ألا يكون مفتوحًا على الإنترنت.

  1. اتصل بـ ServerQuery بعميل TCP بسيط. يذكر دليل ServerQuery من TeamSpeak برنامج Telnet (على Debian أو Ubuntu: sudo apt install telnet إذا لم يكن مثبتًا):
    telnet 127.0.0.1 10011
  2. سجّل الدخول، واختر الخادم الافتراضي 1، وأنشئ المفتاح:
    login serveradmin YOUR_QUERY_PASSWORD
    use sid=1
    privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
    quit
  3. يرد الخادم بـ token=... متبوعًا بـ error id=0 msg=ok. الصق الرمز (token) في عميل TeamSpeak. يهرّب ServerQuery الشرطة المائلة في ردوده على الشكل \/، لذا إذا ظهر الرمز بالشكل \/ فاكتبه /.

tokenid1=6 هو مجموعة Server Admin في خادم افتراضي جديد: والمفتاح الذي ينشئه الخادم عند أول تشغيل يشير إلى المجموعة 6 أيضًا. إذا أعدت تسمية مجموعاتك أو بنيتها من جديد، فنفّذ servergrouplist بعد use sid=1 وخذ sgid لمجموعة المشرف التي تحمل type=1. المجموعات ذات type=0 قوالب، وذات type=2 مجموعات ServerQuery.

فقدت كلمة مرور ServerQuery

يقول دليل البدء السريع من TeamSpeak إن الطريقة الوحيدة للحصول على كلمة مرور جديدة هي حذف قاعدة بيانات الخادم. في الإصدار 3.13.8 توجد طريقة ألطف: شغّل الخادم مرة واحدة مع كلمة مرور جديدة كمعامل تشغيل. يمرر سكربت التشغيل المعاملات إلى الخادم. استخدم الحروف والأرقام فقط، لأن ServerQuery يعامل المسافات وبعض الرموز كمحارف خاصة:

./ts3server_startscript.sh stop
./ts3server_startscript.sh start serveradmin_password=PICK_A_NEW_PASSWORD

في اختبارنا قال السجل بعد ذلك updated server query admin password ونجح تسجيل الدخول بكلمة المرور الجديدة. أنشئ مفتاحك الجديد كما سبق أثناء عمل الخادم، ثم أعد تشغيله بالطريقة المعتادة.

أنشئ مفتاحًا جديدًا في TeamSpeak 6

لا يملك TeamSpeak 6 واجهة ServerQuery نصية على المنفذ 10011: يسرد ملف CONFIG.md الخاص به واجهات استعلام SSH وHTTP وHTTPS، وكلها معطلة افتراضيًا. يستخدم استعلام HTTP مفتاح API تحدده عند التشغيل.

  1. أعد تشغيل الخادم مع تفعيل استعلام HTTP ومفتاح API من اختيارك:
    ./tsserver --accept-license --query-http-enable --query-admin-api-key PICK_A_LONG_RANDOM_KEY
    يستمع استعلام HTTP بعد ذلك على TCP 10080 على جميع العناوين (0.0.0.0)، لذا تأكد من أن جدار الحماية يحجب هذا المنفذ عن الإنترنت.
  2. على الجهاز نفسه اطلب مفتاحًا للمجموعة 6:
    curl -H "x-api-key: PICK_A_LONG_RANDOM_KEY" "http://127.0.0.1:10080/1/privilegekeyadd?tokentype=0&tokenid1=6&tokenid2=0"
  3. الرد بصيغة JSON: {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. الصق الرمز (token) في عميل TeamSpeak. يضيف سجل الخادم سطرًا يقول إن serveradmin أضاف privilege key لمجموعة الخادم Server Admin.
  4. أعد التشغيل بدون --query-http-enable إذا لم تكن بحاجة إلى استعلام HTTP.

مع Docker، أعد إنشاء الحاوية بمتغيري بيئة مع نشر منفذ استعلام HTTP على 127.0.0.1 فقط، حتى لا يمكن الوصول إليه من الإنترنت. تبقى بياناتك في الحجم:

docker rm -f teamspeak-server
docker run -d \
  --name teamspeak-server \
  -p 9987:9987/udp \
  -p 30033:30033 \
  -p 127.0.0.1:10080:10080 \
  -e TSSERVER_LICENSE_ACCEPTED=accept \
  -e TSSERVER_QUERY_HTTP_ENABLED=1 \
  -e TSSERVER_QUERY_ADMIN_API_KEY=PICK_A_LONG_RANDOM_KEY \
  -v teamspeak-data:/var/tsserver/ \
  teamspeaksystems/teamspeak6-server:latest

ثم نفّذ curl نفسه كما في الخطوة 2. استخدم متغيرات البيئة هنا لا خيارات بعد اسم الصورة: أمر الصورة هو tsserver، لذا فإن أي شيء بعد اسم الصورة يستبدله، وفي اختبارنا لم يستجب استعلام HTTP عندما جرّبناه بهذه الطريقة. أعد إنشاء الحاوية بدون متغيري الاستعلام وبدون المنفذ 10080 عندما لا تحتاج إلى استعلام HTTP بعد الآن. يضبط --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD) كلمة مرور حساب الاستعلام serveradmin؛ واستعلام HTTP أعلاه لا يحتاج إليها (اختبار Docker لدينا ضبط مفتاح API فقط)، واستعلام SSH معطل إلى أن تضيف --query-ssh-enable.

المفتاح يقول إنه غير صالح

  • استُخدم من قبل. كل مفتاح يعمل مرة واحدة. يسرد privilegekeylist (TeamSpeak 3) أو /1/privilegekeylist (TeamSpeak 6) المفاتيح التي ما زالت متاحة.
  • هو لخادم افتراضي آخر. المفتاح يعمل فقط على الخادم الافتراضي الذي أُنشئ له.
  • استعلام HTTP يرد بـ invalid apikey. الترويسة x-api-key لا تطابق المفتاح الذي بدأ به الخادم.
  • لم يُنسخ جزء منه. قد يحتوي المفتاح على + و/. انسخ كل ما يلي token=.

استضافة TeamSpeak بنفسك

الإعداد الكامل وحدود الترخيص ومقدار الذاكرة التي يحتاج إليها الخادم: كيف تستضيف خادم TeamSpeak. تؤجّر PlayNHost خوادم Mumble الصوتية لا TeamSpeak؛ وفي Mumble يستخدم أول مشرف كلمة مرور SuperUser من اللوحة بدلًا من مفتاح: كيف تصبح أدمن على سيرفر Mumble الخاص بك.

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

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