MikuBoxForAndroid の日本語紹介
概要
MikuBox for Android は、sing-box をエンジンとして利用する Android 向けの汎用プロキシアプリです。sing-box の持つ多様なプロトコルサポート(例: VLESS/VMess/SS/Trojan 等)や高度なルーティングを Android デバイス上で使える形にパッケージ化することを目標としています。API レベル 21 以上をサポートし、GPL-3.0 で配布。リポジトリには README、ライセンス、リリース情報が含まれており、バイナリ配布や設定方法のドキュメントが用意されている点が特徴です。ユーザーは GUI で設定を編集して sing-box を起動、ローカルでプロキシ処理を行わせることで、端末全体またはアプリ単位のトラフィック経路を制御できます。
リポジトリの統計情報
- スター数: 18
- フォーク数: 0
- ウォッチャー数: 18
- コミット数: 30
- ファイル数: 20
- メインの言語: 未指定
主な特徴
- sing-box の機能を Android 向けにラップして提供(マルチプロトコル対応を想定)
- Android API 21+ 対応、モバイルでの実行に配慮した設計
- バイナリ付きリリースと GPL-3.0 ライセンスの明示
- GUI による設定管理と JSON コンフィグ生成で柔軟にカスタマイズ可能
技術的なポイント
MikuBoxForAndroid の核は「sing-box を Android 上で安全かつ実用的に動かす」点にあります。典型的なアーキテクチャは、ユーザーインターフェース部分で sing-box の JSON 設定を生成し、その設定をバンドルされたまたはダウンロードした sing-box 実行バイナリに渡してプロセスを起動する流れです。実行方法は大きく二通り考えられます:1) アプリ内でネイティブバイナリを同梱し Runtime.exec()/ProcessBuilder で直接起動する方式、2) VPNService/TUN を利用してトラフィックを仮想インターフェース経由で sing-box や tun2socks に渡す方式。後者はアプリ単位ではなく端末全体のトラフィック制御が可能で、DNS フィルタやルーティングポリシー実装に向きます。
Android 固有の課題としては、ネイティブバイナリのABI(armeabi-v7a、arm64-v8a、x86 等)対応、実行パーミッションや SELinux ポリシー、バックグラウンド制限(Android 8 以降のフォアグラウンドサービス要件)、ストレージ権限の扱い、プロセス監視と自動再起動などが挙げられます。また、セキュリティ面では鍵や証明書の保護、設定ファイルの安全な保存、GPL-3.0 の開示義務に注意が必要です。CI/CD や GitHub Releases を使って複数プラットフォーム向けバイナリを配布する運用が一般的で、リポジトリにはリリース対応やライセンス情報が含まれています。
拡張性としては、ルーティングルールの UI 化、プロファイルのインポート/エクスポート、外部プロセスとの連携(例: DNS over HTTPS/DoT、外部プラグイン)の追加が考えられます。開発者はまずローカルで sing-box の最小構成を動作確認し、その後 Android 固有の起動・管理ロジックを実装する方針が安全です。
プロジェクトの構成
主要なファイルとディレクトリ:
- .github: dir(ワークフローや Issue/PR テンプレートが置かれる想定)
- .gitignore: file
- AUTHORS: file(寄稿者情報)
- LICENSE: file(GPL-3.0)
- README.md: file(プロジェクト概要、ダウンロード/使い方、ライセンス情報)
リポジトリ内には、リリース用のバイナリや設定テンプレート、ドキュメントが含まれていることが想定されます。具体的には:
- バイナリ/アセットディレクトリ(sing-box の実行ファイルや ABI 別バイナリ)
- 設定テンプレート(JSON サンプル、routing/DNS の例)
- スクリプト(起動/パーミッション付与/検証用のシェルや Gradle スクリプト)
- ドキュメント(README に加え使い方、ビルド手順、寄稿方法の説明)
また、GitHub Releases を用いた配布と、API レベル 21+ を示すバッジ、GPL-3.0 のバッジが README に記載されています。実運用では、各種 Android の制約(バイナリ署名、API 権限、バックグラウンド制限)に合わせた追加ドキュメントが重要です。
…他 15 ファイル
まとめ
sing-box を Android で使いたい開発者向けの実用的なラッパー。導入や拡張の土台が整っているリポジトリです。
リポジトリ情報:
- 名前: MikuBoxForAndroid
- 説明: MikuBox for Android / sing-box / universal proxy toolchain for Android
- スター数: 18
- 言語: null
- URL: https://github.com/HatsuneMikuUwU/MikuBoxForAndroid
- オーナー: HatsuneMikuUwU
- アバター: https://avatars.githubusercontent.com/u/146099520?v=4
READMEの抜粋:
MikuBox for Android
sing-box / universal proxy toolchain for Android.
一款使用 sing-box 的 Android 通用代理软件.