install_desktop التثبيت · دون رسوم ترخيص & مفتوح المصدر

شغّلوا Klacks بأنفسكم — على بنيتكم التحتية الخاصة.

ثلاثة طرق، نتيجة واحدة: حزمة Windows لحاسوب مكتبكم، أو المثبّت الموجّه لخادمكم، أو مكدّس Docker Compose لإعدادكم الخاص — دون تسجيل ودون رسوم ترخيص. على الحاسوب المكتبي تختارون البلد أثناء التثبيت؛ أما للخادم وDocker Compose فتأتي حزمة البلد ومعها العطل الرسمية وقواعد أوقات العمل والإعدادات المسبقة للقطاعات الخاصة ببلدكم (والإضافات الزمنية حيثما تكون محددة للبلد).

حزمة البلد

اختاروا قطاعكم — اختياري

يُدوَّن اختياركم في ملف تعريف البلد كإعداد مسبق ويحدّد أي وحدات قطاعية تكون مفعّلة عند التشغيل الأول. تحتوي الحزمة دائماً على جميع القطاعات — ويمكنكم تفعيل المزيد في التطبيق في أي وقت.

computer

على حاسوب المكتب (دون Docker)

للمنشآت التي لديها حاسوب مكتبي واحد فقط: ملف تثبيت لنظام Windows — دون Docker ودون خادم خاص بكم. تعمل قاعدة البيانات وKlacks وخدمة التحديث كخدمات Windows في الخلفية، وتصل التحديثات تلقائياً، وتبقى بياناتكم على هذا الحاسوب.

المتطلبات

check_circle Windows 11 (64 بت)
check_circle يعمل أيضًا على Windows 10 22H2 (64 بت). لم تعد Microsoft تدعم Windows 10 دعمًا اعتياديًا؛ ولا تتوفر تحديثات الأمان إلا عبر برنامج ESU المدفوع.
check_circle يُستخدم Klacks مباشرةً على هذا الحاسوب — الوصول من أجهزة أخرى على الشبكة غير مدعوم بعد
check_circle اتصال بالإنترنت عند التشغيل الأول (نماذج الذكاء الاصطناعي، نحو 700 MB) ومن أجل التحديثات
check_circle صلاحيات المسؤول لإجراء التثبيت

ثلاث خطوات

1

تنزيل ملف التثبيت انقروا على «تنزيل لـ Windows». يُحفظ الملف «Klacks-Setup-win-x64.exe» عادةً في مجلد «التنزيلات».
2

النقر المزدوج واختيار البلد انقروا نقراً مزدوجاً على الملف. إذا عرض Windows SmartScreen تحذيراً، فافتحوا المعلومات الإضافية واختاروا التشغيل على أي حال — فملف التثبيت غير موقّع رقمياً بعد. بعد ذلك وافقوا على طلب صلاحيات المسؤول. في معالج التثبيت اختاروا بلدكم (العطل الرسمية، المنطقة الزمنية، قواعد أوقات العمل)، وإن شئتم اختصاراً على سطح المكتب. يعرض المعالج مدى التقدم، ويستغرق التثبيت بضع دقائق.
3

فتح Klacks وتسجيل الدخول في النهاية اختاروا فتح Klacks في المتصفح. وستجدون Klacks لاحقاً في قائمة ابدأ باسم «Klacks» (أو على العنوان http://localhost:5180). سجّلوا الدخول بالحساب الأولي الذي يعرضه المعالج في النهاية، وأنشئوا حساب مسؤول خاصاً بكم. إذا كان Klacks لا يزال قيد التشغيل، فانتظروا بضع دقائق — فالتشغيل الأول يستغرق وقتاً أطول قليلاً.

download تنزيل لـ Windows

لنظام Windows بإصدار 64 بت (x64). على أجهزة Windows 11 المزوّدة بمعالج ARM (مثل Snapdragon X) يعمل Klacks عبر المحاكاة؛ أما Windows 10 على ARM فغير مدعوم.

لأجهزة Mac: قريباً.

Linux؟ انظروا أدناه: Klacks على حاسوب Linux.

إلغاء التثبيت: يمكن إزالة Klacks مثل أي برنامج Windows آخر — افتحوا الإعدادات ثم التطبيقات، وابحثوا عن العنصر «Klacks» وألغوا تثبيته. يسأل برنامج إلغاء التثبيت ما إذا كان يجب حذف قاعدة البيانات والإعدادات والنسخ الاحتياطية أيضاً. إذا أجبتم بـ«لا»، تبقى بياناتكم في C:\ProgramData\Klacks وتستخدمها أي إعادة تثبيت لاحقة من جديد.

dns

مثبّت موجّه

الطريق الموجّه لخادمكم الخاص: يُنشئ سكربت التثبيت الأسرار وشهادة موقّعة ذاتياً، ويجلب أحدث إصدار منشور ويشغّل المكدّس الكامل — على Linux أو Windows.

المتطلبات

check_circle Docker Desktop (Windows) أو Docker Engine مع إضافة Compose (Linux)
check_circle اتصال صادر إلى ghcr.io و github.com (صور الحاويات والتحديثات)
check_circle منفذان حرّان 80 و 443 (قابلان للتهيئة)

ثلاث خطوات

1

التنزيل وفك الضغط نزّلوا ملف ZIP الخاص ببلدكم وفكّوا ضغطه على الجهاز الهدف.
2

تشغيل سكربت التثبيت شغّلوا على Linux السكربت المرفق، وعلى Windows سكربت PowerShell. فهو يُنشئ الأسرار والشهادة، ويطبّق ملف تعريف البلد، وينتظر حتى يصبح المكدّس جاهزاً للعمل.
3

تسجيل الدخول وتغيير كلمة المرور سجّلوا الدخول من المتصفح وغيّروا فوراً كلمة المرور الأولية المذكورة في ملف README المرفق.

download تنزيل حزمة التثبيت

klacks-onprem-il-all.zip

deployed_code

Docker Compose

الطريق المباشر للفرق التي تدير مكدّسات الحاويات بنفسها: docker-compose.yml، وتهيئة nginx، وسكربتات التهيئة الأولية، وملف تعريف البلد، وقالب .env جاهز يضم جميع المتغيّرات — وتبقى السيطرة الكاملة بأيديكم.

المتطلبات

check_circle Docker Engine مع إضافة Compose (أو Docker Desktop)
check_circle اتصال صادر إلى ghcr.io و github.com (صور الحاويات والتحديثات)
check_circle خبرة في تشغيل مكدّسات Docker Compose

ثلاث خطوات

1

التنزيل وفك الضغط نزّلوا ملف ZIP الخاص بـ Compose لبلدكم وفكّوا ضغطه — يشرح ملف README المرفق كل خطوة.
2

إعداد .env انسخوا القالب .env.example إلى .env واضبطوا اسم الخادم وكلمات المرور/الأسرار. مسار ملف تعريف البلد معبّأ مسبقاً.
3

تشغيل المكدّس نفّذوا «docker compose up -d»، ثم سجّلوا الدخول من المتصفح وغيّروا كلمة المرور الأولية فوراً.

download تنزيل حزمة Compose

klacks-compose-il-all.zip

terminal

على حاسوب Linux

الطريقة البسيطة لحاسوب Linux، دون أي معرفة مسبقة: نزّلوا الحزمة، وأدخلوا أمراً واحداً في الطرفية مرة واحدة — ويتكفّل المثبّت بالباقي. بعد ذلك يعمل Klacks باستخدام Docker على هذا الحاسوب، وتصل التحديثات تلقائياً، وتبقى بياناتكم على هذا الحاسوب.

المتطلبات

check_circle Linux بنظام 64 بت مع واجهة سطح مكتب: Ubuntu أو Debian أو Fedora. التوزيعات الأخرى (مثل Linux Mint) غير مدعومة رسمياً — يُرجى فيها تثبيت Docker بأنفسكم أولاً.
check_circle يُنصح بذاكرة عمل (RAM) سعتها 16 GB، لأن المتصفح وسطح المكتب يعملان في الوقت نفسه. إذا كانت الذاكرة أقل من 8 GB تقريباً يتوقف المثبّت.
check_circle اتصال بالإنترنت عند التشغيل الأول ومن أجل التحديثات
check_circle كلمة مرور المسؤول (كلمة مرور sudo) لهذا الحاسوب

download تنزيل لـ Linux

klacks-onprem-il-all.zip

ثلاث خطوات

1

تنزيل الحزمة وفكّ ضغطها في مجلد دائم نزّلوا ملف ZIP وفكّوا ضغطه في مجلد يبقى في مكانه بشكل دائم، مثل مجلد «klacks» في مجلدكم الشخصي — وليس في مجلد «Downloads» (التنزيلات). تعمل التحديثات التلقائية مع هذا المجلد؛ وإذا حُذف، تتوقف التحديثات عن العمل.
2

فتح الطرفية وإدخال الأمر في المجلد الذي يحتوي على ملفات التثبيت بعد فكّ ضغطها، انقروا بزر الفأرة الأيمن واختاروا «فتح في الطرفية»، ثم أدخلوا الأمر الوارد أدناه وأكّدوا بكلمة المرور (لا تظهر أثناء الكتابة). إذا لم يكن Docker مثبّتاً، يعرض المثبّت تثبيته: أجيبوا بـ «y» — يستغرق ذلك بضع دقائق. لا تحتاجون إلى الطرفية إلا هذه المرة الواحدة من أجل التثبيت؛ وإذا شغّلتم المثبّت مرة أخرى لاحقاً (مثلاً للإصلاح)، فاستخدموا الأمر نفسه بما في ذلك sudo.sudo bash install-il.sh
3

الفتح في المتصفح وتسجيل الدخول افتحوا https://localhost في متصفحكم. يعرض المتصفح تحذيراً بشأن الشهادة — أكّدوا التحذير («متقدم» ثم «متابعة» أو «قبول المخاطرة»). سجّلوا الدخول بالحساب الأولي الوارد في ملف README داخل المجلد، وغيّروا كلمة المرور فوراً.

lock

بخصوص تحذير الشهادة: يُنشئ Klacks أثناء التثبيت شهادة خاصة به لا يعرفها متصفحكم — ولهذا يظهر التحذير. ومع ذلك يبقى الاتصال مشفّراً.

description

ملف التعريف فقط — للتثبيتات القائمة

هل يعمل Klacks لديكم بالفعل؟ يحمل ملف التعريف (JSON) الإعدادات المسبقة للبلد — العطل الرسمية وقواعد أوقات العمل والإضافات الزمنية (حيثما تكون محددة للبلد) والقطاعات — ويُطبَّق عند التشغيل الأول لأي تثبيت. وهو أيضاً الطريقة لإضافة قطاع آخر بإعداداته المسبقة لاحقاً.

description تنزيل ملف التعريف (JSON)

من المفيد معرفته

code

مفتوح المصدر (AGPL-3.0)

الشيفرة المصدرية الكاملة متاحة للعموم على GitHub بموجب رخصة AGPL-3.0 — لا رسوم ترخيص ولا ارتباط قسري بمورّد.

storage

بياناتكم موجودة على خوادمكم

يعمل Klacks على بنيتكم التحتية. بيانات الموظفين والجدولة موجودة على خادمكم — ولا وجود لأي إلزام بالسحابة. ولا تُرسَل الطلبات إلى مزوّد ذكاء اصطناعي خارجي إلا إذا اخترتموه؛ ومع نموذج محلي لا يُرسَل أي طلب ذكاء اصطناعي إلى مزوّد خارجي.

update

التحديثات

تتولى خدمة تحديث تطبيق الإصدارات المنشورة الجديدة تلقائياً — مع Docker كخدمة داخل المكدّس، وعلى حاسوب المكتب كخدمة خلفية في Windows.

lock

HTTPS مع Docker

يُنشئ المثبّت شهادة موقّعة ذاتياً للانطلاق — ويمكنكم التبديل إلى شهادتكم الخاصة في أي وقت. غيّروا كلمة المرور الأولية فور تسجيل الدخول الأول. أما حزمة Windows لحاسوب المكتب فتعمل دون شهادة على http://localhost:5180.

التجربة أولاً، ثم التثبيت؟

يتيح لكم Playground تجربة Klacks مباشرةً في المتصفح ببيانات نموذجية — دون تثبيت ودون تسجيل. أو ألقوا نظرة على الشيفرة المصدرية على GitHub.

code عرض على GitHub