IP归属地查询 · 全球 IPv4 / IPv6 双栈定位

免费 IP 归属地查询 API

本工具同时提供 GET / POST 接口，参数 id 为待查询 IP，返回完整 HTML 页面。如需纯 JSON 接口获取当前访问者 IP，请调用 /https://ip.yuesha.com/api.php。

cURL

curl -X POST "https://ip.yuesha.com/" -d "id=8.8.8.8"

Python

import requests

resp = requests.post("https://ip.yuesha.com/", data={"id": "8.8.8.8"}, timeout=10)
print(resp.text)

Node.js

const axios = require('axios');

axios.post('https://ip.yuesha.com/', 'id=8.8.8.8', {
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  timeout: 10000
}).then(r => console.log(r.data));

Java (JDK 11+)

import java.net.URI;
import java.net.http.*;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest req = HttpRequest.newBuilder()
                .uri(URI.create("https://ip.yuesha.com/"))
                .header("Content-Type", "application/x-www-form-urlencoded")
                .POST(HttpRequest.BodyPublishers.ofString("id=8.8.8.8"))
                .build();
        HttpResponse<String> resp = client.send(req, HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.body());
    }
}

Go

package main

import (
    "fmt"
    "net/http"
    "net/url"
    "strings"
    "time"
)

func main() {
    form := url.Values{}
    form.Set("id", "8.8.8.8")
    client := &http.Client{Timeout: 10 * time.Second}
    resp, err := client.PostForm("https://ip.yuesha.com/", form)
    if err != nil { panic(err) }
    defer resp.Body.Close()
    buf := new(strings.Builder)
    buf.ReadFrom(resp.Body)
    fmt.Println(buf.String())
}

PHP

<?php
$ctx = stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-type: application/x-www-form-urlencoded',
        'content' => http_build_query(['id' => '8.8.8.8']),
        'timeout' => 10,
    ]
]);
echo file_get_contents('https://ip.yuesha.com/', false, $ctx);

C#

using System;
using System.Collections.Generic;
using System.Net.Http;

class Program {
    static async Task Main() {
        using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(10) };
        var content = new FormUrlEncodedContent(new Dictionary<string, string> { { "id", "8.8.8.8" } });
        var resp = await client.PostAsync("https://ip.yuesha.com/", content);
        Console.WriteLine(await resp.Content.ReadAsStringAsync());
    }
}

使用建议：

1. 请设置合理超时（建议 8–10 秒），并在失败时进行重试或降级。
2. 批量场景请使用本页「批量查询」标签，避免短时间高频请求触发在线接口限流。
3. 本接口返回 HTML 页面；如需 JSON 格式当前 IP，请访问 /https://ip.yuesha.com/api.php。