# lan-ipquery **Repository Path**: q411729088/lan-ipquery ## Basic Information - **Project Name**: lan-ipquery - **Description**: 基于 ip2region 的离线 IP 归属查询服务:网页+API,数据不出内网 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-23 - **Last Updated**: 2026-09-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # lan-ipquery 基于 [ip2region](https://github.com/lionsoul2014/ip2region) 的**离线 IP 归属查询服务**:网页查询 + HTTP API,Docker 一键部署,数据全程不出内网。 查 IP 归属地,不用再把 IP 发给第三方网站。 ## 特性 - **离线查询**:数据文件在本地,全程无外呼,查询行为不出内网 - **微秒级**:ip2region 查询性能约 10 微秒,纯本地无网络延迟 - **双栈覆盖**:IPv4 + IPv6 - **归属精度**:中国精确到城市/运营商,海外到国家(部分州/城市) - **批量查询**:一次最多 500 个 IP,JSON 接口 - **网段归属**:输入 CIDR(如 `1.2.3.0/24`),列出覆盖该网段的全部 IP 段 - **数据浏览**:按国家、按 IP 版本分页浏览全网 IP 段归属 - **自动更新**:定时脚本拉取上游最新库,md5 比对有变化才替换重启 ## 快速开始 ```bash git clone <仓库地址> && cd lan-ipquery # 1. 准备数据:下载官方 xdb 到 data/ 目录(或直接跑 update-data.sh 自动拉取) mkdir -p data curl -L -o data/ip2region_v4.xdb \ https://cdn.jsdelivr.net/gh/lionsoul2014/ip2region@master/data/ip2region_v4.xdb curl -L -o data/ip2region_v6.xdb \ https://gh-proxy.com/https://raw.githubusercontent.com/lionsoul2014/ip2region/master/data/ip2region_v6.xdb # 2. 构建并启动 docker compose up -d --build ``` 浏览器打开 `http://:6810` 即可使用。 ## API | 接口 | 方法 | 说明 | | --- | --- | --- | | `/api/query?ip=X` | GET | 单 IP 查询(IPv4/IPv6 自适应) | | `/api/batch` | POST | 批量查询,body `{"ips":[...]}`,≤500 个 | | `/api/health` | GET | 健康检查 | | `/api/info` | GET | 数据与统计信息 | | `/api/countries` | GET | 国家列表(供段列表下拉使用) | | `/api/segments?country=X&ver=v4\|v6\|all&offset&limit` | GET | 指定国家的 IP 段列表(分页) | | `/api/cidr?cidr=1.2.3.0/24` | GET | 网段归属查询 | ```bash # 单 IP 查询 curl "http://:6810/api/query?ip=223.5.5.5" # 批量查询 curl -X POST http://:6810/api/batch \ -H "Content-Type: application/json" \ -d '{"ips":["223.5.5.5","8.8.8.8","2400:3200::1"]}' # 网段归属 curl "http://:6810/api/cidr?cidr=1.2.3.0/24" ``` 数据字段格式:`国家|省份|城市|运营商|ISO代码`,示例:`中国|浙江省|杭州市|阿里|CN`。 ## 数据更新 `update-data.sh` 负责自动更新:下载上游最新 v4/v6 库 → md5 与当前库比对 → 有变化才备份、替换并重启容器,无变化直接跳过。 通过 cron 每周日 04:00 执行: ```bash 0 4 * * 0 bash /path/to/lan-ipquery/update-data.sh >> /path/to/lan-ipquery/update.log 2>&1 ``` 上游库约每月更新 1-2 次,所以本地数据最多落后一周。 ## 目录结构 ``` lan-ipquery/ ├── app.py # 主服务(网页 + HTTP API + 后台索引) ├── app/ip2region/ # ip2region Python 绑定(来自上游仓库) ├── Dockerfile ├── docker-compose.yml ├── update-data.sh # 数据自动更新脚本 └── data/ # 运行期数据(gitignore,首次部署自行下载) ``` ## 数据来源与致谢 - 数据与查询库:[ip2region](https://github.com/lionsoul2014/ip2region),Apache-2.0 / MIT 双许可,本项目按上游协议使用并致谢 - 本项目(`app.py`、`update-data.sh`、Dockerfile 等封装层)为原创代码 ## License [Apache-2.0](LICENSE)