آموزش میزبانی شخصی openGym با Docker Compose
راهنمای کامل نصب openGym روی سرور شخصی. یاد بگیرید چگونه با استفاده از Docker Compose، تنظیمات TLS پیش از فعالسازی Passkey و مدیریت دادههای JSON را به درستی انجام دهید.
آنچه با میزبانی شخصی openGym به دست میآورید
شما openGym را با کلون کردن مخزن، ویرایش دو خط در .env و اجرای docker compose up -d --build پشت یک reverse proxy که TLS (امنیت لایه انتقال) را مدیریت میکند، به صورت شخصی میزبانی میکنید. openGym یک ردیاب تمرینات ورزشی و وزن بدن است: برنامههای هفتگی، تمرینات هدایتشده، ثبت هر ست و نمایش تغییرات وزن در طول زمان. این نرمافزار تحت مجوز AGPL-3.0 است و همه دادهها را در فایلهای JSON ساده روی دیسک شما ذخیره میکند، بنابراین نیازی به اجرای سرور پایگاه داده نیست.
پشته (stack) شامل دو کانتینر با اجرای طولانیمدت است: یک کانتینر nginx که build مربوط به React را سرویسدهی میکند و یک کانتینر Node که API را در خود جای داده است. به علاوه، یک job یکباره (one-shot) وجود دارد که در اولین اجرا، حدود 140 مگابایت تصاویر و فایلهای GIF تمرینات را دانلود میکند.
دو نکته وجود دارد که فایل README پروژه برای کسی که روی سرور عمومی مستقر میکند، تلویحاً بیان کرده اما صراحتاً توضیح نداده است. ورود با Passkey به یک نام میزبان (hostname) وابسته است، بنابراین دامنه و گواهی آن باید پیش از اولین ورود وجود داشته باشند، نه بعد از آن. همچنین، سرور اختیاری MCP در تگ ثابت v1.2.7 فقط خواندنی است و روی ماشینی اجرا میشود که کلاینت هوش مصنوعی شما روی آن قرار دارد، نه داخل پشته؛ این موضوع کاری را که باید هنگام قرارگیری دادهها روی یک VPS انجام دهید، تغییر میدهد. سرور فعلی MCP همچنین از ثبت تمرینات پس از جفتسازی با سرور شما پشتیبانی میکند.
openGym جوان است. اولین نسخه تگشده، v1.0.0، در تاریخ 20 July 2026 منتشر شد و v1.2.7 در 18 August 2026 عرضه گردید. سیزده تگ در اولین ماه و 34 تگ تا 9 October 2026 که v1.4.0 در آن روز تگ شد، نشان میدهد که برنامه همچنان در حال تغییر است؛ بنابراین به جای ساختن آنچه در شاخه پیشفرض (default branch) قرار دارد، یک تگ نسخه (release tag) را بررسی کنید.
پیش از نخستین ورود، دامنه را برنامهریزی کنید
Passkeyها روش ورود شما به openGym هستند. هر Passkey به یک Relying Party ID (یا همان RP ID) متصل است که در واقع همان دامنهای است که اعتبارنامه روی آن ایجاد شده است؛ مرورگرها نیز Passkeyها را فقط روی HTTPS ایجاد میکنند. تنها استثنا در این مورد localhost است.
این موضوع پیامدی دارد که کاربران معمولاً در گوشیهای خود با آن مواجه میشوند. اگر http://203.0.113.10:8080 را از دستگاه دیگری باز کنید، هیچ اعلان Passkey نمایش داده نمیشود، زیرا مرورگر از ایجاد اعتبارنامه روی مبدأ HTTP ساده یا آدرس IP خام خودداری میکند. یادداشتهای عیبیابی خود پروژه نیز همین نکته را تایید میکنند: عدم نمایش اعلان به این معنی است که شما روی http:// یا یک IP هستید.
بدتر اینکه RP ID در تمامی اعتبارنامههایی که کاربران شما قبلاً ثبت کردهاند، نهادینه شده است. اگر RP_ID را بعداً تغییر دهید، Passkeyهای ذخیرهشده روی دستگاههای کاربران دیگر با دامنه جدید مطابقت نخواهند داشت و در نتیجه هیچکس نمیتواند وارد سیستم شود. ابتدا نام میزبان (hostname) را تعیین کنید، DNS را به سمت VPS هدایت کنید و پیش از آنکه کسی روی Create profile ضربه بزند، گواهی (certificate) را فعال و آماده کنید.
استقرار openGym با Docker Compose
فایل compose، مسیرهای ./data و ./media را بهصورت bind-mount نسبت به موقعیت خود فایل متصل میکند؛ بنابراین دایرکتوری که پروژه را در آن clone میکنید، همان دیتابیس شماست. آن را در مکانی با ماندگاری بالا قرار دهید.
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 یک آدرس clone برای github.com/DuarteSantos8/openGym ارائه میدهد. تا تاریخ 4 November 2026، این مخزن در دسترس است و خود را به عنوان خانه اصلی پروژه معرفی میکند. پیش از اولین build، تگ مربوطه را checkout کنید: شاخه پیشفرض (default branch) از نسخهای که این راهنما توصیف میکند جلوتر رفته است و در آن، انیمیشنهای تمرین درون image قرار دارند و job مربوط به media که در ادامه آمده، دیگر وجود ندارد. بخش مربوط به pinning دلیل این موضوع را توضیح میدهد.
فایل .env را ویرایش کنید. سه خط در یک VPS اهمیت دارند.
RP_ID=gym.example.com
ORIGIN=https://gym.example.com
WEB_PORT=127.0.0.1:8080مقدار RP_ID نام میزبان (hostname) خام و ORIGIN آدرس کامل شامل طرح (scheme) است. این مقادیر باید دقیقاً با نوار آدرس مرورگر مطابقت داشته باشند، در غیر این صورت ورود با خطای verification failed شکست میخورد. مقدار WEB_PORT در بخش مربوط به خصوصی نگهداشتن پورت 8080 توضیح داده شده است.
docker compose up -d --build
docker compose ps --all
docker compose logs mediaدستور docker compose ps --all باید وضعیت web و api را به عنوان در حال اجرا (running) و media را به عنوان خارجشده (exited) با کد 0 نشان دهد. پرچم --all را حفظ کنید: بدون آن، Compose فقط کانتینرهای در حال اجرا را لیست میکند و job تمامشده media اصلاً نمایش داده نمیشود. این خروج صحیح است: job مربوط به media دارای وضعیت restart: "no" است زیرا کار آن یک دانلود یکباره است. لاگ آن با خطی که با ✓ Exercise media ready شروع میشود پایان مییابد و ls media/img | wc -l باید عدد 1,324 را چاپ کند (نه 0)، که تعداد تصاویر بندانگشتی (thumbnails) موجود در مجموعه داده تمرینات بالادستی تا تاریخ 9 October 2026 است. دایرکتوری خالی به این معنی است که دانلود شکست خورده و برنامه کارتهای تمرین را با تصاویر خالی نمایش میدهد.
پرچم --build را حفظ کنید. فایل compose در این تگ، imageهای از پیش ساختهشده را در ghcr.io با تگ latest نامگذاری میکند. این imageها تا تاریخ 18 October 2026 مجدداً منتشر شدهاند، اما latest از جدیدترین نسخه پیروی میکند؛ بنابراین docker compose pull کدی جدیدتر از کدی که همین الان checkout کردید را اجرا خواهد کرد. هر دو سرویس دارای بخش build هستند و --build آنها را از روی کدی که checkout کردهاید build میکند. اگر با خود Compose آشنا نیستید، با Docker Compose روی یک VPS شروع کنید و سپس به اینجا بازگردید.
نسخه را ثابت کنید، زیرا این پروژه نوپا است
رجیستری دوباره تصاویر نسخهبندیشده ارائه میدهد، اما فایل compose در نسخه v1.2.7 همچنان از latest استفاده میکند. تا تاریخ 4 نوامبر 2026، مقدار latest به نسخه 1.4.4 اشاره دارد که در 3 نوامبر 2026 منتشر شده است. آنچه شما ثابت (pin) میکنید، نسخه checkout شده روی دیسک است، زیرا این نسخه تعیین میکند که کدام ویرایش از برنامه در نهایت وارد کانتینر شود.
cd /opt/opengym
git fetch --tags
git checkout v1.2.7دستور git status اکنون یک وضعیت detached HEAD را در آن تگ گزارش میدهد، که دقیقاً همان چیزی است که روی سرور به آن نیاز دارید. تا زمانی که تگ دیگری را checkout نکنید، هیچ تغییری زیر پای شما رخ نخواهد داد.
نسخه v1.2.7 همان نسخهای است که این راهنما بر اساس آن نوشته شده و دیگر جدیدترین نسخه نیست. نسخههای بعدی، خودِ فرآیند استقرار را تغییر میدهند (در شاخه پیشفرض، job مربوط به media حذف شده است)، بنابراین پیش از تغییر نسخه ثابت، یادداشتهای انتشار (release notes) را بخوانید و فایل compose را مقایسه کنید. یادداشتهای انتشار v1.4.2 و v1.4.3 همچنین شامل اصلاحات امنیتی هستند و پروژه از کاربران self-hoster میخواهد که بهروزرسانی کنند.
سپس به Compose دستور دهید که دیگر به سراغ رجیستری نرود. این تنظیمات را در docker-compose.override.yml قرار دهید؛ فایلی که Compose بهطور خودکار بارگذاری کرده و با فایل اصلی (tracked) ادغام میکند. کلیدهای Scalar توسط فایل override جایگزین میشوند، بنابراین نیازی به ویرایش هیچ فایلی در git نیست و git pull تمیز باقی میماند. برای اطلاع از قوانین کامل ادغام، به نحوه ادغام فایل override توسط Compose مراجعه کنید.
services:
api:
pull_policy: build
web:
pull_policy: buildبا اعمال این تنظیمات، اجرای بعدی docker compose up -d به جای دریافت (pull) هر آنچه latest در آن روز به آن اشاره دارد، از روی سورسکدی که در اختیار دارید build انجام میدهد. بررسی کنید که ادغام بهدرستی اعمال شده باشد، سپس build را روی تگ مورد نظر مجدداً انجام دهید.
docker compose config | grep pull_policy
docker compose up -d --buildپایاندهی TLS با یک reverse proxy
کانتینرها از پروتکل HTTP ساده استفاده میکنند. باید ابزاری در لایهٔ جلویی وجود داشته باشد که گواهی TLS را مدیریت کند. 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 بزنید. اگر اعلان passkey ظاهر شد و سپس ورود به سیستم گزارش verification failed داد، RP_ID یا ORIGIN با URL موجود در نوار آدرس مطابقت ندارد. مقدار .env را اصلاح کنید و دوباره docker compose up -d را اجرا کنید؛ این کار کانتینرها را بازسازی میکند تا مقادیر جدید را بخوانند. دستور docker compose restart باعث بارگذاری مجدد .env نمیشود.
محدود کردن دسترسی به پورت 8080 از اینترنت عمومی
بهصورت پیشفرض، سرویس وب 8080 را روی تمام رابطهای شبکه منتشر میکند؛ بنابراین برنامه از طریق IP عمومی شما و با پروتکل HTTP ساده در دسترس است، در حالی که پروکسی در همان سرور از 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 باید با خطای رد شدن (refused) یا وقفه (timeout) مواجه شود، در حالی که نام دامنه HTTPS همچنان به کار خود ادامه میدهد.
بستن ثبتنام پس از ایجاد پروفایل خود
ثبتنام بهصورت پیشفرض باز است و حالت مهمان (guest mode) فعال میباشد. در یک نام میزبان عمومی، این یعنی هر کسی که URL را پیدا کند میتواند روی سرور شما پروفایل بسازد. ابتدا پروفایل خود را ثبت کنید، سپس شناسه کاربری (user ID) خود را پیدا کنید: ls data/ فایلی به نام state-<uid>.json را برای هر کاربر فهرست میکند و آن <uid> همان مقداری است که به آن نیاز دارید.
ADMIN_UIDS=<your-uid>
INVITE_ONLY=1
ALLOW_GUEST=0دستور docker compose up -d را دوباره اجرا کنید. بخش تنظیمات (Settings) اکنون یک داشبورد مدیریت (Admin dashboard) را نشان میدهد که در آن میتوانید کدهای دعوت تولید یا ابطال کنید؛ بنابراین افرادی که با آنها تمرین میکنید میتوانند ثبتنام کنند و هیچکس دیگری قادر به این کار نخواهد بود. openGym هیچ شناختی از ارائهدهندگان هویت خارجی ندارد، بنابراین آن کدهای دعوت فقط همین یک برنامه را کنترل میکنند و هیچ تأثیری بر سایر بخشهای سرور ندارند؛ اگر ترجیح میدهید برای هر نفر یک حساب کاربری واحد برای تمام سرویسهای خود داشته باشید، قرار دادن Authentik به عنوان یک forward auth proxy پیش از بارگذاری صفحه ورود passkey در openGym، دسترسی به نام میزبان را محدود میکند.
محل ذخیرهسازی دادهها و پشتیبانگیری برای محافظت از آنها
همه چیز در دایرکتوری ./data قرار دارد که به مسیر /data در کانتینر API متصل (mount) شده است. چهار نوع فایل وجود دارد: db.json شامل پروفایلها و اعتبارنامههای عمومی passkey است، state-<uid>.json روتینها، تمرینات و وزن بدن یک کاربر را نگه میدارد، secret کلید کوکی نشست (session cookie) است و vapid.json کلیدهای اعلانهای فشاری (push notification) را که در اولین اجرا تولید شدهاند، در خود جای میدهد.
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 مربوط به پایگاه داده و وضعیت تمرینات را در یک فایل موقت مینویسد و سپس آن را بهصورت اتمیک (atomic) جایگزین فایل مقصد میکند، بنابراین فایلهای زنده را در محل اصلی بازنویسی نمیکند. سپس آرشیو را از سرور خارج کنید، زیرا آرشیوی که روی همان VPS باقی بماند، در صورت خرابی VPS از بین میرود. فایل media/ را از پشتیبانگیری حذف کنید: این فایل شامل 140 مگابایت تصاویر تمرینات است که job مربوط به رسانه میتواند دوباره آنها را بهصورت رایگان دانلود کند.
بازیابی به معنای استخراج فایلهای tar در همان مسیر روی میزبانی است که همان دامنه را سرویسدهی میکند. یک passkey ذخیرهشده روی گوشی شما به RP ID که در زمان ایجاد آن ثبت شده، محدود است؛ بنابراین بازیابی روی یک نام میزبان (hostname) جدید، پایگاه دادهای به شما میدهد که هیچکس نمیتواند به آن وارد شود. دامنه را حفظ کنید یا برای ثبت مجدد تمام passkeyها برنامهریزی کنید. همین نظم برای هر چیز دیگری که اجرا میکنید نیز صدق میکند و پشتیبانگیری و ارتقای یک استک Docker Compose روال کلی این کار را پوشش میدهد.
سرور MCP پینشده فقطخواندنی است و روی دستگاه شما اجرا میشود
پروتکل MCP (مخفف Model Context Protocol) روشی است که کلاینتی مانند Claude Desktop یا Cursor با یک سرور ابزار محلی ارتباط برقرار میکند. openGym یکی از آنها را در mcp/ عرضه میکند. این سرور بخشی از فایل compose نیست، یک کانتینر محسوب نمیشود و روی هیچ پورتی گوش نمیدهد. کلاینت آن را به عنوان یک child process اجرا کرده و از طریق 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 در نصب تککاربره اختیاری است، جایی که سرور تنها پروفایلی را که پیدا میکند شناسایی مینماید. در branch پیشفرض فعلی، یازده ابزار ارائه میشود: 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 عرضه کرد. دستیاری که از آن سرور پینشده استفاده میکند میتواند پاسخ دهد که هفتهٔ گذشته چه وزنهای زدهاید، اما نمیتواند ست ثبت کند، برنامهای را ویرایش کند یا چیزی را حذف نماید. در branch فعلی، ده ابزار عملیات خواندن را انجام میدهند و log_workout پس از جفتسازی، تمرینات را از طریق سرور شما ذخیره میکند؛ این قابلیت تا زمان جفتسازی غیرفعال است. آن لیست نمونهای فشرده از تصمیمی است که طراحی عامل (agent) مدام به آن بازمیگردد: ابزارهایی که در معرض دید قرار میدهید، تمام کارهایی هستند که یک مدل میتواند انجام دهد، و یادگیری نحوه کارکرد عاملها با نوشتن حلقه توسط خودتان سریعترین راه برای درک این موضوع است که چرا مجموعه ابزارهای فقطخواندنی یک انتخاب طراحی است، نه یک محدودیت.
این بخشی است که خوانندهٔ 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 به هر فرد یک عامل sandboxed روی سرور میدهد تا جهش stdio به سمت data/ دوباره یک ارتباط محلی باشد.
اگر cat data/db.json مقدار Permission denied را برگرداند، کانتینر API آن فایلها را با دسترسی root نوشته است و لاگین شما نمیتواند آنها را بخواند. آنها را با sudo کپی کنید یا مالکیت آنها را روی میزبان تغییر دهید. برای سرورهایی که قرار است به جای stdio از طریق شبکه گوش دهند، به اجرای سرورهای MCP روی یک VPS مراجعه کنید.
openGym یا wger: کدام را اجرا کنید؟
wger گزینهٔ تثبیتشده در این حوزه است و نرمافزار بسیار بزرگتری محسوب میشود. استک compose آن شامل gunicorn برای سرویسدهی به یک برنامهٔ Django، به همراه PostgreSQL، Redis و یک worker از نوع Celery است که همگی پشت nginx قرار دارند. در عوض، شما قابلیت ردیابی تغذیه و مواد تشکیلدهنده، یک REST API مستند، یک پایگاهداده بزرگ از تمرینات ورزشی و امکاناتی برای مربیانی که برنامههای دیگران را مدیریت میکنند، دریافت میکنید.
openGym شامل دو کانتینر و یک پوشه از فایلهای JSON است و هیچ حساب کاربری برای مدیریت، فراتر از passkeyها ندارد. تفاوت دقیقاً همینجاست. اگر تا به حال یک نصب Chatwoot را مدیریت کرده باشید، جایی که پشتیبانگیری به معنای گرفتن dump از Postgres در کنار دایرکتوری آپلودهاست و هر ارتقای نسخه نیازمند اجرای migrationهای پایگاهداده است، از قبل میدانید که ساختار wger چه انتظاراتی از نظر نگهداری از شما دارد.
اگر میخواهید غذا را در کنار تمرینات ردیابی کنید یا به یک API برای توسعه نیاز دارید، wger را اجرا کنید. اگر به دنبال استکی هستید که آنقدر کوچک باشد که بتوانید در یک بعدازظهر کل آن را بررسی کنید و ورود به سیستم آن بدون رمز عبور (و خطر نشت آن) باشد، openGym را انتخاب کنید. هزینهٔ این انتخاب، بلوغ نرمافزار است: تا تاریخ 19 August 2026، اولین نسخهٔ openGym تنها یک ماه قدمت دارد، در حالی که wger سالها سابقهٔ انتشار نسخه دارد. نسخهٔ خود را ثابت (pin) کنید، پشتیبانها را نگه دارید و پیش از هر بهروزرسانی، یادداشتهای انتشار (release notes) را مطالعه کنید.
اگر هنوز در حال تصمیمگیری هستید که چه چیزی ارزش فضای سرور شما را دارد، چه چیزی در سال 2026 ارزش self-hosting دارد به بررسی این توازنها میپردازد و این برنامه در کنار 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 هرگز در گوشی من درخواست passkey را نشان نمیدهد؟
مرورگر به دلیل اینکه شما روی http:// یا یک آدرس IP خام مانند http://192.168.1.20:8080 هستید، از ایجاد اعتبارنامه خودداری میکند. مرورگرها فقط در مبدأهای HTTPS اجازه استفاده از passkey را میدهند و 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 قرار دارند که به عنوان /data در کانتینر API مونت شده است. این دایرکتوری شامل db.json برای پروفایلها و اعتبارنامههای عمومی passkey، یک فایل state-<uid>.json برای هر کاربر جهت ذخیره تمرینات و وزن بدن، secret برای کلید کوکی نشست و vapid.json برای کلیدهای اعلان push است. برای تهیه نسخه پشتیبان، ابتدا docker compose stop api را اجرا کنید، سپس tar czf ~/opengym-$(date +%F).tar.gz data/ و docker compose start api را انجام دهید و آرشیو را از سرور کپی کنید. از media/ صرفنظر کنید، زیرا شامل 140 مگابایت تصاویر تمرینی است که media job بهطور خودکار دوباره دانلود میکند.
آیا Claude میتواند تاریخچه تمرینات openGym مرا بخواند؟
بله، از طریق سرور اختیاری MCP در دایرکتوری mcp/. سرور نسخه v1.2.7 دارای هشت ابزار فقطخواندنی است. شاخه پیشفرض فعلی دارای یازده ابزار است: ده روتین خواندن، پیشنمایش نشستها، برنامههای هفتگی، تمرینات، وزن بدن، حداکثر وزنه قابل جابجایی (1RM)، تعادل عضلانی و برنامهها؛ log_workout پس از جفتسازی، تمرینات را از طریق سرور شما مینویسد. این یک کانتینر نیست و هیچ پورتی را باز نمیکند: کلاینت شما آن را از طریق stdio اجرا میکند و ابزارهای خواندن آن مستقیماً به فایلهای JSON در OPENGYM_DATA دسترسی پیدا میکنند. از آنجا که این یک مسیر در سیستم فایل است، اجرای openGym روی یک VPS به معنای همگامسازی یک کپی از data/ روی دستگاهی است که کلاینت را اجرا میکند، یا فراخوانی سرور از طریق ssh در پیکربندی کلاینت.
آیا باید openGym را خودمیزبانی کنم یا wger را؟
اگر در کنار گزارش تمرینات به دنبال ردیابی غذا و تغذیه هستید، یا به یک REST API مستند برای توسعه نیاز دارید، wger را انتخاب کنید. این سرویس پشته بزرگتری را اجرا میکند: Django تحت gunicorn، PostgreSQL، Redis و یک worker از نوع Celery پشت nginx. اگر به دنبال دو کانتینر، فایلهای JSON که میتوانید با cat بخوانید و ورود با passkey بدون نیاز به مدیریت رمز عبور هستید، openGym را انتخاب کنید. تا تاریخ 19 August 2026، اولین نسخه تگشده openGym یک ماهه است، بنابراین قبل از هر بهروزرسانی، یک git tag را بررسی کرده و از data/ نسخه پشتیبان تهیه کنید.