🛠️ تثبيت LanguageTool — واجهة تدقيق نحوي وأسلوبي ذاتية الاستضافة
انشر LanguageTool على Ubuntu بواسطة Docker — واجهة برمجية ذاتية الاستضافة لتدقيق النحو والأسلوب لأكثر من 30 لغة توجّه إليها إضافات متصفحك ومحرراتك، على المنفذ 8183.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/languagetool/languagetool-ubuntu.sh
chmod +x languagetool-ubuntu.sh
sudo bash languagetool-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/languagetool/languagetool-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x languagetool-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم ويشغّل erikvl87/languagetool على المنفذ 8183 بحد ذاكرة Java يصل إلى 1 غيغابايت وحجم ./ngrams لبيانات n-gram الاختيارية التي تحسّن الدقة.
sudo bash languagetool-ubuntu.sh
4 اختبار الواجهة البرمجية
لا يوجد موقع لزيارته — LanguageTool واجهة برمجية. تأكد أنه يعمل باستعلام نقطة نهاية اللغات:
curl http://<your-server-ip>:8183/v2/languages
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8183 | REST API (host → container 8010) — no web UI, no authentication |
| Java heap | Java_Xms 512m to Java_Xmx 1g |
| ./ngrams | Optional n-gram data for better accuracy |
نظرة عامة
LanguageTool محرك تدقيق نحوي وأسلوبي وإملائي مفتوح المصدر يدعم أكثر من 30 لغة، مع إصدار المكتبة الأساسية تحت رخصة LGPL 2.1. يشغّل هذا النشر صورة Docker الخاصة بـ erikvl87/languagetool، التي تحزم LanguageTool كسيرفر REST برمجي مستقل بلغة Java دون الحاجة لقاعدة بيانات خارجية. بدلاً من إرسال كتاباتك لخدمة سحابية، تشغّل نفس محرك التدقيق الذي يشغّل خدمة LanguageTool.org العامة على جهازك الخاص، وتوجّه إليه إضافات المتصفح وملحقات المحررات وتطبيقاتك الخاصة.
لماذا تستخدمه
الاستضافة الذاتية لـ LanguageTool تعني أن كل جملة تكتبها — تذاكر دعم، مستندات داخلية، مسودات عقود، ملاحظات خاصة — تُدقَّق بالكامل على بنية تحتية تتحكم بها، دون أن يغادر أي نص شبكتك. تزيل حدود الأحرف وحدود الطلبات الموجودة في طبقة الواجهة البرمجية العامة المجانية، وتتيح لك دمج تدقيق النحو والأسلوب مباشرة في أدواتك وتطبيقاتك الداخلية عبر استدعاء REST بسيط. للفرق أو الأفراد الذين يكتبون مواد حساسة، أو ببساطة يريدون خلفية تدقيق سريعة وغير محدودة، يُعد سيرفر LanguageTool الخاص طريقة قليلة الجهد للحصول على تدقيق بأسلوب Grammarly دون اشتراك أو مقايضة خصوصية.
متى تحتاجه
- تريد تدقيق النحو والأسلوب في متصفحك أو محررك دون إرسال نصك لخدمة سحابية خارجية
- تصطدم بحدود الأحرف أو الطلبات في الواجهة البرمجية العامة المجانية لـ LanguageTool وتحتاج تدقيقاً محلياً غير محدود
- تحتاج دمج التدقيق في تطبيقك أو أداتك الداخلية عبر استدعاء واجهة REST برمجية بسيط
- تكتب مواد حساسة أو سرية — مسودات قانونية، تقارير داخلية، تذاكر دعم — يجب ألا تغادر بنيتك التحتية أبداً
- تدعم فريقاً يكتب بعدة لغات وتريد خلفية تدقيق خاصة واحدة مشتركة للجميع
من يحتاجه
- الكتّاب والمحررون وفرق المحتوى الذين يريدون تدقيقاً نحوياً وأسلوبياً خاصاً وغير محدود دون اشتراك سحابي
- المطورون الذين يدمجون ميزات التدقيق في تطبيقاتهم أو أنظمة إدارة المحتوى أو أدواتهم الداخلية عبر الواجهة البرمجية REST
- الشركات وفرق العمل القانوني أو الصحي ذات متطلبات السرية التي تمنع إرسال النص لخدمات خارجية
- أصحاب الاستضافة الذاتية الذين يشغّلون بالفعل مكدساً خاصاً (Nextcloud وويكيات وتطبيقات ملاحظات) ويريدون مدقق نحو خاص مطابق
- غير الناطقين الأصليين والطلاب الذين يكتبون بكثافة بلغة ثانية أو ثالثة ويحتاجون تدقيقاً متكرراً وغير محدود
- الأفراد المهتمون بالخصوصية الذين يفضّلون تشغيل نفس المحرك مفتوح المصدر محلياً بدلاً من استخدام Grammarly أو خدمة LanguageTool العامة
حالات الاستخدام الشائعة
- تشغيل إضافة LanguageTool الرسمية للمتصفح مقابل سيرفرك الخاص بدلاً من languagetool.org
- إضافة تدقيق نحوي وأسلوبي لنظام إدارة محتوى مخصص أو أداة توثيق أو تطبيق كتابة داخلي
- تدقيق كميات كبيرة من النص برمجياً عبر الواجهة البرمجية REST لخطوط مراجعة المحتوى
- تدقيق المسودات في ملحقات المحررات (LibreOffice، بدائل Google Docs، إضافات VS Code) التي تدعم رابط سيرفر LanguageTool مخصص
- تشغيل تدقيقات نحوية دفعية على أرشيف مستندات دون الاصطدام بحدود أي واجهة برمجية سحابية
- توفير خلفية تدقيق خاصة مشتركة لفريق أو منظمة بالكامل
الميزات الرئيسية
- تدقيق نحوي وأسلوبي وإملائي عبر أكثر من 30 لغة تشمل الإنجليزية والألمانية والفرنسية والإسبانية والبولندية والروسية
- مكتبة أساسية مفتوحة المصدر تحت رخصة LGPL 2.1، دون قيود ملكية على محرك التدقيق الأساسي
- واجهة برمجية REST متوافقة مع نفس البروتوكول المستخدم في خدمة LanguageTool.org العامة وإضافة متصفحها الرسمية
- يكتشف أخطاء تعتمد على السياق — أزواج كلمات مُربِكة، تطابق الفاعل والفعل، علامات ترقيم، ومشاكل أسلوبية — وليس فقط الأخطاء الإملائية
- دعم اختياري لبيانات n-gram يحسّن اكتشاف الكلمات سهلة الالتباس عند تحميلها في حجم ngrams
- لا حدود أحرف أو طلبات أو فوترة لكل طلب بعد الاستضافة الذاتية، على عكس طبقة الواجهة البرمجية العامة المجانية
- يعمل كسيرفر Java مستقل خفيف دون اعتماد على قاعدة بيانات خارجية
- يعمل مع الإضافة الرسمية للمتصفح والعديد من ملحقات المحررات وأي تطبيق مخصص عبر طلبات HTTP بسيطة
كيفية الاستخدام بعد التثبيت
- تأكد أن السيرفر يستجيب بطلب نقطة نهاية /v2/languages والتحقق أنها تعيد قائمة اللغات المدعومة
- ثبّت إضافة LanguageTool الرسمية للمتصفح واضبط رابط السيرفر إلى http://your-server-ip:8183/v2 في إعدادات الإضافة
- اضبط أي ملحقات محررات (LibreOffice أو VS Code أو غيرها) تدعم سيرفر LanguageTool مخصص لتوجيهها لنسختك
- اختبر طلب تدقيق بنموذج نص قصير يحتوي خطأً نحوياً متعمداً للتأكد أن الاقتراحات تعود بشكل صحيح
- نزّل واربط بيانات n-gram الاختيارية في حجم ./ngrams إذا أردت اكتشافاً أدق للكلمات سهلة الالتباس
- ادمج نقطة نهاية /v2/check في أي تطبيق أو سكريبت داخلي يحتاج تدقيقاً برمجياً
- راقب استهلاك ذاكرة Java تحت الحمل الفعلي واضبط حدود الذاكرة إذا كنت تعالج كميات كبيرة من النص
- أعدّ وكيلاً عكسياً مع HTTPS ومصادقة أساسية إذا احتجت الوصول للواجهة البرمجية من خارج شبكتك المحلية
أفضل ممارسات الأمان
- يأتي LanguageTool بدون مصادقة افتراضياً — لا تكشف المنفذ 8183 مباشرة للإنترنت العام أبداً
- قيّد الوصول بـ ufw أو جدار حماية سحابتك بحيث لا يصل للمنفذ 8183 إلا المضيفون الموثوقون أو شبكتك المحلية
- إذا احتجت وصولاً عن بُعد، ضع الواجهة البرمجية خلف وكيل عكسي مع HTTPS ومصادقة أساسية أو فحص مفتاح API
- استخدم VPN مثل WireGuard للوصول عن بُعد بدلاً من كشف نقطة نهاية التدقيق للعامة
- حافظ على تحديث صورة erikvl87/languagetool لاستلام تحديثات الأمان والقواميس من المصدر
- تذكّر أن السبب الكامل للاستضافة الذاتية هو خصوصية النص — نسخة مكشوفة للإنترنت تُبطل هذا الغرض وتدعو للاستغلال
- اعزل الحاوية على شبكة Docker خاصة بها إذا كان المضيف يشغّل خدمات مكشوفة أخرى أكثر حساسية
- راقب حجم الطلبات إذا كانت الواجهة البرمجية متاحة لعدة فرق داخلية، لرصد أي ارتفاع غير متوقع في الاستخدام مبكراً
المنافذ وإعدادات جدار الحماية
يستمع LanguageTool على المنفذ 8183 على المضيف، معيّناً من المنفذ الداخلي للحاوية 8010 — يجب توجيه العملاء دائماً إلى 8183 مع لاحقة /v2، لأن 8010 هو فقط المنفذ المستخدم داخل الحاوية. هذه واجهة برمجية REST دون واجهة ويب ودون مصادقة مدمجة، لذا يجب ألا يُكشف المنفذ 8183 أبداً مباشرة للإنترنت العام: قيّده على شبكتك المحلية أو المضيفين الموثوقين بـ ufw، وإذا احتجت وصولاً عن بُعد فعلياً، ضعه خلف وكيل عكسي يضيف HTTPS وطبقة مصادقة، أو صِل إليه عبر VPN مثل WireGuard.
النسخ الاحتياطي والصيانة
- احتفظ بنسخة من docker-compose.yml أو أمر التشغيل حتى يمكن إعادة إنشاء نفس إعداد السيرفر بالضبط على مضيف جديد
- إذا نزّلت بيانات n-gram اختيارية في حجم ./ngrams، انسخها احتياطياً أو دوّن مصدر التنزيل الأصلي، لأنها قد تكون كبيرة الحجم
- LanguageTool نفسه عديم الحالة — لا توجد بيانات مستخدمين أو حسابات أو قاعدة بيانات للنسخ الاحتياطي بخلاف إعدادك وبيانات n-gram
- وثّق أي ضبط لحجم ذاكرة Java أو متغيرات بيئة طبقتها، حتى تطابق إعادة النشر إعدادات أدائك الأصلية
- احتفظ بسجل لأي أدوات عميل (إضافات متصفح، ملحقات محررات، تطبيقات) مضبوطة لتوجه لرابط سيرفرك
- اختبر أن حاوية جديدة أُعيد إنشاؤها من ملف compose المحفوظ تستجيب بشكل صحيح على نقطة نهاية /v2/languages
الأخطاء الشائعة
- توقّع موقع على المنفذ 8183 — LanguageTool واجهة برمجية فقط، وفتح الرابط في متصفح لن يُظهر واجهة تدقيق
- نسيان لاحقة /v2 عند ضبط إضافة المتصفح أو ملحق المحرر — رابط القاعدة وحده ليس نقطة نهاية صالحة
- كشف المنفذ 8183 للإنترنت العام دون أي مصادقة أو وكيل عكسي أمامه
- الخلط بين منفذ المضيف 8183 والمنفذ الداخلي للحاوية 8010 المذكور في بعض توثيق المصدر
- تخطي بيانات n-gram الاختيارية ثم التفاجؤ بأن أزواج الكلمات شائعة الالتباس لا تُكتشف
- إرسال كتل نصية ضخمة جداً في طلب واحد بدلاً من تقسيمها لأجزاء أسهل إدارة لذاكرة Java
- عدم ضبط حجم ذاكرة Java لأحمال عمل عالية الحجم، مما يؤدي لتدقيقات بطيئة أو فاشلة تحت الحمل
- افتراض أن النسخة ذاتية الاستضافة تتصرف مطابقة لإعدادات الواجهة البرمجية العامة الافتراضية دون التحقق من فروقات الإعداد
استكشاف الأخطاء وإصلاحها
- لا استجابة من الواجهة البرمجية — تحقق أن الحاوية تعمل بـ docker ps وراجع docker logs لأخطاء بدء التشغيل
- إضافة المتصفح تُظهر خطأ اتصال — تأكد أن رابط السيرفر مضبوط على http://your-server-ip:8183/v2 بما في ذلك لاحقة /v2
- رفض الاتصال على المنفذ 8183 — تحقق من تعيين المنفذ في ملف compose وتأكد أن ufw يسمح بالمنفذ محلياً
- أوقات استجابة بطيئة تحت الحمل — زد حجم ذاكرة Java (Java_Xmx) وراقب استهلاك ذاكرة الحاوية أثناء ذروة التدقيق
- أزواج كلمات معينة سهلة الالتباس لا تُعلَّم — تأكد أن بيانات n-gram الاختيارية مُنزَّلة ومربوطة بشكل صحيح في ./ngrams
- أخطاء لغة غير مدعومة — استعلم /v2/languages للتأكد أن رمز اللغة الذي تطلبه متاح فعلياً
- استهلاك ذاكرة مرتفع بمرور الوقت — أعد تشغيل الحاوية دورياً إذا لاحظت تزايداً تدريجياً أثناء أحمال عمل طويلة وعالية الحجم
- الحاوية تتوقف فوراً بعد البدء — تحقق من تعارض منفذ مع خدمة أخرى مربوطة بالفعل بالمنفذ 8183
البدائل
Grammarly هو البديل التجاري الأكثر صقلاً باقتراحات قوية للنبرة والوضوح، لكنه يتطلب إرسال نصك لخوادم Grammarly السحابية ويأتي بتسعير اشتراك للميزات المتقدمة. يعتبر Microsoft Editor ومدقق Google Docs المدمج مريحين إذا كنت تعيش بالفعل داخل تلك المنظومات، لكن لا يمكن استضافة أي منهما ذاتياً أو دمجه في تطبيقات مخصصة عشوائية. Hunspell وAspell مكتبات تدقيق إملائي خفيفة بحتة دون تحليل نحوي أو أسلوبي، مفيدة فقط إذا احتجت أدنى بصمة ممكنة. لمحرك ذاتي الاستضافة فعلياً ومفتوح المصدر يدقق النحو والأسلوب — وليس الإملاء فقط — عبر أكثر من 30 لغة بواجهة REST برمجية بسيطة، يبقى LanguageTool أحد الخيارات الواقعية القليلة جداً.
متى لا تستخدمه
LanguageTool ليس الخيار الصحيح إذا كنت تحتاج اقتراحات نبرة ووضوح وإثراء مفردات بمستوى Grammarly — الخدمات التجارية لا تزال متقدمة في هذا المجال الأكثر ذاتية والموجَّه نحو تدريب الأسلوب، ويركّز LanguageTool بشكل أضيق على قواعد النحو والإملاء والأسلوب الميكانيكي. إذا كان فريقك بالكامل يعمل بالفعل داخل Google Docs أو Microsoft 365 والخصوصية ليست هاجساً أساسياً، فالمدققات المدمجة لا تتطلب أي إعداد وقد تكون كافية. وإذا احتجت فقط تدقيقاً إملائياً أساسياً دون تحليل نحوي، فإن مكتبة خفيفة مثل Hunspell بصمتها أصغر بكثير من تشغيل سيرفر LanguageTool كامل مبني على Java. لكن للتدقيق النحوي الحساس للخصوصية وغير المحدود والقابل للدمج برمجياً، يصعب منافسة LanguageTool ذاتي الاستضافة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل LanguageTool موقع أفتحه في المتصفح؟
لا — هذا النشر هو سيرفر الواجهة البرمجية، وليس له واجهة خاصة به. تشغّله ثم توجّه إضافة LanguageTool للمتصفح أو ملحق محرر إلى سيرفرك بدلاً من الخدمة العامة.
كيف أستخدمه مع إضافة المتصفح؟
ثبّت إضافة LanguageTool الرسمية، ثم في إعداداتها اضبط رابط السيرفر إلى http://your-server-ip:8183/v2. لاحقة /v2 مطلوبة — نسيانها هو أكثر خطأ إعداد شيوعاً. بعد ذلك، تدقّق الإضافة نصك مقابل سيرفرك الخاص بدلاً من languagetool.org.
أي منفذ يستخدمه؟
المنفذ 8183 على المضيف، معيّن من المنفذ الداخلي 8010. وجّه العملاء إلى http://your-server-ip:8183/v2. المنفذ 8010 الذي قد تراه في توثيق المصدر هو المنفذ داخل الحاوية.
ما فائدة حجم ngrams؟
يحمل بيانات n-gram اختيارية تحسّن قدرة LanguageTool على اكتشاف الأخطاء المعتمدة على السياق، مثل الخلط بين 'their' و'there'. غير مطلوبة — يعمل المدقق بدونها — لكن إضافة البيانات إلى ./ngrams تحسّن اقتراحاته بشكل ملحوظ.
هل من الآمن كشفه للإنترنت؟
لا. لا يملك مصادقة، والسبب الكامل للاستضافة الذاتية هو إبقاء نصك خاصاً، لذا نسخة مكشوفة للإنترنت تُبطل الغرض وتسمح لأي شخص بإرسال نص إليها.