에러 코드

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

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

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_00121

Unexpected exception: <exception>: <reason>

네트워크 방화벽 테스트 항목에서, https://mudfish.net/api/reqheaders URL 로의 접속이 실패하였음을 뜻합니다. 즉, 어떠한 이유로 미꾸라지 홈페이지까지 연결이 제대로 동작하지 않음을 뜻합니다.

<exception> 세부 항목들은 아래의 MUDEXP_00127 섹션을 참고 바랍니다.

MUDEXP_00127

Unexpected exception: <exception>: <reason>

이 오류의 경우, 보통 자동 로그인이 어떠한 이유로 실패할 경우, 발생될 수 있는 이슈입니다. <exception> 가 해당 이슈가 발생된 원인을 가르킵니다.

• java.net.SocketTimeoutException

  만약 <reason> 에 Read timed out 이슈가 발생된다면, 미꾸라지 중앙 서버 혹은 웹 서버와의 통신에 timeout 이슈가 발생되었음을 뜻합니다.

우선은 인터넷 연결이 제대로 되어 있는지 확인하시고, 미꾸라지 연결에 방해가 될 수 있는 네트워크 방화벽이 있는지 확인해 보시기 바랍니다.

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_00251

talkc__recv() error: <errno> <errmsg>

이 오류의 경우, 미꾸라지 RTT 데몬과의 통신에 문제가 있음을 뜻합니다. <errno> 가 실제 오류 코드를 가르키며, 보통 아래와 같은 코드가 발생될 수 있습니다.

• 11 Try again

  이 코드의 경우, timeout 을 뜻합니다. 특정 시간 동안 미꾸라지 서버에서 data 가 전달되고 있지 않음을 보통 뜻합니다.

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 입력을 통해 재로그인하시기 바랍니다.

• 5

  이 오류 코드의 경우, 로그인 인증 서버에서 로그인 시도를 차단하였음을 뜻합니다. 이 오류가 발생될 경우, 잠깐 로그인 시도를 멈추시고, 약 1 분 이후에 다시 한번 더 시도를 해보시기 바랍니다.

MUDEXP_00401

Not enough information to calculate shortest pathes.

보통 이슈의 경우, RTT 추천 경로를 계산할 만한 충분한 미꾸라지 중계 서버와의 RTT 정보가 없기 때문에 발생될 수 있습니다. 아래의 부분을 우선 체크해 보시기 바랍니다.

• 현재 미꾸라지 크레딧을 가지고 있는지. 가끔 크레딧이 없을 경우, 중계 서버와의 RTT 테스트가 제대로 되지 않을 수 있습니다.