メインコンテンツまでスキップ

Muddog トラブルシューティング

まず 接続 画面で、自分の VPN接続 と 自分のインターネット共有 のどちらに 問題があるかを確認してください。それぞれの 接続詳細、またはエラー通知の エラー詳細 に原因が表示されます。

症状確認する内容
サービスに接続できないサービスの状態とアクセス権
国の一覧が空、または接続に失敗する国と相手への接続
接続済みなのにIPが変わらない、または通信できないVPNの適用範囲とトラフィック
アプリの起動ボタンを押せない、または特定のアプリだけに適用されないアプリ別VPN
サービスが機能に対応していないというエラーアプリとサービスのバージョン
自分のインターネット共有だけが失敗する共有と記録の保存

サービスに接続できない​

アプリは、バックグラウンドサービスの状態を読み取り、画面に表示します。このメッセージは、 アプリから状態を確認できないという意味 であり、VPNや共有が確実にオフになっている という意味ではありません。

サービスが正常に戻ると、アプリは自動的に再接続します。以下で、お使いのOSに 合った状態と権限を確認してください。サービスを起動すると、インターネット共有も 同時に始まります。

Linux​

  1. インストール直後であれば、デスクトップからログアウトして再度ログインし、アプリを開きます。

  2. ターミナルでサービスの状態を確認します。

    systemctl status muddog-engine.service --no-pager

  3. サービスが停止していて、VPNと共有の利用を再開する場合は起動します。 起動と同時にインターネット共有も再開されます。

    sudo systemctl start muddog-engine.service

  4. サービスは実行中なのにアプリからアクセスできない場合は、アプリを使うアカウントの ターミナルで id -nG を実行し、muddog グループが含まれているか確認します。

管理者が別のアカウントでインストールしたためにグループに追加されていない場合は、 アプリを使う一般ユーザーとしてログインしたターミナル で次のコマンドを実行してください。 その後、デスクトップからログアウトして再度ログインする必要があります。

sudo usermod -aG muddog "$(id -un)"

代わりにアプリを管理者権限で実行することは避けてください。サービス自体が起動しない場合は、 次のコマンドで最近のエラーを確認できます。

sudo journalctl -u muddog-engine.service -n 100 --no-pager

Windows​

PowerShellでサービスの状態を確認します。

Get-Service -Name muddog-engine

サービスが停止している場合は、管理者権限で起動したPowerShell で起動します。

Start-Service -Name muddog-engine

サービスを無効に設定している場合は、自動起動を再び有効にする方法に 従ってください。サービスがない場合や必要なファイルが不足している場合は、最新のMSIで インストールまたは修復します。アプリは一般ユーザー権限で起動します。

macOS​

  1. macOS 13以降であることと、Muddog.app を /Applications にコピーしたことを確認します。
  2. 現在ログインしているアカウントがmacOSの管理者アカウントであることを確認します。
  3. Service → Enable Background Service でサービスの登録を要求します。
  4. Service → Background Service Settings… でMuddogのバックグラウンド実行を 許可します。許可後、アプリがサービスに再接続するまで待ちます。

ターミナルで、登録されたサービスの状態を確認することもできます。

sudo launchctl print system/net.3rocks.muddog.engine

DMG内や別のフォルダーからアプリを起動すると、サービスを登録できません。 既存のアプリを置き換えた後に問題が発生した場合は、macOSの更新手順に 従ってサービスを削除してから、アプリを起動し直してください。

上記の手順を行っても失敗が続く場合は、 問題の報告にサービスのエラー内容も記載してください。

国の一覧が空、または接続に失敗する​

  1. 通常のインターネット接続が利用できるか確認します。
  2. 接続先の国 → 一覧を更新 を押します。
  3. 選択した国が一覧から消えている場合は、自動選択 または別の国で接続します。
  4. 接続サーバーの設定を変更したことがある場合は、 詳細設定の既定値に戻して保存します。
  5. それでも失敗する場合は、接続詳細 を確認します。

P2P接続は、選択した国の参加者と双方のネットワーク状態に影響されます。国が表示されて いても、接続が保証されるわけではありません。利用可能な相手がいない場合は、 しばらくしてから再度試すか、別の国を選んでください。ファイアウォールやルーターの 通信制限が原因かどうかを確認するには、利用可能な別のインターネット回線でも比較できます。

最大10回は接続試行の上限です。相手が見つからなければ、それより前に終了することがあります。 すでに接続済みのVPNが切れた場合は、手動で再接続する必要があります。

接続済みなのにIPが変わらない、または通信できない​

  1. 接続 → 現在の接続の適用範囲 が、意図したモードになっているか確認します。 設定を保存しただけで再接続していない場合は、以前の範囲が引き続き適用されます。
  2. IP・アドレス範囲モードであれば、接続したい 宛先IP が一覧に含まれるか、除外されるかを 確認します。アドレス一覧にドメイン名を入力することはできません。
  3. アプリ別モードであれば、アプリを完全に終了してからMuddogで起動し直します。
  4. 確認したい接続がIPv6かどうかを確認します。IPv6はVPNを通りません。 Windowsのアプリ別モードでは、選択したアプリのIPv6通信を遮断します。
  5. 他のVPNやネットワーク管理ツールを併用している場合は、その接続を切断した状態でも 比較します。他のツールが設定した経路が優先されることがあります。

IP確認に使うブラウザーや確認ページがVPNの適用対象でなければ、通常の回線のIPが 表示されるのは正常です。DNSも、使用するモードとDNSサーバーのIPによっては通常の回線を使用します。

特定のウェブサイトの地域制限が続く場合は、別の国や別の接続相手でも確認してください。 Muddogは、そのサービスに接続できることや、特定の速度を保証するものではありません。

macOSでWi-Fiなど使用中の回線を変更した場合は、VPNを切断して再度接続してください。 IP包含モードで、他のプログラムが設定したホスト経路と競合するというエラーが表示された場合は、 そのプログラムの接続と、指定したIP・アドレス範囲を確認してください。

アプリ別VPNが適用されない​

  • macOSはアプリ別VPNに対応していません。インターネット全体またはIP・アドレス範囲の モードを使用してください。
  • VPNで起動 が無効になっている場合は、アプリ別モードで保存したか、そのモードで VPNに接続したか、起動するアプリを選択したかを確認します。
  • アプリの一覧が空の場合は、一覧を更新 または 実行ファイルを探す を使用します。
  • ブラウザーが既存のウィンドウを開くだけの場合は、バックグラウンドプロセスも終了してから起動します。
  • 別のサービスに起動を引き渡すアプリや、既存のインスタンスを再利用するアプリには対応していません。 インストール方法とアプリ別VPNの利用条件を確認してください。
  • Linuxでは、Snap・Flatpakアプリに対応していません。 systemdユーザーセッション、cgroup v2、nftablesに関するエラーの場合は、該当する環境を 確認し、エラー詳細 を問題の報告に含めてください。
  • Windowsでは、起動する .exe ファイルを選択する必要があります。VPNに再接続した後は、 プログラムを完全に終了し、Muddogで起動し直してください。
  • WindowsでWinDivertコンポーネントがない、または読み込めないというエラーが表示された場合は、 MSIで修復または再インストールします。失敗が続く場合は、エラー詳細 を報告してください。

アプリとサービスのバージョンが異なる​

アプリが要求した機能に対応していない旧バージョンのサービスに接続すると、エラーが 発生します。新しいパッケージでアプリとサービスを一緒に更新してください。 macOSでアプリ別VPNを利用できないのは、バージョンのエラーではなく、対応機能の違いによるものです。

更新後も同じエラーが残る場合は、お使いのOSに合った方法でサービスを再起動します。 再起動すると、使用中の自分のVPN接続と共有接続が切断されます。

Linuxでは、アプリを閉じて次のコマンドを実行し、アプリを開き直します。

sudo systemctl restart muddog-engine.service

Windowsでは、アプリを閉じ、管理者権限のPowerShellで次のコマンドを実行してから、アプリを開き直します。

Restart-Service -Name muddog-engine

macOSでは、Service → Remove Background Service and Quit を選択し、 /Applications 内の Muddog を再度起動して、必要なサービスの許可を完了します。

サービスを再起動した後は、VPNに再度接続する必要があります。エラーが続く場合は、 再起動を繰り返すよりも、アプリのバージョンとエラー詳細をまとめて報告してください。

インターネット共有だけが失敗する、または記録を読めない​

まず 自分のインターネット共有 → 接続詳細 を確認してください。記録の保存領域不足、 保存容量の上限超過、ファイルの書き込みエラーがあると、共有が停止します。 記録はローカルでの保管方法に従って保存されます。

ディスクの空き容量とサービスのログを確認してください。保管中の記録が必要な場合は、 エラーを消すためにむやみに削除せず、エラーメッセージを添えてサポートに問い合わせてください。

記録の検索だけが失敗する場合は、サービスへのアクセス権とバージョンを確認します。 日付ごとの記録が整理され、検索中に内容が変わった場合は、日付と条件を選び直して 検索 を押します。検索は成功したのに結果が空の場合は、UTCの日付、フィルター、 次の記録 を確認してください。