shizukudns

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

安装

shizukudns 是一个 CLI 应用程序，推荐用以下任一方式安装。

方式一：pipx（推荐，自动隔离环境）

pipx 会为每个 CLI 工具创建独立虚拟环境，命令全局可用，不会污染系统 Python。

# 安装 pipx（Debian/Ubuntu/macOS 均可）
sudo apt install pipx          # Debian/Ubuntu
# brew install pipx            # macOS
# pip install --user pipx      # 其他系统

pipx ensurepath               # 把 ~/.local/bin 加入 PATH（仅首次）
pipx install shizukudns

安装后 myn 命令全局可用。升级用 pipx upgrade shizukudns。

方式二：venv + pip

python3 -m venv ~/.venvs/shizukudns
source ~/.venvs/shizukudns/bin/activate
pip install shizukudns
myn -v
# 之后每次使用前先 activate，或直接用 ~/.venvs/shizukudns/bin/myn

方式三：pip --break-system-packages（不推荐，仅应急）

pip install --break-system-packages shizukudns

⚠️ 仅当上述方式不可用时使用，可能影响系统 Python。

方式四：直接下载运行（无需安装）

# 下载 wheel 后用 python 直接运行，无需安装
pip download shizukudns --no-deps -d ./sd
pip install --target ./sd -r <(pip show shizukudns 2>/dev/null || echo "requests Flask")
python -c "import sys; sys.path.insert(0,'./sd'); from shizukudns.cli import main; main()" -v

安装后即可使用 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