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

Mudfishを使う

Mudfish VPNは大きく3つのプログラムで構成されています。 mudfish、mudflow と mudrun がそれですが、各プログラムの役割について少しお話しすると下記のようになります。

  • mudfish (Mudfish Core)

    Mudfishのコアプログラムです。 Routing Tableの変更やトラフィック処理、Mudfish中継サーバーとの通信などを担当します。 mudrunを使用できない場合は、コマンドプロンプトウィンドウから直接実行することもできます。

  • mudflow (Mudfish Flow Controller)

    Mudfishのトラフィックとルーティングテーブルを管理するプログラムです。 RTTチェックとRouting Path設定はこのプログラムを介して行われます。

  • mudrun (Mudfish Launcher)

    mudfish を実行させるためのヘルパーとして機能するプログラムです。コマンドプロンプトを使用すると、サーバーの選択とサービスの選択が容易ではないため、これを解決するためにHTMLベースのインターフェースを提供します。

アカウントの作成​

Mudfishを使用するには必ずユーザーIDが必要で、最初のホームページ画面(https://mudfish.net)で使用したいアカウントを作成してください。

実行する​

Windows​

Mudfish Launcherを実行する前に​

Mudfishプログラムが正しく動作するためには、TAP-Win32 Adapter v9インターフェースがDHCPサーバーからIPを受信するように設定されている必要があります。

Windows Vista/7/8/8.1/10 に基づいて、コントロールパネル → ネットワークと共有センター → アダプターの設定変更メニューにアクセスすると、TAP-Win32 Adapter v9 という名前のデバイスを見つけることができます。見つからない場合は、Mudfishのインストールに問題があることを意味します。

該当デバイスの属性で、インターネットプロトコルバージョン4(TCP/IPv4)の属性(R)を以下のように見てください。

以下の画面に示すように、IPとDNSサーバーのアドレスを自動的に受信するように設定しておく必要があります。

上記のように設定して確認して保存すると、Mudfish VPNの使用準備は完了です。

Mudfish Launcherを実行する​

Mudfish Launcherプログラムを実行するには、次のようにします。

  • 「スタート」→「すべてのプログラム」→「Mudfish Cloud VPN」→「Mudfish Launcher」を起動すると、ブラウザにログインウィンドウが表示されます。

    Windows Vista/7/8/8.1/10 ユーザーの場合、「Mudfish Launcher」実行時必ず 管理者権限で実行 メニューで実行します。 「Mudfish Launcher」アイコンを右クリックすると確認できます。

Windows Vista/7/8のための「mudfish launcher」の実行

を実行すると、「Mudfish Launcher」はIP 127.0.0.1の任意のポート(デフォルトでは http://127.0.0.1:8282) に TCP listening を行い、そのサービスに接続するようにデフォルトブラウザを浮かべます。

Mac OS X​

ガイド(INFO)

Mudfishを初めて実行すると、いくつかのシステムを構成する部分があります。 1つ目はNetworksエントリにMudfish VPNを設定し、2つ目はSystem ExtensionでMudfishをインストールすることです。

NetworksエントリにMudfish VPNを設定する

Mudfish VPN設定をmacOSにインストールするプロセスです。 Allowボタンを押して許可してください。

System ExtensionによるMudfishのインストール

初めてMudfishを実行すると、次の警告メッセージを確認できます。このメッセージは、MudfishがVPNを使用するように内部Packet Tunnelを構成するためにSystem Extension機能を使用するために発生します。

  • macOS Golden Gate 以降のバージョンの場合

    • 「システム設定→一般」メニューに入り、「ログイン項目と拡張プログラム」メニューに入ります。

    • 「拡張プログラム」セクションの下に表示されると、「カテゴリ別」タブが存在します。その部分をクリックした後、「ネットワーク拡張機能」メニューを探します。その後、「(i)」アイコンをクリックして「Mudfish Cloud VPN」を有効にします。

  • macOS Sequoia以降のバージョンの場合

    • 「システム設定→一般」メニューに入り、「ログイン項目と拡張プログラム」メニューに入ります。

    • 「拡張プログラム」セクションの下に表示されている場合は、「ネットワーク拡張プログラム」メニューを探します。その後、「(i)」アイコンをクリックして「Mudfish Cloud VPN」を有効にします。

      picture 1

  • macOS Sonoma以降のバージョンの場合

    'システム環境設定→個人情報保護およびセキュリティ'項目に入り、該当ブロックされたものを許可してください。

    picture 0

  • macOS 旧バージョンの場合

    この場合、「システム環境設定→セキュリティとプライバシー」項目に入り、該当ブロックされたものを許可してください。

    macOS Big Sur 以前のバージョンをお使いの方は、macOS のバグにより Mudfish System Extension 名が「Placeholder Developer」と表示される部分がありますのでご注意ください。

Mudfish Launcherプログラムをアプリケーションで選択して実行しますが、実行中にrootパスワードを尋ねられます。

正常にプログラムが実行されたら、右上に Menulet 形式のプログラムとして動作していることを確認できます。

「Open Dashboard」のようなメニューからダッシュボードにアクセスし、ログインと設定を続行できます。

ちなみに、Mudfish VPN実行ファイルは必ずroot権限で実行する必要がありますが、以下の必要があるためroot権限が必要です。

  • 内部的に現在のユーザーコンピュータと中継サーバー間のICMPプロトコルを利用してRTT(Round Trip Time)を計算する部分がありますが、ICMPプロトコルをMac OS X上で実装するにはraw socketの使用が必須ですが、root権限のみを使用できます。

  • ウィザードメニューを使用してIPアドレスを設定する場合は、使用しているオペレーティングシステムのルーティングテーブルを変更する必要があります。これもroot権限が必要です。

  • Mudfish の通信に使用する tap(4) デバイスへの IP アドレス割り当てには DHCP を使用します。この情報を取得する dhclient コマンドの実行には root 権限が必要です。

Linux​

Mudfish Launcherプログラムを実行するには、次のようにします。以下は、インストールバージョンがv4.5.0であると仮定して作成された例です。現在インストールされているバージョン情報に注意して使用してください。

$ sudo /opt/mudfish/4.5.0/bin/mudrun

mudrun (Mudfish Launcher) プログラムは必ず root 権限で実行する必要がありますが、以下の必要性により root 権限が必要です。

  • 内部的に現在のユーザーコンピュータと中継サーバー間のICMPプロトコルを利用してRTT(Round Trip Time)を計算する部分がありますが、ICMPプロトコルをLinux上で実装するにはraw socketの使用が必須ですが、root権限のみを使用できます。

  • ウィザードメニューを使用してIPアドレスを設定する場合は、使用しているオペレーティングシステムのルーティングテーブルを変更する必要があります。これもroot権限が必要です。

  • Mudfish の通信に使用する tap(4) デバイスへの IP アドレス割り当てには DHCP を使用します。この情報を取得する dhclient コマンドの実行には root 権限が必要です。

を実行すると、「Mudfish Launcher」はIP 127.0.0.1の任意のポート(たとえば、 http://127.0.0.1:8282) に TCP LISTENING を行います。便利なブラウザを表示して、対応するURLにアクセスしてください。

備考

もし mudrun バイナリがLinux上で正しく動作しない場合、 mudrun-headless バイナリでテストしてみてください。

このバイナリの場合、UI (GTK) 関連ライブラリを使用しないため、サーバー上で戻ることができるように構成されたファイルです。

ログイン​

"Mudfish Launcher"が正常に動作している場合は、ブラウザに次のように表示する必要があります。

Mudfish Launcherログイン画面

上記「アカウント作成」で作成したID/PASSWORDを入力してログインしてください。ログインが成功したら、次の画面が表示されます。

Mudfish Launcher ダッシュボード

これでMudfishを使用する準備が整いました。

停止する​

Windows​

Mudfishを実行した後にプログラムを終了したい場合は、システムトレイのMudfish Launcherアイコンを終了してください。

アイコンの上で右クリックするとメニューが表示されます。そこでExitを選択することでMudfishプロセスを終了できます。

Mac OS X​

Menuletアイコンをクリックしたときに出るExitメニューまたは Mudfish Cloud VPN プロセスをkillコマンドで殺すだけです。

Linux​

プロセスリストでmudrunをkillコマンドで殺すだけです。まだ正式な終了方法はありません。