Mudfish App for Android

This section describes how to use the mudfish app for Android. You can install it by searching for "Mudfish" n the Play Store.

Introduction

Differences between Android and Desktop

Here's summary what's differences between mudfish app for iOS and mudfish vpn for desktop.

For mudfish app, it supports two mode; Full VPN mode and Per-app VPN mode. So you can pick whather apps you'd like to apply in the configuration menu.
At mudfish app, it doesn't apply "item configuration / program settings" which set from mudfish vpn for desktop. The configuration of mudfish app is completely separated.
Your data plan is shared. If your data plan is PPT (Pay Per Traffic), your credit usage will be charged how much you used.

However if your data plan is Subscription, no extra credit charges but the speed cap.
Mudfish credits are shared cross mudfish services. So you can use it at both mudfish apps and mudfish other services.

How to use at App Players

If you want to use mudfish app for Android at App Players such as Bluestacks, Nox, you should use mudfish app built for Android API 21. You can install it as follows:

Download API file at https://mudfish.net/releases/ link. The file ending with -21 (e.g. net.mudfish.vpn-release-4.4.12-21.apk) means it's for API 21.
To install APK file, please drag and drop the file into the app player.

MTU configuration

If you want to change default MTU (Maximum Transmission Unit), it can be used.
Packet Dump

This menu could be used to capture the packets. To perform the packet dump, you can do as follows:
1. Launch the mudfish app and login with your ID/PWD.
2. Visit 'Preferences' menu of mudfish app and clicks "Packet Dump" option.
3. Go back to the main screen and touch 'Connect' button after picking up a mudfish node you'd like to use.
4. Reproduce your problem or play the game.
5. Touch 'Disconnect' menu when you completed to reproduce the issue or when you think packets are enough collected.
6. Visit 'Preferences' menu and turn off 'Packet Dump'.
7. Touch 'Packet Dump Upload' option and upload it after explaining it briefly.

Release Notes

4.6.3 (2023-03-03)

Fixes a bug that on some devices, calling setrlimit() doesn't work.

4.6.2 (2023-03-02)

Fixed a launcher permission issue.

4.6.1 (2023-02-26)

Changed the minimum SDK version from 28 to 25.
Be more verbose when the app starts to log a edge case that chdir() doesn't work properly.
Logs the model and version information.

4.5.8 (2022-09-21)

Uses startForegroundService() method to trigger VPN connection.
Fixed one exception to crash the app crash.

4.5.7 (2022-09-09)

Support the configuration synchronization feature which saves and loads your mudfish app configuration into mudfish server.
Fixed some edge cases triggered by unexpected exceptions.
Adds a filtering option of mudfish nodes to support the case-insensitive or case-sensitive search.
Tags more error or warning messages.

4.5.5

Fixed some app crash issues at edge cases.
When the auto-login token is expired at beginning of the month, the app will be refreshed properly.
Adds 'Find username' and 'Find password' icons at the login screen.

4.5.4

Makes the VPN service in the foreground not to be killed by the system.
Fixes a crash while checking the credit dialog.
Fixed a crash when JNI calls aren't initialized yet.

4.5.3

Fixed a crash on the login screen.

4.5.2

Fixed a bug of EBADF error. It was trigged by wrong use of ParcelFileDescriptor class.
Includes the RTT test logs in the problem report.
Fixed a crash issue while setting the configuration.
Fixed a crash issue while signing up to show the progress bar.
Shows a message properly if the data plan hits the speed cap.

4.5.1

Implements the multi-path mode.

4.4.50

Requires ACCESS_NETWORK_STATE to check that it solves EPERM issue of the socket.
Code clean ups for ping checks. Now as default, it performs the RTT calculation to mudfish nodes.
Shows the recommended pathes for the per-app item if it's possible to show.
Some UI changes to show the data plan properly.
Saves the filtering pattern for the listing of mudfish nodes.
Fixed a crash issue if fd is larger than FD_SETSIZE.

4.4.46

Syncs the user configuration for android if you're using Per-App VPN.
Syncs the item configuration for Per-App VPN.
Fixed an exception issue crashing the app.
Added one more firewall check via HTTP request.

Error Codes

In this section, I'll describe each of the error codes that can come up using the Mudfish Android app and describe their solutions.

If the problem is not solved by the methods described below, please ask at the Mudfish Forum.

MUDEXP_00023

Failed to get information: (num)

This error can be caused by poor authentication with the mudfish authentication server. Depending on (num), its reason could be different. The reason for each (num) is as follows:

-2

This can occur if the connection to the Mudfish Authentication Server is established, but the response cannot be received after sending authentication information.

Usually, in this case, please check that there's a network firewall on your network that prevents you from connecting to the mudfish server, or if your personal firewall / antivirus program is blocking the connection.
-3

This number indicates that your ID/PWD isn't correct or found. Please try to sign out and sign in again. To sign up, you can find a menu at the app configuration.
-9

This number indicates that the authentication using the same ID was repeated several times within a short period of time so your connection was blacklisted by the authentication daemon.

When this error occurs, please stop using the mudfish for a while and try connecting again after about 5 minutes.

MUDEXP_00026

Failed to get the default gateway for DNS (sid <sid>)

This issue means there's a problem to communicate with mudfish RTT server. When this issue happens, other mudfish error codes already are logged to show the details.

Please check that there's a network firewall between your phone and mudfish master servers. As temporary workaronds,

Please terminate the mudfish app completely and restart the mudfish app.

MUDEXP_00034

No mudfish credits available.

This error message indicates one of the followings:

If your data plan is PPT (Pay-Per-Traffic), the issue is caused by lack of mudfish credits. Please purchase mudfish credits at https://mudfish.net/admin/credits/buy link.
If your data plan is SUB (Subscriptioin), normally you don't have buy the Subscription voucher. For details, please visit Policy change for Data Plan - 20210607 link.

MUDEXP_00035

Can't use the mudfish node you picked.

In the case of this error, if you try to use the mudfish node picked in the mudfish app, but for some reason it can not be used, it could happen. It usually comes out for the following reasons.

If you have a PPT(Pay Per Traffic) data plan but no paid items are equipped.

In this case, log in to https://mudfish.net and equip at least one paid item.
If the mudfish server is dead, this could happen. Then try to log out and log back in to the app to get the latest relay server information.

MUDEXP_00160

tun -> server: Got <exception>

This error points that it failed to send UDP packet due to <exception> error. It shows more details about why:

java.io.IOException: sendto failed
- EPERM (Operation not permitted)
  
  This error indicates that sendto(2) operatioin for UDP (this UDP is used by the mudfish communicateion between app and mudfish node) is blocked by some reason.
  
  Please check you're using a firewall app on your phone or there's OS-dependent configuration to block mudfish.

MUDFISH