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

تشغيل خادم

التخزين والنسخ الاحتياطي والحدود

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

تتناول هذه الصفحة تشغيل Oleafly Server وإدارته يومًا بعد يوم. لتثبيته، ابدأ بصفحة تشغيل خادم تعاون.

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

المتغيرما يفعلهالافتراضي
OLEAFLY_PUBLIC_URLعنوان HTTPS الذي يُدخله الناس في Oleafly. ويمكن أن يتضمن مسارًا، مثل https://www.cs.example.edu/oleafly. مطلوب. تضبطه لك ملفات Compose وCoolify.لا شيء
OLEAFLY_BINDالعنوان والمنفذ اللذان يستمع عليهما الخادم.0.0.0.0:8080
OLEAFLY_DATA_DIRالمجلد المخصص لقاعدة البيانات والملفات المخزنة./data
OLEAFLY_SERVER_NAMEالاسم الذي يراه الناس في Oleafly، مثل Smith Lab.Oleafly Server
OLEAFLY_SERVER_ICON_URLعنوان HTTPS لصورة مربعة تظهر بجوار الاسم.لا شيء
OLEAFLY_SETUP_CODEرمز الإعداد الخاص بك للاستخدام مرة واحدة: 12 حرفًا أو رقمًا على الأقل، مع شرطات أو مسافات إن شئت. من دونه ينشئ الخادم رمزًا.مُولَّد
OLEAFLY_GITHUB_CLIENT_ID, OLEAFLY_GITHUB_CLIENT_SECRETيشغّل تسجيل الدخول عبر GitHub.معطّل
OLEAFLY_GITHUB_URLعنوان خادم GitHub Enterprise Server.https://github.com
OLEAFLY_GITHUB_API_URLعنوان واجهة GitHub API، إذا كان عنوانك غير معتاد.https://api.github.com، أو /api/v3 تحت OLEAFLY_GITHUB_URL
OLEAFLY_GITHUB_LABELالنص الظاهر على زر تسجيل الدخول عبر GitHub.GitHub
OLEAFLY_OIDC_<NAME>_ISSUER, OLEAFLY_OIDC_<NAME>_CLIENT_ID, OLEAFLY_OIDC_<NAME>_CLIENT_SECRETيشغّل مزوّد OpenID Connect يُدعى <NAME>.معطّل
OLEAFLY_OIDC_<NAME>_LABELالنص الظاهر على زر تسجيل الدخول الخاص به، مثل University login.<NAME>
OLEAFLY_OIDC_<NAME>_TRUST_EMAILيعتبر كل عنوان بريد إلكتروني صادر عن هذا المزوّد عنوانًا موثّقًا. اقرأ عناوين البريد الإلكتروني الموثّقة أولًا.false
OLEAFLY_SMTP_URL, OLEAFLY_MAIL_FROMالبريد الإلكتروني. اقرأ البريد الإلكتروني.معطّل
OLEAFLY_OPEN_SIGNUPيمنح كل من يسجّل الدخول عبر أحد مزوّديك حسابًا بدور عضو. اقرأ التسجيل المفتوح.false
OLEAFLY_WEBيشغّل الوصول عبر المتصفح. اقرأ الوصول عبر المتصفح.false
OLEAFLY_BLOB_STOREالمكان الذي تُخزَّن فيه ملفات مثل الأشكال وملفات PDF. الخيار fs يبقيها في OLEAFLY_DATA_DIR. أما عنوان مثل s3://lab-bucket أو s3://lab-bucket/oleafly فيخزّنها في حاوية.fs
OLEAFLY_S3_ENDPOINTعنوان مخزن متوافق مع S3 غير Amazon S3، مثل MinIO أو Cloudflare R2. اتركه فارغًا عند استخدام Amazon S3.Amazon S3
OLEAFLY_S3_REGIONمنطقة الحاوية.us-east-1
OLEAFLY_S3_ACCESS_KEY_ID, OLEAFLY_S3_SECRET_ACCESS_KEYالمفتاح الذي يستخدمه الخادم للوصول إلى الحاوية. مطلوب مع عنوان s3://.لا شيء
OLEAFLY_MAX_PROJECT_MBأكبر مشروع يقبله الخادم، بالميغابايت.200
OLEAFLY_MAX_FILE_MBأكبر ملف واحد، بالميغابايت.50
OLEAFLY_MAX_MEMBERS_PER_PROJECTأقصى عدد للأشخاص في مشروع واحد.20
OLEAFLY_ACCOUNT_STORAGE_MBأقصى ما يجوز أن تخزّنه المشاريع التي يملكها حساب واحد، بالميغابايت. اقرأ الحدود لكل حساب.بلا حد، أو 100 مع التسجيل المفتوح
OLEAFLY_MAX_PROJECTS_PER_ACCOUNTأقصى عدد من المشاريع المشتركة يجوز أن يملكه حساب واحد.بلا حد، أو 50 مع التسجيل المفتوح
OLEAFLY_UPLOADS_PER_HOURعدد عمليات رفع الملفات واللقطات التي يجوز لحساب واحد إجراؤها في ساعة.بلا حد، أو 300 مع التسجيل المفتوح
OLEAFLY_SIGN_IN_BURSTعدد طلبات تسجيل الدخول التي يستطيع عنوان شبكة واحد إرسالها في دفعة واحدة. يستغرق تسجيل الدخول الواحد نحو ستة طلبات، لذا يغطي الافتراضي 50 شخصًا عند عنوان واحد يسجّلون الدخول في الوقت نفسه.300
OLEAFLY_SIGN_IN_PER_MINUTEعدد طلبات تسجيل الدخول التي يحصل عليها عنوان شبكة واحد في كل دقيقة بعد الدفعة الأولى.120
OLEAFLY_EMAIL_LINKS_PER_IPعدد رسائل البريد الإلكتروني لتسجيل الدخول التي يرسلها الخادم إلى الأشخاص عند عنوان شبكة واحد خلال 15 دقيقة.100
OLEAFLY_EMAIL_LINKS_PER_ADDRESSعدد رسائل تسجيل الدخول التي يمكن أن يحصل عليها عنوان بريد إلكتروني واحد خلال 15 دقيقة. لا يمكن أن يتجاوز OLEAFLY_EMAIL_LINKS_PER_IP.3
OLEAFLY_DEVICE_CODES_PER_IPعدد رموز تسجيل الدخول التي يمكن للأشخاص عند عنوان شبكة واحد طلبها خلال 10 دقائق.100
OLEAFLY_SNAPSHOT_MEMORY_MBمقدار الذاكرة، بالميغابايت، الذي يجوز للخادم استخدامها لبناء لقطات المشاريع.نصف حد ذاكرة الحاوية، أو 1024 من دونه
OLEAFLY_BEHIND_PROXYيأخذ عنوان كل شخص من ترويسة X-Forwarded-For التي يضيفها الوكيل لديك. تشغّله ملفات Compose وCoolify وRender.false
OLEAFLY_PROXY_HOPSعدد الوكلاء الذين يمر عبرهم كل طلب قبل وصوله إلى الخادم. يحتاج إلى OLEAFLY_BEHIND_PROXY=true.1
OLEAFLY_LOG_LEVELمقدار ما يسجّله الخادم: error أو warn أو info أو debug أو trace. لا تسجّل المكتبات التي يستخدمها الخادم سوى التحذيرات إلا إذا اخترت debug أو trace.info
OLEAFLY_SECURITY_LOG_DAYSعدد أيام الاحتفاظ بمدخلات سجل الأمان ومدخلات سجل الوصول إلى المشاريع ودعوات الضيوف المُجابة أو المنتهية.365
OLEAFLY_ARCHIVE_DAYSعدد أيام الاحتفاظ بمشروع بعد أن يتوقف مالكه عن مشاركته.30
OLEAFLY_POLL_HOLD_SECONDSالمدة التي يبقي فيها الخادم طلب long-polling مفتوحًا حين لا توجد تعديلات منتظرة، من ثانية واحدة إلى 40 ثانية. اجعله أقل ببضع ثوانٍ من مهلة الخمول لأي وكيل يقف أمام الخادم.25

في ملف .env الخاص بـ Compose، ضع القيمة بين علامتي اقتباس مفردتين إذا كانت تحتوي على $ أو #. ويمكن أيضًا قراءة الإعدادات التي تحمل أسرارًا من ملفات. اقرأ إبعاد الأسرار عن .env.

افتراضيًا يحتفظ الخادم بكل شيء في OLEAFLY_DATA_DIR: قاعدة البيانات، والملفات التي يشاركها الناس، ولقطات المشاريع. اللقطات نسخ محفوظة من كل مشروع تتيح للناس الانضمام واللحاق بما فاتهم بسرعة.

يمكن للخادم بدلًا من ذلك الاحتفاظ بالملفات واللقطات في Amazon S3، أو في مخزن آخر بواجهة API متوافقة مع S3، مثل MinIO أو Cloudflare R2. وتبقى قاعدة البيانات في OLEAFLY_DATA_DIR في الحالتين، لذا يظل الخادم بحاجة إلى مجلد البيانات الخاص به.

  1. أنشئ حاوية وامنع الوصول العام إليها.

  2. أنشئ مفتاحًا يستطيع قراءة الكائنات في تلك الحاوية والكتابة فيها وحذفها، ولا شيء غير ذلك. على Amazon S3 يعني ذلك s3:GetObject وs3:PutObject وs3:DeleteObject على arn:aws:s3:::lab-bucket/*، أو على arn:aws:s3:::lab-bucket/oleafly/* إذا استخدمت مجلدًا.

  3. اضبط المتغيرات، مثلًا في .env:

    نافذة المحطة الطرفية
    OLEAFLY_BLOB_STORE=s3://lab-bucket/oleafly
    OLEAFLY_S3_REGION=eu-west-1
    OLEAFLY_S3_ACCESS_KEY_ID=your-access-key-id
    OLEAFLY_S3_SECRET_ACCESS_KEY=your-secret-access-key

بالنسبة لمخزن غير Amazon S3، اضبط أيضًا OLEAFLY_S3_ENDPOINT على عنوانه، مثل https://minio.example.org:9000 أو https://<account-id>.r2.cloudflarestorage.com، واضبط OLEAFLY_S3_REGION على المنطقة التي يتوقعها (auto في حالة R2). ويعمل http:// العادي أيضًا، لكن لا تستخدمه إلا عندما يكون المخزن على الشبكة الخاصة نفسها التي عليها الخادم.

الجزء الذي يلي اسم الحاوية مجلد اختياري. يُسمّى كل ملف باسم بصمة SHA-256 الخاصة به ويوضع تحت أول حرفين من تلك البصمة، فالملف الذي تبدأ بصمته بـ 3f9a يُخزَّن باسم oleafly/3f/3f9a.... وللقطات مجلد snapshots خاص بها، وفيه مجلد لكل مشروع. عندما يقرأ الخادم ملفًا أو لقطة مرة أخرى، يطابق البايتات مع البصمة ويرفض ما لا يطابقها. ومن دون حاوية، يوجد التصميم نفسه في مجلد blobs داخل OLEAFLY_DATA_DIR.

إذا رفضت الحاوية طلبًا، فسيفشل الرفع أو التنزيل ذاك، ويعرض سجل الخادم ما قالته الحاوية، مثل 403 Forbidden (AccessDenied). أما خطأ الخادم أو المهلة أو انقطاع الاتصال فأمر مختلف: يحاول الخادم حتى ثلاث مرات، مع وقفة عشوائية قصيرة بين المحاولات. وإذا تعذّر عليه حذف كائن، فدوّن ذلك ويحاول مجددًا في كل دورة صيانة، كل 6 ساعات، بحيث لا يترك الانقطاع كائنات خلفه.

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

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

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

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

يستطيع كل عضو في المشروع قراءة ملفاته المجمّعة. ولا يستطيع استبدالها إلا المالكون والمحررون.

يتحدث الخادم بلغة HTTP العادية، لذا يتولى أمر HTTPS شيء يقف أمامه: Caddy في إعداد Compose، أو وكيل Coolify، أو خادم ويب تشغّله أصلًا، مثل خادم جامعتك. وأيًّا كان ما يقف في الأمام فعليه أن:

  • يقبل الطلبات بحجم يصل إلى OLEAFLY_MAX_PROJECT_MB
  • يضيف عنوان العميل إلى X-Forwarded-For

وينبغي له أيضًا أن يمرر ترقيات WebSocket إلى /ws ويبقي تلك الاتصالات مفتوحة لمدة ساعة على الأقل. يستخدمها التحرير المباشر متى استطاع. ومع تفعيل الوصول عبر المتصفح، يجب أن يمررها إلى /web/ws أيضًا، لأن تطبيق المتصفح ليس له بديل أبطأ.

شغّل الخادم في مكان لا يصل إليه سوى الوكيل. على الجهاز نفسه، اضبط OLEAFLY_BIND=127.0.0.1:8080. ثم اضبط OLEAFLY_BEHIND_PROXY=true.

تحجب بعض الشبكات اتصالات WebSocket، وغالبًا ما تكون شبكة جامعة أو شركة خلف وكيل ترشيح. يظل التحرير المباشر يعمل هناك، لكن ببطء أكبر. عندما يفشل محلان متتاليان لاتصال WebSocket بينما لا يزال الخادم يجيب عبر HTTPS، يتحول Oleafly إلى HTTP long-polling. يرسل التعديلات إلى /api/v1/projects/<project>/frames وينتظر تعديلات الآخرين على /api/v1/projects/<project>/poll، مبقيًا كل طلب مفتوحًا لمدة تصل إلى OLEAFLY_POLL_HOLD_SECONDS. كل تعديل يصل رغم ذلك. يجرّب Oleafly اتصال WebSocket مرة أخرى كل دقيقة ويعود إليه فور نجاح أحدها.

يخبرك Test connection في Oleafly وConnection checks في لوحة الإدارة متى يحدث هذا: «Live edits take a slower route because this network blocks the usual one. They still arrive.»

إذا كنت تشغّل الوكيل أمام الخادم، فمرّر ترقيات WebSocket على أي حال. يعمل long-polling، لكن كل دفعة تعديلات تكلف طلبًا إضافيًا وتأخيرًا أطول قليلًا.

تغلق بعض الوكلاء الطلب الذي يصمت لأقل من 30 ثانية، وnginx بقيمة proxy_read_timeout قصيرة أحد أمثلتها. تجيب هؤلاء طلبات long-polling بخطأ 502 أو 504، فتصل التعديلات متأخرة. اضبط OLEAFLY_POLL_HOLD_SECONDS أقل ببضع ثوانٍ من تلك المهلة، مثل 8 لمهلة مدتها 10 ثوانٍ.

يدوّن الخادم عنوان العميل في موضعين: سجل الأمان، والحدود المفروضة على عدد مرات بدء عنوان ما لتسجيل الدخول أو فتح اتصال مباشر.

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

مع OLEAFLY_BEHIND_PROXY=true، يقرأ الخادم ترويسة X-Forwarded-For ويستخدم آخر عنوان فيها، وهو الذي أضافه وكيلك. إذا كانت الترويسة مفقودة أو لا تحوي عنوانًا صالحًا، يرجع الخادم إلى عنوان الاتصال. لا يتغير شيء آخر. يتجاهل الخادم X-Forwarded-Proto وX-Forwarded-Host وForwarded، ويبني كل عنوان يوزعه من OLEAFLY_PUBLIC_URL.

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

مع وكيلين متتاليين، مثلًا Cloudflare أمام وكيل Coolify، اضبط OLEAFLY_PROXY_HOPS=2. عندئذ يأخذ الخادم العنوان الثاني من النهاية. احسب الوكلاء الذين يمر عبرهم كل طلب فقط. ونفق Cloudflare Tunnel الذي يقود مباشرة إلى الخادم يُحسب واحدًا.

للتحقق من الرقم، سجّل الدخول من حاسوبك وافتح Security log في لوحة الإدارة. ينبغي أن يعرض أحدث مدخل عنوانك العام، وهو العنوان الذي يخبرك به موقع مثل ifconfig.me. إذا عرض بدلًا منه عنوانًا خاصًا أو عنوان Cloudflare، فارفع OLEAFLY_PROXY_HOPS بمقدار واحد.

يمرّر Caddy اتصالات WebSocket وX-Forwarded-For من دون إعدادات إضافية، ويحصل على الشهادة بنفسه. تحتوي صفحة وضع HTTPS في المقدمة على ملف Caddyfile كاملًا.

احصل أولًا على شهادة للنطاق، مثلًا باستخدام certbot. ثم احفظ هذا باسم /etc/nginx/conf.d/oleafly.conf وشغّل sudo nginx -t && sudo systemctl reload nginx:

map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
listen 443 ssl;
server_name collab.example.org;
ssl_certificate /etc/letsencrypt/live/collab.example.org/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/collab.example.org/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_read_timeout 1h;
proxy_send_timeout 1h;
client_max_body_size 200m;
}
}

يطابق client_max_body_size القيمة الافتراضية لـ OLEAFLY_MAX_PROJECT_MB وهي 200. إذا رفعت أحدهما فارفع الآخر.

تحتاج إلى Apache 2.4.47 أو أحدث، وهو ما تتضمنه Debian 12 وUbuntu 22.04 وما بعدهما. شغّل الوحدات:

نافذة المحطة الطرفية
sudo a2enmod proxy proxy_http ssl

احفظ هذا باسم /etc/apache2/sites-available/oleafly.conf، ثم شغّل sudo a2ensite oleafly && sudo systemctl reload apache2:

<VirtualHost *:443>
ServerName collab.example.org
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/collab.example.org/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/collab.example.org/privkey.pem
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:8080/ upgrade=websocket timeout=3600
ProxyPassReverse / http://127.0.0.1:8080/
</VirtualHost>

يمرّر upgrade=websocket اتصالات WebSocket، ويُبقي timeout=3600 تلك الاتصالات مفتوحة لمدة ساعة. ويضيف Apache عنوان العميل إلى X-Forwarded-For من تلقاء نفسه.

إذا كان الخادم يقبع تحت مسار، فضمّن المسار في OLEAFLY_PUBLIC_URL، مثل https://www.cs.example.edu/oleafly، وفي عناوين رد الاتصال التي تسجّلها لدى مزوّدي تسجيل الدخول. يجيب الخادم مع هذا المسار ومن دونه على السواء، فيستطيع وكيلك تمريره أو تجريده. مع nginx، استخدم location /oleafly/ { بالأسطر نفسها في الداخل، وأبقِ proxy_pass http://127.0.0.1:8080; من دون مسار ليمرّر nginx المسار.

حدود صف دراسي كامل على شبكة واحدة

قسم بعنوان “حدود صف دراسي كامل على شبكة واحدة”

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

  • تسجيلات الدخول: يحصل العنوان الواحد على دفعة من 300 طلب تسجيل دخول، ثم طلبين في الثانية. يستغرق تسجيل الدخول الواحد نحو ستة طلبات، فيستطيع 50 شخصًا تسجيل الدخول في الوقت نفسه. غيّر هذين الإعدادين عبر OLEAFLY_SIGN_IN_BURST وOLEAFLY_SIGN_IN_PER_MINUTE.
  • روابط البريد الإلكتروني: 100 لعنوان واحد في 15 دقيقة، و3 لعنوان بريد إلكتروني واحد. غيّر هذين الإعدادين عبر OLEAFLY_EMAIL_LINKS_PER_IP وOLEAFLY_EMAIL_LINKS_PER_ADDRESS.
  • رموز تسجيل الدخول: 100 رمز، و10 رموز خاطئة، من عنوان واحد في 10 دقائق. غيّر هذا الإعداد عبر OLEAFLY_DEVICE_CODES_PER_IP.
  • الاتصالات المباشرة لها حدّها الخاص الأكبر، بحيث يستطيع صف كامل خلف عنوان واحد إعادة الاتصال دفعة واحدة بعد إعادة التشغيل. الاتصالات التي تفشل في إثبات جلستها وحدها تستهلك هذا الحد: دفعة من 300، ثم عشرة في الثانية. أما الاتصال الذي يثبت جلسته فيُحسب على جهازه الخاص بدلًا من ذلك، وهو يستطيع إعادة الاتصال 60 مرة في دفعة، ثم مرة في الثانية.

تُحسب كل عناوين IPv6 في شبكة /64 واحدة عنوانًا واحدًا. ولا تعمل هذه الحدود لكل شخص على حدة إلا حين يرى الخادم العنوان الحقيقي لكل شخص، لذا اضبط وكيلك ضبطًا صحيحًا.

يرسل الخادم ping إلى كل اتصال مباشر كل 30 ثانية. ويغلق الاتصال الذي يترك تلك الأوامر بلا رد لمدة 90 ثانية، والاتصال الذي يتوقف عن قراءة ما يرسله الخادم.

تنطبق حدود المشاريع على الجميع: OLEAFLY_MAX_PROJECT_MB للمشروع كاملًا (200 ميغابايت افتراضيًا)، وOLEAFLY_MAX_FILE_MB للملف الواحد (50 ميغابايت)، وOLEAFLY_MAX_MEMBERS_PER_PROJECT للأشخاص في مشروع واحد (20). تعرض Overview في لوحة الإدارة الحدود الحالية.

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

الحدالإعدادمع التسجيل المفتوح
مساحة تخزين المشاريع التي يملكها الحسابOLEAFLY_ACCOUNT_STORAGE_MB100 ميغابايت
المشاريع المشتركة التي يملكها الحسابOLEAFLY_MAX_PROJECTS_PER_ACCOUNT50
عمليات الرفع التي يجريها الحساب في ساعةOLEAFLY_UPLOADS_PER_HOUR300

القيمة التي تعيّنها تتقدّم دائمًا على القيمة الافتراضية. ويجب أن تكون كل قيمة عددًا صحيحًا لا يقل عن 1.

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

لا تعرض Overview في لوحة الإدارة هذه الحدود. ومع تفعيل التسجيل المفتوح، يذكرها سجل الخادم في كل مرة يبدأ فيها.

  • سجل الخادم هو ما يعرضه docker compose logs oleafly-server أو Logs في Coolify أو journalctl -u oleafly-server. يحدد OLEAFLY_LOG_LEVEL مقدار ما يقوله.
  • سجل الأمان يسجّل عمليات تسجيل الدخول والمرفوض منها، والأجهزة، والأشخاص، والأدوار، والإعدادات، والمشاريع، والضيوف، كل مع وقته وعنوان IP الخاص به. يقرأه المشرفون والقائمون على الصيانة تحت Security log في لوحة الإدارة. وتُحذف المدخلات الأقدم من OLEAFLY_SECURITY_LOG_DAYS يومًا.
  • سجلات الوصول إلى المشاريع تسجّل من فتح مشروعًا أو انضم إليه أو نزّل نسخة منه، مع اسم الجهاز والوقت. يفعّلها مالك المشروع، عندما يكون الخيار Allow project access logs مفعّلًا، ولا يقرأها إلا ذلك المالك. وتنطبق مدة الاحتفاظ نفسها.

يعتمد ما يحتاجه النسخ الاحتياطي الكامل على مكان تخزين الملفات:

  • الملفات على القرص (OLEAFLY_BLOB_STORE=fs، الافتراضي): قاعدة البيانات والملفات واللقطات كلها في مجلد البيانات. انسخ المجلد كاملًا احتياطيًا.
  • الملفات في حاوية: يحتفظ مجلد البيانات بقاعدة البيانات، وتحتفظ الحاوية بالملفات واللقطات. نسخة من قاعدة البيانات مضافًا إليها الحاوية تساوي نسخًا احتياطيًا كاملًا. فعّل تعيين الإصدارات للحاوية حتى يمكن استرجاع كائن حُذف خطأً.
أين يحتفظ الخادم بالبيانات، وما الذي ينبغي نسخه احتياطيًاعند حفظ الملفات على القرص، وهو الخيار الافتراضي، يضم مجلد البيانات قاعدة البيانات ومجلد blobs الذي يحوي الملفات واللقطات، لذلك تنسخ المجلد كاملًا احتياطيًا. وعند حفظ الملفات في حاوية، يضم مجلد البيانات قاعدة البيانات وتحتفظ حاوية S3 بالملفات واللقطات، لذلك تنسخ قاعدة البيانات والحاوية احتياطيًا.الملفات على القرص (افتراضي)الملفات في حاويةoleafly-serverمجلد البياناتقاعدة البيانات: الحسابات والإعدادات والسجلاتblobs: الملفات واللقطاتانسخ المجلد كاملًا احتياطيًاoleafly-serverمجلد البياناتقاعدة البياناتحاوية تخزين S3الملفاتواللقطاتانسخ احتياطيًا قاعدة البيانات والحاويةأين يحتفظ الخادم بالبيانات، وما الذي ينبغي نسخه احتياطيًاعند حفظ الملفات على القرص، وهو الخيار الافتراضي، يضم مجلد البيانات قاعدة البيانات ومجلد blobs الذي يحوي الملفات واللقطات، لذلك تنسخ المجلد كاملًا احتياطيًا. وعند حفظ الملفات في حاوية، يضم مجلد البيانات قاعدة البيانات وتحتفظ حاوية S3 بالملفات واللقطات، لذلك تنسخ قاعدة البيانات والحاوية احتياطيًا.الملفات على القرص (افتراضي)الملفات في حاويةoleafly-serverمجلد البياناتقاعدة البيانات وblobs(الملفات واللقطات)انسخ المجلد كاملًا احتياطيًاoleafly-serverمجلد البياناتقاعدة البياناتحاوية تخزين S3الملفاتواللقطاتانسخ احتياطيًا قاعدة البياناتوالحاوية
يعتمد ما يحتاج إليه النسخ الاحتياطي الكامل على مكان تخزين الملفات.

انسخ احتياطيًا بانتظام واحتفظ بالنسخ في مكان خاص، لأنها تحوي كل مشروع. إعداداتك، مثل .env، ليست في مجلد البيانات، فاحتفظ بنسخة منها أيضًا.

مع Docker، يتوقف الخادم بضع ثوانٍ أثناء نسخ الحجم. يعيد Oleafly الاتصال من تلقاء نفسه. شغّل هذه الأوامر في مجلد الخادم، وهو /opt/oleafly-server إذا استخدمت المثبّت.

نافذة المحطة الطرفية
cd /opt/oleafly-server
sudo docker compose stop oleafly-server
sudo docker run --rm -v oleafly-server_oleafly-data:/data:ro -v "$PWD":/backup debian:13.7-slim tar -C /data -czf /backup/oleafly-data-$(date +%F).tar.gz .
sudo docker compose start oleafly-server

مع systemd:

نافذة المحطة الطرفية
sudo systemctl stop oleafly-server
sudo tar -C /var/lib/private/oleafly-server -czf /root/oleafly-data-$(date +%F).tar.gz .
sudo systemctl start oleafly-server

انسخ الأرشيف إلى جهاز آخر.

على Coolify، يبدأ اسم الحجم بمعرّف المورد. اعثر عليه بالأمر docker volume ls --filter name=oleafly-data، واستخدمه بدلًا من oleafly-server_oleafly-data، وأوقف الخادم وابدأه من لوحة Coolify بدلًا من docker compose.

النسخة الاحتياطية التي لم تستعدها قط ليست إلا أمنية. يبدأ هذا التدريب نسخة ثانية من الخادم من نسخة احتياطية، ويترك النسخة العاملة وشأنها، ويتحقق من أن كليهما الخادم نفسه. استخدم تاريخ أرشيفك بدلًا من 2026-10-11.

نافذة المحطة الطرفية
cd /opt/oleafly-server
sudo docker volume create oleafly-restore-drill
sudo docker run --rm -v oleafly-restore-drill:/data -v "$PWD":/backup:ro debian:13.7-slim tar -C /data -xzf /backup/oleafly-data-2026-10-11.tar.gz
sudo docker run -d --name oleafly-restore-drill -v oleafly-restore-drill:/data -e OLEAFLY_PUBLIC_URL=https://restore-drill.invalid -e OLEAFLY_GITHUB_CLIENT_ID=restore-drill -e OLEAFLY_GITHUB_CLIENT_SECRET=restore-drill "$(sudo docker compose images -q oleafly-server)"
sudo docker run --rm --network container:oleafly-restore-drill curlimages/curl:8.22.0 -fsS --retry 10 --retry-connrefused --retry-delay 1 http://127.0.0.1:8080/.well-known/oleafly-server
curl -fsS https://collab.example.org/.well-known/oleafly-server

يجب أن يتطابق server_id في الإجابتين. للنسخة التدريبية تسجيل دخول GitHub صوري لا يستطيع تسجيل دخول أي أحد، ولا منفذ مفتوح، فلا يستطيع أحد استخدامها. أزلها متى انتهيت:

نافذة المحطة الطرفية
sudo docker rm -f oleafly-restore-drill
sudo docker volume rm oleafly-restore-drill

للاستعادة الفعلية مع Docker Compose، أوقف الخادم، واستبدل محتويات الحجم بالأرشيف، ثم ابدأه من جديد:

نافذة المحطة الطرفية
cd /opt/oleafly-server
sudo docker compose stop oleafly-server
sudo docker run --rm -v oleafly-server_oleafly-data:/data -v "$PWD":/backup:ro debian:13.7-slim sh -c 'find /data -mindepth 1 -delete && tar -C /data -xzf /backup/oleafly-data-2026-10-11.tar.gz'
sudo docker compose start oleafly-server

مع systemd:

نافذة المحطة الطرفية
sudo systemctl stop oleafly-server
sudo find /var/lib/private/oleafly-server -mindepth 1 -delete
sudo tar -C /var/lib/private/oleafly-server -xzf /root/oleafly-data-2026-10-11.tar.gz
sudo systemctl start oleafly-server

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

لا يحتفظ الأرشيف إلا بما كان موجودًا وقت إنشائه. ينسخ Litestream (يفتح في علامة تبويب جديدة) كل تغيير على قاعدة بيانات الخادم إلى حاوية متوافقة مع S3 بعد نحو ثانية من حدوثه. ويتضمنه ملف Compose خدمةً اختيارية.

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

  1. أنشئ حاوية، أو مجلدًا داخل حاوية، لا يستخدمه إلا Litestream الخاص بهذا الخادم. لا تشاركه مع OLEAFLY_BLOB_STORE. أعطِ Litestream مفتاحًا يستطيع به سرد محتويات الحاوية وقراءة الكائنات فيها والكتابة عليها وحذفها.

  2. أضف التفاصيل إلى .env:

    نافذة المحطة الطرفية
    LITESTREAM_REPLICA_URL=s3://lab-backups/oleafly-server
    LITESTREAM_REGION=eu-west-1
    LITESTREAM_ACCESS_KEY_ID=your-access-key-id
    LITESTREAM_SECRET_ACCESS_KEY=your-secret-access-key
    COMPOSE_PROFILES=litestream

    بالنسبة لمخزن غير Amazon S3، اضبط أيضًا LITESTREAM_ENDPOINT على عنوانه وLITESTREAM_REGION على المنطقة التي يتوقعها (auto في حالة R2). يجعل COMPOSE_PROFILES كل أمر docker compose يتضمن Litestream.

  3. ابدأه:

    نافذة المحطة الطرفية
    sudo docker compose up -d
  4. تحقق من أنه نسخ قاعدة البيانات. يطبع هذا سطرًا يحوي snapshot complete:

    نافذة المحطة الطرفية
    sudo docker compose logs litestream | grep 'snapshot complete'

يأخذ Litestream نسخة كاملة مرة يوميًا ويحتفظ بأسبوع من النسخ والتغييرات الواقعة بينها. الجدول الزمني في litestream.yml.

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

نافذة المحطة الطرفية
cd /opt/oleafly-server
sudo docker run --rm -v oleafly-litestream-drill:/data "$(sudo docker compose images -q oleafly-server)" --version
sudo docker compose run --rm --no-deps -v oleafly-litestream-drill:/restore litestream restore -config /etc/litestream.yml -o /restore/oleafly-server.sqlite3 /data/oleafly-server.sqlite3
sudo docker run -d --name oleafly-litestream-drill -v oleafly-litestream-drill:/data -e OLEAFLY_PUBLIC_URL=https://restore-drill.invalid -e OLEAFLY_GITHUB_CLIENT_ID=restore-drill -e OLEAFLY_GITHUB_CLIENT_SECRET=restore-drill "$(sudo docker compose images -q oleafly-server)"
sudo docker run --rm --network container:oleafly-litestream-drill curlimages/curl:8.22.0 -fsS --retry 10 --retry-connrefused --retry-delay 1 http://127.0.0.1:8080/.well-known/oleafly-server
curl -fsS https://collab.example.org/.well-known/oleafly-server

ينشئ الأمر الأول الحجم المؤقت بالمالك الذي يحتاجه الخادم. يجب أن يتطابق server_id في الإجابتين الأخيرتين. أزل النسخة متى انتهيت:

نافذة المحطة الطرفية
sudo docker rm -f oleafly-litestream-drill
sudo docker volume rm oleafly-litestream-drill

استعادة قاعدة البيانات من Litestream

قسم بعنوان “استعادة قاعدة البيانات من Litestream”

عندما يكون ملف قاعدة البيانات تالفًا أو مفقودًا لكن بقية مجلد البيانات سليمة، أوقف الخادم وLitestream، واحذف ما بقي من قاعدة البيانات، ثم استعدها وابدأ من جديد:

نافذة المحطة الطرفية
cd /opt/oleafly-server
sudo docker compose stop oleafly-server litestream
sudo docker run --rm -v oleafly-server_oleafly-data:/data debian:13.7-slim rm -rf /data/oleafly-server.sqlite3 /data/oleafly-server.sqlite3-wal /data/oleafly-server.sqlite3-shm /data/.oleafly-server.sqlite3-litestream
sudo docker compose run --rm --no-deps litestream restore -config /etc/litestream.yml /data/oleafly-server.sqlite3
sudo docker compose up -d

بعد فقدان قرص مع ملفات في حاوية، شغّل الأوامر أعلاه على الحجم الجديد الفارغ وأبقِ إعدادات الحاوية نفسها في .env. يعود كل مشروع بملفاته ولقطاته.

بعد فقدان قرص مع ملفات على القرص، استعِد أحدث أرشيف لديك واكتفِ بذلك. لا تضع قاعدة بيانات أحدث من Litestream فوق أرشيف أقدم. ستشير قاعدة البيانات حينئذ إلى ملفات ولقطات لا يملكها الأرشيف، ولن تُفتح تلك المشاريع.

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

  • التثبيت بأمر واحد: شغّل curl -fsSL https://oleafly.com/server/install.sh | sudo sh -s -- update. يبقي .env، ويجلب ملفات الإصدارة الجديدة وصورتها، ويعيد تشغيل الخادم.
  • Docker Compose يدويًا: نزّل ملفات الإصدارة الجديدة إلى مجلد الخادم كما في Docker Compose يدويًا، ثم شغّل sudo docker compose up -d.
  • Coolify: اختر Redeploy. مع الصورة المنشورة، يجلب ذلك أحدث إصدارة تحت وسم الصورة.
  • Render: افتح الخدمة وابدأ نشرًا يدويًا، وهو يجلب الصورة مرة أخرى.
  • Railway: انشر الخدمة مجددًا من قائمتها. ويستطيع Railway أيضًا تحديث صورة من سجل GitHub بنفسه.
  • systemd: ثبّت الإصدارة الجديدة كما في تنزيل الخادم، ثم شغّل sudo systemctl restart oleafly-server.

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

معاينة الصورة

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

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