{"id":15040882,"url":"https://github.com/mlgmxyysd/xiaomi-hyperos-bootloader-bypass","last_synced_at":"2025-05-14T20:05:49.949Z","repository":{"id":208793340,"uuid":"721287807","full_name":"MlgmXyysd/Xiaomi-HyperOS-BootLoader-Bypass","owner":"MlgmXyysd","description":"A PoC that exploits a vulnerability to bypass the Xiaomi HyperOS community restrictions of BootLoader unlocked account bindings.","archived":false,"fork":false,"pushed_at":"2024-09-26T13:15:01.000Z","size":59,"stargazers_count":3546,"open_issues_count":118,"forks_count":374,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-04-11T10:00:47.464Z","etag":null,"topics":["android","android-development","bootloader","bootloader-unlock","hyperos","miui","xiaomi"],"latest_commit_sha":null,"homepage":"https://www.neko.ink/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MlgmXyysd.png","metadata":{"files":{"readme":"docs/README-ja.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"MlgmXyysd","custom":["https://paypal.me/MlgmXyysd","https://afdian.net/@MlgmXyysd"]}},"created_at":"2023-11-20T18:41:07.000Z","updated_at":"2025-04-11T05:38:53.000Z","dependencies_parsed_at":"2024-01-05T05:31:34.157Z","dependency_job_id":"af3010b5-89a2-4116-acae-826723c02f41","html_url":"https://github.com/MlgmXyysd/Xiaomi-HyperOS-BootLoader-Bypass","commit_stats":{"total_commits":24,"total_committers":4,"mean_commits":6.0,"dds":0.5416666666666667,"last_synced_commit":"0af1b9b6775f9280299356b9657c29ef567b3558"},"previous_names":["mlgmxyysd/xiaomi-hyperos-bootloader-bypass"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MlgmXyysd%2FXiaomi-HyperOS-BootLoader-Bypass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MlgmXyysd%2FXiaomi-HyperOS-BootLoader-Bypass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MlgmXyysd%2FXiaomi-HyperOS-BootLoader-Bypass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MlgmXyysd%2FXiaomi-HyperOS-BootLoader-Bypass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MlgmXyysd","download_url":"https://codeload.github.com/MlgmXyysd/Xiaomi-HyperOS-BootLoader-Bypass/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254219373,"owners_count":22034397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-development","bootloader","bootloader-unlock","hyperos","miui","xiaomi"],"created_at":"2024-09-24T20:45:13.910Z","updated_at":"2025-05-14T20:05:49.904Z","avatar_url":"https://github.com/MlgmXyysd.png","language":"PHP","funding_links":["https://patreon.com/MlgmXyysd","https://paypal.me/MlgmXyysd","https://afdian.net/@MlgmXyysd","https://www.patreon.com/MlgmXyysd"],"categories":[],"sub_categories":[],"readme":"# Xiaomi HyperOS BootLoader Bypass\n\n![Version: 1.0](https://img.shields.io/badge/Version-1.0-brightgreen?style=for-the-badge) [![English](https://img.shields.io/badge/English-brightgreen?style=for-the-badge)](README.md) [![中文文档](https://img.shields.io/badge/中文文档-brightgreen?style=for-the-badge)](README-zh.md)\n\n脆弱性を悪用し、コミュニティレベルのアカウントバインド制限をバイパスして、Xiaomi HyperOS の BootLoader のロックを解除できる PoC。\n\n\u003e [!NOTE]\n\u003e Pull reqeust で このプロジェクトの改善を提案できます :)\n\n## 💘 php-adb\n\nこのプロジェクトでは [php-adb](https://github.com/MlgmXyysd/php-adb) ライブラリを使用しています。\n\n## ☕ コーヒーを奢る\n\n✨ このプロジェクトが気に入ったら、以下の方法でコーヒーを奢ってください：\n\n - [AFDIAN](https://afdian.net/@MlgmXyysd)\n - [PayPal](https://paypal.me/MlgmXyysd)\n - [Patreon](https://www.patreon.com/MlgmXyysd)\n\n## ⚠️ 警告\n\nBootLoader のロックを解除した後、以下の問題が発生する可能性があります：\n\n- ソフトウェアの異常動作／ハードウェアの損傷\n- デバイスに保存されているデータの損失\n- クレジットカードの盗難、またはその他の経済的損失\n\n\u003e [!CAUTION]\n\u003e 上記のいずれかが発生した場合は、BootLoader のロックを解除する際に発生する可能性があるリスクであるため、すべての責任は自分で負う必要があります。  \nこれは明らかにすべてのリスクを保障するものではありません。**警告しましたからね**。\n\n- 保証適用外  \n  基本保証だけでなく、購入した追加の延長保証の一部 (Mi Care や画面破損の保証など) も、Xiaomi が提供する除外規定に従って失われる可能性があります。\n- TEE 関連の機能は永久に使用不可能です。  \n  Samsung Knox のようにハードウェア レベルで自己破壊するため、マザーボードを交換する以外に復旧方法はありません。\n- ソースコード非公開のカーネルが原因で、サードパーティ システムをフラッシュした後の機能異常\n- BootLoader のロックを解除すると、デバイスまたはアカウントが BAN されます。\n\n\u003e [!WARNING]\n\u003e 上記のいずれかが発生した場合は、運が悪いと思ってください。  \nXiaomi が BootLoader のロック解除を制限して以来、Xiaomi の「オタク」精神、さらには GPL にも違反しています。\n\u003e BootLoader のロック解除に対する Xiaomi の制限は無限であり、開発者としてそれに対してできることは何もありません。\n\n## 📲 アンロック要件\n\n- 対象デバイス：\n  - BAN されていない[^1] Xiaomi、Redmi、または POCO デバイス\n  - デバイスが HyperOS の公式バージョンを実行している\n  - (2023/11/23 に追記) デバイスは Xiaomi によってアカウントの資格確認を強制されない\n- 有効な SIM カード：\n  - SIM カードが使用できないタブレットを除く[^1]\n  - SIM カードのサービスが使用不能になっていない\n  - SIM カードはモバイルネットワークにアクセスできる\n  - 有効な SIM カード毎に、３か月以内に ２台のデバイスのロックを解除できます。\n- 有効な Xiaomi アカウント\n  - BAN されていない[^1] Xiaomi アカウント\n  - 各アカウントでロックを解除できるのは、１ヶ月で１台、１年で３台のみです。\n- 上記の [警告](#%EF%B8%8F-警告) を読み、理解したものとします。\n\n[^1]: Xiaomi が提供するロック解除手順によると、特定のアカウントとデバイスはロック解除ツールの使用を禁止されます。これは「リスク管理」と呼ばれています。\n\n## ⚙️ 使用方法\n1. [公式サイト](https://www.php.net/downloads) からシステムに PHP 8.0+ をダウンロードしてインストールします。\n2. `php.ini` で OpenSSL と Curl 拡張機能を有効にします。  \n  (スクリプトが機能しない場合は、`extension_dir` を PHP の `ext` ディレクトリに設定してください。)\n3. [php-adb](https://github.com/MlgmXyysd/php-adb) の `adb.php` をディレクトリに配置します。\n4. [platform-tools](https://developer.android.com/studio/releases/platform-tools?hl=ja#downloads) をダウンロードして`libraries` に展開します。\n  ※注意: Mac OS では、`adb` の名前を `adb-darwin` に変更する必要があります。\n5. ターミナルを開き、PHP インタープリターを使用して[スクリプト](../bypass.php)を実行します。\n\n- P.S. [Releases](https://github.com/MlgmXyysd/Xiaomi-HyperOS-BootLoader-Bypass/releases/latest) には、必要なファイルとクイック実行スクリプトが同梱されています。\n\n6. `設定`→`デバイス情報`→`MIUIバージョン`を７回以上連続でタッチして`開発者向けオプション`を有効にします。\n7. `設定`→`追加設定`→`開発者向けオプション`で、`OEMロック解除`、`USBデバッグ`、`USBデバッグ (セキュリティ設定)` を有効にします。\n8. **有効な**[^1] Xiaomi アカウントでログインします。\n9. デバイスを優先でPCに接続します。\n10. `このPCからのUSBデバイスを常に許可する` にチェックを入れてから `OK` を押します。\n\n- ※ 上記の[\"アンロック要件\"](#-アンロック要件)を確認して下さい。\n\n11. スクリプトの指示に従い待機します。\n12. バインドが成功したら、[公式のロック解除ツール](https://www.miui.com/unlock/index.html)を使用して、解除が可能になるまでの待機時間を確認できます。\n13. 待機時間中は、デバイスを通常どおり使用し、SIM カードを挿入したままにし、Xiaomi アカウントからログアウトしたり、`デバイスを探す`をオフにしたりせず、ロックが正常に解除されるまでデバイスを再バインドしないでください。  \n  デバイスは定期的に`HeartBeat`パケットをサーバーに自動的に送信します。\n\n## 📖 回避策\n\n- 準備中...\n\n## 🔖 FAQ\n\n- Q: ロック解除ツールが依然として 168/360 (またはそれ以上) 時間待つように要求するのはなぜですか？\n  - A: 原則として、この PoC は、Xiaomi が HyperOS に対して追加した追加の制限を回避するだけです。  \n    MIUI の制限に従う必要があります。\n\n- Q: デバイスに `Couldn't verify, wait a minute or two and try again` と表示される。\n  - A: これは正常であり、デバイス側のバインド要求はスクリプトによってブロックされます。  \n    実際のバインド結果は、スクリプトプロンプトの影響を受けます。\n\n- Q: エラーコード `401` でバインドに失敗しました。\n  - A: Xiaomi アカウントの認証情報の有効期限が切れているため、デバイスからログアウトして再度ログインする必要があります。\n\n- Q: エラーコード `20086` でバインドに失敗しました。\n  - A: デバイスの認証情報の有効期限が切れているため、デバイスを再起動する必要があります。\n\n- Q: エラーコード `20090` または `20091` でバインドに失敗しました。\n  - A: デバイスの `Security Device Credential Manager` 機能が破損しています。  \n    サポートについてはアフターサービスにお問い合わせください。\n\n- Q: エラーコード `30001` でバインドに失敗しました。\n  - A: デバイスは、Xiaomi によってアカウントの資格確認を強制されました。  \n    Xiaomi はずっと前に「オタク」の精神を失っており、それについて私たちにできることは何もありません。\n\n- Q: エラーコード `86015` でバインドに失敗しました。\n  - A: サーバーがバインド要求を拒否しました。もう一度試してください。\n\n## ⚖️ ライセンス\n\nライセンスがない場合、このプロジェクトの使用のみが許可されます。  \nこのソフトウェア（およびリンクなど）のすべての著作権を許可なく削除または変更することはできません。  \nこのプロジェクトのすべての権利は、[MeowCat Studio](https://github.com/MeowCat-Studio)、[Meow Mobile](https://github.com/Meow-Mobile)、[NekoYuzu](https://github.com/MlgmXyysd) に帰属します。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlgmxyysd%2Fxiaomi-hyperos-bootloader-bypass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlgmxyysd%2Fxiaomi-hyperos-bootloader-bypass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlgmxyysd%2Fxiaomi-hyperos-bootloader-bypass/lists"}