fa Installation

نصب

پیش‌نیازها

• macOS 26 یا جدیدتر
• Apple Silicon (M1 یا جدیدتر). مک‌های اینتل پشتیبانی نمی‌شوند.

Homebrew (پیشنهادی)

brew install --cask lordversa/tap/v2mac

Homebrew هشدار Gatekeeper را دور می‌زند. پس از آن V2Mac خودش را به‌روز می‌کند، حتی اگر با Homebrew نصب شده باشد (به‌روزرسانی را ببینید).

دانلود دستی

1. فایل V2Mac-<version>.dmg را از آخرین نسخه دانلود کنید. هر نسخه یک فایل .sha256 هم برای بررسی دانلود دارد.
2. DMG را باز کنید و V2Mac را به Applications بکشید.
3. برنامه notarize نشده، پس macOS اولین اجرا را مسدود می‌کند. یک بار بازش کنید، سپس در System Settings → Privacy & Security روی Open Anyway بزنید، یا این را اجرا کنید:

xattr -dr com.apple.quarantine /Applications/V2Mac.app

اولین اتصال

1. روی Add Subscription (⌘N) بزنید و آدرس اشتراک یا یک لینک vless://، vmess://، trojan://، ss:// یا hy2:// را بچسبانید.
2. روی یک سرور دوبار کلیک کنید (یا انتخابش کنید و Return بزنید).
3. برنامه‌ها را روی socks5://127.0.0.1:10808 یا http://127.0.0.1:10808 تنظیم کنید، یا System Proxy یا TUN را روشن کنید.

V2Mac در نوار منو می‌ماند. بستن پنجره پراکسی را خاموش نمی‌کند؛ برای توقف با ⌘Q خارج شوید.

در اولین اجرا V2Mac اجازهٔ نمایش اعلان می‌خواهد. نوار منو و میان‌برها را ببینید.

به‌روزرسانی

• برنامه: V2Mac روزی یک بار GitHub را بررسی می‌کند و نسخه‌های تازه را خودش نصب می‌کند. فقط فایل‌های تغییرکرده (اغلب کمتر از ۱ مگابایت) را در پس‌زمینه دانلود می‌کند و به‌روزرسانی را هنگام بستن برنامه نصب می‌کند. وقتی به‌روزرسانی آماده است، نقطهٔ کوچکی روی آیکون نوار منو دیده می‌شود و پنل و Settings → General دکمهٔ Restart Now را برای نصب فوری نشان می‌دهند (VPN چند ثانیه قطع می‌شود). حلقه روی آیکون یعنی نسخهٔ تازه پیدا شده ولی هنوز دانلود نشده. پس از به‌روزرسانی اعلان «V2Mac به نسخهٔ … به‌روز شد» می‌آید.
• اگر می‌خواهید خودتان تصمیم بگیرید، Install updates automatically را در Settings → General خاموش کنید: آن‌وقت V2Mac فقط Update Now نشان می‌دهد. Check for app updates بررسی را کلاً خاموش می‌کند.
• هر به‌روزرسانی پیش از نصب با امضای پروژه بررسی می‌شود.
• هستهٔ Xray: Settings → Core → Check for Update. فایل با SHA-256 بررسی و پیش از جایگزینی آزمایش می‌شود. Revert to Bundled به هستهٔ همراه برنامه برمی‌گردد.

حذف برنامه

1. از V2Mac خارج شوید (⌘Q). این کار TUN، پراکسی سیستم و کیل‌سوییچ را خاموش می‌کند.
2. اگر helper را فعال کرده‌اید، در Settings → General → Privileged helper روی Remove Helper بزنید.
3. /Applications/V2Mac.app را پاک کنید (یا brew uninstall --cask v2mac).
4. برای پاک کردن داده‌ها: ~/Library/Application Support/v2mac