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

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

تتناول هذه الصفحة تشغيل Oleafly Server وإدارته يومًا بعد يوم. لتثبيته، ابدأ بصفحة [تشغيل خادم تعاون](/docs/collaboration/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` | يعتبر كل عنوان بريد إلكتروني صادر عن هذا المزوّد عنوانًا موثّقًا. اقرأ [عناوين البريد الإلكتروني الموثّقة](/docs/collaboration/server-access/#verified-email-addresses) أولًا. | `false` |
| `OLEAFLY_SMTP_URL`, `OLEAFLY_MAIL_FROM` | البريد الإلكتروني. اقرأ [البريد الإلكتروني](/docs/collaboration/server-access/#email). | معطّل |
| `OLEAFLY_OPEN_SIGNUP` | يمنح كل من يسجّل الدخول عبر أحد مزوّديك حسابًا بدور عضو. اقرأ [التسجيل المفتوح](/docs/collaboration/server-access/#open-sign-up). | `false` |
| `OLEAFLY_WEB` | يشغّل الوصول عبر المتصفح. اقرأ [الوصول عبر المتصفح](/docs/collaboration/server-access/#browser-access). | `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` | أقصى ما يجوز أن تخزّنه المشاريع التي يملكها حساب واحد، بالميغابايت. اقرأ [الحدود لكل حساب](#limits-per-account). | بلا حد، أو `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](/docs/collaboration/server/#keep-secrets-out-of-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`:

   ```sh
   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 المجمّعة

عندما يجمّع مالك أو محرر مشروعًا مشتركًا بنجاح، يرسل تطبيقه ملف PDF إلى الخادم، مع ملف SyncTeX الخاص به إن وُجد. ويرسل ملفًا واحدًا على الأكثر في الدقيقة لكل مشروع. يحتفظ الخادم بملف PDF واحد وملف SyncTeX واحد لكل مشروع، مع اسم الملف الرئيسي ومن جمّعه ومتى. ويعرض [الوصول عبر المتصفح](/docs/collaboration/server-access/#browser-access) ملف PDF هذا للأشخاص في المشروع.

يحل كل رفع محل الذي قبله، ويُحذف الملف القديم بمجرد ألا يستخدمه شيء. وتُخزَّن الملفات المجمّعة مع الملفات الأخرى، على القرص أو في الحاوية، وتُحذف مع مشروعها. ويمكن أن يصل حجم الملف المجمّع إلى `OLEAFLY_MAX_FILE_MB`. ويُحتسب ضمن [مساحة تخزين الحساب](#limits-per-account) لدى المالك، لكنه لا يُحتسب ضمن عمليات الرفع في الساعة.

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

## خلف وكيل عكسي

يتحدث الخادم بلغة 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 بينما لا يزال الخادم يجيب عبر 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

يدوّن الخادم عنوان العميل في موضعين: سجل الأمان، و[الحدود](#limits-for-a-class-on-one-network) المفروضة على عدد مرات بدء عنوان ما لتسجيل الدخول أو فتح اتصال مباشر.

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

مع `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 اتصالات WebSocket و`X-Forwarded-For` من دون إعدادات إضافية، ويحصل على الشهادة بنفسه. تحتوي صفحة [وضع HTTPS في المقدمة](/docs/collaboration/server/#put-https-in-front) على ملف `Caddyfile` كاملًا.

### nginx

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

```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 2.4.47 أو أحدث، وهو ما تتضمنه Debian 12 وUbuntu 22.04 وما بعدهما. شغّل الوحدات:

```sh
sudo a2enmod proxy proxy_http ssl
```

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

```apache
<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` واحدة عنوانًا واحدًا. ولا تعمل هذه الحدود لكل شخص على حدة إلا حين يرى الخادم العنوان الحقيقي لكل شخص، لذا [اضبط وكيلك](#what-oleafly_behind_proxy-changes) ضبطًا صحيحًا.

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

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

## الحدود لكل حساب

تنطبق ثلاثة حدود على كل حساب. وهي معطّلة حتى تعيّنها، إلا إذا كان [التسجيل المفتوح](/docs/collaboration/server-access/#open-sign-up) مفعّلًا، فهو يشغّلها بهذه القيم الافتراضية:

| الحد | الإعداد | مع التسجيل المفتوح |
| --- | --- | --- |
| مساحة تخزين المشاريع التي يملكها الحساب | `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` إذا استخدمت المثبّت.

```sh
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:

```sh
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`.

```sh
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 صوري لا يستطيع تسجيل دخول أي أحد، ولا منفذ مفتوح، فلا يستطيع أحد استخدامها. أزلها متى انتهيت:

```sh
sudo docker rm -f oleafly-restore-drill
sudo docker volume rm oleafly-restore-drill
```

### الاستعادة

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

```sh
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:

```sh
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

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

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

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

   ```sh
   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. ابدأه:

   ```sh
   sudo docker compose up -d
   ```

4. تحقق من أنه نسخ قاعدة البيانات. يطبع هذا سطرًا يحوي `snapshot complete`:

   ```sh
   sudo docker compose logs litestream | grep 'snapshot complete'
   ```

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

#### تدريب الاستعادة عبر Litestream

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

```sh
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` في الإجابتين الأخيرتين. أزل النسخة متى انتهيت:

```sh
sudo docker rm -f oleafly-litestream-drill
sudo docker volume rm oleafly-litestream-drill
```

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

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

```sh
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`. يعود كل مشروع بملفاته ولقطاته.

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

## التحديث

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

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

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