استضافة openGym ذاتيًا عبر Docker Compose على VPS
تعلّم نشر openGym على VPS عبر Docker Compose مع تثبيت الوسم v1.2.7، إعداد TLS قبل أول Passkey، معرفة مكان البيانات، وتشغيل MCP اختياريًا.
ما تحصل عليه عند الاستضافة الذاتية لـopenGym
تستضيف openGym ذاتياً عبر استنساخ المستودع، وتعديل سطرين في .env، وتشغيل docker compose up -d --build خلف Reverse Proxy ينهي TLS (أمان طبقة النقل). openGym هو متعقّب للتمارين الرياضية ووزن الجسم: خطط أسبوعية، وتمارين موجّهة، وتسجيل لكل مجموعة، وتتبع الوزن بمرور الوقت. يُرخَّص البرنامج بموجب AGPL-3.0، ويخزّن كل شيء في ملفات JSON عادية على القرص، لذلك لا تحتاج إلى تشغيل خادم قاعدة بيانات.
تتكوّن الحزمة من حاويتين تعملان باستمرار: حاوية nginx تقدّم نسخة React المبنية، وحاوية Node تستضيف API، بالإضافة إلى مهمة تُشغَّل مرة واحدة لتنزيل نحو 140 MB من صور التمارين وملفات GIF عند تشغيلها للمرة الأولى.
يشير README للمشروع إلى أمرين، لكنه لا يوضحهما صراحةً لمن ينشر التطبيق على خادم عام. يرتبط تسجيل الدخول باستخدام Passkey باسم المضيف، لذلك يجب أن يكون النطاق وشهادته موجودين قبل تسجيل الدخول الأول، وليس بعده. كما أن خادم MCP الاختياري للقراءة فقط في الوسم المثبّت v1.2.7، ويعمل على الجهاز الذي يعمل عليه عميل AI، وليس داخل الحزمة. وهذا يغيّر الإجراءات المطلوبة عندما تكون البيانات على VPS. ويدعم خادم MCP الحالي أيضاً تسجيل التمارين بعد إقرانه بخادمك.
ما زال openGym حديثاً. يعود أول إصدار موسوم، v1.0.0، إلى 20 July 2026، ووصل v1.2.7 في 18 August 2026. وظهور 13 وسماً في شهره الأول، ثم 34 وسماً بحلول 9 October 2026 مع وسم v1.4.0 في ذلك اليوم، يعني أن التطبيق ما زال يتغير بسرعة. لذلك افحص وسم إصدار محدداً بدلاً من بناء الإصدار الموجود على الفرع الافتراضي وقت التنفيذ.
خطّط للنطاق قبل تسجيل الدخول الأول
تستخدم openGym مفاتيح المرور لتسجيل الدخول. يرتبط مفتاح المرور بمعرّف الطرف المعتمد (RP ID)، وهو النطاق الذي أُنشئت عليه بيانات الاعتماد. ولا تنشئ المتصفحات مفاتيح مرور إلا عبر HTTPS. الاستثناء الوحيد هو localhost.
ويظهر أثر ذلك عند استخدام الهاتف. افتح http://203.0.113.10:8080 من جهاز آخر، ولن يظهر طلب مفتاح المرور إطلاقاً، لأن المتصفح يرفض إنشاء بيانات اعتماد على مصدر HTTP عادي أو على عنوان IP مجرد. وتذكر ملاحظات استكشاف الأخطاء وإصلاحها الخاصة بالمشروع الشيء نفسه: عدم ظهور الطلب يعني أنك تستخدم http:// أو عنوان IP.
والأسوأ أن معرّف الطرف المعتمد مضمّن في كل بيانات اعتماد سجّلها المستخدمون مسبقاً. إذا غيّرت RP_ID لاحقاً، فلن تعود مفاتيح المرور المخزنة على أجهزتهم متطابقة، ولن يتمكن أحد من تسجيل الدخول. حدّد اسم المضيف أولاً، ووجّه DNS إلى VPS، وشغّل الشهادة بنجاح قبل أن يضغط أي مستخدم على Create profile.
نشر openGym باستخدام Docker Compose
يربط ملف Compose المسارين ./data و./media بـbind mount نسبةً إلى موقعه، ولذلك فإن الدليل الذي تستنسخ المستودع فيه هو قاعدة بياناتك. ضعه في موقع دائم.
sudo install -d -o "$USER" -g "$USER" /opt/opengym
git clone https://github.com/DuarteSantos8/openGym /opt/opengym
cd /opt/opengym
git checkout v1.2.7
cp .env.example .envيعرض README رابط استنساخ github.com/DuarteSantos8/openGym. اعتباراً من 4 November 2026، يشير ذلك المستودع إلى موقع المشروع ويعرّف نفسه بهذه الصفة. افحص الوسم قبل أول عملية بناء: فقد انتقل الفرع الافتراضي إلى ما بعد الإصدار الذي يشرحه هذا الدليل، وأصبحت رسوم التمارين المتحركة في ذلك الفرع مضمنة داخل الصورة، ولم تعد مهمة الوسائط أدناه موجودة. يشرح القسم الخاص بتثبيت الإصدار السبب.
حرّر .env. توجد 3 أسطر مهمة على VPS.
RP_ID=gym.example.com
ORIGIN=https://gym.example.com
WEB_PORT=127.0.0.1:8080يمثل RP_ID اسم المضيف المجرد، بينما يمثل ORIGIN عنوان URL الكامل بما في ذلك المخطط. يجب أن يتطابقا تماماً مع العنوان الظاهر في شريط العناوين، وإلا يفشل تسجيل الدخول مع verification failed. تُشرح قيمة WEB_PORT في القسم الخاص بإبقاء المنفذ 8080 خاصاً.
docker compose up -d --build
docker compose ps --all
docker compose logs mediaيفترض أن يعرض docker compose ps --all كلاً من web وapi وهما قيد التشغيل، وأن يعرض media منتهياً برمز الخروج 0. احتفظ بالراية --all: فبدونها يعرض Compose الحاويات قيد التشغيل فقط، ولذلك لا تظهر مهمة media المكتملة إطلاقاً. هذا الخروج صحيح: فقد حصلت مهمة الوسائط على restart: "no" لأن عملها تنزيل يُنفَّذ مرة واحدة. ينتهي سجلها بسطر يبدأ بـ✓ Exercise media ready، ويفترض أن يطبع ls media/img | wc -l القيمة 1,324 بدلاً من 0، وهو عدد الصور المصغرة التي يتضمنها مستودع بيانات التمارين upstream اعتباراً من 9 October 2026. يدل الدليل الفارغ على فشل التنزيل، وعندها يعرض التطبيق بطاقات التمارين بصور فارغة.
احتفظ بالراية --build. يسمّي ملف Compose في هذا الوسم صوراً مبنية مسبقاً على ghcr.io باستخدام الوسم latest. أُعيد نشر تلك الصور اعتباراً من 18 October 2026، لكن latest يتبع أحدث إصدار، ولذلك قد يشغّل docker compose pull تعليمات برمجية أحدث من المصدر الذي تحققت منه للتو. يتضمن كلا الخدمتين قسماً build، بينما يبني --build الخدمتين من نسخة المستودع التي تحققت منها. إذا كانت Compose جديدة عليك، فابدأ بـDocker Compose على VPS ثم عُد إلى هنا.
ثبّت الإصدار، لأن هذا المشروع حديث
يحتوي السجل مجدداً على صور ذات إصدارات، لكن ملف Compose في v1.2.7 لا يزال يطلب latest. اعتباراً من 4 November 2026، يشير latest إلى 1.4.4، الذي صدر في 3 November 2026. ما تثبّته هو نسخة المستودع الموجودة على القرص، لأنها تحدد إصدار التطبيق الذي سينتهي به الأمر داخل الحاوية.
cd /opt/opengym
git fetch --tags
git checkout v1.2.7يعرض git status الآن حالة HEAD منفصلة عند تلك العلامة، وهذا هو المطلوب على الخادم. لن يتغير شيء أسفل النسخة الحالية إلى أن تسجّل خروجاً إلى علامة أخرى.
v1.2.7 هو الإصدار الذي كُتب هذا الدليل استناداً إليه، ولم يعد الأحدث. تغيّر الإصدارات اللاحقة عملية النشر نفسها؛ فعلى الفرع الافتراضي لم تعد مهمة الوسائط موجودة. لذلك اقرأ ملاحظات الإصدار وقارن ملف Compose قبل تغيير الإصدار المثبّت. تذكر ملاحظات إصدار v1.4.2 وv1.4.3 أيضاً إصلاحات أمنية، ويطلب المشروع من مشغّلي الاستضافات الذاتية التحديث.
بعد ذلك، اطلب من Compose التوقف تماماً عن الوصول إلى السجل. ضع ما يلي في docker-compose.override.yml، إذ يحمّله Compose تلقائياً ويدمج محتواه فوق الملف المتتبَّع. تستبدل مفاتيح القيم المفردة بالقيم الموجودة في ملف التجاوز، لذلك لا تحتاج إلى تعديل أي شيء في git، وتبقى git pull نظيفة. راجع كيفية دمج Compose لملف التجاوز للاطلاع على قواعد الدمج الكاملة.
services:
api:
pull_policy: build
web:
pull_policy: buildبعد ذلك، سيبني docker compose up -d لاحقاً من المصدر الموجود لديك، بدلاً من سحب أي نسخة يشير إليها latest في ذلك اليوم. تحقق من تطبيق الدمج، ثم أعد البناء عند العلامة.
docker compose config | grep pull_policy
docker compose up -d --buildإنهاء TLS باستخدام reverse proxy
تستخدم الحاويات HTTP عاديًا. يجب أن يتولى مكوّن أمامها الشهادة. يُعد Caddy المسار الأقصر، لأنه يطلب الشهادة من Let's Encrypt ويجددها تلقائيًا.
gym.example.com {
reverse_proxy 127.0.0.1:8080
}يعمل nginx وTraefik وNginx Proxy Manager بالطريقة نفسها. وينطبق ذلك أيضًا على Cloudflare Tunnel، الذي يوثّقه المشروع ولا يحتاج إلى فتح أي منفذ وارد.
curl -sI https://gym.example.com | head -1يجب أن يعيد ذلك HTTP/2 200 من دون تحذير بشأن الشهادة. افتح الموقع الآن في متصفح، وانقر على Create profile. إذا ظهر طلب مفتاح المرور، ثم أبلغ تسجيل الدخول عن verification failed، فهذا يعني أن RP_ID أو ORIGIN لا يطابق عنوان URL في شريط العنوان. أصلح .env، ثم شغّل docker compose up -d مرة أخرى. فهذا يعيد إنشاء الحاويات كي تقرأ القيم الجديدة. لا يعيد docker compose restart تحميل .env.
إبقاء المنفذ 8080 خارج الإنترنت العام
تَنشر خدمة الويب افتراضياً 8080 على كل الواجهات، لذلك يمكن الوصول إلى التطبيق عبر HTTP غير المشفّر باستخدام عنوان IP العام، بينما يوفّر الـproxy خدمة HTTPS على الخادم نفسه. لا تعالج قاعدة جدار ناري هذه المشكلة. ينشر Docker المنفذ باستخدام قاعدة DNAT في جدول nat، ثم تُعالَج حركة المرور هذه في السلسلة FORWARD حيث تقبلها قواعد Docker الخاصة، بينما توجد قواعد ufw في مسار INPUT. لذلك لا يحظر sudo ufw deny 8080/tcp أي شيء.
الحل هو النشر على عنوان loopback فقط. يربط ملف compose "${WEB_PORT:-8080}:${NGINX_PORT:-80}"، لذلك تُستبدل أي قيمة تضبطها في WEB_PORT على الجانب الأيسر من ذلك الربط، كما تقبل الصيغة المختصرة في Docker زوج ip:port في هذا الموضع. لذلك تعمل WEB_PORT=127.0.0.1:8080.
docker compose config
sudo ss -ltnp | grep 8080في الإعداد المدمج، وتحت ports الخاص بخدمة الويب، يجب أن ترى host_ip: 127.0.0.1. يجب أن يعرض ss القيمة 127.0.0.1:8080، لا 0.0.0.0:8080. ومن جهاز آخر، يجب أن يُرفض الاتصال بـcurl http://<your-vps-ip>:8080 الآن أو تنتهي مهلة الاتصال، بينما يستمر اسم مضيف HTTPS في العمل.
أغلق التسجيل بعد إنشاء ملفك الشخصي
يكون التسجيل مفتوحاً افتراضياً، ويكون وضع الضيف مفعّلاً. على اسم مضيف عام، يعني ذلك أن أي شخص يعثر على عنوان URL يمكنه إنشاء ملف شخصي على خادمك. أنشئ ملفك الشخصي أولاً، ثم ابحث عن معرّف المستخدم الخاص بك: يعرض ls data/ ملفاً باسم state-<uid>.json لكل مستخدم، وتكون قيمة <uid> هي القيمة المطلوبة.
ADMIN_UIDS=<your-uid>
INVITE_ONLY=1
ALLOW_GUEST=0شغّل docker compose up -d مرة أخرى. يعرض Settings الآن لوحة Admin يمكنك من خلالها إنشاء رموز الدعوة وإبطالها، بحيث يستطيع الأشخاص الذين تتدرب معهم التسجيل ولا يستطيع أي شخص آخر ذلك. لا يعرف openGym شيئاً عن موفّري الهوية الخارجيين، لذلك تتحكم رموز الدعوة هذه في هذا التطبيق وحده ولا تؤثر في أي شيء آخر على الخادم؛ وإذا كنت تفضّل منح حساب واحد لكل شخص عبر جميع الخدمات التي تشغّلها، فإن وضع Authentik أمامه كوكيل forward auth يقيّد الوصول إلى اسم المضيف قبل تحميل تسجيل الدخول باستخدام passkey الخاص بـ openGym.
مكان البيانات والنسخة الاحتياطية التي تحميها
يوجد كل شيء في الدليل ./data، وهو موصول داخل حاوية API في المسار /data. توجد أربعة أنواع من الملفات: يحتوي db.json على الملفات الشخصية وبيانات اعتماد مفاتيح المرور العامة، ويحتوي state-<uid>.json على روتينات المستخدم الواحد وتمارينه ووزن جسمه، وsecret هو مفتاح ملف تعريف ارتباط الجلسة، ويحتوي vapid.json على مفاتيح إشعارات الدفع التي تُنشأ عند التشغيل الأول.
cd /opt/opengym
docker compose stop api
tar czf ~/opengym-$(date +%F).tar.gz data/
docker compose start apiأوقف API أولاً حتى تبقى الملفات متسقة مع بعضها أثناء نسخ tar لها. في الإصدار v1.2.7، يكتب API ملفي JSON الخاصين بقاعدة البيانات وحالة التمارين إلى ملف مؤقت، ثم يعيد تسميته فوق الملف الهدف بطريقة ذرية. لذلك لا يعيد كتابة هذه الملفات الحية في مكانها. بعد ذلك، انسخ الأرشيف إلى خارج الخادم، لأن الأرشيف الموجود على VPS لا ينجو من فقدان VPS. استبعد media/ من النسخة الاحتياطية؛ فهو يحتوي على 140 MB من صور التمارين التي تعيد مهمة الوسائط تنزيلها مجاناً.
تعني الاستعادة فك الأرشيف في المسار نفسه على مضيف يخدم النطاق نفسه. يكون مفتاح المرور المخزن على هاتفك مرتبطاً بمعرّف RP الذي أُنشئ له، لذلك تمنحك الاستعادة إلى اسم مضيف جديد قاعدة بيانات تعمل، لكن لا يستطيع أي شخص تسجيل الدخول إليها. حافظ على النطاق، أو خطط لإعادة تسجيل كل مفتاح مرور. ينطبق الإجراء نفسه على كل ما تشغّله، ويشرح النسخ الاحتياطي وترقية مكدس Docker Compose الروتين العام.
خادم MCP المثبّت للقراءة فقط، ويعمل على جهازك
MCP (بروتوكول سياق النموذج) هو الطريقة التي يتواصل بها عميل مثل Claude Desktop أو Cursor مع خادم أدوات محلي. يتضمن openGym خادماً في mcp/. لا يُعد جزءاً من ملف compose، وليس حاوية، ولا يستمع على أي منفذ. يشغّله العميل كعملية فرعية، ويتواصل معه عبر stdio. يقرأ الخادم المثبّت الملفات المحلية فقط؛ أما الخادم الحالي فيرسل أيضاً عمليات حفظ التمارين إلى واجهة API الخاصة بـopenGym المقترنة بك.
ثبّته في المكان الذي يعمل فيه العميل، وليس على الخادم:
cd openGym/mcp
npm installثم أضفه إلى claude_desktop_config.json:
{
"mcpServers": {
"opengym": {
"command": "node",
"args": ["/absolute/path/to/openGym/mcp/src/index.js"],
"env": {
"OPENGYM_DATA": "/absolute/path/to/openGym/data",
"OPENGYM_UID": "<your-uid>"
}
}
}
}يكون OPENGYM_UID اختيارياً في تثبيت لمستخدم واحد، حيث يكتشف الخادم ملف التعريف الوحيد الذي يعثر عليه. في الفرع الافتراضي الحالي، يوفّر إحدى عشرة أداة: list_routines، get_routine، preview_session، get_week_plan، list_workouts، get_workout، get_bodyweight، estimate_1rm، muscle_balance، get_programme وlog_workout. يعرض preview_session ما سيضعه التطبيق فعلياً على الشاشة عند بدء تمرين، بعد أن تكون سياسة التدرّج وسجلّك قد عدّلا الخطة. تضمّن الإصدار الموسوم v1.2.7 ثماني أدوات للقراءة فقط، من دون preview_session أو get_programme أو log_workout. يستطيع مساعد يستخدم ذلك الخادم المثبّت الإجابة عن التمرين الذي أديته على المقعد الأسبوع الماضي، لكنه لا يستطيع تسجيل مجموعة، أو تعديل تمرين، أو حذف أي شيء. في الفرع الحالي، تقرأ عشر أدوات البيانات، وتحفظ log_workout التمارين عبر خادمك بعد الاقتران؛ وتظل معطّلة إلى أن يتم الاقتران. تمثل هذه القائمة مثالاً موجزاً على قرار يتكرر في تصميم الوكلاء: الأدوات التي تتيحها هي كل ما يستطيع النموذج فعله، وتعلّم كيفية عمل الوكلاء بكتابة الحلقة بنفسك هو أسرع طريقة لفهم أن مجموعة الأدوات للقراءة فقط خيار تصميم وليست قيداً.
هذه هي المشكلة التي يتعين على مستخدم VPS حلّها. OPENGYM_DATA هو مسار في نظام الملفات، بينما توجد بياناتك على VPS ويعمل عميل الذكاء الاصطناعي على حاسوبك المحمول. توجد طريقتان واضحتان للتعامل مع ذلك.
- انسخ البيانات إلى جهازك ووجّه الخادم إلى النسخة:
rsync -a --delete user@gym.example.com:/opt/opengym/data/ ~/opengym-data/، ثم اضبطOPENGYM_DATAعلى~/opengym-data. يقرأ الخادم المثبّت البيانات فقط، لذلك لا تفقد النسخة شيئاً. أعد تشغيل rsync عندما تريد أرقاماً محدثة. - شغّل الخادم عبر ssh، مع ضبط
commandعلىsshوضبطargsعلى["-T", "user@gym.example.com", "OPENGYM_DATA=/opt/opengym/data node /opt/opengym/mcp/src/index.js"]. يتطلب ذلك تثبيت Node على VPS، واستخدام تسجيل دخول لا يطبع شيئاً إلى stdout، لأن stdout هو قناة البروتوكول.
تفترض الطريقتان أن الوكيل نفسه يعمل على حاسوبك المحمول. وإذا كنت تفضّل تشغيله على الجهاز نفسه الذي توجد عليه البيانات، فإن OneCLI يوفّر لكل شخص وكيلاً معزولاً داخل بيئة اختبار على الخادم، وبذلك تعود قفزة stdio إلى data/ محلية.
إذا أعاد cat data/db.json القيمة Permission denied، فقد كتبت حاوية API هذه الملفات بصفة root، ولا يستطيع حساب تسجيل دخولك قراءتها. انسخها باستخدام sudo، أو غيّر الملكية على المضيف. بالنسبة إلى الخوادم المخصّصة للاستماع عبر الشبكة بدلاً من stdio، راجع تشغيل خوادم MCP على VPS.
openGym أم wger: أيهما ينبغي أن تشغّل؟
يُعدّ wger الخيار الراسخ في هذا المجال، وهو برنامج أكبر بكثير. تُشغّل حزمة Compose الخاصة به gunicorn لتقديم تطبيق Django، وPostgreSQL، وRedis، وعامل Celery خلف nginx. في المقابل، تحصل على تتبّع التغذية والمكوّنات، وREST API موثّقة، وقاعدة بيانات كبيرة لتمارين المجتمع، وميزات للمدرّبين الذين يديرون خطط أشخاص آخرين.
يتكوّن openGym من حاويتين ومجلد يحتوي على ملفات JSON، ولا توجد فيه حسابات تحتاج إلى إدارة باستثناء passkeys. هذا هو الفرق كله. إذا سبق لك تشغيل تثبيت Chatwoot وصيانته، حيث تعني النسخة الاحتياطية تفريغ قاعدة بيانات Postgres إلى جانب مجلد التحميلات، ويتطلب كل تحديث للإصدار تشغيل عمليات ترحيل قاعدة البيانات، فأنت تعرف بالفعل طبيعة الصيانة التي يفرضها wger.
شغّل wger إذا أردت تتبّع الطعام إلى جانب التدريب، أو إذا كنت تحتاج إلى API تبني عليه. شغّل openGym إذا أردت حزمة صغيرة بما يكفي لقراءة مكوّناتها من البداية إلى النهاية خلال فترة بعد الظهر، وتسجيل دخول بلا كلمة مرور يمكن تسريبها. تكلفة هذا الاختيار هي انخفاض مستوى النضج: في 19 August 2026، كان أول إصدار من openGym قد صدر قبل شهر، بينما يملك wger سنوات من الإصدارات السابقة. ثبّت إصدارك، واحتفظ بالنسخ الاحتياطية، واقرأ ملاحظات الإصدار قبل كل تحديث.
إذا كنت لا تزال تقرر ما الذي يستحق مساحة على الخادم، فراجع ما الذي يستحق الاستضافة الذاتية في 2026 لمعرفة المفاضلات، ويمكن لهذا التطبيق أن يعمل بسهولة إلى جانب Mealie للوصفات أو Actual Budget لإدارة المال على VPS صغير واحد.
التحديث دون فقدان أي بيانات
cd /opt/opengym
docker compose stop api
tar czf ~/opengym-$(date +%F).tar.gz data/
docker compose start api
git fetch --tagsتحقّق من الإصدار المطلوب باستخدام git checkout v<new>، ثم نفّذ docker compose up -d --build لإعادة إنشاء الحاويات من ذلك الوسم. أجرِ النسخ الاحتياطي أولاً في كل مرة، لأن مسار الاستعادة لملفات JSON المخزنة على القرص هو أمر tar واحد ويستغرق ثواني.
FAQ
لماذا لا يعرض openGym أبداً مطالبة بمفتاح مرور على هاتفي؟
يرفض المتصفح إنشاء بيانات اعتماد لأنك تستخدم http:// أو عنوان IP مجرداً، مثل http://192.168.1.20:8080. لا تسمح المتصفحات بمفاتيح المرور إلا على مصادر HTTPS، مع localhost بوصفه الاستثناء الوحيد. ضع openGym خلف reverse proxy يحمل شهادة حقيقية لاسم مضيف حقيقي، واضبط RP_ID=gym.example.com وORIGIN=https://gym.example.com في .env، ثم شغّل docker compose up -d لكي تلتقط الحاويات القيم الجديدة. إذا ظهرت المطالبة لكن أبلغ تسجيل الدخول عن verification failed، فالقيمتان لا تطابقان عنوان URL الظاهر في شريط العناوين تطابقاً تاماً.
أين يخزّن openGym بياناتي، وكيف أنشئ نسخة احتياطية منها؟
في دليل ./data الموجود بجوار ملف compose، والمضمّن في حاوية API على المسار /data. يحتوي هذا الدليل على db.json للملفات الشخصية وبيانات اعتماد مفاتيح المرور العامة، وملف state-<uid>.json واحداً لكل مستخدم لبيانات التمارين ووزن الجسم، وsecret لمفتاح ملف تعريف ارتباط الجلسة، وvapid.json لمفاتيح إشعارات الدفع. أنشئ نسخة احتياطية باستخدام docker compose stop api، ثم tar czf ~/opengym-$(date +%F).tar.gz data/، ثم docker compose start api، وانسخ الأرشيف إلى خارج الخادم. تخطَّ media/، إذ يبلغ حجمه 140 MB من صور التمارين التي تنزّلها مهمة الوسائط مجدداً تلقائياً.
هل يستطيع Claude قراءة سجل تماريني في openGym؟
نعم، من خلال خادم MCP الاختياري في دليل mcp/. يحتوي الخادم المثبّت بالإصدار v1.2.7 على ثماني أدوات للقراءة فقط. يحتوي الفرع الافتراضي الحالي على إحدى عشرة أداة: عشر أدوات لقراءة الروتينات، ومعاينات الجلسات، وخطط الأسابيع، والتمارين، ووزن الجسم، والحد الأقصى التقديري لتكرار واحد، وتوازن العضلات، والبرامج؛ أما log_workout فيكتب التمارين عبر خادمك بعد إقرانه. هذا الخادم ليس حاوية ولا يفتح أي منفذ. يبدأه عميلك عبر stdio، وتصل أدوات القراءة فيه مباشرةً إلى ملفات JSON في OPENGYM_DATA. وبما أن ذلك مسار لنظام الملفات، فإن تشغيل openGym على VPS يتطلب إما مزامنة نسخة من data/ إلى الجهاز الذي يشغّل العميل، أو استدعاء الخادم عبر ssh من إعدادات العميل.
هل ينبغي أن أستضيف openGym ذاتياً أم wger؟
اختر wger إذا أردت تتبع الطعام والتغذية إلى جانب سجل تمارينك، أو أردت REST API موثّقاً تبني عليه. يشغّل wger حزمة أكبر: Django تحت gunicorn، وPostgreSQL، وRedis، وعاملاً لـ Celery خلف nginx. اختر openGym إذا أردت حاويتين، وملفات JSON يمكنك قراءتها باستخدام cat، وتسجيل دخول بمفتاح مرور من دون إدارة كلمات مرور. في 19 August 2026، كان أول إصدار موسوم لـ openGym عمره شهراً واحداً، لذا افحص git tag وأنشئ نسخة احتياطية من data/ قبل كل تحديث.