تخطَّ إلى المحتوى

الإدارة12‏/11‏/2026مدة القراءة: 5 دقائق

الإعداد

يُضبط Mitra بالكامل عبر متغيرات البيئة. لا يوجد ملف إعداد تربطه بالحاوية: تضبط المتغيرات على الحاوية، ويقرؤها Mitra عند تشغيله. كل المتغيرات اختيارية، والمتغير الذي لا تضبطه يأخذ القيمة الافتراضية المذكورة أدناه.

مع Docker Compose، توضع المتغيرات في القسم environment:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
environment:
MITRA_URL: 'https://mitra.example.com'
MITRA_NAME: 'Family Calendar'

ويعمل ملف .env أو أسرار Docker بالقدر نفسه، إن كنت تفضل إبقاء الأسرار خارج ملف compose. يسري التغيير في المرة التالية التي يبدأ فيها Mitra:

Terminal window
docker compose up -d

ما يلزم إعداده على الخادم

Section titled “ما يلزم إعداده على الخادم”

لا شيء تقريبًا. يضيف المستخدمون بأنفسهم، داخل التطبيق، تقويمات Mitra وCalDAV وتقويم Apple والاشتراكات في التقويمات وNotion وTodoist وTempo.

أمران فقط يحتاجان إلى بيانات اعتماد تسجلها أولًا لدى جهة أخرى: تقويم Google (MITRA_GOOGLE_*) وتسجيل الدخول (MITRA_OIDC_*).

حين يصبح الوصول إلى Mitra ممكنًا من أي مكان غير جهازك، ضعه خلف خادم وكيل عكسي مثل Caddy أو Traefik أو nginx، ودع الخادم الوكيل يتولى HTTPS. فـ Mitra نفسه يتحدث HTTP العادي داخل الحاوية. وبعض الميزات لا تعمل إلا عبر HTTPS:

  • لا تسمح المتصفحات بالتذكيرات وبتثبيت التطبيق إلا على عناوين https:// (وعلى http://localhost).
  • لا تُعلَّم ملفات تعريف الارتباط الخاصة بتسجيل الدخول بأنها آمنة إلا على https://، ومعظم مزوّدي الهوية يشترطون عنوان إعادة توجيه يبدأ بـ https://.
  • يتطلب تقويم Google عنوان إعادة توجيه يبدأ بـ https://.

ثم اضبط MITRA_URL على العنوان العام.

مع Caddy، هذا كل ما يلزم:

mitra.example.com {
reverse_proxy localhost:3000
}

ومع Traefik، وجّه الطلبات إلى Mitra بتسميات (labels) على الخدمة:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
restart: unless-stopped
volumes:
- ~/mitra:/app/data
labels:
- "traefik.enable=true"
- "traefik.http.routers.mitra.rule=Host(`mitra.example.com`)"
- "traefik.http.services.mitra.loadbalancer.server.port=3000"
environment:
MITRA_URL: 'https://mitra.example.com'

MITRA_URL هو العنوان الذي يكتبه المستخدمون في المتصفح للوصول إلى Mitra، لا العنوان الداخلي للحاوية:

environment:
MITRA_URL: 'https://mitra.example.com'

يبني Mitra منه عناوين العودة لتقويم Google ولتسجيل الدخول، ويعلّم ملفات تعريف الارتباط بأنها آمنة حين يبدأ بـ https://. يمكنك الاستغناء عنه ما دمت تجرب Mitra على http://localhost. اضبطه حالما يصبح لـ Mitra عنوان حقيقي، ولا بد من ضبطه لتفعيل تسجيل الدخول.

يحل MITRA_NAME محل «Mitra» في الشريط الجانبي وعلامة تبويب المتصفح والتطبيق المثبت:

environment:
MITRA_NAME: 'Family Calendar'

النقر على الاسم يفتح مربع الحوار حول، الذي يعرض الإصدار والإيداع (commit) اللذين تشغّلهما. ويحتفظ التطبيق المثبت بالاسم والرمز «Mitra»، لأنهما يُثبَّتان عند بناء التطبيق.

المتغيرالقيمة الافتراضيةالوصف
MITRA_URL(غير مضبوط)العنوان العام الذي يصل منه المستخدمون إلى Mitra، مثل https://mitra.example.com. منه تُبنى عناوين العودة لتسجيل الدخول ولتقويم Google، وعليه يتوقف كون ملفات تعريف الارتباط آمنة. اختياري ما دمت تجرب Mitra على localhost، ومطلوب لتسجيل الدخول، ومستحسن لتقويم Google ولأي خادم عام.
MITRA_NAME(Mitra، بلغة كل مستخدم)الاسم الظاهر في الشريط الجانبي وعلامة تبويب المتصفح والتطبيق المثبت.
MITRA_PORT3000المنفذ الذي يستمع إليه الخادم. مع Docker، غيّر جهة المضيف في ربط المنافذ بدلًا من ذلك؛ ولا تضبط هذا المتغير إلا إذا كان على العملية نفسها أن تستمع إلى منفذ آخر. ويتبعه فحص السلامة المدمج.
MITRA_LOG_LEVELinfoمقدار ما يسجله Mitra: error أو warn أو info أو debug أو trace. يشمل كل مستوى كل ما هو أهدأ منه.
MITRA_UPDATE_CHECK(مفعّل)اضبطه على off (أو false أو 0 أو no) لإيقاف التحقق من التحديثات.
MITRA_MCP(مفعّل)اضبطه على off (أو false أو 0 أو no) لإغلاق العنوان الذي تتصل به أدوات الذكاء الاصطناعي.
المتغيرالقيمة الافتراضيةالوصف
MITRA_VAPID_SUBJECTmailto:mitra@localhostجهة الاتصال التي تراها خدمات الإشعارات الفورية لتذكيرات خادمك، وعادةً ما تكون عنوان mailto:. لا يراها أحد ممن يستخدمون Mitra. تُنشأ مفاتيح التوقيع تلقائيًا، فلا شيء آخر يلزم ضبطه.
المتغيرالقيمة الافتراضيةالوصف
MITRA_PHOTON_URLhttps://photon.komoot.ioخدمة الترميز الجغرافي Photon التي يعتمد عليها حقل الموقع. وجّهه إلى نسخة Photon خاصة بك بدلًا من النسخة العامة التي تقدمها komoot.
المتغيرالقيمة الافتراضيةالوصف
MITRA_FILE_MAX_SIZE25Mأكبر حجم لملف يمكن إرفاقه بعنصر، بالبايت أو مع اللاحقة k أو M أو G. اضبطه على 0 لإيقاف إضافة الملفات.
MITRA_FILE_QUOTA(غير مضبوط)المساحة الإجمالية التي يمكن لكل مستخدم شغلها بالملفات المرفقة، وتُكتب بالطريقة نفسها. بدونه لا يوجد حد.

اضبط المتغيرين كليهما ليتمكن المستخدمون من ربط تقويم Google. وضبط المعرف وحده يمنع Mitra من البدء.

المتغيرالقيمة الافتراضيةالوصف
MITRA_GOOGLE_CLIENT_ID(غير مضبوط)معرف عميل OAuth من وحدة تحكم Google Cloud.
MITRA_GOOGLE_CLIENT_SECRET(غير مضبوط)سر عميل OAuth. مطلوب كلما ضُبط MITRA_GOOGLE_CLIENT_ID.

ضبط MITRA_OIDC_ISSUER يفعّل تسجيل الدخول. وإن غابت المتغيرات التي يحتاجها، يرفض Mitra البدء.

المتغيرالقيمة الافتراضيةالوصف
MITRA_OIDC_ISSUER(غير مضبوط)عنوان URL للجهة المُصدِرة لدى مزوّد OIDC. يتطلب MITRA_OIDC_CLIENT_ID وMITRA_URL.
MITRA_OIDC_CLIENT_ID(غير مضبوط)معرف العميل المسجل لدى مزوّدك.
MITRA_OIDC_CLIENT_SECRET(غير مضبوط)سر العميل. لا تضبطه للعميل العام؛ فـ Mitra يستخدم PKCE دائمًا.
MITRA_OIDC_SCOPESopenid profile emailالنطاقات التي يطلبها Mitra، مفصولة بمسافات. openid مطلوب؛ وprofile وemail يعطيان Mitra اسم كل مستخدم وبريده الإلكتروني.

لا تضبط هذه المتغيرات على الخادم. يضبطها البناء أو الصورة، أو هي مخصصة للعمل على تطوير Mitra نفسه.

المتغيريضبطهالوصف
MITRA_VERSIONالبناءالإصدار المضمّن في الصورة.
MITRA_COMMITالبناءالإيداع المضمّن في الصورة.
MITRA_DEVالتطويريتيح تكامل عرض تجريبي، وهو مجموعة من التقويمات التجريبية، أثناء العمل على Mitra.
NODE_ENVالصورةproduction في صورة الحاوية.

خادم مع تسجيل الدخول وتقويم Google وخدمة ترميز جغرافي خاصة به:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
restart: unless-stopped
ports:
- '3000:3000'
volumes:
- ~/mitra:/app/data
environment:
MITRA_URL: 'https://mitra.example.com'
MITRA_NAME: 'Family Calendar'
# Sign-in
MITRA_OIDC_ISSUER: 'https://auth.example.com'
MITRA_OIDC_CLIENT_ID: 'mitra'
MITRA_OIDC_CLIENT_SECRET: '…'
# Google Calendar
MITRA_GOOGLE_CLIENT_ID: '….apps.googleusercontent.com'
MITRA_GOOGLE_CLIENT_SECRET: '…'
# Your own geocoder
MITRA_PHOTON_URL: 'https://photon.internal.example.com'