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

تشغيل خادم

تسجيل الدخول والوصول

أعدّ مزوّدي تسجيل الدخول والبريد الإلكتروني لخادم Oleafly Server، وحدّد مَن يدخل عبر قواعد الوصول والتسجيل المفتوح والأدوار والضيوف، وفعّل الوصول عبر المتصفح، وأدر الخادم من وحدة تحكم المشرف.

يسجّل الأشخاص الدخول إلى خادم Oleafly Server عبر مزوّدين تُعدّهم أنت، ولذلك لا يتعامل الخادم مع كلمات المرور مطلقًا. وتقرّر أنت بقواعد الوصول مَن يدخل. ويتولّى المشرفون إدارة ما تبقّى من وحدة تحكم المشرف داخل Oleafly.

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

https://collab.example.org/auth/callback/<provider>

إذا كان OLEAFLY_PUBLIC_URL يتضمّن مسارًا، فإن عنوان ردّ الاتصال يتضمّنه أيضًا، كما في https://www.cs.example.edu/oleafly/auth/callback/github.

  1. في GitHub، اختر صورتك الشخصية ثم Settings › Developer settings › OAuth apps، واختر New OAuth App. إذا كان التطبيق مملوكًا لمؤسسة، فاستخدم Developer settings في إعدادات المؤسسة بدلًا من ذلك.
  2. املأ Application name (مثل Smith Lab Oleafly) وHomepage URL (https://collab.example.org) وAuthorization callback URL (https://collab.example.org/auth/callback/github). اترك Enable Device Flow معطّلًا.
  3. اختر Register application. انسخ Client ID، ثم اختر Generate a new client secret وانسخ السرّ.
  4. عيّن OLEAFLY_GITHUB_CLIENT_ID وOLEAFLY_GITHUB_CLIENT_SECRET، ثم أعد تشغيل الخادم.

يطلب الخادم من GitHub الملف الشخصي وعناوين البريد الإلكتروني الخاصة بالشخص فقط (read:user وuser:email). ويغيّر OLEAFLY_GITHUB_LABEL النص الظاهر على زر تسجيل الدخول.

بالنسبة إلى GitHub Enterprise Server، سجّل التطبيق هناك وعيّن أيضًا OLEAFLY_GITHUB_URL بعنوانه، مثل https://github.example.edu. لا تعيّن OLEAFLY_GITHUB_API_URL إلا إذا كان عنوان API لديك غير معتاد.

يغطّي OpenID Connect كلاً من GitLab وGoogle وMicrosoft Entra ID وKeycloak وAuthentik وOkta ومعظم أنظمة تسجيل الدخول الموحّد في الجامعات. إذا كانت جامعتك لا تقدّم سوى SAML، فضَع Keycloak أو Dex وسيطًا بينهما.

  1. اختر اسمًا قصيرًا من أحرف وأرقام، مثل GITLAB. يصبح هذا الاسم جزءًا من أسماء المتغيّرات، ويصبح بأحرف صغيرة جزءًا من عنوان ردّ الاتصال. في ملف .env الخاص بـ Compose، أعد تسمية أسطر UNIVERSITY أو أضف كتلة ثانية.

  2. سجّل تطبيقًا لدى مزوّدك. اختر تطبيقًا سريًا أو تطبيق ويب، وعيّن redirect URI إلى https://collab.example.org/auth/callback/gitlab، واسم بالنطاقات openid وemail وprofile.

  3. أضف تفاصيل المزوّد:

    OLEAFLY_OIDC_GITLAB_ISSUER=https://gitlab.com
    OLEAFLY_OIDC_GITLAB_CLIENT_ID=example-client-id
    OLEAFLY_OIDC_GITLAB_CLIENT_SECRET=example-client-secret
    OLEAFLY_OIDC_GITLAB_LABEL=GitLab
  4. أعد تشغيل الخادم.

التسمية (label) هي النص الظاهر على زر تسجيل الدخول، مثل University login. أما المُصدِر (issuer) فهو العنوان الذي ينشر المزوّد تحته /.well-known/openid-configuration. بعض الأمثلة الشائعة:

المزوّدالمُصدِر
GitLab.comhttps://gitlab.com
GitLab مُدار ذاتيًاعنوان GitLab لديك، مثل https://gitlab.example.edu
Googlehttps://accounts.google.com
Microsoft Entra IDhttps://login.microsoftonline.com/ يليه معرّف المستأجر الخاص بك ثم /v2.0
Keycloakhttps://sso.example.edu/realms/ يليه اسم realm

عناوين البريد الإلكتروني الموثّقة

قسم بعنوان “عناوين البريد الإلكتروني الموثّقة”

تطابق إدخالات قائمة المسموح لهم وقواعد النطاقات عناوين البريد الإلكتروني الموثّقة فقط. ولا يعتبر الخادم عنوانًا موثّقًا إلا عندما يقول المزوّد ذلك: بأن يعلّمه GitHub موثّقًا، أو بأن تكون مطالبة email_verified في OpenID Connect بالقيمة true.

تُغفل بعض مزوّدي المؤسسات هذه المطالبة. إذا كان مزوّدك كذلك، وكان لا يوزّع إلا عناوين تتحكّم بها مؤسستك، فعليك تعيين OLEAFLY_OIDC_<NAME>_TRUST_EMAIL=true. لا تعيّنه أبدًا لمزوّد يتيح للأشخاص كتابة أي عنوان بريد إلكتروني يشاؤونه، فقد يستطيع أي شخص حينها تسجيل الدخول بصفته شخصًا من قائمة المسموح لهم.

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

من دون Docker، أضف الشهادة إلى نظام التشغيل. فعلى Debian وUbuntu، انسخها إلى /usr/local/share/ca-certificates/ باسم ينتهي بـ .crt ثم شغّل sudo update-ca-certificates.

لا تتضمّن صورة Docker مدير حزم، لذا زوّدها بقائمة شهادات تشمل شهادتك. بجوار docker-compose.yml، وعلى جهاز Debian أو Ubuntu:

نافذة المحطة الطرفية
cat /etc/ssl/certs/ca-certificates.crt university-ca.pem > ca-bundle.pem
chmod 644 ca-bundle.pem

ثم أضف الملف إلى الخادم في docker-compose.override.yml وشغّل docker compose up -d من جديد:

services:
oleafly-server:
volumes:
- ./ca-bundle.pem:/etc/ssl/certs/ca-certificates.crt:ro

البريد الإلكتروني اختياري، وكل شيء آخر يعمل بدونه. فمن دون بريد إلكتروني ترسل أنت عنوان الخادم إلى الأشخاص بنفسك، ويعرض Oleafly المشروعات المشتركة مع كل شخص تحت Shared with you.

لإعداده، أعطِ الخادم حساب SMTP:

OLEAFLY_SMTP_URL=smtps://oleafly%40example.org:example-app-password@smtp.example.org:465
OLEAFLY_MAIL_FROM=Smith Lab <oleafly@example.org>

عيّن السطرين معًا أو لا تعيّن أيًّا منهما. واكتب المحارف الخاصة في اسم المستخدم وكلمة المرور بصيغة URL، مثل %40 بدلًا من @.

  • يستخدم smtps:// وضع TLS من البداية، على المنفذ 465 ما لم تُسمّ منفذًا آخر.
  • يستخدم smtp:// المنفذ 587 ما لم تُسمّ آخر، ثم ينتقل إلى TLS عبر STARTTLS. إذا كان خادم البريد لا يقدّم STARTTLS فلن يرسل الخادم.
  • مُرحّل البريد على الجهاز نفسه هو الاستثناء: ترسل smtp://localhost وsmtp://127.0.0.1 وsmtp://[::1] من دون TLS.
  • يمكن لمُرحّل على الشبكة الخاصة نفسها تخطّي TLS عند إضافة ?tls=none، كما في smtp://mailpit:1025?tls=none. ولا يمكن أن يحمل العنوان حينها اسم مستخدم أو كلمة مرور، لأنهما سيعبران الشبكة غير مشفّرين. استخدمه فقط عندما لا يستطيع أحد غيرك الوصول إلى تلك الشبكة.

يتحقّق الخادم من شهادة خادم البريد مقابل الشهادات الموثوق بها في النظام.

هناك ستة أنواع من رسائل البريد الإلكتروني. لا تذهب الرسالة الموجّهة إلى شخص لديه حساب بالفعل إلا إلى عناوينه الموثّقة، وتُتخطى دائمًا عناوين noreply الخاصة بـ GitHub.

البريد الإلكترونيمتى تُرسل
الإضافة إلى الخادميضيف مشرف شخصًا إلى قائمة المسموح لهم بعنوان بريده الإلكتروني. تحمل الرسالة اسم الخادم ورابط Add to Oleafly وعنوان الخادم. أما إضافة شخص باسم مستخدم GitHub أو عبر قاعدة نطاق فلا ترسل شيئًا، لأن الخادم لا يملك عنوانًا له بعد.
مشاركة مشروعيضيف مالك مشروع شخصًا إلى مشروع. تحمل الرسالة عنوان المشروع ومَن شاركه ودور الشخص ورابطًا يفتح المشروع، إضافة إلى صفحة ويب المشروع للحالات التي لا يفتح فيها الرابط التطبيق. تغيير الدور لاحقًا لا يرسل شيئًا. يمكن لكل شخص إيقاف هذه الرسائل من بطاقة الخادم في Settings → Collaboration.
جهاز جديديسجّل حساب الدخول على جهاز آخر. تحمل الرسالة اسم الجهاز ونظام تشغيله والوقت وفق المنطقة الزمنية للخادم، مع تذكير بتسجيل خروج ذلك الجهاز إذا لم يكن صاحبه هو من استخدمه. الجهاز الأول لحساب جديد لا تصله رسالة. عيّن TZ، مثل TZ=Europe/Berlin، لاختيار المنطقة الزمنية.
دعوة ضيفيدعو مالك مشروع ضيفًا. تحمل الرسالة عنوان المشروع ومَن أرسل الدعوة ورابط Add to Oleafly والعنوان الذي سيُسجّل الدخول به. عندما تكون الموافقة مفعّلة، تُرسل الرسالة بعد الموافقة على الدعوة.
ذكريذكر شخص عضوًا في تعليق أو ردّ. تسمّي الرسالة مَن ذكر الشخص، والمشروع، والملف، والنص الذي يقع عليه التعليق، والتعليق نفسه، مع رابط يفتح التعليق في Oleafly. تُرسل الرسالة بعد نحو دقيقة من وصول التعليق إلى الخادم، وتجتمع الذكر الخاص بالشخص نفسه خلال تلك الدقيقة في رسالة واحدة. لا يحصل أحد على رسالة عن تعليقاته الخاصة أو عن مشروع لا يستطيع فتحه، وتعديل تعليق لا يرسل الذكر نفسه مرتين أبدًا. يمكن لكل شخص إيقاف هذه الرسائل عبر Email me when someone mentions me in a comment على بطاقة الخادم في Settings → Collaboration.
رابط تسجيل الدخوليطلب شخص رابطًا من صفحة تسجيل الدخول إلى الخادم.

يمكن للمشرفين إيقاف كل نوع عدا روابط تسجيل الدخول عبر Email notifications في إعدادات الخادم. أما روابط تسجيل الدخول فتُرسل دائمًا، لأن الأشخاص لا يستطيعون تسجيل الدخول بدونها.

في وحدة تحكم المشرف، افتح Email. تعرض الصفحة ما إذا كان البريد الإلكتروني مفعّلًا وعنوان المرسل (From)، ولا تعرض كلمة المرور أبدًا. ويمكن لمشرف اختيار Send test email لإرسال رسالة إلى عنوانه الموثّق. تخبرك الصفحة حينها بما إذا كانت الرسالة قد أُرسلت أو بما أجاب به خادم البريد.

وعندما يكون البريد الإلكتروني معطّلًا، تعرض الصفحة رابط Add to Oleafly وعنوان الخادم، لتتمكّن من إرسالهما بنفسك.

الإرسال لا يعطّل الإجراء الكامن خلفه أبدًا. يحتفظ الخادم بالرسائل في قائمة انتظار في الذاكرة ويعيد المحاولة بعد 30 ثانية ودقيقتين و10 دقائق و30 دقيقة وساعتين. كل محاولة فاشلة تحذير في سجلّ الخادم، وتعرض صفحة Email آخر فشل. وإذا فشلت المحاولة الأخيرة أيضًا، سجّل الخادم خطأً وتخلّص من تلك الرسالة. والرسائل التي لا تزال في الانتظار عند إعادة تشغيل الخادم تُفقد.

يمكن للأشخاص أيضًا تسجيل الدخول برابط يرسله الخادم إليهم بالبريد الإلكتروني، فلا يحتاجون إلى حساب GitHub أو OpenID Connect. ويتطلّب هذا البريد الإلكتروني. ثم يفعّل مشرف الخيار Sign in by email في إعدادات الخادم، وهو معطّل افتراضيًا.

يختار الشخص Continue with Email في Oleafly، ويُدخل عنوانه في المتصفّح، ثم يختار Email me a link. يعمل الرابط مرة واحدة، ولمدة 15 دقيقة، وعلى الحاسوب الذي طلبه. ويؤدّي فتح الرابط إلى صفحة تحوي زر Sign in. فتح الرابط وحده لا يستخدمه، ولذلك لا يمكن لفاحص بريد يتبع الروابط أن يستنفده.

لا تزال قواعد الوصول لديك تقرّر مَن يدخل: إدخال في قائمة المسموح لهم لذلك العنوان، أو قاعدة نطاق، أو دعوة ضيف. والإدخال في قائمة المسموح لهم باسم مستخدم GitHub لا يطابق رابط البريد الإلكتروني. وتقول الصفحة الشيء نفسه سواء سمح الخادم بذلك العنوان أم لم يسمح، فلا يستطيع أحد استخدامها لمعرفة مَن يملك حسابًا.

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

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

يرسل الخادم 3 روابط كحدّ أقصى إلى عنوان بريد إلكتروني واحد، و100 رابط إلى عنوان IP واحد، في 15 دقيقة، بحيث يستطيع صف من 50 شخصًا يتشاركون عنوانًا واحدًا تسجيل الدخول جميعًا. ويغيّر OLEAFLY_EMAIL_LINKS_PER_ADDRESS وOLEAFLY_EMAIL_LINKS_PER_IP هذين الرقمين. وتُحتسب كل عناوين IPv6 في شبكة /64 واحدة عنوانًا واحدًا. وإيقاف Sign in by email يبطل الروابط التي أُرسلت سابقًا.

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

يعرض Oleafly عنوان خادمك يليه /auth/device ورمزًا من ثمانية أحرف. يفتح الشخص ذلك العنوان على أي هاتف أو حاسوب، ويكتب الرمز، ويتحقّق من اسم الحاسوب الذي تعرضه الصفحة، ثم يسجّل الدخول. ويجب أن يكتمل تسجيل الدخول في المتصفّح الذي كُتب الرمز فيه، ولذلك فإن صفحة تسجيل دخول يرسلها شخص آخر كرابط لا تسجّل دخول أي أحد.

يعمل الرمز مرة واحدة، ويتوقّف عن العمل بعد 10 دقائق، ولا تستطيع إلا النسخة من Oleafly التي طلبته إكمال تسجيل الدخول. وزر Stop, this wasn’t me يلغيه. يمكن لعنوان IP واحد طلب 100 رمز وكتابة 10 رموز خاطئة في 10 دقائق، وهو ما يكفي لصف من 50 شخصًا يتشاركون عنوانًا واحدًا، ويغيّر OLEAFLY_DEVICE_CODES_PER_IP ذلك.

تسجيل الدخول وحده لا يكفي للدخول، بل يجب أن تسمح قاعدة وصول للشخص بالدخول. أدِر القواعد ضمن Access rules في وحدة تحكم المشرف:

  • Allowed people: أضف شخصًا بعنوان بريده الإلكتروني أو باسم مستخدم GitHub مع الدور الذي سيحصل عليه. وتعمل أسماء المستخدمين مع GitHub فقط، لأن المزوّدين الآخرين يتيحون للأشخاص اختيار أسمائهم أو تغييرها. وإذا كان الخادم يرسل بريدًا إلكترونيًا، فإن إضافة شخص بعنوان بريده ترسل إليه عنوان الخادم ورابط Add to Oleafly.
  • Domains: اسمح لكل مَن يملك عنوان بريد إلكتروني موثّقًا عند نطاق، مثل cs.example.edu، بتسجيل الدخول بالدور الذي تختاره.

بعد إضافة الأشخاص، يمكنهم إضافة الخادم في Oleafly وتسجيل الدخول.

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

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

لخادم يجوز لأي شخص استخدامه، عيّن OLEAFLY_OPEN_SIGNUP=true وأعد تشغيله. عندئذ يحصل كل من يسجّل الدخول عبر أحد مزوّديك على حساب بدور Member، دون إدخال في قائمة المسموح لهم أو قاعدة نطاق. ومع تفعيل Sign in by email، يعمل رابط البريد الإلكتروني بالطريقة نفسها.

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

ويفعّل أيضًا الحدود لكل حساب: ما لم تعيّن قيمًا أخرى، يجوز لكل حساب تخزين 100 ميغابايت، وامتلاك 50 مشروعًا مشتركًا، وإجراء 300 عملية رفع في الساعة.

لا تعرض وحدة تحكم المشرف ما إذا كان التسجيل المفتوح مفعّلًا. ويذكر سجلّ الخادم ذلك في كل مرة يبدأ فيها: «Open sign-up is on, so anyone who signs in gets an account as a member.» يستطيع الأعضاء البحث عن بعضهم عند مشاركة مشروع، لذا فكّر في إيقاف Member directory في إعدادات الخادم إذا كان الخادم مفتوحًا.

لكل شخص دور واحد على مستوى الخادم يمنحه المشرفون ومشرفو الصيانة. وفي كل مشروع يُضاف إليه له أيضًا دور في المشروع يمنحه مالك ذلك المشروع. وتسرد صفحة الأدوار أدوار المشروع: Owner وEditor وReviewer وCommenter وViewer.

لا يفتح أي دور على مستوى الخادم مشروعًا بنفسه، فلا يأتي الوصول إلى المشروع إلا من مالكه.

الإجراءAdminMaintainerMemberGuest
إضافة الخادم إلى Oleaflyنعمنعمنعمنعم
عرض قائمة الأعضاءنعمنعمنعم، إلا إذا أخفاها مشرفلا
مشاركة مشروعنعمنعمنعملا
قراءة سجلّ الأماننعمنعملالا
إضافة أعضاء إلى الخادمنعمنعملالا
تعيين مشرفي الصيانةنعملالالا
تغيير إعدادات الخادمنعملالالا
حذف مشروع لتحرير مساحة التخزيننعملالالا
تسجيل خروج جهاز شخصنعمنعم، لكن ليس أجهزة المشرفين أو مشرفي الصيانة الآخرينأجهزته الخاصة فقطأجهزته الخاصة فقط
قراءة المشروعات المخزّنة بوصول مباشر إلى الخادمليس من داخل التطبيقليس من داخل التطبيقليس من داخل التطبيقليس من داخل التطبيق

الصف الأخير هو الأهم. فالمشروعات غير مشفّرة على الخادم، ولذلك يستطيع من يشغّل الجهاز قراءة كل مشروع مخزّن أيًّا كان دوره. ولا يمنح Oleafly أي دور، بما في ذلك المشرف، طريقة لفعل ذلك من داخل التطبيق. وعندما يحذف مشرف مشروعًا لتحرير مساحة التخزين، يُبلَّغ مالك المشروع وأعضاؤه، وتبقى نسخهم الخاصة على حواسيبهم.

الضيف شخص من خارج خادمك، مثل مؤلف مشارك في جامعة أخرى، يدعوه مالك مشروع إلى مشروع. ولا يرى الضيوف إلا المشروعات التي دُعوا إليها.

الضيوف معطّلون على الخادم الجديد. يفعّلهم مشرف عبر Allow guests في إعدادات الخادم. والخيار Approve guests first مفعّل افتراضيًا، فيوافق مشرف أو مشرف صيانة على كل دعوة قبل أن تعمل. أوقِفه لتعمل الدعوات فورًا. وعندما يرسل مشرف أو مشرف صيانة دعوة، تُعتمد فورًا.

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

لا يستطيع إلا مالك المشروع دعوة الضيوف إليه، وذلك من مربّع حوار Share الخاص بالمشروع.

  • الدعوة لعنوان واحد ومشروع واحد، وتنتهي بعد 14 يومًا.
  • يستطيع الشخص الواحد إرسال 20 دعوة كحدّ أقصى في الساعة.
  • عندما تكون الموافقة مفعّلة، تنتظر الدعوة ضمن Pending guests أعلى صفحة People. يوافق المشرفون ومشرفو الصيانة هناك على الدعوة أو يرفضونها أو يسحبونها، ويمكن للمالك سحبها أيضًا.
  • إذا كان الخادم يرسل بريدًا إلكترونيًا وكان Email notifications مفعّلًا، يتلقّى الضيف رسالة دعوة. وإلا فإن Oleafly يعطي المالك رابط Add to Oleafly ليرسله بنفسه.
  • إذا كان المشروع يضم بالفعل العدد الأقصى من الأشخاص الذي يسمح به الخادم، تنتظر الدعوة، وتعمل في المرة التالية التي يسجّل فيها الشخص الدخول بعد رحيل أحدهم.

يضيف الضيف الخادم ويسجّل الدخول بأي خيار يعطي الخادم العنوان المدعوّ بوصفه عنوانًا موثّقًا: GitHub، أو مزوّد OpenID Connect، أو رابط بريد إلكتروني. والعنوان غير الموثّق لا يُحتسب. وينشئ تسجيل الدخول الأول حساب ضيف ويفتح كل مشروع دُعي إليه ذلك العنوان.

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

وعندما يُزال الضيف من مشروعه الأخير أو يتركه، ينهي الخادم وصوله: يحذف الحساب ويسجّل خروج كل جهاز. وتعيد الدعوة الجديدة الحساب نفسه. أما إذا أزلت ضيفًا ضمن People بينما لا يزال لديه مشروعات، فلن تعيده دعوة جديدة.

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

عند تفعيل الوصول عبر المتصفح، يستطيع الأشخاص فتح المشروعات المشتركة معهم في متصفح ويب، دون تثبيت Oleafly. فيحررون ويقترحون التغييرات ويعلّقون ويتحادثون ويقرؤون أحدث ملف PDF مجمّع. ويغطي العمل في متصفح ما يرونه.

عيّن OLEAFLY_WEB=true وأعد تشغيل الخادم. تتضمّن صورة الحاوية المنشورة تطبيق المتصفح. أما البناء الذي لا يتضمّنه فيسجّل «OLEAFLY_WEB is true, but this build of Oleafly Server has no browser app, so browser access stays off.»

بعد تفعيله:

  • يقع تطبيق المتصفح على عنوان خادمك متبوعًا بـ /web/، مثل https://collab.example.org/web/. وتحصل صفحة كل مشروع تحت /p/ أيضًا على رابط Open in browser.
  • يسجّل الأشخاص الدخول على /web/sign-in بالمزوّدين وروابط البريد الإلكتروني نفسها التي في Oleafly، وتقرّر قواعد الوصول نفسها مَن يدخل. ويبقى المتصفح مسجّل الدخول 30 يومًا.
  • يُحتسب كل متصفح جهازًا من أجهزة ذلك الحساب، باسم مثل «Safari on macOS». ويظهر في قائمة أجهزة الشخص وفي سجلّ الأمان، وتسجيل خروجه يُنهي جلسة ذلك المتصفح.
  • يتصل المتصفح بـ /web/ws عبر WebSocket وليس له مسار أبطأ، لذا يجب أن يمرّر الوكيل لديك ترقيات WebSocket إلى هناك. ويفعل ذلك بالفعل Caddy وأمثلة nginx وApache في خلف وكيل عكسي.
  • ملف PDF الذي يقرؤه الأشخاص هو أحدث ملف جمّعه مالك أو محرر في Oleafly. ويشرح ملفات PDF المجمّعة كيف يصل إلى هناك.

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

وحدة تحكم المشرف نافذة لإدارة خادم واحد من داخل Oleafly، ويستطيع المشرفون ومشرفو الصيانة فتحها. في Settings → Collaboration، اختر Open admin console على بطاقة الخادم أو أعلى Manage server. ويحصل كل خادم على نافذته الخاصة.

القسمما يعرضه وما يفعله
Overviewما إذا كان الخادم سليمًا، وعدد الأشخاص والأجهزة والمشروعات فيه، ومَن هم المتّصلون، ومقدار مساحة التخزين التي يستخدمها، وخيارات البريد الإلكتروني وتسجيل الدخول فيه، وإعداداته بنظرة سريعة. يحذّر برسالة Nobody can sign in عندما لا يكون للخادم خيار تسجيل دخول، وبرسالة The server can’t save files عندما يتعذّر الكتابة في مجلد البيانات.
Peopleكل مَن سجّلوا الدخول. غيّر الأدوار، وأوقف الأشخاص مؤقتًا أو أزلهم، وسجّل خروج أجهزتهم. وتظهر دعوات الضيوف المنتظرة للموافقة في الأعلى.
Access rulesقائمة المسموح لهم وقواعد النطاقات.
Projectsكل مشروع مشترك على الخادم، مع مالكه وعدد أشخاصه وحجمه وآخر نشاط له. ابحث بالعنوان أو المالك، واعرض المشروعات المشتركة أو المؤرشفة أو قيد التحميل فقط، وأرشف مشروعًا أو استعده.
Settingsإعدادات الخادم.
Emailما إذا كان البريد الإلكتروني معدًّا، وعنوان المرسل (From)، وآخر فشل. أرسل رسالة اختبار من هنا.
Security logعمليات تسجيل الدخول والمرفوضة منها، والأجهزة، والأشخاص، والإعدادات، والمشروعات، والضيوف. يذكر كل إدخال مَن فعله ومتى ومن أي عنوان IP، مع تفاصيل مثل المشروع وخيار تسجيل الدخول المستخدم أو سبب رفض تسجيل الدخول.
Connection checksالفحوص نفسها التي يجريها Test connection، من حاسوبك إلى الخادم.

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

أرشفة مشروع توقف مشاركته على الجميع: يتوقّف الأشخاص عن مزامنته ويحتفظون بنسخهم الخاصة، ويحذفه الخادم بعد OLEAFLY_ARCHIVE_DAYS يومًا ما لم يستعده مشرف أولًا. والاستعادة تشاركه مجددًا مع الأشخاص أنفسهم. والمشروع الذي لم يكتمل تحميله الأول لا يمكن استعادته. وكلا الأمرين يظهر في سجلّ الأمان.

لا تفتح وحدة التحكم مشروعًا أبدًا، بل تعرض العناوين والمالكين والأحجام، ولا شيء مما في داخلها.

تنطبق هذه الإعدادات على كل شخص على الخادم، ولا يستطيع تغييرها إلا المشرفون.

الإعدادما يفعله
Allow guestsيمكن للأعضاء دعوة أشخاص من خارج الخادم إلى مشروعات يملكونها.
Approve guests firstيوافق مشرف صيانة أو مشرف على كل دعوة ضيف قبل أن تعمل.
Member directoryيمكن للأعضاء البحث عن بعضهم بالاسم عند مشاركة مشروع.
Show email addresses in the directoryيرى الأعضاء عناوين البريد الإلكتروني لبعضهم عند البحث عن أحدهم.
Allow link sharingيمكن لمالكي المشروعات السماح لأي عضو بفتح مشروع من رابطه.
Allow public note linksيمكن للأعضاء نشر نسخة للقراءة فقط من ملاحظة على رابط يستطيع أي شخص فتحه دون تسجيل الدخول. وهو معطّل افتراضيًا. وتعطيله يوقف كل رابط منشور إلى أن تعيد تفعيله. انظر نشر نسخة للقراءة فقط.
Allow project access logsيمكن لمالكي المشروعات الاحتفاظ بسجلّ لمن فتح مشروعهم.
Allow commentsيمكن للأشخاص في المشروعات المشتركة التعليق على النص والردّ عليه. وإيقاف هذا الخيار يخفي التعليقات في كل مكان مع إبقائها مخزّنة.
Email notificationsأوقفه لإيقاف رسائل الخادم للجميع، باستثناء روابط تسجيل الدخول.
Sign in by emailيمكن للأشخاص تسجيل الدخول برابط يُرسل إلى عنوان بريدهم الإلكتروني، ويتطلّب هذا إعدادات البريد الإلكتروني للخادم.
معاينة الصورة

تعذّر تحميل إجابات الذكاء الاصطناعي

حاول مرة أخرى، أو ابحث في الوثائق.