미꾸라지 앱 (Android 용)

Android 용 미꾸라지 앱에 관한 설명 문서입니다. 미꾸라지 앱은 구글 플레이 스토어에서 "Mudfish" 혹은 "미꾸라지" 검색으로 설치하실 수 있습니다.

소개

PC용 미꾸라지와 다른점

간혹 미꾸라지 앱과 PC용 미꾸라지를 혼동하는 분들이 계시는데요, 서로 간 차이를 요약한다면 다음과 같습니다.

  1. 미꾸라지 앱의 경우 기본적으로 "Full VPN 모드"로 작동됩니다. 만약 앱 별로 미꾸라지를 설정하고 싶다면, 설정 메뉴에 들어가서 앱 기반 기능을 활성화할 수 있습니다.

  2. PC용 미꾸라지 설정에 있는 "아이템" / "프로그램 설정" 등은 전혀 상호 작용하지 않습니다. 즉, 미꾸라지 앱 설정은 PC용 미꾸라지 설정과 완전히 별개로 동작합니다.

  3. 미꾸라지 요금제는 상호 공유됩니다. 만약 미꾸라지 계정의 요금제가 종량제 (트래픽당 과금) 일 경우, 사용하신 트래픽 만큼 크레딧이 차감되게 됩니다.

    만약 요금제가 정액제인 경우, 별도의 크레딧 차감은 없지만 속도 제한이 걸리게 됩니다.

  4. 미꾸라지 크레딧은 상호 공유됩니다. 미꾸라지 앱에서 결제한 크레딧은 다른 미꾸라지 서비스에서도 동일하게 사용하실 수 있습니다.

앱 플레이어에서 이용 방법

Android 용 미꾸라지 앱을 Bluestacks, Nox 와 같은 앱 플레이어에서 이용하고자 할 경우, Android API 21 용으로 컴파일된 미꾸라지 앱을 이용하셔야 합니다. 다음과 같이 설치하실 수 있습니다.

  1. https://mudfish.net/releases/ 에서 원하시는 APK 파일을 다운로드합니다. 예를 들어, net.mudfish.vpn-release-4.4.12-21.apk 와 같이 끝 이름이 -21 로 끝나는 것이 API 21 기준으로 컴파일된 APK 파일입니다.

  2. APK 설치를 하시려면 다운로드하신 파일을 Drag & Drop 으로 앱 플레이어에 놓으시면 설치가 진행되실 것입니다.

메뉴

첫화면

미꾸라지 앱 첫화면은 로그인 화면입니다. 오른쪽 상단에 (더하기) 아이콘을 클릭하여 회원 등록을 할 수 있으며, 기존에 ID 를 가지고 계신 분은 그대로 로그인 할 수 있습니다.

만약 로그인을 그대로 유지하고 싶으신 분의 경우, "Remember Me" 버튼을 활성화한 상태에서 로그인을 하시면 됩니다.

메인 화면

로그인을 한 후 보게 되는 화면입니다. 여러가지 기능에 대한 요약 정보가 보이게 되며, 각 항목을 누르게 되면, 세부 정보를 보여주게 됩니다. 현재 항목은 각각 다음과 같습니다.

  • 크레딧

    현재 계정에 연동된 크레딧을 보여줍니다. 해당 항목을 클릭 시, 크레딧 구매 메뉴로 넘어가게 됩니다.

  • 요금제

    현재 사용중인 요금제의 간략한 정보를 보여줍니다. 해당 항목을 누르면 요금제 변경 화면으로 넘어가게 됩니다.

  • 중계 서버

    현재 사용할 미꾸라지 중계 서버 정보를 보여줍니다. 해당 항목을 누르면, 중계 서버 변경을 위한 화면을 볼 수 있습니다.

  • 중계 서버 모드

    현재 미꾸라지 앱의 경우 다음의 중계 서버 모드를 지원합니다.

    1. 기본 모드

      기본 모드의 경우, 1 개의 미꾸라지 중계 서버를 거쳐 목적지에 도달하게 됩니다.

    2. Multi-Path 모드

      Multi-Path 모드의 경우 해당 목적지까지 2 ~ 3 개의 중계 서버를 경유하여 도달하게 됩니다.

      기본적으로 사용자가 설정한 중계 서버를 사용하며, 추가적으로 해당 목적지까지 도달하는데, 최적으로 판단되는 다른 중계 서버를 함께 사용하게 됩니다.

    3. Simple FEC 모드

      Simple FEC 모드는 로컬 ISP 에서 패킷 로스가 발생하는 사용자들을 위해 제작되었습니다.

      같은 패킷을 여러번 반복하여 전송하여, 중간에 패킷 로스가 발생되더라도 다른 패킷이 이를 보완하게 됩니다.

  • VPN 모드

    현재 VPN 모드를 화면에 표시합니다. 기본적으로 1) Full VPN 모드입니다. 만약 Per-app 기반으로 특정 앱만 미꾸라지 적용을 위해서는 설정 메뉴에서 지정 및 변경하실 수 있습니다.

    만약 Per-app 기반으로 설정된 상태라면 각 앱의 정보를 보여줄 수 있는 화면으로 이동하게 됩니다.

  • 트래픽

    현재 사용중인 트래픽의 양을 보여줍니다.

크레딧 구매

설정

미꾸라지 앱의 설정을 변경할 수 있는 메뉴로 현재 아래와 같은 메뉴가 있습니다.

  • 동작 모드

    • 앱 기반

      앱별로 트래픽을 중계 서버로 전송합니다.

    • Full VPN 기반

      전체 트래픽을 중계 서버로 전송합니다.

  • 앱 목록

    동작 모드가 "앱 기반"일 경우, 활성화게 되며, 적용하고자 하는 앱 목록을 선택하게 됩니다.

  • Reverse Per-App 기능

    기본적으로 Per-App 기능을 선택한 앱만 미꾸라지를 통해 전달되게 됩니다. 하지만 이 기능이 켜져 있을 경우, 선택한 앱만 미꾸라지를 통해 전달하지 않고, 나머지 다른 모든 앱들을 미꾸라지를 거치게 만듭니다.

  • 패킷 덤프

    • 패킷 덤프

    • 패킷 덤프 업로드

  • 일반

    • 연결 프로토콜

    • MTU 설정

      안드로이드 VPN 의 기본 MTU (Maximum Transmission Unit) 값을 변경하고자 할 경우 이용할 수 있는 메뉴입니다.

    • 다른 설정들

    • 문제점 보고서 보내기

  • 버전

    현재 미꾸라지 앱 버전을 보여줍니다.

  • 로그아웃

    • 자동 로그인을 해제하고 기존 설정 파일 및 cache 데이타를 모두 제거합니다.

에러 코드

이 섹션의 경우, 미꾸라지 안드로이드 앱을 사용하면서 나올 수 있는 에러 코드에 대해 각각 설명하고 해결책에 대해서 기술하고자 합니다.

만약 아래에 기술된 방법으로도 해당 이슈가 해결되지 않는다면 미꾸라지 포럼을 통해 질문 부탁드리겠습니다.

MUDEXP_00001

  • 방화벽 우회 기능이 현재 disable 되었습니다.

    이 메세지는 미꾸라지 웹사이트가 임시적으로 방화벽 우회 기능을 이용한 인증을 disable 했을 때 나타날 수 있습니다.

    보통 이 메세지가 보인다는 것은 미꾸라지가 DDoS 공격을 당하고 있음을 뜻하는데요, 이 경우, 네트워크 방화벽이 없는 네트워크 환경에서 다시 접속해 보시기 바랍니다.

  • Unsuccessful response

    이 메세지가 나왔다면, 로그인 과정 자체가 오류가 발생하였음을 뜻합니다. 미꾸라지 웹 서버의 응답이 성공적이지 못하였음을 뜻합니다.

MUDEXP_00023

Failed to get information: (num)

이 오류의 경우 미꾸라지 중앙 서버와의 인증이 제대로 이루어지지 않을 경우 발생될 수 있는 오류입니다. (num) 에 대한 번호에 따라서 이유가 달라지게 됩니다. 각 (num) 에 대한 이유는 아래와 같습니다.

  • -1

    이 오류의 경우, 미꾸라지 중앙 서버와의 TCP 연결 자체가 안되었음을 뜻합니다. 즉, 어떠한 이유로 연결 자체가 차단되어 생긴 이슈일 가능성이 높습니다.

    1. 우선 현재 사용하시는 환경내에 네트워크 방화벽이 존재하는지를 확인해 보시기 바랍니다.

    2. 5G / LTE 로 연결되어 있을 때 동일한 증상이 발생되는지 혹은 WIFI 에 연결되어 있을 때 동일한 증상이 발생되는지를 확인해 보시기 바랍니다.

    만약 이 방법 모두 제대로 동작하지 않는다면, 문제점 보고서 를 보내주시면 분석 후 해당 주제글에 답변을 드리도록 하겠습니다.

  • -2

    미꾸라지 중앙 서버까지 연결은 되었지만, 인증 정보를 보낸 후 해당 응답을 받을 수 없을 경우에 발생될 수 있습니다.

    보통 이 경우, 네트워크 상에 미꾸라지 중앙 서버와의 연결을 방해하는 네트워크 방화벽이 있는지 혹은 개인적으로 사용하는 방화벽 / 백신 프로그램 같은 것이 연결을 방해하는지 살펴보시기 바랍니다.

  • -3

    이 오류의 경우, ID/PWD 를 이용한 미꾸라지 인증이 제대로 이루어지지 않았음을 뜻합니다. 앱에서 로그 아웃을 하신 후 다시 로그인을 시도해 보시기 바랍니다. 로그 아웃 메뉴는 앱 설정 메뉴 밑에서 찾으실 수 있습니다.

  • -9

    이 오류의 경우, 짧은 시간내에 같은 ID 를 사용한 인증이 여러번 반복하여, 인증 데몬에서 blacklist 처리가 되었을 경우, 발생될 수 있습니다.

    이 오류 발생시, 미꾸라지 사용을 잠시 멈춘 후, 약 5 분후에 다시 접속을 시도해 보시기 바랍니다.

  • -11

    이 오류의 경우, 미꾸라지 로그인 정보를 어떠한 이유로 인해 Android 장치 내부에 저장할 수 없을 경우 발생될 수 있습니다.

    예를 들어, 저장 장치의 경로가 Read-only file system 일 경우, 이 오류가 발생될 수 있습니다.

    해당 이슈가 미꾸라지 앱을 완전히 삭제하신 후 다시 설치하셔도 동일한 증상이신지 확인해 보시기 바랍니다.

MUDEXP_00024

Failed to do auto-login: <errno>

이 오류의 경우, 자동 로그인에 실패했을 경우, 발생될 수 있는 이슈입니다. <errno> 값에 따라서 각각 원인이 다른데요, 각각 다음과 같은 이유입니다.

  • -1

    <errno> 값이 -1 일 경우, 미꾸라지 인증 서버 자체에 연결을 할 수 없는 경우에 나타날 수 있습니다. 네트워크 방화벽에 의해 혹은 안드로이드 자체의 방화벽 앱에 의해 혹은 다른 여러 인터넷 이슈로 인하여 인증 서버에 연결이 실패할 경우 나타납니다. 우선은 인터넷 연결 이슈가 있는지를 확인해 보시기 바랍니다.

    문제가 지속된다면 1:1 문의를 남기시기 바랍니다.

MUDEXP_00026

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

이 이슈의 경우, <sid> 에 해당되는 미꾸라지 중계 서버가 서비스 불가 상태일 경우 나타날 수 있는 오류입니다. 만약 사용자가 서비스 불가 미꾸라지 중계 서버를 사용중이었다면 이 오류를 만날 수 있습니다.

이 경우, 사용 중인 미꾸라지 중계 서버를 다른 것으로 변경하시면 문제가 해결되실 것입니다.

MUDEXP_00034

No mudfish credits available.

에러 메세지가 나타내는 것 처럼 미꾸라지 크레딧이 부족하기 때문에 발생되는 이슈입니다. https://mudfish.net/admin/credits/buy 링크에서 미꾸라지 크레딧을 구매하시기 바랍니다.

MUDEXP_00035

Can't use the mudfish node you picked.

이 오류의 경우, 미꾸라지 앱에서 설정한 중계 서버를 사용하고자 했으나, 어떠한 이유로 인해서 사용할 수 없을 경우 나올 수 있는 이슈입니다. 보통 다음과 같은 이유로 인해서 나옵니다.

  • 요금제로 정액제를 사용하고 있지만 장착하고 있는 유료 아이템이 없을 경우.

    이 경우, https://mudfish.net 에 로그인하셔서 유료 아이템 1 개 이상을 장착하셔야 해결이 됩니다.

  • 해당 중계 서버가 죽어 있는 경우. 앱을 로그아웃 하신 후 다시 로그인하시면 최신의 중계 서버 정보를 받아오게 됩니다.

MUDEXP_00137

Unexpected exception: <exception_msg>

이 오류의 경우, 로그인 과정에서 문제가 있을 경우, 발생될 수 있는 예외 사항입니다. 나올 수 있는 오류는 알려진 바로는 다음과 같습니다.

  • java.io.IOException

    연결 과정에서 입출력(In/Ouput) 관련 오류가 있음을 뜻합니다.

MUDEXP_00208

Failed to open .conf for writing at <path>: <errno> <errmsg>

이 오류의 경우, 미꾸라지 설정 파일을 핸드폰 내부의 저장 공간에 기록할 수 없을 때 발생될 수 있습니다. <path> 가 쓸려고 한 위치를 가르키며, <errno> <errmsg> 정보가 각각 정확한 오류 이유를 설명합니다.

현재까지 발생된 오류 메세지들로는 다음과 같은 것이 있습니다.

  • 30 Read-only file system

    만약 이 오류를 보게 된다면, 사용하고 계신 핸드폰의 모델명과 안드로이드 버전을 미꾸라지 포럼 혹은 1:1 문의로 남겨주시기 바랍니다.

    미꾸라지 앱이 쓰기가 불가능한 곳에 설정 파일을 기록할려고 하기 떄문에 발생된 것입니다.

    미꾸라지 앱을 완전히 종료하신 후 다시 시도를 하셔도 동일한 증상이 발생되는지 확인 부탁드립니다.

MUDEXP_00245

Unsuccessful response

이 이슈의 경우 보통 아래의 조건에서 발생될 수 있습니다.

  1. 네트워크 방화벽 테스트를 통과하지 못하여 이 오류가 발생되기 전에, 미꾸라지 앱의 방화벽 우회 기능이 켜져 있음을 뜻합니다.

  2. 방화벽 우회 모드가 켜져 있어, Cloudflare 의 CDN 망을 통해 우회 접속을 시도하였지만, Cloudflare 을 통한 접근이 어떠한 이유로 실패하였음을 뜻합니다.

만약 네트워크 방화벽 테스트가 잘못되었다고 판단이 된다면, 로그인 화면에서 해당 우회 기능을 Off 할 수 있으니 참고 바랍니다.

MUDEXP_00266

Failed to get a default SID... Something is wrong.

이 오류의 경우, 사용자가 선택한 미꾸라지 중계 서버의 Unique ID 을 내부적으로 찾을 수 없을 경우, 발생될 수 있습니다. 보통 다음과 같은 상황에서 발생될 수 있는데요,

  1. 사용자가 현재 죽어있는/작동하지 않는 미꾸라지 중계 서버를 선택하여 접속을 시도했을 경우. 이 경우라면, 다른 미꾸라지 중계 서버를 선택하여 시도를 해보시기 바랍니다.

  2. 사용자가 미꾸라지 중계 서버를 아직 선택하지 않은 상태에서 미꾸라지 연결을 시도했을 경우.

  3. 어떠한 이유로 미꾸라지 중앙 서버로 부터 미꾸라지 중계 서버의 정보를 받지 못하였을 경우.

    • 연결이 불안하여 이 이슈가 발생될 수도 있으며,

    • 혹은 방화벽에 의해 연결이 차단되어 발생되었을 수도 있습니다.

    이 문제가 발생되었다면, 우선 미꾸라지 앱을 완전히 종료하신 후, 다시 실행해 보시기 바랍니다.

MUDEXP_00292

Failed to do the auto-login (reason <reason_code>)

이 오류의 경우, 미꾸라지 앱이 자동 로그인을 시도하였으나, 미꾸라지 서버 측에서 오류를 반환하였을 경우 나올 수 있는 오류입니다. 자세한 이유는 <reason_code> 에서 확인이 됩니다.

  • 4

    이 오류 코드의 경우, 자동 로그인에 사용된 인증 토큰이 유효하지 않거나, 만료되었을 경우를 뜻합니다.

    로그인 화면에서 다시 ID/password 입력을 통해 재로그인하시기 바랍니다.

iOS 용 →