多数据源聚合的 IP 地理位置、网络信息、安全检测查询系统。支持 AbuseIPDB、iplocate.io 双数据源实时对比分析，内嵌 OpenStreetMap 地图定位。

A multi-source IP geolocation, network info, and security detection system with AbuseIPDB + iplocate.io dual-source comparison and embedded OpenStreetMap positioning.

• 🔍 IP 信息查询 — 输入任意 IPv4/IPv6 地址，聚合多源数据
• 📊 多源对比 — AbuseIPDB、iplocate.io 双数据源并排对比，差异高亮
• 🛡️ 安全检测 — VPN / 代理 / Tor / 威胁检测，AbuseIPDB 滥用评分
• 🗺️ 地图定位 — Leaflet + OpenStreetMap 嵌入式地图，深色/浅色主题自动切换 Tile
• 📍 街道地址 — Nominatim 反向地理编码，精确到街道级别
• 🌐 中英双语 — 界面标签同时显示中文和英文
• 💻 浏览器标识 — 自动检测并展示访客浏览器、操作系统、设备类型
• 🎨 主题切换 — 深色 / 浅色主题一键切换
• 📱 响应式 — 完美适配桌面端和移动端

• 🔐 密码认证 — Token 鉴权，24h 自动过期
• 📝 SEO 设置 — 配置网站标题、描述、关键词
• 🔑 API Key 管理 — 在线管理 AbuseIPDB（多 Key 轮询）、iplocate.io 密钥
• 🔗 接口地址配置 — 自定义各数据源 API 端点地址，方便接入代理或新数据源
• 🗺️ 地图设置 — 配置 Nominatim 联系邮箱
• 🔒 安全设置 — 修改管理密码
• ⚡ 实时生效 — 所有设置修改即时生效，无需重启服务

git clone https://github.com/logdns/ip-query.git
cd ip-query

npm install

cp .env.example .env

编辑 .env 文件，填入你的 API Key：

# 服务端口
PORT=3008

# AbuseIPDB API Keys (支持多个，逗号分隔)
ABUSEIPDB_KEYS=your_key_1,your_key_2

# iplocate.io API Key
IPLOCATE_API_KEY=your_iplocate_key

# 管理后台密码
ADMIN_PASSWORD=your_admin_password

# Nominatim 联系邮箱 (可选)
NOMINATIM_EMAIL=your-email@example.com

注意: 首次启动时，系统会自动从 .env 迁移配置到 data/settings.json。之后可通过管理后台在线修改，无需编辑文件。

# 开发模式
npm run dev

# 生产模式
npm start

服务器启动后访问:

• 前台: http://localhost:3008
• 管理后台: http://localhost:3008/admin

1. 登录宝塔面板，进入 软件商店
2. 安装 PM2 管理器（Node.js 进程管理）
3. 安装 Nginx（如果尚未安装）
4. 在 PM2 管理器中确认 Node.js 版本 >= 16

方式一：Git 克隆（推荐）

cd /www/wwwroot
git clone https://github.com/logdns/ip-query.git
cd ip-query
npm install --production

方式二：宝塔文件管理器上传

1. 打开宝塔 文件 管理器，进入 /www/wwwroot/
2. 上传项目压缩包并解压到 /www/wwwroot/ip-query/
3. 在终端执行 cd /www/wwwroot/ip-query && npm install --production

cd /www/wwwroot/ip-query
cp .env.example .env

编辑 .env 文件，填入你的 API Key 和管理密码。

方式一：宝塔 PM2 管理器界面

1. 打开 PM2 管理器
2. 点击 添加项目
3. 填写信息：
   • 项目名称: ip-query
   • 启动文件: /www/wwwroot/ip-query/server.js
   • 运行目录: /www/wwwroot/ip-query
4. 点击 提交

方式二：命令行

cd /www/wwwroot/ip-query
pm2 start server.js --name ip-query
pm2 save
pm2 startup

1. 在宝塔面板 网站 中添加站点，填写你的域名
2. 点击 设置 → 反向代理 → 添加反向代理
3. 填写：
   • 代理名称: ip-query
   • 目标 URL: http://127.0.0.1:3008
4. 点击 提交

点击 设置 → 配置文件，在 server {} 块内添加：

# 获取真实 IP (重要！)
set_real_ip_from 0.0.0.0/0;
real_ip_header X-Forwarded-For;
real_ip_recursive on;

# 静态文件缓存
location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
    root /www/wwwroot/ip-query/public;
    expires 7d;
    add_header Cache-Control "public, immutable";
}

# 反向代理到 Node.js
location / {
    proxy_pass http://127.0.0.1:3008;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_cache_bypass $http_upgrade;
    proxy_connect_timeout 60s;
    proxy_read_timeout 60s;
}

1. 在宝塔面板 网站 → 设置 → SSL
2. 选择 Let's Encrypt 免费证书
3. 点击 申请

• 访问 https://你的域名 查看前台
• 访问 https://你的域名/admin 进入管理后台
• 默认管理密码为 .env 中设置的 ADMIN_PASSWORD

# 查看运行状态
pm2 status

# 查看日志
pm2 logs ip-query

# 重启
pm2 restart ip-query

# 停止
pm2 stop ip-query

# 更新代码后重启
cd /www/wwwroot/ip-query
git pull
npm install --production
pm2 restart ip-query

系统支持后台一键在线更新，也可手动更新。无论哪种方式，用户配置数据都会自动保留，无需手动迁移。

核心机制：data/settings.json 与 .env 都在 .gitignore 中，git pull 永远不会覆盖它们。所有在管理后台修改的配置都持久化在 data/settings.json，因此升级是无损的。

后台更新基于 GitHub Releases：只有维护者发布正式 Release 时才会提示更新，版本号语义化（如 v1.1.0），并附完整更新说明。

1. 进入管理后台 → 在线更新 标签页
2. 点击 检查更新，系统会调用 GitHub API 获取最新 Release，对比当前版本，展示版本号、发布时间与更新说明
3. 若有新版本，点击 更新到 vX.Y.Z，系统会：
   • git fetch --tags 后强制对齐（git reset --hard）到该 Release 对应的 tag；本地代码改动会被覆盖，但 data/settings.json、.env 已被 gitignore，用户配置不受影响
   • 自动 pm2 restart 重启进程使新代码生效
   • 轮询健康检查，服务恢复后自动刷新页面

若未运行在 PM2 下，后台会提示需手动重启进程（前端文件已生效，刷新即可）。 私有仓库可在 .env 中配置 GITHUB_TOKEN 以访问 Release API。

# 1. 提交并推送代码到 main
git push origin main

# 2. 打 tag 并发布 Release (需安装 gh CLI)
gh release create v1.1.0 --title "v1.1.0" --notes "## 更新内容
- 新增 XXX 功能
- 修复 YYY 问题"

发布后，所有部署方在后台「检查更新」即可看到 v1.1.0 及其更新说明。

cd /www/wwwroot/ip-query
git fetch --tags                       # 拉取最新 tag（不会动 data/settings.json）
git checkout v1.1.0                    # 切换到目标版本
npm install --production               # 如有新依赖
pm2 restart ip-query                   # 重启使后端代码生效

lib/settings.js 在读取时使用 deepMerge 将已存在的 settings.json 与新版默认配置合并：

• 新版本新增的配置字段 → 自动补上默认值
• 你已有的配置值 → 原样保留，不被覆盖

因此从旧版本升级后，无需手动编辑 settings.json，新功能所需的配置项会自动出现。

升级生产环境前，建议先备份配置（一行命令即可）：

cp data/settings.json data/settings.json.bak    # 备份当前配置
# 如更新后出现异常，可随时回滚：
#   cp data/settings.json.bak data/settings.json && pm2 restart ip-query

若需回退到某个旧版本代码：

git log --oneline                 # 查看历史版本
git checkout <commit-hash>        # 切到指定版本（data/settings.json 不受影响）
pm2 restart ip-query

ip-query/
├── server.js              # Express 后端服务
├── package.json           # 项目依赖
├── .env.example           # 环境变量模板
├── nginx.conf             # Nginx 配置参考
├── lib/
│   └── settings.js        # 设置管理模块
├── data/
│   └── settings.json      # 持久化设置 (自动生成)
└── public/
    ├── index.html          # 前台页面 (中英双语)
    ├── admin.html          # 管理后台页面
    ├── css/
    │   ├── style.css       # 前台样式
    │   └── admin.css       # 管理后台样式
    └── js/
        ├── app.js          # 前台逻辑 (含 Leaflet 地图)
        └── admin.js        # 管理后台逻辑

• 需要 API Key（免费注册 / Free registration）
• 提供安全威胁评分、举报次数、Tor 检测
• 支持多 Key 轮询，提升限额
• 注册: https://www.abuseipdb.com/account/plans

• 需要 API Key（免费注册 / Free registration）
• 提供详细信息：地理位置、ASN、VPN/Proxy/Tor/威胁检测、公司信息、托管商信息
• API 格式: GET https://iplocate.io/api/lookup/{ip}?apikey=YOUR_KEY
• 文档: https://www.iplocate.io/docs

• 免费，无需 API Key
• 反向地理编码，将经纬度转换为街道地址
• 限制: 每秒 1 次请求
• 文档: https://nominatim.org/release-docs/develop/api/Reverse/

MIT © logdns