fa Installation

به macOS 14 یا جدیدتر روی Apple Silicon یا Intel نیاز دارد. برای Apple Silicon فایل DMG معمولی و برای Intel فایل Intel DMG با پسوند -intel.dmg را بگیرید. سندباکس امن به Apple Silicon و macOS 26 یا جدیدتر نیاز دارد. Liquid Glass و مرکز کنترل به macOS 26 نیاز دارند؛ macOS 14 و 15 از کنترل‌های استاندارد استفاده می‌کنند. پیشنهاد دامنه با Apple Intelligence به macOS 26 و مدل محلی در دسترس نیاز دارد؛ نمایه‌سازی سرورها در Spotlight به macOS 15 نیاز دارد.

نصب

پیش‌نیازها

• macOS 14 یا جدیدتر
• Apple Silicon یا Intel.

Homebrew (پیشنهادی)

brew install --cask v2macapp/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

بررسی فایل دانلودشده

V2Mac هنوز notarize نشده است، پس macOS نمی‌تواند DMG را تأیید کند. آنچه خودتان می‌توانید بررسی کنید:

shasum -a 256 ~/Downloads/V2Mac-<version>.dmg

• نتیجه را با فایل .sha256 همان نسخه و با sha256 در cask هوم‌برو مقایسه کنید. یکسان بودن نشان می‌دهد فایل در مسیر خراب یا عوض نشده است. هر دو از همان انتشار می‌آیند، پس اصل بودن خود انتشار را ثابت نمی‌کند.
• پس از نصب، codesign --verify --deep --strict /Applications/V2Mac.app بررسی می‌کند که چیزی در برنامه پس از ساخت تغییر نکرده باشد.
• به‌روزرسانی‌های داخل برنامه محکم‌ترند: هر کدام با کلید به‌روزرسانی V2Mac امضا می‌شود و برنامه به‌روزرسانی بدون امضا را نمی‌پذیرد.

اولین اتصال

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