How To Set Up Mudfish

Installation¶

Mudfish is an application which could be used to avoid the network congestion past changing the concrete routing path through Mudfish VPN servers.

Download¶

The latest package found at the download section of http://mudfish.net . The packages for 32 fleck and 64 chip machines are available.

For Windows¶

Install and Uninstall¶

Install¶

The first screen of Mudfish installer is the component menu.

At that place are two components and each item installs equally follows:

• Mudfish - Core Binaries

  Cadre files. Three programs are contained that Mudfish Cadre, Mudfish Period Controller and Mudfish Launcher.

• TAP-Win32 Adapter v9

  Miniport adapter working with cadre programs. tap0901 driver distributed by OpenVPN applied science Inc. will be installed.

Side by side step is an installation folder choice. In this certificate we presume that you install the program at C:\Program Files\Mudfish Cloud VPN ( C:\Program Files (x86)\Mudfish Cloud VPN for 64-bit machine).

After selecting the install folder and so click 'Install' button.

If this's your first installation for Mudfish, you could encounter the following warning messages to install TAP-Win32 Adapter v9. This network commuter must be installed.

If you're a Windows vii user, the following dialog box could come up upwards.

Keeps going to install.

Uninstall¶

With Windows Explorer, please move to C:\Program Files\Mudfish Cloud VPN folder ( C:\Program Files (x86)\Mudfish Cloud VPN in 64-flake machine). Simply run uninstall.exe file.

It volition uninstall all files and directory including TAP-Win32 Adapter v9 driver.

How to use¶

Mudfish consists of three programs that Mudfish Core (mudfish.exe), Mudfish Flow Controller (mudflow.exe) and Mudfish Launcher (mudrun.exe). Each program'south roles are every bit follows:

• Mudfish Cadre (mudfish.exe)

  Core programme to handle the routing tabular array, RX/TX packets and the communication between Chief server. Command line options are besides available to launch information technology at Windows console.

• Mudfish Flow Controller (mudflow.exe)

  Flow controller to manage the routing table and RTT measurement.

• Mudfish Launcher (mudrun.exe)

  Web UI based on the reverse proxy.

Launch information technology!¶

Let'due south launch Mudfish Launcher.

• Opens "Mudfish Launcher" from "All Programs" -> Mudfish". If you're a Windows Vista/seven/8 user it should run as adminirator privileges by right-clicking on "Mudfish Launcher" icon, and selecting "Run every bit ambassador".

If information technology works with problems, your default browser'll be opened and move to http://127.0.0.1:8282

Port number could be vary that 1 of random number (1024 - 65535) if port 8282 is in apply.

Sign in¶

If Mudfish Launcher is working correctly, your default browser'll be launched then automatically visit the Web UI equally follows:

How to use Mudfish Launcher¶

The following screen volition be shown when the sign-in process was expert.

Now information technology's prepare to use all Mudfish nodes.

Stop Mudfish¶

Clicks the exit menu of Mudfish'southward organization tray icon if you want to finish. If information technology's not existed properly, the following processes should be killed past Task Manager:

• mudfish.exe
• mudflow.exe
• mudrun.exe

For Mac Bone X¶

Install tap(iv) driver¶

Mac OS X does non accept tap(4) driver as default and then nosotros demand to install tap(4) driver to employ Mudfish first. For Mac OS X, it'southward bachelor at http://tuntaposx.sourceforge.net/

Download the latest package file.

Unzip the file then you can run across the package.

Install it.

During installing tap(4) driver, it requires root permission because information technology's kernel module.

Done to install.

If you're familiar to use Terminal, you could check status of tap/tun kernel module using kextstat command.

mac:~ weongyo$                kextstat   ...   111    0 0xffffff7f81dd2000 0x7000     0x7000     foo.tap                (1.0)                <7 5 4 one>   112    0 0xffffff7f81dd9000 0x8000     0x8000     foo.tun                (1.0)                <7 5 iv 1>   ...              

These kernel modules will be automatically reloaded whenever Mac Os X booted.

Install and Uninstall¶

Install¶

We presume that yous downloaded a Mudfish package from the download folio and the file extension of package is ".dmg". With double-clicking the file, it'll be mounted on the OS and prove the folder. You can install the Mudfish by copying the icon into Applications folder.

Similar other applications, the drag-and-drop into Applications folder is all to install

Alert

Delight note that just clicking the Mudfish icon on .dmg prototype would non piece of work. It's required to install information technology into the Applications to run.

Uninstall¶

Like other applications, moving the application icon into Trash is all. However if you'd like to remove manually, the below control could exist used to remove all files.

                  $                  sudo rm -rf /Applications/Mudfish\                  Cloud\                  VPN.app/                

How to employ¶

Mudfish consists of three programs that Mudfish Core (mudfish), Mudfish Period Controller (mudflow) and Mudfish Launcher (mudrun). Each programme's roles are equally follows:

• Mudfish Core (mudfish)

  Core program to handle the routing tabular array, RX/TX packets and the advice between Master server. Command line options are available to launch information technology at console.

• Mudfish Flow Controller (mudflow)

  Flow controller to manage the routing table and RTT measurement.

• Mudfish Launcher (mudrun)

  Web UI based on the reverse proxy.

Launch it!¶

Alert

Equally some security reasons, running the Mudfish could be blocked with the following window:

Then you should manually add together the awarding at the exceptional list which is available at 'System Preferences -> Security & Privary' menu.

When it's launched, information technology'll inquire your root'south password.

If it works successfully, the icon volition exist shown on the meridian-right as follow.

Please note that Mudfish requires root permission to launch considering

• It needs to use raw-socket interface for calculating RTT (Round Trip Time) with ICMP protocol.
• It needs to modify the arrangement routing table for redirecting the specific traffic.
• It needs to launch dhclient(8) for fetching IP address.

When information technology'due south launched, it opens a listening address at 127.0.0.ane:8282 accessable with spider web broswer using http://127.0.0.one:8282

Sign in¶

If Mudfish Launcher is working correctly, your default browser'll be launched when you click 'Open up Dashboard' menu on the Mudfish menulet icon as follows:

How to use Mudfish Launcher¶

The following screen will be shown when the sign-in process was good.

Now it's set up to use all Mudfish nodes

Stop Mudfish¶

At the Mudfish menulet icon, the exit bill of fare is bachelor to end. If y'all'd like to kill all Mudfish processes, the following is processes used by Mudfish application.

• mudfish
• mudflow
• mudrun

For Linux¶

Install and Uninstall¶

Install¶

We assume that that y'all downloaded a Mudfish package from the download page and its file extension is .sh .

                  $                  wget http://static.loxch.com/releases/mudfish-4.3.8-linux-x86_64.sh                  $                  sudo sh mudfish-4.3.viii-linux-x86_64.sh Verifying archive integrity... All good. Uncompressing Mudfish v4.3.8...... Installation is                  done                  under /opt/mudfish/4.3.8.                  $                  ls -l /opt/mudfish/4.three.8/bin/                

At linux pacakge, at that place are three executable binary files and the installation path would be always /opt/mudfish/$(VERSION)/bin/ . Please annotation that $(VERSION) is vary depending on what version you're installed.

Uninstall¶

The below command could be used to remove Mudfish package.

                  $                  sudo rm -rf /opt/mudfish/iv.iii.8/                

How to employ¶

Mudfish consists of iii programs that Mudfish Cadre (mudfish), Mudfish Period Controller (mudflow) and Mudfish Launcher (mudrun). Each plan's roles are as follows:

• Mudfish Cadre (mudfish)

  Cadre program to handle the routing tabular array, RX/TX packets and the communication between Master server. Command line options are available to launch it at panel.

• Mudfish Flow Controller (mudflow)

  Flow controller to manage the routing table and RTT measurement.

• Mudfish Launcher (mudrun)

  Web UI based on the contrary proxy.

Launch information technology!¶

Let's launch Mudfish Launcher. The version could vary depending on your package.

                  $                  sudo /opt/mudfish/4.iii.8/bin/mudrun                

Mudfish requires root permission to launch because

• It needs to use raw-socket interface for calculating RTT (Round Trip Time) with ICMP protocol.
• It needs to modify the arrangement routing table for redirecting the specific traffic.
• It needs to launch dhclient(eight) for fetching IP address.

When it's launched, it opens a listening address at 127.0.0.1:8282 accessable with web broswer using http://127.0.0.1:8282

Sign in¶

On Linux arrangement you should manually open the browser and access to Mudfish UI which is normally bachelor at http://127.0.0.ane:8282

How to use Mudfish Launcher¶

The following screen will be shown when the sign-in process was good.

At present it's ready to utilise all Mudfish nodes.

Stop Mudfish¶

Terminates mudrun process with Ctrl-C if you're running equally foreground process or impale(ane) it.

Source: https://mudfish.net/docs/en_install.html

Share this post