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

تتيح لك متغيرات البيئة تمرير قيم الإعداد — مثل توكن بوت Discord أو مفتاح API — إلى تطبيقك دون كتابتها مباشرةً في كود مصدرك. على Daki Hosting، الطريقة الموصى بها هي إنشاء ملف .env مباشرةً على خادمك باستخدام مدير الملفات في Portal أو عبر SFTP.

ما ستتعلمه

• ما هي متغيرات البيئة ولماذا تهم
• كيفية إنشاء ملف .env على خادمك
• كيفية تحميل قيم .env في Node.js وPython
• أفضل الممارسات للحفاظ على الأسرار آمنة

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

متغيرات البيئة أزواج مفتاح-قيمة يمكن لتطبيقك الجاري قراءتها من بيئته. وهي الطريقة القياسية لـ:

• تخزين القيم الحساسة (التوكنات ومفاتيح API وكلمات المرور) بمعزل عن الكود
• تغيير الإعدادات دون تعديل ملفات المصدر أو إعادة نشرها
• تجنب رفع الأسرار إلى نظام التحكم بالإصدارات

إنشاء ملف .env

أبسط طريقة وأكثرها موثوقية لإدارة متغيرات البيئة على Daki هي إنشاء ملف .env على خادمك. يمكنك ذلك بطريقتين:

الخيار 1: استخدام مدير الملفات (للتعديلات السريعة)

1. افتح خادمك في Portal (portal.daki.cc).
2. انتقل إلى تبويب Files.
3. انقر على New File وسمِّه .env.
4. انقر على الملف لفتحه في المحرر على الويب وأضف متغيراتك:
   .envنسخ

   BOT_TOKEN=your_discord_bot_token_here
   PORT=3000
   DATABASE_URL=your_db_connection_string

5. انقر على Save.
6. أعد تشغيل خادمك.

الخيار 2: استخدام SFTP (موصى به للإعداد الأولي)

اتصل بخادمك عبر SFTP (بيانات الاعتماد في تبويب Settings) وارفع ملف .env مباشرةً من جهازك المحلي. انظر مدير الملفات لتعليمات إعداد SFTP.

تحميل قيم .env في تطبيقك

التطبيقات لا تقرأ ملفات .env تلقائيًا، بل تحتاج إلى مكتبة لتحميلها في البيئة.

{
  "dependencies": {
    "dotenv": "^16.0.0"
  }
}

require('dotenv').config();

const token = process.env.BOT_TOKEN;
const port  = process.env.PORT || 3000;

python-dotenv

from dotenv import load_dotenv
import os

load_dotenv()

token = os.environ.get("BOT_TOKEN")
port  = int(os.environ.get("PORT", 3000))

تنسيق ملف .env

كل سطر في ملف .env يتبع الصيغة KEY=VALUE:

# Comments start with a hash
BOT_TOKEN=your_token_here
API_KEY=some_api_key
DB_HOST=localhost
DB_PORT=5432
DEBUG=false

• المفاتيح عادةً بأحرف كبيرة مع شرطات سفلية.
• لا تحتاج القيم إلى علامات اقتباس، لكنها مدعومة.
• الأسطر التي تبدأ بـ # تعليقات وتُتجاهل.

أفضل الممارسات

• لا تكتب التوكنات أو الأسرار مباشرةً في ملفات الكود المصدري، خاصةً إذا كان كودك على GitHub.
• أضف .env إلى .gitignore حتى لا يُرفع أبدًا عن طريق الخطأ.
• أنشئ ملف .env على الخادم، لا على جهازك المحلي — أو استخدم SFTP لرفع ملف .env محلي مستبعد من نظام التحكم بالإصدارات.
• أعد تشغيل خادمك بعد إنشاء ملف .env أو تعديله.
• استخدم أسماء مفاتيح وصفية تجعل إعداداتك موثّقة بذاتها.

الخطوات التالية

• إعدادات التشغيل — اضبط أمر التثبيت وأمر التشغيل وصورة Docker.
• نشر بوت Discord.js — شرح كامل للنشر بما في ذلك إعداد التوكن.
• نشر بوت Python — شرح كامل للنشر بما في ذلك إعداد التوكن.