ضع مفاتيح بوتك وإعداداته في صفحة البوت، قسم البيئة: أضفها واحدًا واحدًا أو الصق ملف .env كاملًا، وحدّد إبقاء هذه القيمة سرية لكلمات المرور والمفاتيح، ثم أعد تشغيل البوت. يقرؤها كودك كأي متغير بيئة.
لماذا هنا وليس في ملف
- تُخزَّن القيم المحفوظة هنا مشفّرة لدى اللوحة، لا في ملفات سيرفرك. ولا تظهر في Files ولا عبر SFTP ولا في النسخ الاحتياطية.
- القيمة السرية لا تظهر مرة أخرى أبدًا، لا لك ولا لمن تمنحه صلاحية: تعرض القائمة نقاطًا وآخر أربعة أحرف منها.
- تستطيع مشاركة كودك، أو وضعه على GitHub، دون تسريب مفتاح.
أضف متغيرًا واحدًا
- افتح سيرفر بوتك في لوحة التحكم، ثم صفحة البوت، قسم البيئة.
- تحت إضافة متغير، اكتب الاسم، مثل
OPENAI_API_KEY، والقيمة. - يتحدد إبقاء هذه القيمة سرية من تلقاء نفسه للأسماء التي تبدو أسرارًا (التي تنتهي بـ
KEYأوTOKENأوSECRETأوPASSWORDوما شابهها، أو رابط قاعدة بيانات). حدّده أو ألغِ تحديده حسب حاجتك. - اضغط إضافة متغير.
- يقول القسم تُطبَّق التغييرات عند تشغيل البوت في المرة القادمة. إذا كان البوت يعمل، فاضغط إعادة التشغيل الآن.
الصق ملف .env كاملًا
- اضغط لصق ملف .env.
- الصق محتويات ملف
.envعندك. لا يُرسل شيء بعد: تسرد النافذة الأسماء التي وجدتها، مع شارة سر على ما ستحفظه أسرارًا. - الأسماء التي لن تقبلها اللوحة تُعلَّم بـ تم التخطي: رمز البوت بأي من أسمائه (
DISCORD_TOKENوTOKENوBOT_TOKENوDISCORD_BOT_TOKEN)، وGIT_TOKEN، وإعدادات نوع بوتك نفسها (مكانها قسم الكود)، وأسماء النظام مثلPATH، والأسماء التي تغيّر طريقة بدء بيئة التشغيل مثلPYTHONPATHأوNODE_PATHأو أي اسم يبدأ بـLD_. وتقول ملاحظة أين مكانها. والأسطر التي لا يمكن قراءتها إطلاقًا تُسرد مع أرقام أسطرها. - اضغط زر الاستيراد، مثل استيراد 6 متغير. الأسطر المتخطاة لا تدخل في العدد.
تعمل صيغ .env المعتادة: KEY=value وexport KEY=value والتعليقات والقيم بين علامتي اقتباس 'single' أو "double" (وقد تمتد علامات الاقتباس المزدوجة على عدة أسطر). وإذا ظهر اسم مرتين فالأخير هو الذي يُعتمد.
اقرأها في كودك
| اللغة | الكود |
|---|---|
| Node.js وBun | process.env.OPENAI_API_KEY |
| Python | os.environ["OPENAI_API_KEY"] |
| Java | System.getenv("OPENAI_API_KEY") |
| C# | Environment.GetEnvironmentVariable("OPENAI_API_KEY") |
| Deno | Deno.env.get("OPENAI_API_KEY") |
| Go | os.Getenv("OPENAI_API_KEY") |
| Rust | std::env::var("OPENAI_API_KEY") |
كودك يستخدم dotenv أو python-dotenv أصلًا؟ يظل يعمل: لا تستبدل هاتان المكتبتان متغيرًا مضبوطًا مسبقًا، فتتغلب قيم اللوحة على ملف .env متبقٍّ.
غيّر متغيرًا أو أزله
- للقيمة العادية تعديل، وللسر استبدال. يبدأ السر فارغًا لأن قيمته لا تُرسل إليك أبدًا: اكتب القيمة الجديدة واضغط حفظ.
- عند الضغط على إزالة يظهر السؤال إزالة OPENAI_API_KEY؟؛ أكّد بـ إزالة المتغير. لا يعود البوت يملكه عند تشغيله في المرة القادمة.
القواعد والحدود
- يتكون الاسم من أحرف وأرقام وشرطات سفلية، بحد أقصى 64 حرفًا، ولا يبدأ برقم.
- القيمة حتى 4 KB. ويمكن أن يضم البوت حتى 50 متغيرًا.
- الأسماء التي تضبطها اللوحة بنفسها تُرفض برسالة
... is set by PlayNHost and cannot be changed here.: أسماء الرمز (DISCORD_TOKENوTOKENوBOT_TOKENوDISCORD_BOT_TOKEN)، وGIT_TOKENوPATHوHOMEوNODE_OPTIONS، والأسماء التي تبدأ بـSERVER_أوPNH_، وإعدادات نوع بوتك نفسها مثلMAIN_FILE. - الأسماء التي تغيّر طريقة بدء بيئة التشغيل أو الـ shell تُرفض تحت إضافة متغير برسالة
... controls how the bot starts and cannot be set here.(ويعلّمها ملف.envالملصوق بـ تم التخطي)، مثلPYTHONPATHأوNODE_PATHأوJAVA_TOOL_OPTIONSأو أي اسم يبدأ بـLD_أوNPM_CONFIG_أوPIP_أوGIT_.
يصل رمز Discord الخاص بك إلى كودك دون أي متغير منك، باسم DISCORD_TOKEN وأيضًا باسم TOKEN وBOT_TOKEN وDISCORD_BOT_TOKEN. ولهذا لا يمكن ضبط هذه الأسماء هنا.
لا يملك البوت الجاهز قائمة متغيراته الخاصة: مفاتيحه حقول ثابتة في بطاقة بيانات الاعتماد في هذا القسم. والمفتاح الذي لا يبدأ البوت من دونه يعرض مطلوب، وإلى أن يُعيَّن تُبقي بطاقة إعداد بوتك في نظرة عامة زر تشغيل البوت معطّلًا وتقود إلى هنا برابط افتح البيئة: كيف تغيّر إعدادات بوت جاهز.
ذو صلة: كيف تحمي رمز بوت Discord، كيف تستخدم قاعدة بيانات مع بوت Discord.
