Skip to content

Latest commit

ย 

History

1,768 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿงฐ MyIP - A Better IP Toolbox

IPCheck.ing Banner

jason5ng32%2FMyIP | Trendshift

Mentioned in Awesome Self Hosted

GitHub Repo stars GitHub forks Docker Pulls

Website PWA

CodeQL Docker Build and Push

English | ็ฎ€ไฝ“ไธญๆ–‡ | ็น้ซ”ไธญๆ–‡ | ะ ัƒััะบะธะน | Franรงais | Portuguรชs (BR)

An open-source, all-in-one IP toolbox: IP lookup from multiple sources, connectivity tests, WebRTC & DNS-leak detection, speed test, MTR, censorship checks, Whois, and more โ€” self-hostable with one Docker command.

๐Ÿ‘‰ Demo: https://ipcheck.ing

Feel free to bookmark the demo or deploy your own.

Deploy with Docker

๐Ÿ‘€ 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 and IP addresses.
  • ๐Ÿ—„๏ธ MAC Lookup: Identifies the vendor and details behind a physical address.
  • ๐Ÿ›ฐ๏ธ ASN Info & Upstream Topology: Shows AS details, historical announcements for an IP prefix, and the upstream paths from an ASN to the Tier 1 backbone.
  • ๐Ÿ“ถ 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

Important

MaxMind GeoLite2 credentials are required. They power IP geolocation and ASN lookups โ€” without them, the MaxMind source returns 503. They're free: โ†’ MaxMind Setup

Warning

ALLOWED_DOMAINS is required on a real domain. It's the hostname allowlist for the backend API โ€” without it, every request from a non-localhost domain gets 403. โ†’ Reverse Proxy & Domains

docker run -d -p 18966:18966 \
  -e MAXMIND_ACCOUNT_ID="YOUR_ACCOUNT_ID" \
  -e MAXMIND_LICENSE_KEY="YOUR_LICENSE_KEY" \
  -e MAXMIND_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

Proxy rules for checking your real IP and your proxy IP at the same time

If you're using a proxy for internet access, consider adding this rule to your proxy configuration (modify it according to your client). This setup lets you check both your real IP and the IP when using the proxy:

# 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

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

1Password

Greptile

Sentry

GitBook

v.ps

Cloudflare Project Alexandria

๐Ÿ“„ License

MIT ยฉ Jason Ng

About

The best IP Toolbox. Check your IP address & geolocation, test IP for WebRTC and DNS IP leaks, run an IP quality check, browser fingerprint check, website availability check, network speed test, global latency test, MTR test, Whois search, and more.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

11.8k stars

Watchers

35 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages