Skip to content

C++ 怎么查询 IP 归属地?libcurl + nlohmann/json 写一个命令行工具(完整可编译代码) ​

C++ 项目里想查个 IP 归属地,选择其实不多:引一个几十兆的离线库,编译进二进制,数据还得定期更新;或者自己拼 HTTP 请求,被 libcurl 的回调签名和 HTTPS 证书折腾一下午。前者重,后者散。

这篇文章走第三条路:用 libcurl 调在线接口 + nlohmann/json 解析,写一个单文件、能编译、能直接扔到跳板机或网关机器上跑的命令行工具。全篇一个语言,一个文件,编译两条命令。

一、什么时候值得在 C++ 里干这件事 ​

不是所有场景都适合。先分清楚:

适合:长期跑在服务器上的 C++ 服务(网关、代理、风控前置),需要在本地对访问 IP 做一层地域判断或打标签;运维/安全团队需要一个不依赖 Python 运行时的排查工具,丢到只装了基础库的机器上就能用;已经在写 C++ 的数据面程序,不想为了一行 HTTP 再维护一套 Python 脚本。

不适合:一次性分析几千个 IP——那是 Python 的活,requests 三行搞定,没必要上 C++;高并发批量查询——C++ 的优势在单机性能,但免费接口本身有 60 次/分钟的限制,语言再快也没用,要快就得上 VIP 版额度。

判断标准很简单:如果这段逻辑要长在常驻服务里,用 C++ 值;如果只是跑一次看结果,别折腾。

二、方案:一个 curl 句柄 + 一个小缓存 ​

结构做三层就够,别过度设计:

  • 传输层:一个复用的 CURL* 句柄。每次请求新建句柄会重复做 DNS、TLS 握手,白白多花几十毫秒;复用后连接少说能省一半时间。
  • 解析层:nlohmann/json 只需要一个头文件,json::parse 之后按 key 取值,字段缺失不会崩(value() 带默认值)。
  • 缓存层:std::unordered_map<std::string, Geo>,进程生命周期内有效。同一个 IP 查第二次直接返回内存结果——排查场景里同一个 IP 反复出现是常态。

三个现实约束决定代码怎么写:

  1. 必须带 User-Agent。 不带 UA 的裸请求会被挡在外面(403),这不是接口在刁难,是常见的反爬策略。请求里显式设一个能识别的 UA。
  2. 超时必须有。 默认的 curl 超时是无限的,接口卡住时你的线程就跟着挂住。设 3 秒超时、2 秒连接超时,宁可这次失败下次重试。
  3. 失败要和"查无此人"分开。 网络超时、HTTP 非 200、非法 IP 返回的 400,性质都不同。工具的做法是统一返回 false 并把原因打到 stderr,让调用方决定怎么处理。

三、完整代码:单文件 C++ 查询工具 ​

nlohmann/json 用单头文件版本(json.hpp)即可,从官方 release 页面下载放到同目录。编译:

bash
# 依赖:libcurl 开发包(Ubuntu: apt install libcurl4-openssl-dev)
g++ -std=c++17 -O2 geoquery.cpp -o geoquery -lcurl
cpp
// geoquery.cpp —— IP 归属地命令行查询工具
// 用法: ./geoquery <ip> [ip ...]
#include <curl/curl.h>
#include <nlohmann/json.hpp>

#include <chrono>
#include <iostream>
#include <stdexcept>
#include <string>
#include <thread>
#include <unordered_map>

using json = nlohmann::json;

static size_t write_cb(char* ptr, size_t size, size_t nmemb, void* userdata) {
    static_cast<std::string*>(userdata)->append(ptr, size * nmemb);
    return size * nmemb;
}

struct Geo {
    std::string country, prov, city, isp;
};

class GeoClient {
public:
    GeoClient() {
        curl_global_init(CURL_GLOBAL_DEFAULT);
        handle_ = curl_easy_init();
        if (!handle_) throw std::runtime_error("curl_easy_init 失败");

        curl_easy_setopt(handle_, CURLOPT_WRITEFUNCTION, write_cb);
        curl_easy_setopt(handle_, CURLOPT_TIMEOUT, 3L);         // 总超时 3 秒
        curl_easy_setopt(handle_, CURLOPT_CONNECTTIMEOUT, 2L);  // 连接超时 2 秒
        curl_easy_setopt(handle_, CURLOPT_FOLLOWLOCATION, 1L);
        curl_easy_setopt(handle_, CURLOPT_ACCEPT_ENCODING, ""); // 自动解压 gzip

        headers_ = curl_slist_append(headers_, "User-Agent: geoquery-cpp/1.0");
        headers_ = curl_slist_append(headers_, "Accept: application/json");
        curl_easy_setopt(handle_, CURLOPT_HTTPHEADER, headers_);
    }

    ~GeoClient() {
        if (headers_) curl_slist_free_all(headers_);
        if (handle_) curl_easy_cleanup(handle_);
        curl_global_cleanup();
    }

    GeoClient(const GeoClient&) = delete;
    GeoClient& operator=(const GeoClient&) = delete;

    // 返回 false 表示查询失败(网络异常 / 非 200 / 非法 IP)
    bool query(const std::string& ip, Geo& out) {
        auto it = cache_.find(ip);
        if (it != cache_.end()) {          // 命中缓存,零网络开销
            out = it->second;
            return true;
        }

        std::string url = "https://ip9.com.cn/get?ip=" + ip;
        std::string body;
        curl_easy_setopt(handle_, CURLOPT_URL, url.c_str());
        curl_easy_setopt(handle_, CURLOPT_WRITEDATA, &body);

        CURLcode rc = curl_easy_perform(handle_);
        if (rc != CURLE_OK) {
            std::cerr << "[warn] " << ip << " 请求失败: " << curl_easy_strerror(rc) << "\n";
            return false;                   // 超时/断连:不缓存,下次可重试
        }

        long code = 0;
        curl_easy_getinfo(handle_, CURLINFO_RESPONSE_CODE, &code);
        if (code != 200) {
            std::cerr << "[warn] " << ip << " HTTP " << code
                      << (code == 403 ? "(缺 UA 或被拦截)"
                                      : code == 429 ? "(触发限速)" : "") << "\n";
            return false;
        }

        try {
            json j = json::parse(body);
            if (j.value("ret", 0) != 200 || !j.contains("data") || !j["data"].is_object()) {
                return false;               // 非法 IP:ret=400,data 不是对象
            }
            const auto& d = j["data"];
            out.country = d.value("country", "");
            out.prov    = d.value("prov", "");
            out.city    = d.value("city", "");
            out.isp     = d.value("isp", "");
        } catch (const json::exception& e) {
            std::cerr << "[warn] " << ip << " 解析失败: " << e.what() << "\n";
            return false;
        }

        cache_[ip] = out;
        return true;
    }

private:
    CURL* handle_ = nullptr;
    curl_slist* headers_ = nullptr;
    std::unordered_map<std::string, Geo> cache_;
};

int main(int argc, char** argv) {
    if (argc < 2) {
        std::cerr << "用法: " << argv[0] << " <ip> [ip ...]\n";
        return 1;
    }

    try {
        GeoClient client;
        for (int i = 1; i < argc; ++i) {
            Geo g;
            if (client.query(argv[i], g)) {
                std::cout << argv[i] << "\t" << g.country << " " << g.prov << " "
                          << g.city << " / " << g.isp << "\n";
            } else {
                std::cout << argv[i] << "\t查询失败\n";
            }

            // 免费版 60 次/分钟:批量循环时在两次请求之间留间隔
            if (i + 1 < argc) std::this_thread::sleep_for(std::chrono::milliseconds(1100));
        }
    } catch (const std::exception& e) {
        std::cerr << "fatal: " << e.what() << "\n";
        return 1;
    }
    return 0;
}

编译跑一下:

text
$ ./geoquery 220.181.108.151 114.114.114.114 8.8.8.8 999.1.1.1
220.181.108.151 中国 北京 北京 / 电信
114.114.114.114 中国 江苏 南京 / 电信
8.8.8.8 美国   / Google LLC
999.1.1.1       查询失败
[warn] 999.1.1.1 HTTP 200(ret=400,非法 IP)

四点值得说明:

  • write_cb 里的 size * nmemb 才是真实字节数。 这是 libcurl 回调最常见的错误,很多人写 return size,结果响应被截断,json::parse 报"unexpected end of input",排查半天才发现是回调返回错了。
  • 句柄复用带来的是实打实的加速。 第一次请求要 DNS + TLS 握手,通常 100 毫秒往上;同一句柄第二次请求走的是已建立的连接,几十毫秒就回来了。
  • CURLOPT_TIMEOUT 和 CURLOPT_CONNECTTIMEOUT 要分开设。 前者管整个请求,后者只管连接阶段。只设总超时的话,遇到"能连上但服务器不回"的情况,你的线程要愣满 3 秒。
  • ret 字段必须校验。 非法 IP 时 HTTP 状态码依然是 200,靠状态码判断会漏——ret=400 才是真正的信号,data 也不是对象,所以上面代码里用 is_object() + ret 双重校验。

四、接到常驻服务里要注意什么 ​

别在请求路径上同步调接口。 接口再快也是外网调用,有抖动。正确的做法是启动时预热一批高频 IP、运行期异步补充缓存,请求路径上只读内存缓存(命中就用,未命中当"未知"处理)。同步阻塞 = 加了一个外网依赖到核心链路上,接口一抖你的服务就抖。

限速要放在客户端。 免费版 60 次/分钟是按 IP 算的,如果你的服务部署在多台机器上,每台都在刷这个额度,很快就会被限。做批量任务时统一走一线程、或者干脆离线跑好写进配置文件,别让业务线程各查各的。

缓存设过期时间。 普通机房 IP 归属地基本不变,可以长期缓存;家宽和移动网络 IP 变动频繁,缓存几小时就够。上面 unordered_map 是进程内的永久缓存,长期跑的服务要自己加时间戳,或者接一层本地文件/RocksDB 缓存。

要更细的判断就上 VIP 字段。 免费版的 isp 只能看出运营商,判断不了"这是机房还是家宽"。风控场景需要区分 IDC 机房(ip_type)和 ASN(ip_asn)时,这两项由 VIP 版提供,接的时候按同样的 JSON 结构多取两个 key 就行。

编译依赖要写进构建脚本。 -lcurl 是必须的,pkg-config --libs libcurl 拿到的链接参数在有些发行版上还带 -lssl -lcrypto,用 CMake 的话直接 find_package(CURL REQUIRED) 更省事。

总结 ​

C++ 查 IP 归属地这件事,代码量其实不大:一个复用句柄、一个头文件解析器、一层内存缓存,一百来行就是一个能编译能跑的工具。真正花时间的是那些细节——UA 要带、超时要有、write_cb 要返回字节数、ret 要校验。

接口是 https://ip9.com.cn/get?ip=<IP>,免费版不需要注册、60 次/分钟/IP,IPv4 和 IPv6 都支持,返回国家、省市、运营商、经纬度等字段;高并发或者要机房价 ip_type、ASN 的场景用 VIP 版。文档和额度见官网 https://www.ip9.com.cn。