اختيار طريقة التثبيت
يعمل Arkvory على خادم واحد. ولكل تثبيت الأجزاء نفسها:
- API: واجهة HTTP API ووحدة التحكم على الويب.
- العامل (worker): ينهي عمليات الرفع وينفّذ مهام الخلفية.
- وكيل النسخ الاحتياطي: ينشئ نسخًا احتياطية مجدولة في مخزن النسخ الاحتياطية.
- PostgreSQL: قاعدة بيانات الفهرس.
يُخزَّن محتوى الملفات على قرص محلي في الخادم. الخادم الواحد ليس نظام توافر عالٍ: يسبب التحديث أو تعطل الخادم انقطاعًا قصيرًا، ويستأنف العملاء عمليات النقل. وللحصول على خادمين أو ثلاثة خوادم Linux تحتفظ بنسخة متزامنة وتتولى المهام عن بعضها، راجع عنقود التوافر العالي.
خيارات التثبيت
| الخيار | المنصة | يبدأ بعد إعادة التشغيل دون تسجيل دخول | قاعدة البيانات | التحديثات التلقائية بعد التثبيت | موصى به لـ |
|---|---|---|---|---|---|
برنامج التثبيت الرسومي Arkvory-Setup-x64.exe | Windows x64 | نعم (خدمات Windows) | PostgreSQL 18.4 مضمَّن، يديره Arkvory | متوقفة | خوادم Windows ومحطات العمل، والتثبيت دون اتصال بالإنترنت |
حزمة Linux Arkvory-amd64.deb وArkvory-x86_64.rpm | Linux x64 مع systemd | نعم (وحدات systemd) | عنقود PostgreSQL مخصص من توزيعتك (الإصدار 16 إلى 19) | متوقفة | خوادم Debian وUbuntu والخوادم المعتمدة على RPM |
نص برمجي، خدمات أصلية: install.sh (Linux)، install.ps1 (Windows) | Linux x64 أو arm64 مع systemd، وWindows x64 | نعم | خادم PostgreSQL الموجود لديك | متوقفة، أو مفعّلة مع --automatic / -AutomaticUpdates | الأتمتة، وخادم PostgreSQL قائم، وLinux arm64 |
| Docker Compose | Linux مع Docker Engine | نعم، إذا بدأ محرك الحاويات عند الإقلاع | حاوية PostgreSQL 18.4 | متوقفة، أو مفعّلة مع --automatic | مضيفات الحاويات |
| Docker Desktop | Windows x64 | لا. لا تعمل الحاويات إلا بعد أن يسجّل المستخدم الدخول ويبدأ Docker Desktop | حاوية PostgreSQL 18.4 | متوقفة، أو مفعّلة مع -AutomaticUpdates | التجربة على محطة عمل |
تثبّت كل الخيارات API والعامل ووكيل النسخ الاحتياطي نفسها. ويتوفر HTTPS المضمَّن للتثبيتات الأصلية فقط. أما تثبيت Compose فيحتاج إلى وكيل عكسي (reverse proxy) لتوفير HTTPS. راجع HTTPS والوكيل العكسي.
التثبيت عن بُعد عبر SSH
Arkvory Remote Setup جزء من حزم العميل. يعمل على حاسوب المسؤول، ويتصل بخادم عبر SSH، ويثبّت هناك حزمة Linux أو Windows الأصلية. ثم ينشئ حساب المالك ويفتح وحدة التحكم عبر نفق SSH خاص.
| الخادم | المتطلبات |
|---|---|
| Linux x64 | SSH وSFTP، وsystemd، وapt-get أو dnf، وroot أو مستخدم يملك sudo -n (دون طلب كلمة مرور) |
| Windows x64 | OpenSSH Server مع SFTP، وWindows PowerShell، وحساب مسؤول |
لا يعمل النفق إلا أثناء تشغيل Remote Setup، ولا ينشر Arkvory لحواسيب أخرى. ولا يُدعم sudo المحمي بكلمة مرور، ولا وكلاء SSH (SSH agents)، ولا مضيفات القفز (jump hosts)، ولا خوادم ARM.
محتويات الإصدار
تُنشر الإصدارات في github.com/ProAnima/Arkvory/releases.
| الملف | الغرض |
|---|---|
Arkvory-Setup-x64.exe | برنامج التثبيت الرسومي لـ Windows. يتضمن Node.js وPostgreSQL وWinSW وبيئة تشغيل Microsoft Visual C++ |
Arkvory-amd64.deb وArkvory-x86_64.rpm | حزم Linux. تتضمن Node.js |
install.sh وinstall.ps1 | برامج تثبيت بسطر الأوامر للخدمات الأصلية أو Docker Compose |
Arkvory-Linux.tar.gz وArkvory-Windows.zip | مجموعات الأتمتة: برنامج التثبيت بسطر الأوامر وملفات الإصدار، للتثبيت دون وصول إلى GitHub Releases |
Arkvory-CLI-Setup-x64.exe وArkvory-CLI-amd64.deb وArkvory-CLI-x86_64.rpm | حزم العميل: عميل سطر الأوامر arkvoryctl وArkvory Remote Setup |
arkvoryctl.mjs وarkvory-remote.mjs | أدوات العميل نفسها في ملفات مفردة لـ Node.js 24 |
arkvory-runtime.zip وarkvory-setup.mjs وarkvory-release.json وarkvory-release.json.sig وrelease-checksums.json وnative-*.json | ملفات البرنامج وملفات البيان والمجاميع الاختبارية والتوقيع. تقرؤها برامج التثبيت وبرنامج التحديث |
المتطلبات
| العنصر | المتطلب |
|---|---|
| Windows، برنامج التثبيت الرسومي | x64، إصدار Windows 10.0.17763 أو أحدث (Windows 10 الإصدار 1809، Windows Server 2019). صلاحيات المسؤول |
| Windows، النص البرمجي | x64، وWindows PowerShell. صلاحيات المسؤول للخدمات الأصلية |
| حزم Linux | x64، وsystemd، وglibc 2.28 أو أحدث، وPython 3. يثبّت مدير الحزم PostgreSQL 16 أو أحدث |
| Linux، النص البرمجي | x64 أو arm64، وsystemd للخدمات الأصلية، وglibc، وBash، وcurl، وPython 3، وtar، وxz |
| Docker Compose | Docker Engine مع إضافة Compose، أو Docker Desktop بوضع حاويات Linux. ويمكن استخدام Podman مع موفّر compose متوافق |
| PostgreSQL | قاعدة بيانات واحدة لتثبيت Arkvory واحد. لا تربط تثبيتين بقاعدة البيانات نفسها أبدًا |
| تخزين الملفات | نظام ملفات محلي يدعم الروابط الصلبة (hard links). لا تستخدم مشاركة شبكية لتخزين الملفات |
| مخزن النسخ الاحتياطية | وحدة تخزين منفصلة، مُحمَّلة (mounted) قبل بدء الخدمات. راجع النسخ الاحتياطية |
لا يحدد Arkvory حدودًا دنيا ثابتة للمعالج أو الذاكرة. خطّط لمساحة القرص لملفاتك وقاعدة البيانات ومخزن النسخ الاحتياطية. يُبقي Arkvory افتراضيًا 1 GiB من المساحة الحرة على وحدة التخزين، ويقبل حتى 10 TiB من عمليات الرفع المحجوزة. ويمكنك تغيير الحدين كليهما. راجع الإعداد.
الوصول إلى الشبكة أثناء التثبيت والتحديث
يعمل برنامج التثبيت الرسومي دون إنترنت. أما الخيارات الأخرى فتنزّل ملفات عبر HTTPS:
| المضيف | يستخدمه |
|---|---|
nodejs.org | ينزّل كل من install.sh وinstall.ps1 الإصدار 24.21.0 من Node.js ويتحقق من SHA-256 الخاص به |
api.github.com وgithub.com ومضيفات التنزيل في GitHub | برامج التثبيت النصية، والتحديثات عندما يتعذر الوصول إلى مركز التحديثات |
hub.proanima.net | التحقق من التحديثات وتنزيلها. راجع التحديثات |
| Docker Hub | يبني Compose صورته من node:24.21.0-bookworm-slim ويشغّل postgres:18.4 |
دون إنترنت، ثبّت وحدّث من نسخة محلية من الإصدار. راجع التحديثات.
المنافذ
| المنفذ | الخدمة | الإتاحة الافتراضية |
|---|---|---|
| 8080/TCP | API ووحدة التحكم (HTTP، أو HTTPS مع TLS المضمَّن) | 127.0.0.1 فقط. يمكن للتثبيت الأصلي أن يستمع إلى عناوين أخرى بعد إعداد HTTPS. وينشره Compose دائمًا على 127.0.0.1:8080 |
| 54329/TCP | PostgreSQL المُدار في برنامج التثبيت الرسومي وحزم Linux | 127.0.0.1 فقط |
| 5432/TCP | حاوية PostgreSQL في تثبيت Compose | غير منشور. لا يمكن الوصول إليه إلا داخل شبكة Compose |
افتح منفذ HTTPS فقط لشبكات العملاء. ولا تفتح منفذ قاعدة البيانات أبدًا.
دليل التثبيت
جذر التثبيت هو C:\ProgramData\ProAnima\Arkvory على Windows و/opt/proanima-arkvory على Linux. استخدم دليلًا مخصصًا فارغًا خارج الأدلة الرئيسية للمستخدمين (home) وملفاتهم الشخصية.
| المسار في الجذر | المحتوى |
|---|---|
installation.json | الإصدار المثبَّت ووضع التثبيت وإعداد التحديث التلقائي وتثبيت الإصدار (pin) |
journal.json وoperation.lock | حالة آخر تحديث، وقفل العملية الجارية |
launcher.mjs وmanage.mjs | يشغّلان الخدمات وأوامر الإدارة |
releases/<version>/ | شيفرة البرنامج لكل إصدار مثبَّت. لا تكتب الخدمات هنا |
runtime/ | Node.js. ويضع برنامج التثبيت الرسومي هنا أيضًا PostgreSQL وWinSW |
config/ | الإعدادات والمفاتيح ومفتاح الاسترداد. راجع الإعداد |
data/ | تخزين الملفات في التثبيت الأصلي |
database/ | عنقود PostgreSQL المُدار. وعلى Windows سجلاته أيضًا |
logs/ | سجلات خدمات Windows وسجل برنامج التحديث في Windows |
service/ | أغلفة خدمات Windows |
updates/ | طلبات التحديث من وحدة التحكم وحالة برنامج التحديث |
يحتفظ تثبيت Compose ببياناته في مجلدات Docker (volumes) باسم proanima-arkvory_storage (الملفات) وproanima-arkvory_catalog (قاعدة البيانات)، لا في data/.
لا تُحذف الإصدارات القديمة في releases/ تلقائيًا. وبعد تحديث ناجح يمكنك حذف الإصدارات غير المستخدمة. احتفظ بالإصدار الحالي وبالإصدار السابق المذكور في journal.json.
مفتاح الاسترداد
ينشئ برنامج التثبيت الملف config/bootstrap-token.txt. يحتوي هذا الملف على مفتاح الاسترداد: مفتاح بصلاحيات المسؤول. ولا يستطيع قراءته إلا root أو مجموعة Administrators.
- استخدمه مرة واحدة لإنشاء حساب المالك الأول إذا لم ينشئه برنامج التثبيت. وتطلبه وحدة التحكم عند أول تشغيل.
- تقرؤه أدوات التثبيت على الخادم: إنشاء المالك، و
arkvory configure --backup-vault، والتحقق من النسخة الاحتياطية بعد التحديث، والنسخة الاحتياطية قبل تغيير مخطط قاعدة البيانات. لا تحذف هذا الملف. - لا تنسخه إلى العملاء أو أنظمة CI أو النصوص البرمجية. وللعمل اليومي، أنشئ حسابات مستخدمين ومفاتيح خدمة بأذونات محدودة. راجع الحسابات والوصول.
لاستبدال مفتاح الاسترداد، راجع الإعداد.
الخطوات التالية
- ثبّت باستخدام الصفحة الخاصة بمنصتك: Windows أو Linux أو Docker Compose.
- سجّل الدخول وانشر أول ملف. راجع البدء السريع.
- اضبط HTTPS قبل أن يتصل العملاء من حواسيب أخرى.
- اربط مخزن نسخ احتياطية وشغّل أول نسخة احتياطية. راجع النسخ الاحتياطية.
- اختر سياسة التحديث.