미꾸라지 앱 (iOS 용)

iPhone 용 미꾸라지 앱에 대한 사용법에 대한 문서입니다. 미꾸라지 앱은 앱스토어에서 "Mudfish" 로 검색하여 설치하실 수 있습니다.

미꾸라지 VPN (PC 용) 과 다른 점

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

  1. 미꾸라지 앱의 경우 무조건 "Full VPN 모드"로 작동됩니다. 현재 버전은 Per-App VPN 기능이 구현되지 않았으며, 핸드폰의 모든 트래픽을 미꾸라지 중계 서버를 통해 처리가 되도록 합니다.

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

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

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

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

첫화면

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

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

메인 화면

매우 단순한 형태이며, 현재 아래와 같은 메뉴가 있습니다.

  • 환영 메세지

    현재 사용자 ID 를 보여줍니다. 해당 메뉴 클릭시 다음과 같은 메뉴가 이용 가능합니다.

    • Account

      미꾸라지 계정 페이지로 이동을 합니다.

    • Problem Report

      문제점 보고서를 보내실 수 있습니다. 보통 문제점이 재현된 후 이 메뉴를 클릭한 후 전송해 주시면 됩니다.

    • Logout

      로그인되어 있는 상태를 리셋하여 로그 아웃합니다.

  • 미꾸라지 크레딧

    현재 미꾸라지 크레딧 잔액을 표시합니다. 해당 메뉴 클릭 시, 미꾸라지 크레딧을 InApp 결제를 통해 구매할 수 있는 메뉴로 이동합니다.

  • 중계 서버 목록

    현재 설정된 미꾸라지 중계 서버를 표시합니다. 만약 다른 중계 서버로 변경하고 싶다면 클릭하여 사용할 미꾸라지 중계 서버를 선택할 수 있습니다.

  • 노드 모드

    중계 서버 연결 방식을 선택하는 메뉴입니다. 아래와 같은 모드가 현재 지원 됩니다.

    • 기본 모드

      기본으로 선택되는 모드이며, 1 개의 미꾸라지 중계 서버를 사용하여 목적지에 도달하게 됩니다.

    • SimpleFEC 모드

      사용자의 핸드폰과 미꾸라지 중계 서버 사이에 packet loss 가 발생되고 있을 경우, 이를 극복하기 위한 모드입니다. 중복된 패킷을 여러개 발송하여, 중간에 있을 수 있는 packet loss 을 예방합니다.

      대신 크레딧 사용량이 최소 2 ~ 3 배정도 많을 수 있습니다.

    • 고급 모드

      미꾸라지 중계 서버 2 개를 묶어 목적지에 도달하고자 할 때 사용할 수 있는 모드입니다. 어떤 미꾸라지 중계 서버를 사용할 지 직접 선택할 수 있으며, 오른쪽 상단에 있는 메뉴를 통하여 추천 경로를 확인할 수 있습니다.

      라우팅 이슈로 인해서, 특정 구간을 회피하고자 할 때 사용될 수 있습니다.

  • 설정

    미꾸라지 중계 서버와의 연결 프로토콜을 지정할 수 있습니다. 다음과 같은 메뉴가 이용 가능합니다.

    • Connection Protocol

      현재 미꾸라지 앱의 경우 UDP 프로토콜만 지원을 합니다. 기본값은 UDP (Port 10008) 입니다.

    • MTU

      내부 통신에 사용할 MTU 크기를 지정합니다. 기본값은 1400 Bytes 입니다.

    • RTT check speed

      이 옵션의 경우, 사용자와 미꾸라지 중계 서버간의 RTT 체크 속도를 지정합니다. 만약 이 값이 1 이상의 값일 경우, 미꾸라지 중계 서버에 핑(ping) 정보가 표시되게 됩니다.

      0 부터 5 사이의 값을 지정할 수 있으며, 각각 아래와 같은 의미가 있습니다.

      • 0

        이 값일 경우, RTT 속도 측정을 수행하지 않습니다. 이 값이 기본값입니다.

      • 1

        이 값은 RTT 속도 측정이 가장 느린 경우입니다. 간혹 특정 네트워크 환경에서는 공격적인 RTT 속도 측정이 집 공유기를 먹통으로 만드는 경우가 보고되었는데요, 해당 이슈가 있을 경우 이 값을 사용할 수 있습니다.

      • 5

        가장 빠른 RTT 속도 측정 기능입니다.

  • 연결하기

    현재 VPN 연결 상태를 가리키며, 만약 클릭 시 "연결하기" 혹은 "연결끊기" 기능이 됩니다.

자주 묻는 질문 (FAQ)

로그인시 인증이 필요하다고 하는데, 인증해도 여전히 로그인이 안됩니다.

홈페이지에서 로그인 인증을 진행하실 때, 가장 중요한 것은 미꾸라지 로그인을 시도하신 Public IP 와 인증 시도시 사용한 Public IP 가 같아야 한다는 것입니다. 아래와 같이 시도를 하셔도 동일하신지 확인해 보시기 바랍니다.

  • 아이폰 사파리에서 비공개 릴레이 켜져 있다면, 해당 기능을 Off 하신 후 시도해 보시기 바랍니다. 보통 이 기능의 경우, 중간 Proxy 를 거치기 때문에, 실제 Public IP 가 변경될 수 있습니다.

  • 기존 사용하시는 브라우저 외에 다른 브라우저에서도 시도를 해보시기 바랍니다.

오류 코드

이 섹션에서는 미꾸라지 iOS 앱에서 발생될 수 있는 오류 코드에 대해 설명하고 그에 대한 해결책이 있을 경우 제시합니다.

혹시나 해당 오류 코드 해결이 제대로 되지 않는다면 미꾸라지 포럼 https://forums.mudfish.net 에 문의를 주시기 바랍니다.

MUDEXP_00001

Got a nil response from the provider

이 오류가 발생된다면, 보통 이는 미꾸라지 앱의 packet tunnel 이 제대로 설치가 되지 않았음을 뜻합니다. 해결책으로는

  1. 기존 미꾸라지 앱을 완전히 삭제합니다.

  2. 그리고 AppStore 에서 미꾸라지 앱을 재설치합니다.

  3. 앱을 실행하신 후 로그인을 하시고, "Add VPN configuration" 을 하여 미꾸라지 VPN 설정을 추가하신 후 다시 한번 더 시도해 보시기 바랍니다.

MUDEXP_00042

bad authentication <errno>

이 오류의 경우 iPhone/iPad 에서 미꾸라지 인증 서버와의 통신에 문제가 있음을 뜻합니다. <errno>에 따라서 오류의 이유가 다르니 아래를 참고 바랍니다.

  • -3

    이 숫자의 경우 ID / PWD 가 잘못되었음을 뜻합니다. 우선 입력하신 ID / PWD 를 다시 한번 더 체크해 보시고, 여전히 이슈가 해결이 안된다면

    • 미꾸라지 앱을 앱 닫기를 하신 후, 다시 로그인을 하셔도 동일한 증상인지 확인해 보시기 바랍니다.

    • 미꾸라지 앱에서 Logout 을 하신 후 다시 한번 더 로그인을 시도해 보시기 바랍니다.

MUDEXP_00043

not enough credits

이 오류 메세지의 경우, 현재 사용자의 계정에 앱 작동을 위한 충분한 크레딧 혹은 조건이 맞지 않기 때문입니다. 만약 크레딧 충전을 원하신다면 http://mudfish.net/admin/credits/buy 링크를 방문 바랍니다.

만약 요금제가 종량제가 아닌 정액제이고, 크레딧이 있는데도 불구하고 동작을 하지 않는다면, 정액제 이용권 (Subscription Voucher)을 장착하고 계신지를 살펴보시기 바랍니다.

MUDEXP_00050

Server error!

이 오류 메세지의 경우, 로그인 과정에서 미꾸라지 서버 혹은 방화벽 우회를 위해 사용되는 Cloudfalre CDN 서버에서 HTTP 오류 코드를 반환하였을 때 나올 수 있는 메세지입니다.

우선 방화벽 우회 모드가 활성화되어 있는지 확인해 보시고 만약 우회 기능이 활성화되어 있다면 해당 기능을 Off 하신 후 다시 시도해 보시기 바랍니다.

MUDEXP_00077

error response for auth (reason <errno>)

이 오류의 경우, 어떠한 이유로 미꾸라지 인증 서버를 통한 인증에서 이슈가 있을 경우 발생될 수 있습니다. <errno>를 살펴보아 정확한 원인을 알 수 있습니다. 각각에 대한 오류 번호 내용은 다음과 같습니다.

  • 4 (Wrong Token)

    만약 이 오류 번호일 경우, "자동 로그인" 의 만료와 관련이 있습니다. 보통 "자동 로그인"이 리셋되는 월초에 발생되며, 다음과 같이 해결하실 수 있습니다.

    1. 미꾸라지 앱을 완전히 삭제하신 후 다시 설치를 하시거나,

    2. 혹은 메인 화면에서 "환영 메세지"를 클릭하면, "로그 아웃" 메뉴가 있습니다. 로그 아웃을 하신 후 다시 로그인을 하시면 문제 해결이 되실 것입니다.

← Android 용