Appearance
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 反复出现是常态。
三个现实约束决定代码怎么写:
- 必须带 User-Agent。 不带 UA 的裸请求会被挡在外面(403),这不是接口在刁难,是常见的反爬策略。请求里显式设一个能识别的 UA。
- 超时必须有。 默认的 curl 超时是无限的,接口卡住时你的线程就跟着挂住。设 3 秒超时、2 秒连接超时,宁可这次失败下次重试。
- 失败要和"查无此人"分开。 网络超时、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 -lcurlcpp
// 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。