تشغيل خادم
التخزين والنسخ الاحتياطي والحدود
كل إعدادات 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 في الحالتين، لذا يظل الخادم بحاجة إلى مجلد البيانات الخاص به.
-
أنشئ حاوية وامنع الوصول العام إليها.
-
أنشئ مفتاحًا يستطيع قراءة الكائنات في تلك الحاوية والكتابة فيها وحذفها، ولا شيء غير ذلك. على Amazon S3 يعني ذلك
s3:GetObjectوs3:PutObjectوs3:DeleteObjectعلىarn:aws:s3:::lab-bucket/*، أو علىarn:aws:s3:::lab-bucket/oleafly/*إذا استخدمت مجلدًا. -
اضبط المتغيرات، مثلًا في
.env:نافذة المحطة الطرفية OLEAFLY_BLOB_STORE=s3://lab-bucket/oleaflyOLEAFLY_S3_REGION=eu-west-1OLEAFLY_S3_ACCESS_KEY_ID=your-access-key-idOLEAFLY_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 المجمّعة
قسم بعنوان “ملفات PDF المجمّعة”عندما يجمّع مالك أو محرر مشروعًا مشتركًا بنجاح، يرسل تطبيقه ملف 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”تحجب بعض الشبكات اتصالات 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
قسم بعنوان “ما الذي يغيّره OLEAFLY_BEHIND_PROXY”يدوّن الخادم عنوان العميل في موضعين: سجل الأمان، والحدود المفروضة على عدد مرات بدء عنوان ما لتسجيل الدخول أو فتح اتصال مباشر.
من دون هذا الإعداد، يستخدم الخادم عنوان أي جهة اتصلت به. وخلف وكيل تكون تلك الجهة دائمًا هي الوكيل، فيتقاسم الجميع حدًّا واحدًا ولا يعرض سجل الأمان سوى عنوان الوكيل.
مع 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
قسم بعنوان “Caddy”يمرّر Caddy اتصالات WebSocket وX-Forwarded-For من دون إعدادات إضافية، ويحصل على الشهادة بنفسه. تحتوي صفحة وضع HTTPS في المقدمة على ملف Caddyfile كاملًا.
nginx
قسم بعنوان “nginx”احصل أولًا على شهادة للنطاق، مثلًا باستخدام 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
قسم بعنوان “Apache”تحتاج إلى 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_MB | 100 ميغابايت |
| المشاريع المشتركة التي يملكها الحساب | OLEAFLY_MAX_PROJECTS_PER_ACCOUNT | 50 |
| عمليات الرفع التي يجريها الحساب في ساعة | OLEAFLY_UPLOADS_PER_HOUR | 300 |
القيمة التي تعيّنها تتقدّم دائمًا على القيمة الافتراضية. ويجب أن تكون كل قيمة عددًا صحيحًا لا يقل عن 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، الافتراضي): قاعدة البيانات والملفات واللقطات كلها في مجلد البيانات. انسخ المجلد كاملًا احتياطيًا. - الملفات في حاوية: يحتفظ مجلد البيانات بقاعدة البيانات، وتحتفظ الحاوية بالملفات واللقطات. نسخة من قاعدة البيانات مضافًا إليها الحاوية تساوي نسخًا احتياطيًا كاملًا. فعّل تعيين الإصدارات للحاوية حتى يمكن استرجاع كائن حُذف خطأً.
انسخ احتياطيًا بانتظام واحتفظ بالنسخ في مكان خاص، لأنها تحوي كل مشروع. إعداداتك، مثل .env، ليست في مجلد البيانات، فاحتفظ بنسخة منها أيضًا.
مع Docker، يتوقف الخادم بضع ثوانٍ أثناء نسخ الحجم. يعيد Oleafly الاتصال من تلقاء نفسه. شغّل هذه الأوامر في مجلد الخادم، وهو /opt/oleafly-server إذا استخدمت المثبّت.
cd /opt/oleafly-serversudo docker compose stop oleafly-serversudo 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-serversudo 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-serversudo docker volume create oleafly-restore-drillsudo 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.gzsudo 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-servercurl -fsS https://collab.example.org/.well-known/oleafly-serverيجب أن يتطابق server_id في الإجابتين. للنسخة التدريبية تسجيل دخول GitHub صوري لا يستطيع تسجيل دخول أي أحد، ولا منفذ مفتوح، فلا يستطيع أحد استخدامها. أزلها متى انتهيت:
sudo docker rm -f oleafly-restore-drillsudo docker volume rm oleafly-restore-drillالاستعادة
قسم بعنوان “الاستعادة”للاستعادة الفعلية مع Docker Compose، أوقف الخادم، واستبدل محتويات الحجم بالأرشيف، ثم ابدأه من جديد:
cd /opt/oleafly-serversudo docker compose stop oleafly-serversudo 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-serversudo find /var/lib/private/oleafly-server -mindepth 1 -deletesudo tar -C /var/lib/private/oleafly-server -xzf /root/oleafly-data-2026-10-11.tar.gzsudo systemctl start oleafly-serverينقص الخادم المستعاد التغييرات التي أجراها الناس بعد النسخ الاحتياطي. يلاحظ كل تطبيق ذلك عند إعادة اتصاله، سواء بقي مفتوحًا أو فُتح لاحقًا، ويعيد إرسال تغييراته الناقصة. لا يتعين على أحد فعل أي شيء لذلك. التغيير المبني على تغيير ناقص لشخص آخر ينتظر حتى يفتح ذلك الشخص المشروع، لأن تطبيقه وحده يستطيع إرسال تغييراته. اطلب من كل من كان يحرر قرب وقت العطل أن يفتح المشروع مرة واحدة.
نسخ مستمرة باستخدام Litestream
قسم بعنوان “نسخ مستمرة باستخدام Litestream”لا يحتفظ الأرشيف إلا بما كان موجودًا وقت إنشائه. ينسخ Litestream (يفتح في علامة تبويب جديدة) كل تغيير على قاعدة بيانات الخادم إلى حاوية متوافقة مع S3 بعد نحو ثانية من حدوثه. ويتضمنه ملف Compose خدمةً اختيارية.
ينسخ Litestream قاعدة البيانات فقط. إذا كانت الملفات في حاوية، فالحاوية تحمل أصلًا الملفات واللقطات، فتستطيع نسخة Litestream مع الحاوية معًا إرجاع قرص مفقود. أما إذا كانت الملفات على القرص فواصل إنشاء أرشيفات للحجم أيضًا، لأن Litestream لا ينسخ مجلد blobs.
-
أنشئ حاوية، أو مجلدًا داخل حاوية، لا يستخدمه إلا Litestream الخاص بهذا الخادم. لا تشاركه مع
OLEAFLY_BLOB_STORE. أعطِ Litestream مفتاحًا يستطيع به سرد محتويات الحاوية وقراءة الكائنات فيها والكتابة عليها وحذفها. -
أضف التفاصيل إلى
.env:نافذة المحطة الطرفية LITESTREAM_REPLICA_URL=s3://lab-backups/oleafly-serverLITESTREAM_REGION=eu-west-1LITESTREAM_ACCESS_KEY_ID=your-access-key-idLITESTREAM_SECRET_ACCESS_KEY=your-secret-access-keyCOMPOSE_PROFILES=litestreamبالنسبة لمخزن غير Amazon S3، اضبط أيضًا
LITESTREAM_ENDPOINTعلى عنوانه وLITESTREAM_REGIONعلى المنطقة التي يتوقعها (autoفي حالة R2). يجعلCOMPOSE_PROFILESكل أمرdocker composeيتضمن Litestream. -
ابدأه:
نافذة المحطة الطرفية sudo docker compose up -d -
تحقق من أنه نسخ قاعدة البيانات. يطبع هذا سطرًا يحوي
snapshot complete:نافذة المحطة الطرفية sudo docker compose logs litestream | grep 'snapshot complete'
يأخذ Litestream نسخة كاملة مرة يوميًا ويحتفظ بأسبوع من النسخ والتغييرات الواقعة بينها. الجدول الزمني في litestream.yml.
تدريب الاستعادة عبر Litestream
قسم بعنوان “تدريب الاستعادة عبر Litestream”يستعيد هذا التدريب قاعدة البيانات من الحاوية إلى حجم مؤقت، ويبدأ عليه نسخة ثانية من الخادم، ويتحقق من أن كليهما الخادم نفسه. لا يُمس الخادم العامل.
cd /opt/oleafly-serversudo docker run --rm -v oleafly-litestream-drill:/data "$(sudo docker compose images -q oleafly-server)" --versionsudo 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.sqlite3sudo 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-servercurl -fsS https://collab.example.org/.well-known/oleafly-serverينشئ الأمر الأول الحجم المؤقت بالمالك الذي يحتاجه الخادم. يجب أن يتطابق server_id في الإجابتين الأخيرتين. أزل النسخة متى انتهيت:
sudo docker rm -f oleafly-litestream-drillsudo docker volume rm oleafly-litestream-drillاستعادة قاعدة البيانات من Litestream
قسم بعنوان “استعادة قاعدة البيانات من Litestream”عندما يكون ملف قاعدة البيانات تالفًا أو مفقودًا لكن بقية مجلد البيانات سليمة، أوقف الخادم وLitestream، واحذف ما بقي من قاعدة البيانات، ثم استعدها وابدأ من جديد:
cd /opt/oleafly-serversudo docker compose stop oleafly-server litestreamsudo 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-litestreamsudo docker compose run --rm --no-deps litestream restore -config /etc/litestream.yml /data/oleafly-server.sqlite3sudo 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 أيّهما يحتاج إلى تحديث.