Proxy SOCKS

Caractéristiques

Chaque nœud Mudfish est configuré pour prendre en charge les protocoles SOCKS v3 / v4 / v5. Voici leurs particularités :

• Pour utiliser v3 / v4, vous devez vous connecter au VPN Mudfish et accéder au nœud par son adresse IP privée.
• Le protocole v5 est accessible depuis l’extérieur via l’adresse IP publique. Vous pouvez utiliser le nœud en vous authentifiant avec un identifiant et un mot de passe SOCKS v5.

Méthodes d’accès

Depuis un réseau externe

L’accès est possible avec le protocole SOCKS v5.

• Adresse IP publique

  Utilisez l’adresse IP publique du nœud Mudfish. Dans la liste staticnodes de l’API des nœuds, trouvez le serveur souhaité et saisissez sa valeur ip. Les champs sont décrits dans la section Champs de réponse de l’API des nœuds.

• Port

  TCP 18081.

Utilisez votre identifiant et votre mot de passe Mudfish.

Depuis le réseau interne

attention

Pour utiliser correctement le proxy SOCKS Mudfish dans votre navigateur, Mudfish doit rester en cours d’exécution.

La documentation du proxy HTTP fournit les explications les plus détaillées. Voici la méthode que j’utilise habituellement.

1. Installez et lancez Firefox.

2. Dans « Paramètres → Avancé → Réseau », renseignez SOCKS Host et Port. Pour SOCKS Host, utilisez l’adresse IP interne d’un nœud Mudfish au Japon, que vous pouvez trouver ainsi :

   • Ouvrez https://mudfish.net/server/status et cliquez sur le nom d’un nœud japonais.
   • Le champ « IP interne » donne l’adresse recherchée. Par exemple, le nœud JP Asia (Osaka - SakuraNet) a l’adresse interne 10.252.144.1.
   • Le port par défaut du proxy SOCKS est 8081.

3. Enregistrez et vérifiez la configuration sur https://myip.mudfish.net.

4. Si https://myip.mudfish.net confirme la bonne configuration mais que le site souhaité reste inaccessible, choisissez un autre nœud japonais et réessayez.

Champs de réponse de l’API des nœuds

L’API des nœuds renvoie la liste des nœuds au format JSON. Une réponse réussie a la structure suivante. Cet exemple ne contient qu’un serveur. La liste et les adresses pouvant changer, consultez la réponse actuelle de l’API lors de la configuration.

{
  "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
    }
  ]
}

Champs de premier niveau

Champ	Type	Description
status	Entier	Résultat du traitement de la requête API. 200 indique que la récupération de la liste a réussi. Cette valeur du corps JSON ne représente pas l’état de connexion de chaque nœud.
staticnodes	Tableau	Liste d’objets contenant les informations des nœuds. Chaque entrée représente un serveur.

Champs de chaque serveur dans staticnodes

Champ	Type	Description
sid	Entier	Identifiant utilisé par Mudfish pour distinguer les nœuds. Ce n’est ni une adresse de proxy ni un numéro de port.
hostname	Chaîne	Nom d’hôte du nœud, par exemple node-ae-00421.mudfish.net.
ip	Chaîne	Adresse IPv4 publique du nœud. Utilisez-la comme adresse du proxy pour une connexion SOCKS v5 depuis un réseau externe.
private_ip	Chaîne	Adresse IPv4 privée du nœud dans le VPN Mudfish. Utilisez-la pour accéder au proxy par le réseau interne après connexion au VPN Mudfish.
location	Chaîne	Nom affiché du nœud, comprenant notamment le code pays, la région, la ville et l’hébergeur. Dans l’exemple, AE Middle East (Dubai - Aliyun) désigne un nœud Aliyun à Dubaï, aux Émirats arabes unis.
commercial_node	Entier	Indique si le nœud est payant : 1 pour un nœud payant, 0 pour un nœud de test.
commercial_node_premium_enabled	Entier	Indique le classement premium : 1 pour un nœud premium, 0 pour un nœud sans ce classement. Cette distinction sert à déterminer l’accès aux nœuds selon le titre d’utilisation.

commercial_node et commercial_node_premium_enabled sont renvoyés sous forme d’entiers 1 / 0, et non de booléens JSON true / false. Ils décrivent le classement du serveur, pas sa prise en charge de SOCKS, sa vitesse en temps réel ou sa latence.

Valeurs à utiliser pour SOCKS

Méthode de connexion	Adresse du proxy	Port TCP	Authentification et conditions
SOCKS v5 depuis un réseau externe	ip	18081	Authentification avec l’identifiant et le mot de passe Mudfish.
Réseau interne du VPN Mudfish	private_ip	8081	Une connexion au VPN Mudfish est nécessaire.

La réponse API ne contient ni les ports du proxy ni les identifiants de l’utilisateur. Trouvez le serveur souhaité grâce à location, puis utilisez l’adresse correspondant à votre méthode de connexion et le port indiqué ci-dessus.