# yarrick/iodine

Official git repo for iodine dns tunnel

Repository: https://github.com/yarrick/iodine
Canonical: https://ross.abutalabs.com/products/iodine
Homepage: https://code.kryo.se/iodine
Language: C
License: ISC
License Family: permissive
Topics: dns-tunnel, iodine, dns, tunnel, vpn, hacktoberfest
Last push: 2025-09-04T19:18:00+00:00

## Health v2 (maintenance only)
Score: 50/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 40, release rhythm 35, longevity 100
- inputs: {"age_days": 5324, "days_push": 363, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7956, forks 596 (observed 2026-08-28T04:10:10.232383+00:00)

## What it is
iodine is a C client/server tool that tunnels IPv4 traffic through DNS queries, letting you get network access on firewalled connections where only DNS is allowed. It runs on Linux, macOS, BSDs, Windows, and Android, using a TUN/TAP device and supporting up to 16 simultaneous users per server.

## Use cases
- bypass firewalled wifi that only allows DNS queries
- tunnel IP traffic through a DNS server
- get internet access on a restricted captive-portal network
- set up a covert channel over DNS for pentesting
- route traffic through a DNS tunnel when outbound ports are blocked

## When to choose
- you control a domain and a public server and only DNS egress is permitted
- you need a cross-platform DNS tunnel with good throughput (up to ~1 Mbit/s downstream)
- you want a mature, well-known DNS tunneling tool for security assessments

## When to avoid
- you need high-bandwidth or low-latency tunneling
- you cannot delegate a subdomain's NS records to your server
- you need protocol compatibility across different iodine versions

## Facets
- artifact type: cli-tool
- maturity: active
- function: vpn, networking, proxy
- domain: networking, security, privacy, censorship-circumvention
- platform: windows, bsd, cli, cross-platform
- tags: dns-tunnel, ip-over-dns, tunnel, firewall-bypass, tun-tap, c, censorship-circumvention, command-line, linux, macos, android

## Member repositories
- yarrick/iodine (main) score 50

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:10.232383+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:32:37.522625+00:00, confidence not recorded.
  - readme: https://github.com/yarrick/iodine (fetched 2026-08-28T04:10:10.232383+00:00, sha 7f7fb7e6da78)
  - homepage: https://code.kryo.se/iodine (fetched 2026-08-29T08:29:44.539121+00:00, sha 9ed1b772893e)
  - site_page: https://code.kryo.se/iodine/CHANGELOG.html (fetched 2026-08-29T08:29:44.542041+00:00, sha be7b1c9a5e07)
- Data as of 2026-08-30T08:39:29.467469+00:00.