> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/ar/alsyanh/data-and-backups/exporting-projects.md).

# تصدير المشاريع

في Server Pro وإصدار Community `5.4.0` لقد أدرجنا سكربتًا يتيح للمسؤولين تصدير جميع مشاريع المستخدمين (بما في ذلك تلك التي لا تزال ظاهرة في **المحذوفة** و **في سلة المهملات** المجلدات) إلى دليل على القرص.

{% hint style="info" %}
الناتج من تشغيل هذا السكربت هو نفسه كما لو قمت بتنزيل ملف Zip لجميع المشاريع يدويًا من لوحة تحكم مشاريع المستخدم. سيقوم السكربت بتفريغ أي تغييرات معلّقة قبل بدء التنزيل لضمان أن التصدير يحتوي على أحدث إصدار من المشروع.
{% endhint %}

### القيود

للسكربت الخاص بالتصدير القيود التالية:

* لا يتم تصدير أي إعدادات للمشروع، مثل اسم صورة TeX Live أو المترجم. يجب ضبط هذه الإعدادات عند رفع المشروع إلى حساب المستخدم.
* المشاريع المصدّرة لا تحتوي على أي سجل للإصدارات.
* لا يتم الاحتفاظ بأي معلومات عن المتعاونين. ستحتاج المشاريع إلى المشاركة مرة أخرى. إذا كنت تستخدم المشاركة عبر الرابط، فسيتم إعادة إنشاء روابط العرض والتحرير (لن تكون نفسها كما كانت من قبل).
* لن يتم تصدير أي تعليقات أو معلومات تتبع التغييرات.
* لن يتم تصدير سجل دردشة المشروع.

{% hint style="danger" %}
هذا السكربت **ليس** مُصمَّم ليحل محل النسخ الاحتياطي الكامل للنظام. ولضمان قدرتك على استعادة مثيلك في سيناريو التعافي من الكوارث، فإننا **نوصي بشدة** بأخذ [نسخة احتياطية متسقة](https://docs.overleaf.com/on-premises/maintenance/data-and-backups/..#performing-a-consistent-backup).
{% endhint %}

### **الخيارات**

| الاسم          | الوصف                                                                      |
| -------------- | -------------------------------------------------------------------------- |
| `--help`       | عرض المساعدة                                                               |
| `--user-id`    | معرّف المستخدم (مطلوب ما لم يتم استخدام `--export-all` أو `--project-id`)  |
| `--project-id` | تصدير مشروع واحد (**لا يمكن** استخدامه مع `--user-id` أو `--export-all`)   |
| `--list`       | عرض مشاريع المستخدم (**لا يمكن** استخدامه مع `--output`)                   |
| `--output`     | ملف zip الناتج (لعمليات التصدير الفردية)                                   |
| `--export-all` | تصدير مشاريع جميع المستخدمين (يتطلب `--output-dir`)                        |
| `--output-dir` | دليل لتخزين ملفات التصدير الخاصة بجميع المستخدمين                          |
| `--log-level`  | مستويات السجل المدعومة: `trace`\|`debug`\|`info`\|`warn`\|`error`\|`fatal` |

### **الاستخدام**

استخدم الأمر التالي لتصدير المشاريع لجميع المستخدمين:

{% code overflow="wrap" %}

```bash
# مستخدمو Overleaf Toolkit
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"

# مستخدمو docker-compose.yml القديم
docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"
```

{% endcode %}

{% hint style="info" %}
إذا كنت تشغّل Server Pro أو Community Editition <= 3.5.13 فستحتاج إلى تحديث المثال أعلاه لاستخدام **`export-legacy-user-projects.js`** السكربت.
{% endhint %}

### **الاكتمال**

بمجرد اكتمال التصدير، يمكنك الوصول إلى الملفات عبر الدليل الموجود على المضيف والمثبت كمجلد مرتبط إلى **/var/lib/overleaf** في **docker-compose.yml** الملف أو `OVERLEAF_DATA_PATH` متغير البيئة في **config/overleaf.rc** الملف إذا كنت تستخدم Toolkit.

{% hint style="info" %}
يسمح Overleaf حاليًا بأسماء مشاريع مكررة. إذا احتوى مشروع المستخدم على اسم مكرر، فسيظل إضافة هذه المشاريع إلى ملف Zip المصدَّر الخاص بالمستخدم، ولكن عند استخراجها لن يكون موجودًا إلا إصدار واحد. على Linux، `unzip -B` سيكتب الملفات التي تحمل الاسم نفسه كملفات نسخ احتياطية بدلًا من الكتابة فوقها.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/ar/alsyanh/data-and-backups/exporting-projects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
