에러 코드

이 섹션에서는 미꾸라지 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>에 따라서 오류의 이유가 다르니 아래를 참고 바랍니다.

• -1

  이 숫자의 경우 사용자 인증을 담당하는 서버 데몬과 연결을 할 수 없음을 뜻합니다. 네트워크 환경에 따라서 이 오류가 발생될 수 있으며, 일반적으로 네트워크 환경이 좋지 않은 경우에 발생될 수 있습니다.

  이 이슈가 발생되면, 선행되는 오류 코드가 존재할 수 있습니다. 예를 들어서 다음과 같은 오류가 발생될 수 있으며, 각각의 오류 코드에 대한 자세한 내용은 해당 오류 섹션을 참고 바랍니다.

  • MUDEXP_00074
  • MUDEXP_00097
  • MUDEXP_00098

• -3

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

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

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

• -9

  이 이슈의 경우, 짧은 시간 내에 너무 많은 인증 시도가 있었음을 뜻하며, 그로 인해 일시적으로 인증이 차단되었음을 뜻합니다. 이 경우, 최소 3 ~ 5분 정도는 인증 시도를 멈추고 기다리는 것이 좋습니다. 일반적으로 몇 분 후에 해결되나, 만약 계속 이슈가 발생된다면 미꾸라지 포럼에 문의를 주시기 바랍니다.

MUDEXP_00043

not enough credits

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

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

MUDEXP_00050

Server error!

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

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

MUDEXP_00074

authc_open() failed.

미꾸라지 인증 서버에 연결을 어떠한 이유로 할 수 없을 때 발생될 수 있는 이슈입니다. 자세한 이유에 대해서는 로그 파일의 다른 부분을 살펴봐야 합니다. 보통 선행되는 에러 코드가 존재하게 됩니다.

MUDEXP_00077

error response for auth (reason <errno>)

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

• 4 (Wrong Token)

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

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

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

• 5 (Not Activated)

  계정이 일시적으로 비활성화되었을 경우 발생될 수 있는 오류입니다. 보통 짧은 시간내에 너무 많은 인증 시도가 있었을 경우 발생될 수 있습니다.

MUDEXP_00097

VSS_open(<ip>:<port>) failed: <err_code> <err_msg> <errno>. Try next.

이 오류의 경우, 미꾸라지 중앙 서버 (인증 서버)와의 연결이 제대로 동작하지 않을 때 발생될 수 있습니다.

보통 어떤 이유로 연결이 차단되었거나, 인터넷에 문제가 있거나, 핸드폰 자체의 네트웍이 제대로 구성되어 있지 않을 경우 발생될 수 있습니다.

<err_code> 와 <err_msg> 가 좀 더 자세한 이유를 알려주며, 다음과 같은 오류가 나올 수 있습니다.

• 4 CONNECT_ERROR

  connect(2) 자체가 이루어지지 않음을 뜻합니다. <errno> 코드가 정확한 이유를 알려줍니다. 다음과 같은 오류가 발생될 수 있습니다.

  • 64 EHOSTDOWN

    도달할 수 없는 호스트에 소켓 작업을 시도했습니다.

  • 65 EHOSTUNREACH

    호스트에 갈 수 없는 네트웍 경로가 설정되었거나, DNS 서버 응답에 문제가 있을 때 발생될 수 있습니다.

다음과 같은 부분을 확인해 보시기 바랍니다.

• 미꾸라지 VPN 이 완전히 꺼져 있는지.
• 다른 VPN를 사용한다면 해당 부분도 완전히 꺼져 있는지.
• 그 상태에서 인터넷 연결은 문제없이 동작하는지.

MUDEXP_00098

VSS_open(<ip>:<port>) failed: <err_code> <err_msg> <errno>.

이 오류는 위의 MUDEXP_00097 에러 코드와 거의 동일한 오류입니다. 각각에 대한 자세한 내용은 위의 오류 코드를 참고 바랍니다.

MUDEXP_00135

Failed to get the private IP for the staticnode.

이 오류의 경우, VPN 연결을 시도하였으나 연결을 시도하는 과정에서 오류가 발생했을 때 발생합니다. 보통 미꾸라지 앱을 통해서 연결을 하지 않고, iOS 설정에서 직접 연결을 시도하거나, iOS 미꾸라지 위젯에서 연결을 시도할 때 발생될 수 있습니다.

미꾸라지 앱을 열고, 로그인을 한 후 연결하기를 시도해 보시기 바랍니다.