henetdns

README

henetdns

CLI tool for Hurricane Electric hosted DNS management.

中文文档

Installation

go install github.com/momaek/henetdns/cmd/henetdns@latest

Configuration

Configure via command-line flags or environment variables:

Flag	Environment	Description
--base-url	HENETDNS_BASE_URL	HE DNS base URL (default: https://dns.he.net)
--db-path	HENETDNS_DB_PATH	SQLite db path (default: ~/.config/henetdns/client.db)
--username	HE_USERNAME or HE_EMAIL	Account username
--password	HE_PASS	Account password
--timeout	HENETDNS_TIMEOUT	HTTP timeout (default: 20s)

Usage

Login

henetdns login --username your_username
# Password will be prompted if not provided via --password or HE_PASS

List Zones

henetdns zones list
henetdns zones list --json
henetdns zones list --cache-only
henetdns zones list --refresh

List Records

henetdns records list --zone example.com
henetdns records list --zone 123456 --json
henetdns records list --zone example.com --cache-only
henetdns records list --zone example.com --refresh

Cache Behavior

• Default list behavior is cache-first. It reads local SQLite cache first, then falls back to remote fetch when cache is empty.
• --cache-only reads only local cache and never sends remote requests.
• --refresh bypasses local cache, always fetches from remote, and refreshes cache.
• --cache-only and --refresh cannot be used together.

Upsert Record

Create record if not exists (exact match by type, name, value, and priority for MX):

henetdns records upsert \
  --zone example.com \
  --type A \
  --name www \
  --value 192.168.1.1 \
  --ttl 300

henetdns records upsert \
  --zone example.com \
  --type MX \
  --name @ \
  --value mail.example.com \
  --priority 10 \
  --priority-set

Delete Record

Delete exact matching record:

henetdns records delete \
  --zone example.com \
  --type A \
  --name www \
  --value 192.168.1.1

Supported Record Types

• A
• AAAA
• TXT
• CNAME
• MX

Data Storage

Session cookies and cached data are stored in SQLite at ~/.config/henetdns/client.db by default.