shizukudns

DNSHE 免费域名 API 全栈管理工具（CLI + Web）。命令为 myn，覆盖 DNSHE Free Domain API v2.0 全部 18 个接口。

安装

pip install shizukudns

安装后即可使用 myn 命令。

快速开始

# 添加一个 DNSHE 账号（API Key + Secret）
myn account add 我的账号 cfsd_xxxxxxxxxx yyyyyyyyyyyy

# 查看配额
myn quota

# 列出子域名
myn sub list

# 启动 Web 管理界面
myn web
# 指定端口（--host 用于定义端口）
myn web --host 8080

命令总览

全局

账号管理 (account)

myn account list                                   # 列出账号
myn account add <name> <api_key> <api_secret>       # 添加账号
myn account use <id>                                # 设为默认
myn account remove <id>                             # 删除账号
myn account show [id]                               # 查看详情

子域名 (sub)

myn sub list [page=1] [per_page=20] [search=xxx] [status=active]
myn sub get <subdomain_id>
myn sub register <subdomain> <rootdomain>
myn sub renew <subdomain_id>
myn sub delete <subdomain_id>

DNS 记录 (dns)

myn dns list <subdomain_id>
myn dns create <subdomain_id> <type> <content> [name=@] [ttl=600] [priority=10]
myn dns update <id> [type=A] [content=...] [ttl=600]
myn dns delete <id|record_id>

API 密钥 (keys)

myn keys list
myn keys create <key_name> [ip_whitelist=...]
myn keys regenerate <key_id>
myn keys delete <key_id>

配额 / WHOIS / 永久升级

myn quota
myn whois <domain>
myn upgrade list
myn upgrade create <subdomain_id>
myn upgrade assist <assist_code>
myn upgrade cancel <request_id>

操作日志

myn logs [page=1] [per_page=20] [endpoint=...] [success=true]
myn logs clear

Web 界面

myn web 启动一个本地 Flask 服务，提供与 CLI 等价的全功能图形界面：

• 仪表盘：配额概览 + 调用统计 + 端点分布 + 最近动态
• 子域名：筛选 / 排序 / 分页 / 注册 / 续期 / 删除 / 导出 CSV
• DNS 记录：8 种记录类型（A/AAAA/CNAME/MX/TXT/NS/SRV/CAA）
• API 密钥：创建 / 列表 / 重置 Secret / 删除
• 配额 / WHOIS / 永久升级
• 账号切换：侧边栏一键切换
• 内置终端：Web 版命令行
• 操作日志：6 维筛选 + 详情 + 导出 CSV
• 深色模式：跟随系统或手动切换

数据存储

配置与日志存储在 ~/.shizukudns/：

• config.json — 账号列表（API Key + Secret）
• logs.db — SQLite 操作日志

可通过环境变量 SHIZUKUDNS_HOME 自定义数据目录。

覆盖的 API

覆盖 DNSHE Free Domain API v2.0 全部 18 个接口：

技术栈

• Python ≥ 3.9
• requests — HTTP 客户端
• Flask — Web 界面
• SQLite — 操作日志存储（Python 内置）

License

MIT