Skip to main contentPhantom-WG

Mac İstemci Uygulaması


Bir Bakışta

Get the app onto your Mac

Phantom-WG Mac uygulamasını iki yoldan Mac cihazınıza yükleyebilirsiniz.

  • Homebrew Cask (önerilen) — Tek komut ve kolay güncelleme
  • Doğrudan .dmgarm64 Apple Silicon için, x86_64 Intel için ayrı paketler.

İmzalı .app /Applications altına yerleşir; ilk açılışta macOS Gatekeeper imzayı doğrular. .dmg paketlerine mac-v1.3.0 release sayfasından erişilebilir. Derleme, imzalama ve notarizasyon adımları GitHub Actions üzerinde mac-release.yml ile yürütülür.

Sistem Gereksinimleri

  • macOS 14 (Sonoma) veya üzeri
  • Apple Silicon (arm64) veya Intel (x86_64)

Approve three system extensions

Phantom-WG Mac ağ operasyonlarını üç sistem uzantısı üzerinden yürütür:

  • PhantomTunnel — Tünel bağlantısı; Ghost Mode (wstunnel + WireGuard) veya Standalone WireGuard çalışır.
  • PhantomSplitTunnel — Uygulama bazlı yönlendirme için Transparent Proxy katmanı.
  • PhantomDNSProxy — DNS sorgularını seçilen ağ arayüzüne uygulama bazlı sabitleyen DNS Proxy.

İlk açılışta macOS her uzantı için ayrı onay ister; üçü de aktif olana kadar ana arayüz açılmaz.

Import a config and start your tunnel

Tüneli başlatmak için uygulamaya bir WireGuard .conf dosyası içe aktarılır. Mod, yapılandırma dosyasının içeriğine göre belirlenir:

  • Standalone WireGuard — Klasik .conf dosyası içe aktarıldığında uygulama doğrudan WireGuard tünelini başlatır.
  • Ghost Mode (wstunnel + WireGuard).conf dosyası [Wstunnel] bölümü içerirse uygulama otomatik olarak Ghost moduna geçer; trafik wstunnel katmanı içinde taşınır.

Mod seçimi için ayrı bir uygulama veya ayar gerekmez; yapılandırma dosyası belirler.

Route selected apps outside the tunnel

Split-Tunneling, listeye eklediğiniz uygulamaların trafiğini tünelin dışına çıkarır:

  • Bypass Yönlendirmesi — Seçilen uygulamalar fiziksel arayüzünüz veya tercih ettiğiniz ağ arayüzü üzerinden doğrudan çıkar; tünel ayakta kalır, diğer trafik VPN üzerinden akmaya devam eder.
  • Strict Mod — Seçilen arayüz erişilemez hale gelirse bypass listesindeki akışlar reddedilir; sessizce tünele geri yönlendirilmez.
  • mDNSResponder dahil etme — Listeye eklenince yerel ad çözümlemesi de seçili arayüzden taşınır.

Yükleniyor...

Mimari ve Kaynak Kod

Kaynak
Bağlantı
Geliştirme Branch'i app/mac
ADR Dökümanları app/mac/Documentation/ADR

Tutorial müziklerinin lisans ve atıf bilgileri için DISCLOSURE_TR.md dosyasına bakın.