A high-performance IP intelligence and network connectivity diagnostic suite built as a unified Cloudflare Worker with Static Assets.
๐ Website: https://ip.ii2d.com
Most IP lookup tools query a single remote server. my-ip-info cross-validates IP data across your self-hosted Cloudflare edge backend, public APIs (Cloudflare Trace, ipify, ipwho.is, IP.SB, ip.guide, SeeIP, icanhazip.com, IPIP.net), and browser WebRTC STUN candidates to detect VPN/proxy leaks, diagnose coordinate variations across geolocation databases, and measure real-time latency.
- โก Unified Cloudflare Worker: Front-end (React SPA) and Edge API (Hono) deploy together under a single origin. Static assets are served via Cloudflare's edge cache (free & unlimited quota), while API requests run on the edge.
- โก Zero-Latency Edge Intelligence: Automatically extracts city, region, coordinates, ASN (
AS6327), ISP organization, and airport datacenter code (colo) directly from the edge TLS connection without external database lookups. - ๐บ๏ธ Geolocation Convergence Map: Interactive dark Leaflet map plotting coordinates reported by each provider to visualize database discrepancies.
- ๐ก๏ธ Dual-Stack WebRTC & DNS Leak Inspector: Interrogates STUN ICE candidates (IPv4/IPv6) and resolves one-time nonce subdomains to uncover upstream DNS resolvers and detect VPN/proxy leaks.
- ๐ Local IP Connection History: 100% on-device timeline tracking with automatic deduplication, manual snapshots, and safe CSV / JSON data export.
- โ๏ธ Custom Endpoints & Provider Toggles: Enable or disable specific public providers, or register user-defined private backend endpoints in in-app settings.
- โฑ๏ธ Latency & Network Benchmark: Measures round-trip time (RTT) to global Anycast edge nodes.
- ๐ฑ Progressive Web App (PWA): Installable directly from the browser on desktop and mobile with standalone window support, offline UI shell caching, and automatic refetching on network reconnect.
- ๐ค AI-Agent & SEO Ready: Implements
/llms.txtand/llms-full.txtmachine-readable standards, high-resolution Open Graph / Twitter preview cards, Schema.orgWebApplication&FAQPageJSON-LD structured data, XML sitemap (/sitemap.xml), and pre-rendered semantic HTML fallback for crawlers.
my-ip-info can be installed directly as a standalone desktop or mobile application without needing third-party app stores.
- Zero App Store Friction: Install immediately without having to search, download, or authenticate through the Apple App Store or Google Play Store.
- Cross-Platform Consistency: Provides a unified, native app experience across macOS, Windows, Linux, iOS, and Android from a single shared web standard.
- Fast App Launch & Offline Shell: Static app shell assets (HTML, CSS, JS, fonts, and icons) are pre-cached locally using Workbox Service Workers, delivering near-instant loading even on slow or intermittent network connections.
- Always-Fresh Network Diagnostics: Specifically architected with strict cache-busting and API bypass rules (
navigateFallbackDenylist) so dynamic IP and geo lookups are never served from stale caches. Real-time window focus and network reconnect listeners automatically re-probe your IP when toggling VPNs or switching Wi-Fi networks.
- Desktop (Chrome / Edge / Brave / Opera): Click the Install icon in the browser address bar (or navigate to menu
...โ Install my-ip-info). The application will launch in its own dedicated, borderless desktop window and can be pinned to your Dock or Taskbar. - Desktop (Safari on macOS Sonoma+): Go to File โ Add to Dock.
- Mobile (iOS Safari): Tap the Share button (box with an upward arrow) โ scroll down and tap Add to Home Screen.
- Mobile (Android Chrome): Tap the menu
โฎโ select Add to Home screen or Install app.
my-ip-info/
โโโ src/
โ โโโ client/ # React SPA (components, hooks, styling)
โ โโโ server/ # Cloudflare Worker entrypoint & Hono API (/api/v1/*, CLI detection)
โ โโโ shared/ # Shared TypeScript types and IP utilities
โโโ public/ # Static assets, favicon, redirects
โโโ test/ # Unit tests (node:test)
โโโ index.html # SPA entry HTML
โโโ vite.config.ts # Client build configuration
โโโ wrangler.toml # Unified Cloudflare Worker configuration with [assets]
โโโ Dockerfile # Standalone Node/Docker server image
pnpm install# Boot frontend (http://localhost:5173) and Cloudflare Worker (http://localhost:8787) concurrently
pnpm dev
# Or run services individually:
pnpm dev:client # Vite SPA with HMR (proxies /api to :8787)
pnpm dev:worker # Cloudflare Worker via Wrangler / workerd
pnpm dev:node # Standalone Node.js server (:3000)Native git pre-commit hooks (.githooks/pre-commit) automatically format and lint staged changes with Biome via lint-staged, run TypeScript typechecks, and execute unit tests prior to committing:
pnpm test # Run 51 unit tests across core, worker pipeline, and providers
pnpm test:coverage # Run tests with V8 code coverage report
pnpm typecheck # Validate TypeScript types without emit
pnpm lint # Check code against Biome rules
pnpm lint:fix # Automatically apply Biome safe fixes
pnpm format # Format codebase with Biome
pnpm format:check # Verify code formatting
pnpm pre-commit # Run pre-commit checks on staged files (lint-staged)Deploying requires zero environment variables:
# Build frontend and deploy unified worker
pnpm deployWrangler will authenticate via your browser or respect your standard CLOUDFLARE_API_TOKEN environment variable.
Cloudflare Workers isolates local dev environment variables from deployed production secrets:
- Local Development:
wrangler devautomatically reads.env. - Production Deployment:
wrangler deploydoes not upload.env. To upload your secret directly from.envwithout manual typing:Secrets can also be added via the Cloudflare Dashboard (Workers & Pages > my-ip-info > Settings > Variables and Secrets).pnpm run secret:ip2location
To bind a custom domain in your Cloudflare zone, uncomment the route in wrangler.toml:
routes = [
{ pattern = "ip.yourdomain.com", custom_domain = true }
]Cloudflare Workers will automatically configure the DNS record and provision SSL certificates with zero external tools needed.
The frontend can be deployed independently to GitHub Pages via .github/workflows/pages.yml. The build supports customizable GitHub Actions variables (set via Settings โ Secrets and variables โ Actions โ Variables):
| Variable | Description | Default |
|---|---|---|
VITE_BACKEND_URL / BACKEND_URL |
Cloudflare Worker or backend API endpoint URL | https://my-ip-info.ii2d-dev.workers.dev |
FRONTEND_DOMAIN / CUSTOM_DOMAIN |
Custom domain written to CNAME for GitHub Pages |
ip.ii2d.com |
ENABLE_IP2LOCATION |
Enable or disable IP2Location.io provider ('true' / 'false') |
true |
VITE_BASE_PATH |
Base path for GitHub Pages if not using root custom domain | / |
Manual workflow runs via workflow_dispatch also provide optional inputs to override backend_url and frontend_domain on demand.
To delete the deployed worker and its assets:
pnpm undeploy # or: npx wrangler deleteAll backend API routes are versioned under /api/v1 and served from https://my-ip-info.ii2d-dev.workers.dev:
| Route | Method | Content-Type | Description |
|---|---|---|---|
/ |
GET |
text/html or text/plain |
Serves React SPA to browsers (https://ip.ii2d.com); returns raw client IP to CLI tools via Cloudflare Worker (curl -sL https://my-ip-info.ii2d-dev.workers.dev) |
/ip |
GET |
text/plain; charset=utf-8 |
Shorthand endpoint returning raw public IP with defensive security headers (curl -sL https://my-ip-info.ii2d-dev.workers.dev/ip) |
https://my-ip-info.ii2d-dev.workers.dev/api/v1/info |
GET |
text/plain or application/json or text/yaml |
Smart content negotiation: returns plaintext for CLI or JSON for browsers. Supports explicit query override: ?format=json, ?format=yaml, ?format=text, ?format=ip |
https://my-ip-info.ii2d-dev.workers.dev/api/v1/ip |
GET |
text/plain; charset=utf-8 |
Returns raw public client IP address with a trailing newline |
https://my-ip-info.ii2d-dev.workers.dev/api/v1/geo |
GET |
application/json |
Geolocation data (city, region, country, lat/lon, ASN, datacenter colo) |
https://my-ip-info.ii2d-dev.workers.dev/api/v1/yaml |
GET |
text/yaml; charset=utf-8 |
Client metadata and network details formatted as safe YAML |
https://my-ip-info.ii2d-dev.workers.dev/api/v1/health |
GET |
application/json |
Health check endpoint returning status and provider identifier |
https://my-ip-info.ii2d-dev.workers.dev/api/v1/indexnow |
GET |
application/json |
IndexNow protocol configuration, host mapping, and endpoints |
https://my-ip-info.ii2d-dev.workers.dev/api/v1/indexnow |
POST |
application/json |
Dispatches IndexNow push notifications for changed URLs |
/e860aba3b4ba1700c1f44fa0abd9376f.txt |
GET |
text/plain |
IndexNow site ownership key verification file |
/llms.txt |
GET |
text/plain; charset=utf-8 |
Machine-readable context summary for LLMs, search engines, and AI agents |
/llms-full.txt |
GET |
text/plain; charset=utf-8 |
Exhaustive technical specification, API schemas, and diagnostic algorithms for AI reasoning |
/sitemap.xml |
GET |
application/xml |
XML sitemap for search engine crawlers |
/robots.txt |
GET |
text/plain |
Crawler and AI bot access policies |
IndexNow is an open protocol that enables website owners to immediately notify participating search engines (Microsoft Bing, Yandex, Seznam.cz, Naver) whenever pages are added, updated, or deleted.
- Verification Key: Hosted at
https://ip.ii2d.com/e860aba3b4ba1700c1f44fa0abd9376f.txt - CLI Submission:
# Submit all URLs from public/sitemap.xml to IndexNow pnpm run indexnow # Test submission payload locally without sending network requests pnpm run indexnow:dry-run
- Automated Deployment: GitHub Actions runs IndexNow notification automatically on every production deploy in
.github/workflows/pages.yml. - API Endpoint:
GET /api/v1/indexnowinspects current protocol metadata, whilePOST /api/v1/indexnowaccepts custom batch URL submission.
MIT License. Contributions and PRs welcome!