SOCKS Proxy

특징

각각의 미꾸라지 중계 서버는 SOCKS v3 / v4 / v5 프로토콜을 지원하도록 구성되어 있습니다. 프로토콜 별 각각 다음과 같은 특징이 있습니다.

v3 / v4 을 사용하기 위해서는 미꾸라지 VPN 접속 후, 중계 서버의 Private IP 을 통해서만 접근이 가능합니다.
v5 프로토콜의 경우, Public IP 을 통해 외부에 노출되어 있으며, SOCKS v5 의 ID / PWD 인증을 통하여 미꾸라지 중계 서버를 사용할 수 있습니다.

접근 방법

외부망을 통한 방법

SOCKS v5 프로토콜을 이용하여 접근 가능합니다.

Public IP

미꾸라지 중계 서버의 Public IP 을 사용하시면 됩니다. 중계 서버 API의 staticnodes 목록에서 사용할 서버를 찾고, 해당 서버의 ip 값을 입력하세요. 각 필드의 의미는 아래의 중계 서버 API 응답 필드를 참고하세요.
Port

TCP 18081 입니다.

사용하시는 미꾸라지 ID / PWD 을 사용하시면 됩니다.

내부망을 이용한 방법

경고

미꾸라지 SOCKS proxy 기능을 정상 이용하기 위해서는 반드시 브라우저를 통해 이용하시는 동안 미꾸라지가 실행중이어야 합니다.

HTTP Proxy 링크를 보면 가장 자세히 나와 있으니 참고 바랍니다. 여기서는 제가 주로 이용하는 방법에 대해 기록을 하도록 하겠습니다.

Firefox 를 설치하고 실행합니다.
'설정 -> 고급 -> 네트워크' 메뉴에 들어가서 SOCKS Host 와 Port 를 입력합니다. 여기서 SOCKS Host 에 미꾸라지 일본 중계 서버의 내부 IP 를 입력해야 하는데 다음과 같이 알 수 있습니다.
- https://mudfish.net/server/status 에 접속한 후, 일본 중계 서버 이름을 클릭합니다.
- 나오는 정보에 '내부 IP' 가 해당 정보입니다. 예를 들어, JP Asia (Osaka - SakuraNet) 중계 서버의 내부 IP 는 10.252.144.1 입니다.
- Port 는 SOCKS proxy 의 경우, 기본 8081 포트입니다.
저장 후, 제대로 설정되어 있는지 확인을 합니다. https://myip.mudfish.net 에 접속하시면 설정 여부를 확인할 수 있습니다.
https://myip.mudfish.net 에는 제대로 설정되었다고 나오는데, 해당 사이트에 접속이 안된다면 다른 일본 중계 서버로 변경하신 후 다시 테스트를 해보십시오.

중계 서버 API 응답 필드

중계 서버 API는 중계 서버 목록을 JSON 형식으로 반환합니다. 정상 응답은 다음과 같은 구조입니다. 아래는 서버 한 개만 남긴 예제이며, 서버 목록과 주소는 변경될 수 있으므로 실제 설정할 때는 API의 최신 응답을 확인하세요.

{
  "status": 200,
  "staticnodes": [
    {
      "sid": 421,
      "hostname": "node-ae-00421.mudfish.net",
      "ip": "47.91.122.48",
      "private_ip": "10.228.224.1",
      "location": "AE Middle East (Dubai - Aliyun)",
      "commercial_node": 1,
      "commercial_node_premium_enabled": 1
    }
  ]
}

최상위 필드

필드	자료형	설명
`status`	정수	API 요청의 처리 결과입니다. `200`이면 서버 목록 조회에 성공한 것입니다. JSON 본문에 포함된 값이며, 개별 중계 서버의 접속 상태를 나타내지는 않습니다.
`staticnodes`	배열	중계 서버 정보 객체의 목록입니다. 배열의 각 항목이 서버 한 개를 나타냅니다.

`staticnodes`의 서버별 필드

필드	자료형	설명
`sid`	정수	미꾸라지에서 중계 서버를 구분하는 서버 ID입니다. 프록시 접속 주소나 포트 번호가 아닙니다.
`hostname`	문자열	중계 서버의 호스트 이름입니다. 예: `node-ae-00421.mudfish.net`.
`ip`	문자열	중계 서버의 공인 IPv4 주소입니다. 외부망에서 SOCKS v5로 접속할 때 프록시 서버 주소로 사용합니다.
`private_ip`	문자열	미꾸라지 VPN 내부에서 사용하는 중계 서버의 사설 IPv4 주소입니다. 미꾸라지 VPN 접속 후 내부망을 통해 프록시에 접근할 때 사용합니다.
`location`	문자열	국가 코드, 지역, 도시 및 서버 제공 업체 등을 포함한 중계 서버의 표시 이름입니다. 예제의 `AE Middle East (Dubai - Aliyun)`은 아랍에미리트 두바이의 Aliyun 중계 서버를 나타냅니다.
`commercial_node`	정수	유료 중계 서버 여부입니다. `1`은 유료 중계 서버, `0`은 테스트 중계 서버를 나타냅니다.
`commercial_node_premium_enabled`	정수	프리미엄 중계 서버 분류 여부입니다. `1`은 프리미엄 중계 서버, `0`은 해당 분류가 적용되지 않은 서버입니다. 이용권에 따른 중계 서버 이용 가능 여부를 판단할 때 사용되는 구분입니다.

commercial_node와 commercial_node_premium_enabled는 JSON의 true / false가 아닌 정수 1 / 0으로 반환됩니다. 이 값들은 서버의 분류를 나타내며, SOCKS 지원 여부나 실시간 속도, 지연 시간을 나타내는 값은 아닙니다.

SOCKS 설정에 사용할 값

접속 방법	프록시 서버 주소	TCP 포트	인증 및 조건
외부망에서 SOCKS v5로 접속	`ip`	`18081`	미꾸라지 ID와 비밀번호로 인증합니다.
미꾸라지 VPN 내부망으로 접속	`private_ip`	`8081`	미꾸라지 VPN에 접속한 상태여야 합니다.

API 응답에는 프록시 포트나 사용자 인증 정보가 포함되지 않습니다. 원하는 서버를 location으로 찾은 다음, 접속 방법에 맞는 주소와 위의 포트를 사용하세요.

특징​

접근 방법​

외부망을 통한 방법​

내부망을 이용한 방법​

중계 서버 API 응답 필드​

최상위 필드​

staticnodes의 서버별 필드​

SOCKS 설정에 사용할 값​

특징