Are you an LLM? You can read better optimized documentation at /zh-TW\client\sing-box-windows-android.md for this page in Markdown format
Sing Box Windows Android(第三方 Android 客戶端)
說明:該專案由第三方開發者維護,名稱雖含 Windows,實際只發布 Android 版本,與 sing-box 官方團隊無關。若需要官方客戶端,請前往 sing-box for Android。
🎯 簡介
Sing Box Windows Android 是一個基於 sing-box 核心的現代化 Android VPN 客戶端應用,提供簡潔、高效的網路代理管理功能。支援多種代理協議,具有優雅的使用者介面和強大的功能特性。

✨ 主要特性
- 🚀 高效能 VPN 服務:基於 sing-box 核心,穩定可靠的連線體驗
- 📱 現代化介面:採用 Jetpack Compose 建置的 Material 3 設計風格
- 🔗 智慧訂閱管理:支援新增、編輯和管理多個訂閱連結
- ⚡ 即時節點測速:自動測試節點延遲,選擇最優連線節點
- 📊 流量監控統計:即時顯示網路連線和流量使用情況
- 🎯 自動節點分組:智慧組織和管理節點分組
- 🔧 多架構支援:支援 ARM64 和 ARMv7 架構裝置
- 🌐 協議相容性:完整支援 VLESS、Shadowsocks 等主流代理協議
📱 下載安裝
最新版本
架構選擇
根據您的裝置架構選擇合適的 APK:
| 架構 | 檔名 | 適用裝置 | 推薦度 |
|---|---|---|---|
| arm64-v8a | app-arm64-v8a-release.apk | 64 位 ARM 裝置(大部分現代裝置) | ⭐⭐⭐ |
| armeabi-v7a | app-armeabi-v7a-release.apk | 32 位 ARM 裝置(較老裝置) | ⭐⭐ |
系統要求
- Android 版本: Android 10 (API 29) 或更高版本
- 儲存空間: 至少 100MB 可用空間
- 權限: VPN 權限和網路訪問權限
🚀 快速開始
- 下載應用:⬇️ 從 Releases 頁面下載對應架構的 APK
- 安裝應用:在 Android 裝置上安裝 APK 檔案
- 授予權限:允許 VPN 權限和通知權限
- 新增訂閱:輸入您的訂閱連結或匯入本地節點列表
- 連線使用:選擇節點並連線 VPN
📖 使用指南
新增訂閱
- 開啟應用,點選"新增訂閱"
- 輸入訂閱名稱和連結位址
- 點選"新增"並等待同步完成
- 選擇啟用的訂閱
匯入本地節點
您也可以匯入本地節點列表:
- 在訂閱管理中點選"匯入本地"
- 選擇或貼上節點列表內容
- 儲存即可使用本地管理的節點
節點管理
- 自動選擇:使用"自動測速"分組自動選擇最優節點
- 手動選擇:在分組中手動選擇特定節點
- 節點測速:點選測速按鈕測試節點延遲
流量監控
- 即時顯示上傳/下載速度
- 統計累計流量使用
- 監控連線狀態
🛠️ 技術規格
| 專案 | 規格 |
|---|---|
| 開發語言 | Kotlin |
| UI 框架 | Jetpack Compose + Material 3 |
| 核心庫 | libbox (sing-box) |
| 最低 SDK | API 29 (Android 10) |
| 目標 SDK | API 36 (Android 15) |
| 建置工具 | Gradle with Kotlin DSL |
| 支援協議 | VLESS, Shadowsocks 等 |
🔧 開發建置
環境要求
- Android Studio Hedgehog 或更高版本
- JDK 17 或更高版本
- Android SDK (API 29+)
建置步驟
bash
# 克隆倉庫
git clone https://github.com/xinggaoya/sing-box-windows-android.git
cd singboxwindows
# 建置 Debug 版本
./gradlew assembleDebug
# 建置 Release 版本
./gradlew assembleRelease
# 安裝到裝置
./gradlew installDebug專案結構
app/
├── src/main/
│ ├── java/cn/moncn/sing_box_windows/
│ │ ├── config/ # 設定管理
│ │ ├── core/ # 核心功能 (Clash API, 狀態, 診斷)
│ │ ├── ui/ # 使用者介面 (螢幕, 元件, 主題)
│ │ └── vpn/ # VPN 服務
│ ├── res/ # 資源檔
│ └── libs/ # 本地依賴庫 (libbox.aar)
└── build.gradle # 模組建置設定架構概覽
應用採用 單例 Store + Compose 響應式 UI 模式:
- Store 模式:使用單例物件 +
mutableStateOf進行全域性狀態管理 - Repository 模式:設定和訂閱資料持久化
- Manager 模式:核心功能協調 (OutboundGroupManager, CoreStatusManager)
詳細架構文件請參閱 CLAUDE.md。
🤝 貢獻指南
歡迎貢獻程式碼!請遵循以下步驟:
- Fork 本倉庫
- 建立特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 提交 Pull Request
編碼規範
- 遵循 Kotlin 官方編碼規範
- 使用 4 空格縮排
- 函式和變數使用 camelCase
- 類名使用 PascalCase
- 新增必要的註釋說明
📝 更新日誌
檢視 CHANGELOG.md 瞭解詳細的版本更新記錄。
最近更新
v1.1.0 (2025-12-23)
- Clash API 深度整合,即時流量統計
- 支援匯入本地節點列表
- 重構導航架構,底部導航欄設計
- 增強設定功能,設定自動儲存
🐛 問題反饋
如果遇到問題,請:
⚠️ 已知問題
- 部分舊裝置可能需要手動授予通知權限
- 某些網路環境下連線可能不穩定
- 訂閱同步超時時間較長(正在最佳化中)
📄 許可證
本專案採用 MIT 許可證。
🙏 致謝
- sing-box - 強大的網路代理工具
- Jetpack Compose - 現代化的 UI 工具包
- Material Design 3 - 設計系統
⚖️ 免責宣告
本應用僅供學習和研究使用,請遵守當地法律法規。開發者不對使用本應用產生的任何後果承擔責任。