問題まとめ

本章では、一部のよくある問題とその解決方法・対処方法をまとめます。どのような場合でも、まずサービスやクライアントを最新バージョンにアップデートして解決を試みてください。それでも解決しない場合は、以下の案内に従って確認してください。

よくある問題

一部のアプリで画面レイアウトが正常に表示されず、操作可能な要素がまったく表示されない。

こちらのスクリプト user-home/modules/script/enhanced_automation_wechat.yaml をダウンロードし、デバイスの ~/modules/script ディレクトリに配置してください。

firerpa をインストールした後、他のアプリが正常に開けなくなった。

古いバージョンでは一部の環境でこの問題が発生する可能性があります。最新バージョンに切り替えてください。

サービスが正常に起動せず、エラーが avtab または unsupported policy database format を指している。

この状況は Android 16 で発生する場合がありますが、それ以前のバージョンでも可能性はあります。まず、必ず最新バージョンのサービスを使用していることを確認してください。それでも問題が発生する場合、使用している Root ソフトが KernelSU かどうかを確認してください。クラッシュは古いバージョンの ksu がシステムの SELinux policy image を破損させることが原因です。最新版の ksu をお試しください。それでもクラッシュする場合は、Magisk に切り替えるか、シェル権限を下げて実行してください。

サービス起動後、特定のアプリが開けなくなったり、クラッシュしたり、異常を検知されたりする。

一部のアプリが app-zygote を使って Frida を検出している可能性があります。10.0 未満のバージョンでは、properties.local に enhanced-stealth-mode=true を設定することでこの問題を回避できる場合があります(副作用として Frida の spawn 関連機能が使用できなくなります)。10.0 以降のバージョンではこの設定項目は削除されました。最新バージョンにアップグレードし、具体的な状況をご連絡ください。

パケットキャプチャ関連の機能に関する Q&A。

パケットキャプチャ機能が完璧かどうかという質問は必要ありません。FIRERPA がすべての手はずを整えており、キャプチャに必要なすべてのプロセスを完了しています。他のキャプチャソフトでキャプチャできない場合でも、FIRERPA なら必ずキャプチャできます。もし FIRERPA でキャプチャできなければ、同じロジックのどのソフトウェアでもキャプチャできません。証明書の信頼問題を心配する必要はありません。FIRERPA はキャプチャ時にアプリに対してシステムレベルのルート証明書を自動的にインストールするため、手動操作は不要です。QUIC の降格についても、startmitm が自動的に UDP プロトコルを無効化し、通常はアプリが UDP を使用できない場合に自動的に QUIC を使用しないよう降格します。これらすべて手動での介入は不要です。

キャプチャスクリプトを実行したが、データパケットがキャプチャできない。

考えられる原因:1 つはアプリ自体に証明書検証または証明書ピンニングの仕組みがあること、もう 1 つは事前・事後処理が正しく行われていないことです。証明書検証の仕組みがあるかどうかの確認方法:グローバルキャプチャを有効にし、ブラウザなど他のアプリを開いて正常にキャプチャできるか確認します。いくつかのネットワーク接続アプリで試して、あるアプリではキャプチャできて別のアプリではできない場合、キャプチャできないアプリはプライベートプロトコルか証明書検証の仕組みを採用している可能性が高く、通常 startmitm のログに Client TLS handshake failed などの情報が出力されますが、これ自体は重要ではありません。アプリに証明書検証が存在することが確認できた場合は、リバースエンジニアリングなど他の手段で動的に検証メカニズムをバイパスする必要があります。事前・事後処理が正しく行われていない場合:通常、システムファイアウォールを無効にしていないために、プロキシポートに携帯電話からアクセスできず、何も反応がないケースがあります。もう 1 つのケースは、キャプチャを開始する前にアプリが必要なネットワーク接続をすでに確立しており、キャプチャ開始後のトラフィックがそれらの既存の接続を経由して送信され、プロキシを通過しないことです。startmitm を起動した後、アプリを手動で完全に終了(強制停止)し、再度アプリを開いてください。

ワンクリックキャプチャを使用した後、携帯電話がネットワーク切断されたように見える。

まず、ファイアウォールが無効になっているか確認してください。次に、携帯電話のブラウザで Web サイトにアクセスしたときに、ワンクリックキャプチャスクリプトがログを出力するかどうかを確認します。No route to host のようなエラーが表示され、ブラウザのアクセス動作と一致する(アクセスのたびにスクリプトがそのエラーを出力する)場合、考えられる原因は、携帯電話が IPv6 ネットワークアクセスをサポートしており、デフォルトの DNS 解決も IPv6 を使用しているのに、スクリプトを実行している PC が IPv6 を有効にしていないかサポートしていないため、No route to host が発生していることです。お使いのブロードバンドが IPv6 をサポートしている場合は、PC のネットワーク設定で手動で有効にしてください。または、スクリプトのコマンドラインで --proxy-dns 114.114.114.114 を指定して試し、回復するかテストしてください。いずれの方法でも効果がない場合は、サポートまでお問い合わせください。

startmitm を使用したキャプチャで、No route to host と表示され、アプリがネットワークに接続できない。

この問題は上記と同様です。まず、他のいくつかのアプリで正常にキャプチャできるかテストし、サービスに問題がないか切り分けてください。正常にプロキシできる場合、この状況はデバイスが IPv6 をサポートしているが、startmitm を実行しているマシンに有効な IPv6 アドレスがないことが原因の可能性があります。ネットワークに利用可能なパブリック IPv6 がある場合は、PC に割り当ててください。もしくは、ルーター側で IPv6 を完全に無効にしてください。

キャプチャスクリプトに Client TLS handshake failed, does not trust the proxy's certificate と表示される。

対象アプリのデータパケットを正常にキャプチャできている場合は、この出力を気にする必要はありません。これはシステム内の他のアプリやアプリのサードパーティ SDK の証明書検証メカニズムによるログである可能性があります。

サービス起動後、一部の検出ソフトウェアが異常な特徴を検出した。

この問題が FIRERPA を起動した後に発生したことを確認してください。確認できた場合、最新バージョンにアップグレードしても異常な場合はご連絡ください。(enhanced-stealth-mode 設定は 10.0 以降削除されており、適用されません。)

自動起動 APK をインストールしたが、サービスが正常に起動せずアクセスできない。

自動起動 APK はシステムの設定によって制限を受けるため、システム起動時に自動で起動しない場合があります。起動後にアクセスできない場合は、アプリ内の 手動起動 ボタンをクリックして手動で起動し、1 分待ってから再度アクセスを試みてください。それでも起動できない場合は、手動インストールまたはモジュールインストール方法をお試しください。

Python インターフェースやキャプチャで Service Unavailable と表示される。

環境準備 の章の関連設定を完了していることを確認し、その後デバイスを複数回(約 3 回)再起動してみてください。