jason5ng32/myip repository overview

⁠🧰 MyIP - A Better IP Toolbox

⁠👀 Features

⁠🪪 Your IP & Identity

• 🛜 IP Cards: Detects your IPv4 and IPv6 from multiple independent sources side by side — country, region, city, ASN, organization, and the IP's local time zone.
• 🔍 Query IP: Looks up the same detailed information for any IP address you're curious about.
• 🧾 IP History: Keeps a local record of the IPs you've been seen with, filterable by type and country — stored in your browser only.
• 🖥️ Browser Fingerprint: Calculates your browser fingerprint in multiple ways and shows what makes you identifiable.

⁠🕵️ Leaks & Privacy

• 🚥 WebRTC Detection: Reveals the IP address exposed during WebRTC connections — including whether your browser's privacy hardening is on.
• 🛑 DNS Leak Test: Shows which DNS endpoints resolve your queries, to evaluate the risk of DNS leaks when using VPNs or proxies.
• 📋 Security Checklist: A 258-item personal cybersecurity checklist across 12 areas, with progress saved in your browser.

⁠📡 Network Tests

• 🚦 Connectivity Check: Tests the reachability of up to 60 sites of your choice, with multi-round minimum-latency results — plus curated import lists, from country packs to AI, social, streaming, gaming, developer, and more. Based on the results, it signals whether global internet access is currently feasible for you.
• 🚀 Speed Test: Measures your download, upload, and latency against edge networks.
• ⏱️ Global Latency Test: Pings your target from probes all over the world — pick countries from all available Globalping probes, grouped by continent.
• 🚉 MTR Test: Runs MTR from globally distributed probes to see the route packets actually take.
• 🚧 Censorship Check: Shows where a website is blocked worldwide — and by what means.
• 🚏 Proxy Rule Test: Verifies that your proxy software's rule configuration works the way you intended.

⁠🔦 Lookup & Infrastructure

• 📟 DNS Resolver: Resolves a domain through multiple resolvers at once, grouped by country — an easy way to spot hijacking or contamination.
• 📓 Whois Search: Performs Whois lookups for domain names, IP addresses, and AS numbers.
• 🗄️ MAC Lookup: Identifies the vendor and details behind a physical address.
• 🧮 IP Calculator: Subnet math, notation conversions and IPv6 interface details for any IP, prefix, range or list, computed locally.
• 🛰️ ASN Info & Upstream Topology: Right on each IP card — AS details, historical announcements for the IP's prefix, and the upstream paths from its ASN to the Tier 1 backbone.
• 🛂 ASN Profile: The full picture of any AS — registration with the raw Whois record, global rank and size, traffic and connection quality, where its IPv4 space is used, every announced prefix with its RPKI status, its upstreams, peers and customers, and the internet exchanges and data centers where it is present.
• 📶 Service Status: Live availability of well-known services — Claude, OpenAI, GitHub, Cloudflare, and more — from their official status pages, with recent incidents.

⁠✨ Platform

• 📤 Shareable Reports: Turn your test results into a diagnostic report — a read-only link with auto-expiry, AI-ready Markdown, or JSON.
• ⌨️ Curl API: Get your IP from the terminal with a single curl command.
• 🌍 Earth Online: A panel broadcasting global internet outage events as they happen.
• 🌗 Dark Mode: Follows your system automatically, with a manual toggle.
• 📲 PWA: Installable as an app on your phone and as a Chrome app on your desktop.
• ⚡ Keyboard Shortcuts: Every function has one — press ? to see the list.
• 🔤 Multiple Languages: The UI ships in 6 languages, and adding yours takes one locale pack.

⁠📕 How to Use

⁠Using Docker

One command and you're up:

docker run -d -p 18966:18966 --name myip --restart always jason5ng32/myip:latest

Or click the "Deploy with Docker" button at the top of this page.

⁠Deploying in a Node Environment

Make sure you have Node.js installed, then clone the code:

git clone https://github.com/jason5ng32/MyIP.git

Install and build. This project uses pnpm — if you don't have it, install it first (npm ships with Node, so this command always works):

npm install -g pnpm
pnpm install && pnpm run build

Run:

pnpm start

The program will run on port 18966.

⁠⚙️ Configuration

docker run -d -p 18966:18966 \
  -e MAXMIND_ACCOUNT_ID="YOUR_ACCOUNT_ID" \
  -e MAXMIND_LICENSE_KEY="YOUR_LICENSE_KEY" \
  -e DATASET_AUTO_UPDATE="true" \
  -e ALLOWED_DOMAINS="your-domain.com" \
  --name myip --restart always \
  jason5ng32/myip:latest

Everything else — optional API keys, security & rate limiting, logging, Sentry, the curl API domains — is documented in the Environment Variables reference⁠.

⁠📖 Documentation

Full guides live in the MyIP Docs Center: docs.ipcheck.ing⁠

• Developer Guide⁠ — deployment, configuration, architecture, and contributing
• Knowledge Base⁠ — how to use every tool, step-by-step network diagnosis, and networking concepts

⁠🤝 Contributing

Contributions are welcome! We keep a curated set of beginner-friendly tasks — each with exact file paths, acceptance criteria, and tests that guide you to a green build:

• 🏷️ Good first issues⁠ — add a DNS resolver from your country, add curated site lists, translate the README into your language, polish translations, and more
• 🌐 TRANSLATING.md⁠ — bring the UI to your language: a locale pack plus one registry line, and a partial translation is a welcome first PR
• 📄 CONTRIBUTING.md⁠ — setup, conventions, and how PRs flow (target the dev branch)

⁠👩🏻‍💻 Advanced Usage

# IP Testing
IP-CIDR,1.0.0.2/32,Proxy,no-resolve
IP-CIDR6,2606:4700:4700::1111/128,Proxy,no-resolve
DOMAIN,4.ipcheck.ing,DIRECT
DOMAIN,6.ipcheck.ing,DIRECT
# Rule Testing
DOMAIN,ptest-1.ipcheck.ing,Proxy1
DOMAIN,ptest-2.ipcheck.ing,Proxy2
DOMAIN,ptest-3.ipcheck.ing,Proxy3
DOMAIN,ptest-4.ipcheck.ing,Proxy4
DOMAIN,ptest-5.ipcheck.ing,Proxy5
DOMAIN,ptest-6.ipcheck.ing,Proxy6
DOMAIN,ptest-7.ipcheck.ing,Proxy7
DOMAIN,ptest-8.ipcheck.ing,Proxy8

⁠💖 Sponsors & Supporters

As an open source project, I'm very grateful to the following sponsors for their support:

Sponsors

_{↳ RapidProxy — Residential proxies with 90M+ IPs, smart rotation and precise geo-targeting. From $0.55/GB, 10% off with code RAPID10}

_{↳ SwiftProxy — High-quality rotating and static residential proxies, with 90M+ residential IPs across 220+ locations worldwide. It supports HTTP(S), SOCKS5, rotating and sticky sessions, with residential proxy plans starting at just $0.7/GB. Use code PROXY90 for an additional 10% off.}

_{↳ V.PS — High-performance KVM VPS with global locations, fast connectivity, and IPv4 & IPv6 included.}

Supporters

Interested in sponsoring MyIP? Become a sponsor⁠

⁠📄 License

MIT⁠ © Jason Ng