Chrome 확장 기능

구글 Chrome 브라우저의 확장 기능으로 미꾸라지를 사용할 수 있습니다.

설치하기

https://mudfish.net/download 에서 Chrome 확장 기능 링크를 따라 설치하실 수 있습니다.

메뉴 소개

보통 미꾸라지 Chrome 확장 기능이 설치되게 되면 툴바에 미꾸라지 아이콘이 보이게 됩니다. 미꾸라지 아이콘 클릭 시 나오는 메뉴에 대한 설명을 드리면 아래와 같습니다.

중계 서버 목록

사용하실 수 있는 미꾸라지 중계 서버 목록을 나타냅니다.
(시계 모양) 아이콘

최근 사용한 미꾸라지 중계 서버 목록을 보여줍니다.
(톱니 바퀴) 아이콘

Chrome 확장 기능의 설정 메뉴를 확인할 수 있습니다. 현재 이용 가능한 옵션은 아래와 같은 것이 있습니다.
- 일반
  - 자동 로그인
    - 계정 기억하기!
      
      매번 중계 서버를 변경할 때 마다 물어보는 사용자이름 / 암호를 자동으로 입력하도록 하는 메뉴입니다.
  - 기능
    - 중계 서버 변경시 IP 체크 시도
      
      중계 서버가 변경될 때 마다 https://myip.mudfish.net 사이트에 방문하여 자신의 public IP 가 제대로 변경되었는지 확인하는 기능입니다.
    - 미꾸라지가 켜고 꺼질 때, 현재 탭을 갱신하기.
      
      말 그대로 미꾸라지가 켜고 꺼질 때, 현재 active 탭을 refresh 합니다.
  - 연결
    - 암호화 연결 사용
      
      중계 서버와의 연결 시 HTTPS 암호화 프로토콜을 사용합니다. 네트워크 방화벽의 감시를 우회할 때 사용할 수 있습니다.
    - HTTPS 연결을 위해 미꾸라지 root CA 사용하기
      
      HTTPS 연결은 미꾸라지 중계 서버에 의해 복호화된 후, 미꾸라지 root CA 를 이용해 다시 암호화되어 전달됩니다.
      알아주세요
      이 기능이 제대로 동작하기 위해서는 반드시 브라우저에 미꾸라지 root CA 인증서를 설치해야 합니다. 해당 인증서는 아래의 링크에서 찾으실 수 있습니다.
      
      https://mudfish.net/releases/certficates/mudfish-root-ca.crt
      
      자세한 설치 방법은 미꾸라지 root CA 인증서 설치하기 문서를 참고 바랍니다.
- 고급
  - PAC
    
    Proxy Auto Config (PAC) 문법을 이용하여 브라우저가 어떤 URL 들에 대해 미꾸라지 중계 서버를 적용할 지 설정할 수 있습니다.
    
    만약 PAC 문법에 대한 예제를 찾으신다면 아래의 글을 살펴보시기 바랍니다.
    - 해외에서 한국 스트리밍 제한 우회하기
- 도메인 덤프
  
  이 옵션은 브라우저가 방문하는 URL 에 대한 도메인 정보를 수집하는데 사용합니다.

설정은 변경시 자동으로 저장이 됩니다.

기능

중계 서버 접속하기

미꾸라지 아이콘 클릭 시 나오는 메뉴에서 접속하고자 하는 중계 서버를 클릭하시면 됩니다. 접속 시도 시 Proxy 인증을 거치게 되며, 사용하고 계신 미꾸라지 ID / 암호를 입력하시면 됩니다.

중계 서버 접속 끊기

"Disconnect" 메뉴를 클릭하시면 끊어집니다.

디버깅

어떠한 이유로 미꾸라지 크롬 확장 기능이 제대로 동작하지 않을 경우 아래와 같이 이유를 확인하실 수 있습니다.

크롬을 실행하면, 오른쪽 상단에 … (점점점) 아이콘을 누릅니다.
"도구 더보기" → "확장 프로그램" 메뉴로 이동합니다.
해당 메뉴에는 설치된 확장 프로그램들이 보이는데요, 거기서 "미꾸라지 - HTTP 프록시"을 찾습니다.
해당 부분에서 "백그라운드 페이지"를 클릭합니다. 그러면 새로운 창이 열리는데요, 거기에 “Console” 탭에 어떠한 오류가 경고 메세지 등등이 있는지 확인 부탁드립니다.

만약 해당 부분에 특정 오류가 있을 경우 https://forums.mudfish.net 에 보고해 주시면 대단히 감사하겠습니다.

FAQ (자주 묻는 질문)

확장 기능이 동작하지 않습니다.

보통 이 이슈가 발생되면, 체크해야 할 부분이 4 가지가 있는데요, 다음의 사항을 체크해 보시기 바랍니다.

미꾸라지 크레딧이 있는지를 확인해 주시기 바랍니다. 만약 요금제가 종량제라면, 잔여 크레딧이 0 이상이어야 하며, 요금제가 정액제라면, 정액제 이용권을 구매하였고, 만료일이 지나지 않았는지를 확인 바랍니다.
다른 브라우저에서 미꾸라지 확장 기능을 사용하였을 때 동일하게 증상이 재현되는지 확인해 보시기 바랍니다.

미꾸라지의 경우, Chrome, Microsoft Edge, Naver Whale, Firefox 등등 다른 브라우저에서도 동작하도록 되어 있습니다. 만약 자신이 Chrome 사용자인데, 갑자기 동작하지 않는다면, 다른 브라우저에 미꾸라지 확장 기능을 설치하셔서 동일하게 증상이 재현되는지 살펴보시기 바랍니다.

만약 특정 브라우저에만 제대로 동작을 하지 않는다면, 해당 브라우저 자체의 이슈일 가능성이 큽니다.
현재 사용하고 있는 다른 브라우저 확장 기능과의 충돌이 있는지를 확인해 보시기 바랍니다.

미꾸라지 브라우저 기능의 경우, 브라우저의 Proxy 설정을 하게 되는데, 이와 동일한 기능을 하는 다른 브라우저와 충돌로 인해서 해당 이슈가 발생될 수 있습니다.
네트워크 방화벽이 미꾸라지 프록시 서버에 접속을 차단하고 있는지를 확인해 보시기 바랍니다. 현재 미꾸라지 브라우저 확장 기능이 제대로 동작하기 위해서는 아래의 TCP port 연결이 제대로 되어야 합니다.
- TCP 18080 (기본 모드)
- TCP 18082 (Secure 연결 모드)
- TCP 18083 (SSL Bump 모드)

만약 그럼에도 제대로 동작하지 않는다면 위의 "디버깅" 세션대로 브라우저 확장 기능의 실행과정에 이슈가 있었는지를 확인해 보시기 바랍니다.

ERR_TUNNEL_CONNECTION_FAILED 이슈가 발생됩니다.

이 오류 메세지는 크롬 브라우저가 지정한 미꾸라지 중계 서버와 연결하는데, 어떠한 이유로 실패하였음을 뜻합니다. 다음의 항목들을 체크해 보시기 바랍니다.

해당 이슈가 미꾸라지 중계 서버를 다른 것으로 변경하여도 그에 상관없이 이슈가 발생되는지.
미꾸라지 브라우저 확장 기능은 Chrome, Edge, Firefox, Naver Whale 등등을 지원하는데, 다른 브라우저를 설치하고 확장 기능을 설치하여 시도해 보셔도 동일한 이슈가 발생되는지.
미꾸라지 브라우저 확장 기능의 설정에 들어가서, "자동 로그인" 부분에 해당 기능을 활성화하고 미꾸라지 ID/PWD 을 입력하여도 증상이 동일한지.
미꾸라지 브라우저 확장 기능과 기능상 충돌할 수 있는 다른 확장 기능이 설치되어 실행중인 것이 아닌지. 간혹 확장 기능끼리 충돌하여 해당 이슈가 발생될 수 있습니다.

설치하기​

메뉴 소개​

기능​

중계 서버 접속하기​

중계 서버 접속 끊기​

디버깅​

FAQ (자주 묻는 질문)​

확장 기능이 동작하지 않습니다.​

ERR_TUNNEL_CONNECTION_FAILED 이슈가 발생됩니다.​