ipSentinel部署教程：多功能IP网络诊断工具，基于Cloudflare Workers搭建

前言

ipSentinel 是一个基于 Cloudflare Workers 的单文件网络诊断工具。它提供了 IP 查询、连通性测试、WebRTC 隐私检测、风险评分等功能，零服务器即可部署使用。

功能特点

功能 说明
🌐 IP 多维信息查询 客户端 IP、国家、城市、ISP、ASN、数据中心、经纬度
🔗 连通性测试 自动检测国内外网络，测试 Google、YouTube、GitHub 或百度、B站、抖音等
🔒 WebRTC 隐私检测 检测 WebRTC 泄露风险，检查代理/VPN/Tor/数据中心身份
📊 风险评分 基于 ipapi.is 的风险评分，判断 IP 是否被标记
🌙 暗黑模式 支持明暗主题切换
📱 PWA 支持 可添加到手机桌面，像原生 App 一样使用
🗺️ 地图定位 通过 Google Maps 显示 IP 地理位置
🌍 中英双语 支持中文和英文界面切换

技术栈

类别 技术
运行平台 Cloudflare Workers / Pages
前端框架 React 18（CDN 加载）
前端样式 Tailwind CSS（CDN 加载）
IP 数据 Cloudflare request.cf、ip.sb、ipapi.is、ping0.cc

准备工作

  • Cloudflare 账号 — 注册 Cloudflare
  • GitHub 账号 — 用于 Fork 仓库（Pages + GitHub 部署方式需要）

部署方式（三种可选）

方式一：Workers 一键部署（最简单）

  1. 登录 Cloudflare Dashboard
  2. 进入 Workers 和 Pages → 创建应用程序 → 创建 Worker
  3. 给 Worker 起个名字（例如 ip-sentinel）
  4. 点击 部署，然后点击 编辑代码
  5. 打开 ipSentinel _worker.js，复制全部代码
  6. 粘贴到 Worker 编辑器中，覆盖原有代码
  7. 点击 部署 保存

这是最简单的部署方式，适合快速体验。

方式二：Pages 上传资源

  1. 在本地创建一个名为 public 的文件夹
  2. 下载 _worker.js 文件，放到 public 文件夹内
  3. 进入 Cloudflare Dashboard → Workers 和 Pages → Pages → 上传资产
  4. 将 public 文件夹拖拽上传，点击 部署站点

方式三：Pages + GitHub（推荐）

  1. 访问 ipSentinel 项目，点击 Fork
  2. 进入 Cloudflare Dashboard → Workers 和 Pages → Pages → 连接到 Git
  3. 授权后选择你 Fork 的 ipSentinel 仓库
  4. 构建命令和构建输出目录都留空
  5. 点击 保存并部署

配置环境变量（可选）

部署完成后，在 Worker 或 Pages 的 设置 → 环境变量 中添加以下变量（添加后需重新部署）：

变量名 说明 示例值
TITLE 页面标题 IP SENTINEL
NAME 英文名称（副标题） DollSenior
NAMECN 中文名称（副标题） 玩偶学长
SHORT 英文简称 DollSenior
SHORTCN 中文简称 玩偶🧸
DIBUEN 英文页脚版权 IP SENTINEL · DollSenior Edition
DIBUCN 中文页脚版权 IP SENTINEL · 玩偶学长定制版

💡 如果不配置环境变量，页面将使用默认值。

使用教程

1. 访问页面

部署完成后，访问你的 Worker 或 Pages 域名，即可看到 ipSentinel 的主界面。

2. IP 查询

打开页面会自动显示你的公网 IP 信息，包括：

  • IP 地址（IPv4 和 IPv6）
  • 所在国家、城市
  • ISP 和 ASN 信息
  • 是否来自数据中心
  • 经纬度坐标

3. 连通性测试

页面会自动检测你所处的网络环境：

  • 海外网络：测试 Google、YouTube、OpenAI、GitHub 连通性
  • 中国网络：测试百度、Bilibili、抖音、微信连通性

4. WebRTC 隐私检测

检测浏览器 WebRTC 是否可能泄露真实 IP 地址，评估隐私风险。

5. 风险评分

基于 ipapi.is 的数据，评估当前 IP 的风险等级，判断是否被标记为代理、VPN、Tor 或数据中心 IP。

常见问题

位置信息不准确？

request.cf 属性依赖于 Cloudflare 的 IP 数据库，位置信息仅供参考，不保证完全精确。

第三方 API 有限制？

ipSentinel 使用了 ip.sb、ipapi.is、ping0.cc 等第三方免费 API，它们有各自的速率限制，大流量场景可能需要更换 API。

如何绑定自定义域名？

在 Worker 或 Pages 的 触发器 → 自定义域名 中添加你的域名即可。

参考资料