圖標

WGControl

Automated WireGuard tunnel control via home Wi-Fi and Bluetooth.
新版本 1.47.61910
- New: manage several WireGuard tunnels, with per-Wi-Fi-network assignment ("Configured Networks") and separate default tunnels for Wi-Fi, mobile data, and roaming
- New: home screen widget with status, current network, active tunnel, Bluetooth info, and the same pause buttons as the notification; adapts to widget size (abbreviated labels/icon buttons when narrow), background style and opacity configurable
- Changed: Quick Settings tile long-press now opens the app (Status tab) instead of the sy
WGControl automatically manages your WireGuard tunnel based on your Wi-Fi and Bluetooth connections. It disables the tunnel when connected to your configured home Wi-Fi or selected Bluetooth devices (e.g., Android Auto) and re-enables it upon leaving.

This app is a VibeCode product. I have thoroughly tested all functions and believe everything works reliably.
However, I assume no responsibility for errors, results of errors, or atomic fallout.

Key Features:
- Wi-Fi & Bluetooth Detection: Automatically toggles the tunnel based on home networks or paired Bluetooth devices.
- Real-Time Monitoring: Continuously checks system-level VPN status and enforces the target state.
- Ping Connectivity Check (optional, off by default): Verifies internet availability via ICMP/TCP ping to a configurable host (example.com by default) before re-enabling the tunnel.
- Notification Pause Buttons: Manually override the tunnel from the status notification - indefinitely or for a configurable duration - without opening the app.
- Admin Password Protection: Secures configuration tabs using salted PBKDF2 hashing.
- Local Logging: Tracks tunnel commands and network events locally for up to 24 hours with search and export capabilities.
- QuickSettings Tiles and widget to control pause.

Essential Setup Steps:
1. WireGuard App: Enable "Allow user-controlled tunnel management" in settings.
2. Grant Permission: Allow "WireGuard tunnel control" permission.
3. Location Access: Set to "Allow all the time" for background Wi-Fi detection.
4. Battery Optimization: Disable for BOTH WGControl and the WireGuard app.

Note: Not affiliated with WireGuard or Jason A. Donenfeld. Controls the official WireGuard app via its public broadcast interface.

版本

雖然在下方可選擇下載 APK 檔案,但要留意這樣的安裝方式將不會收到更新通知,是一種較不安全的下載方法。建議您先安裝 F-Droid 用戶端使用。

下載 F-Droid
  • 版本 1.47.61910 (47) 建議 於 2026 年 10 月 22 日新增

    此版本需要 Android 7.0 或更高的版本。

    此套件包由原開發者建置和簽署,並保證與此原始碼 Tarball 保持一致。

    權限
    • 在背景存取位置資訊
      這個應用程式隨時都能取得位置資訊 (包括未使用應用程式時)。
    • 僅可在前景中取得概略位置
      只有在你使用時,這個應用程式才能透過定位服務取得你的概略位置。你必須在裝置上開啟定位服務,這個應用程式才能取得位置資訊。
    • 僅可在前景中取得精確位置
      只有在你使用時,這個應用程式才能透過定位服務取得你的精確位置。你必須在裝置上開啟定位服務,這個應用程式才能取得位置資訊。這麼做可能會增加電池用量。
    • 查看網路連線
      允許應用程式查看網路連線相關資訊,像是有哪些網路,以及有沒有連上。
    • 查看 Wi-Fi 連線
      允許應用程式查看 Wi-Fi 網路相關資訊,例如是否已啟用 Wi-Fi,以及所連上 Wi-Fi 裝置的名稱。
    • 與藍牙裝置配對
      允許應用程式查看手機的藍牙設定,以及建立和接受與其他配對裝置的連線。
    • 存取藍牙設定
      允許應用程式設定本機藍牙手機,以及搜尋遠端裝置並配對連線。
    • 與已配對的藍牙裝置連線
      允許應用程式與已配對的藍牙裝置連線
    • 建立及中斷 Wi-Fi 連線
      允許應用程式與 Wi-Fi 存取點連線或中斷連線,並可變更 Wi-Fi 網路的裝置設定。
    • 執行前景服務
      允許應用程式使用前景服務。
    • 搭配「connectedDevice」類型執行前景服務
      允許應用程式搭配「connectedDevice」類型使用前景服務
    • 搭配「location」類型執行前景服務
      允許應用程式搭配「location」類型使用前景服務
    • 擁有完整的網路存取權
      允許應用程式建立網路通訊端及使用自訂網路通訊協定。瀏覽器和其他應用程式會提供將資料傳輸到網際網路的方法,因此不需要這項權限也能將資料傳輸到網際網路。
    • 與鄰近的 Wi-Fi 裝置互動
      允許應用程式顯示鄰近的 Wi-Fi 裝置的資料、與其連線並判斷相對位置
    • 顯示通知
      允許應用程式顯示通知
    • 啟動時執行
      允許應用程式在系統完成開機程序後立刻自行啟動。這會增加手機的開機時間,而且會因為系統一直執行該應用程式導致手機的整體運作速度變慢。
    • 要求忽略電池效能最佳化
      允許應用程式要求權限,以便忽略針對該應用程式的電池效能最佳化設定。
    • 防止手機休眠
      允許應用程式防止手機進入休眠狀態。
    • com.wireguard.android.permission.CONTROL_TUNNELS
    • org.supersane.wgcontrol.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION

    下載 APK 1.9 MiB PGP 簽章 | 建置紀錄