BUNDLE-DOCTOR(1) General Commands Manual BUNDLE-DOCTOR(1)

bundle-doctor - بررسی bundle برای خطاهای رایج

bundle doctor [diagnose] [--quiet] [--gemfile=GEMFILE] [--ssl]
bundle doctor ssl [--host=HOST] [--tls-version=TLS-VERSION] [--verify-mode=VERIFY-MODE]
bundle doctor help [COMMAND]

با این دستور می‌توانید مشکلات رایج Bundler، مانند بررسی محیط gem یا خطاهای SSL/TLS را عیب‌یابی کنید.

فایل Gemfile و محیط gem شما را برای یافتن مشکلات رایج بررسی می‌کند. در صورت تشخیص اشکال، Bundler آن‌ها را چاپ کرده و با وضعیت خروج 1 خارج می‌شود. در غیر این صورت، Bundler یک پیام موفقیت چاپ کرده و با وضعیت خروج 0 خارج می‌شود.

نمونه‌هایی از مشکلات رایجی که شناسایی می‌شوند عبارتند از:

  • تنظیمات نامعتبر Bundler
  • عدم تطابق نسخه‌های Ruby
  • عدم تطابق پلتفرم‌ها
  • gemهای نصب‌نشده
  • وابستگی‌های مفقود

گزینه‌ها (OPTIONS)

فقط هشدارها و خطاها را در خروجی نمایش می‌دهد.
مکان Gemfile(5) که Bundler باید از آن استفاده کند. مقدار پیش‌فرض آن Gemfile(5) در پوشه کاری فعلی است. به طور کلی، Bundler فرض می‌کند که مکان Gemfile(5) همان ریشه پروژه است و سعی می‌کند Gemfile.lock و vendor/cache را نسبت به این مکان پیدا کند.
--ssl
عیب‌یابی مشکلات رایج SSL هنگام اتصال به https://rubygems.org.
این پرچم زیردستور bundle doctor ssl را با مقادیر پیش‌فرض در پشت صحنه اجرا می‌کند.

اگر هنگام اتصال به https://rubygems.org با مشکلات مربوط به گواهی‌های SSL و/یا نسخه‌های TLS مواجه شده‌اید، این دستور می‌تواند به عیب‌یابی مشکلات رایج کمک کند. این فرآیند تشخیصی چند بررسی انجام می‌دهد از جمله:

  • تأیید نسخه Ruby OpenSSL نصب‌شده روی سیستم شما.
  • بررسی نسخه کتابخانه OpenSSL مورد استفاده در زمان کامپایل.
  • اطمینان از پیکربندی صحیح گواهی‌های CA روی دستگاه شما.
  • باز کردن یک اتصال TLS و بررسی نتیجه آن.

گزینه‌ها (OPTIONS)

انجام عیب‌یابی روی HOST. پیش‌فرض rubygems.org است.
مشخص کردن نسخه TLS هنگام برقراری اتصال به HOST.
مقادیر مجاز عبارتند از: 1.1 یا 1.2.
مشخص کردن حالت اعتبارسنجی TLS هنگام باز کردن اتصال به HOST. پیش‌فرض SSL_VERIFY_PEER است.
مقادیر مجاز عبارتند از: CLIENT_ONCE، FAIL_IF_NO_PEER_CERT، NONE، PEER.
September 2025