رفتن به محتوای اصلی

نصب و به‌روزرسانی Muddog

محیط پشتیبانی‌شده​

در صفحهٔ دانلود، سیستم‌عامل و نسخه را بررسی کنید و فایل نصب را بگیرید.

سیستم‌عاملقالب و راهنمای استفاده
Linux x86_64بسته‌های .deb و .rpm. محیط دسکتاپ با systemd لازم است.
Windows 10/11 x64فایل نصب .msi. بستهٔ فعلی Windows فقط x64 را پشتیبانی می‌کند.
macOS 13 Ventura و بالاترفایل نصب .dmg. بستهٔ Universal از Intel و Apple Silicon پشتیبانی می‌کند. برای کنترل برنامه، حساب مدیر macOS لازم است.

نصاب Linux کتابخانه‌ها و بسته‌های وابستهٔ لازم برای اجرای برنامه را نیز نصب می‌کند. VPN به تفکیک برنامه در Linux علاوه بر آن به نشست کاربری systemd و cgroup v2 نیاز دارد؛ nftables در وابستگی‌های بسته قرار دارد. Windows نیز VPN به تفکیک برنامه را پشتیبانی می‌کند و macOS از VPN برای کل اینترنت یا IP و محدوده‌های مشخص پشتیبانی می‌کند.

این راهنما برای 2.x است. اگر فایل 2.x سیستم‌عامل شما هنوز در صفحهٔ دانلود دیده نمی‌شود، ابتدا وضعیت انتشار را بررسی کنید. برای فایل .exe نسخهٔ 1.0.7 در Windows، راهنمای نسخهٔ قدیمی را دنبال کنید.

با شروع سرویس، اشتراک نیز آغاز می‌شود

در Linux و Windows پس از پایان نصب، و در macOS پس از اولین اجرا و تأیید سرویس پس‌زمینه، اشتراک اینترنت خودکار شروع می‌شود. پس از آن سرویس هنگام راه‌اندازی سیستم نیز اجرا می‌شود؛ بنابراین حتی بدون باز کردن پنجرهٔ برنامه، دیگران می‌توانند از خط اینترنت شما استفاده کنند. پیش از نصب، مدیریت اشتراک اینترنت را بررسی کنید.

نصب در Linux​

فرمان‌های زیر نام فایل نسخهٔ 2.0.0 را به عنوان نمونه دارند. در ترمینال به پوشهٔ فایل دانلودشده بروید و نام فایل را با نام بسته‌ای که واقعاً دریافت کرده‌اید جایگزین کنید. نصب به دسترسی مدیر نیاز دارد.

Debian / Ubuntu​

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora​

sudo dnf install ./muddog-2.0.0-1.x86_64.rpm

اولین اجرا پس از نصب​

  1. پس از نصب، از دسکتاپ خارج شوید و دوباره وارد شوید.
  2. Muddog را از منوی برنامه‌ها اجرا کنید.
  3. بررسی کنید صفحهٔ اتصال، وضعیت VPN و اشتراک اینترنت من را نشان دهد.
  4. مطابق اتصال VPN، کشور را انتخاب و متصل شوید.

اگر از حساب کاربر معمولی با sudo نصب کنید، آن کاربر به گروه muddog اضافه می‌شود. باید دوباره وارد شوید تا این دسترسی در برنامه اعمال شود. برنامه را با کاربر معمولی اجرا کنید؛ برای استفاده از VPN نیازی به شناسه یا گذرواژهٔ Mudfish نیست.

اگر مدیر با حساب دیگری نصب کرده یا چند کاربر باید برنامه را کنترل کنند، بررسی مجوز دسترسی به سرویس را ببینید.

نصب در Windows​

  1. اگر Muddog را قبلاً با نصاب .exe نصب کرده‌اید، ابتدا از تنظیمات ← برنامه‌ها در Windows حذف کنید. اگر پیام حذف نسخهٔ قبلی ظاهر شد، حذف را تمام کنید و سپس نصب MSI را دوباره انجام دهید.
  2. فایل .msi دانلودشده را اجرا و درخواست دسترسی مدیر را تأیید کنید.
  3. راهنمای نصب را دنبال کنید. اگر WebView2 Runtime موجود نباشد، دستیار نصب آن را از اینترنت می‌گیرد؛ بنابراین اتصال اینترنت لازم است.
  4. muddog را از منوی شروع یا دسکتاپ با دسترسی کاربر معمولی اجرا کنید.
  5. وضعیت سرویس را در صفحهٔ اتصال بررسی کنید و اتصال VPN را ادامه دهید.

محل نصب پیش‌فرض %ProgramFiles%\muddog است. نصاب سرویس muddog-engine را ثبت و خودکار اجرا می‌کند و قواعد دیوار آتش دریافت UDP مورد نیاز موتور را نیز اضافه می‌کند. اجزای لازم VPN و VPN به تفکیک برنامه در بسته موجود هستند. لازم نیست هر بار برنامه را با دسترسی مدیر اجرا کنید.

نصب در macOS​

  1. فایل .dmg دانلودشده را باز کنید.
  2. Muddog.app را در پوشهٔ برنامه‌ها (/Applications) کپی کنید. اجرای مستقیم داخل DMG امکان ثبت سرویس پس‌زمینه را نمی‌دهد.
  3. در حالی که با حساب مدیر macOS وارد شده‌اید، Muddog کپی‌شده را اجرا کنید.
  4. در تنظیمات سیستم ← عمومی ← موارد ورود و افزونه‌ها، اجرای پس‌زمینهٔ Muddog را تأیید کنید. نام گزینه‌ها ممکن است با نسخهٔ macOS فرق کند.
  5. پس از اتصال مجدد برنامه به سرویس، اتصال VPN را ادامه دهید.

برای باز کردن دوبارهٔ صفحهٔ تأیید، در نوار منوی macOS، Service → Background Service Settings… را انتخاب کنید. اگر ثبت سرویس لازم است، Service → Enable Background Service را بزنید. نام این منوها انگلیسی نمایش داده می‌شود. خود برنامه را بدون sudo اجرا کنید.

به‌روزرسانی​

اگر از VPN استفاده می‌کنید، قطع اتصال را بزنید و فایل نصب جدید متناسب با سیستم‌عامل را از صفحهٔ دانلود بگیرید.

  • Linux: برنامه را ببندید و فرمان نصب بالا را با نام فایل جدید .deb یا .rpm اجرا کنید.
  • Windows: برنامه را ببندید و فایل .msi جدید را اجرا کنید. نصب MSI قبلی در فرایند به‌روزرسانی جایگزین می‌شود.
  • macOS: ابتدا با Service → Remove Background Service and Quit سرویس را حذف و برنامه را ببندید. برنامهٔ /Applications را با Muddog.app در DMG جدید جایگزین کنید، دوباره اجرا کنید و تأییدهای لازم سرویس را تکمیل کنید.

هنگام به‌روزرسانی، اتصال‌های VPN و اشتراک در حال استفاده قطع می‌شوند. پس از آن برنامه را دوباره باز و وضعیت اتصال و اشتراک را بررسی کنید. اگر خطای متفاوت بودن نسخهٔ برنامه و سرویس ظاهر شد، رفع مشکل را ببینید.

برای ارتقا از 1.0.7 قدیمی Linux، برنامهٔ قبلی را ببندید و بستهٔ جدید را نصب کنید. اگر muddog_srv.service قبلاً ثبت شده باشد، نصاب آن را متوقف و اجرای خودکارش را غیرفعال می‌کند. سپس Muddog را از منوی برنامه‌ها اجرا کنید.

حذف​

Linux​

در Debian / Ubuntu از فرمان زیر استفاده کنید:

sudo apt remove muddog

در Fedora:

sudo dnf remove muddog

با حذف بسته، سرویس و VPN پایان می‌یابند و مسیرهای شبکهٔ اضافه‌شده توسط Muddog پاک می‌شوند. در Debian / Ubuntu، اگر می‌خواهید حساب اختصاصی سرویس و گروه نیز حذف شوند، به جای حذف معمولی از sudo apt purge muddog استفاده کنید.

Windows​

در تنظیمات ← برنامه‌ها، muddog را انتخاب و حذف کنید. در فرایند حذف، سرویس و VPN متوقف می‌شوند، مسیرهای VPN پاک می‌شوند و سپس سرویس و قواعد دیوار آتش اضافه‌شده هنگام نصب حذف می‌شوند. تنظیمات کاربر و سوابق اتصال و واسطه‌گری نگهداری می‌شوند.

macOS​

  1. در برنامه Service → Remove Background Service and Quit را انتخاب کنید.
  2. پس از حذف سرویس و بسته شدن برنامه، Muddog.app را از /Applications به سطل زباله منتقل کنید.

اگر ابتدا فقط فایل برنامه را حذف کنید، پاک‌سازی موارد پس‌زمینه ممکن است دیرتر انجام شود. تنظیمات کاربر و سوابق اتصال و واسطه‌گری نگهداری می‌شوند.

سوابق باقی‌مانده و توقف اشتراک​

حذف بسته و حذف سوابق اتصال و واسطه‌گری دو کار جداگانه‌اند. برای محل و شیوهٔ نگهداری سوابق محلی باقی‌مانده، سوابق اتصال و واسطه‌گری را ببینید. برای حفظ برنامه و توقف فقط اشتراک می‌توانید از توقف سرویس استفاده کنید، اما تا وقتی سرویس متوقف است، VPN خودتان نیز قابل استفاده نیست.