一款轻量级的ddns程序DDNS
自动更新 DNS 解析到本机 IP 地址,支持 IPv4/IPv6,内网/公网 IP,自动创建 DNS 记录
主要特性
🚀 多平台支持
- Docker: 推荐方式,支持
amd64、arm64、arm/v7等多架构 (使用文档 ) - 二进制文件: 单文件运行,支持 Windows/Linux/macOS (下载地址 )
- pip 安装:
pip install ddns - 源码运行: 无依赖,仅需 Python 环境
⚙️ 灵活配置
- 命令行参数:
ddns --dns=dnspod --id=xxx --token=xxx(配置文档 ) - JSON 配置文件: 支持多域名、多服务商配置,支持远程URL配置 (配置文档 )
- 环境变量: Docker 友好的配置方式 (配置文档 )
🌍 DNS 服务商支持
- 国内: 阿里DNS ⚡、阿里云ESA ⚡、DNSPOD 、腾讯云DNS ⚡、腾讯云EdgeOne ⚡、华为云DNS ⚡、DNS.COM
- 国际: Cloudflare 、DNSPOD国际版 、HE.net 、NameSilo 、No-IP
- 自定义: 回调 API 、调试模式
⚡ 表示支持 HMAC-SHA256 企业级安全认证 | 查看所有服务商
🔧 高级功能
- 多域名和多级域名解析
- IPv4/IPv6 双栈支持
- 自动创建 DNS 记录
- 内网/公网 IP 自动检测
- HTTP 代理和多代理切换
- 本地缓存减少 API 调用
- 定时任务 和日志管理
因为不怎么喜欢docker,所以直接使用二进制,
apt-get install pipx
pipx install ddns
ln -sf /root/.local/pipx/venvs/ddns/bin/ddns /usr/local/bin/ddns
ddns task
安装ddns systemctl服务
cat /etc/systemd/system/ddns.service
[Unit]
Description=auto-update v4.1.3 installed on 2026-07-03 21:01:16
After=network.target
[Service]
Type=oneshot
WorkingDirectory=/root
ExecStart=/root/.local/pipx/venvs/ddns/bin/python -m ddns --config /file/ddns/config.json
config.json的配置文件参考
{
"$schema": "https://ddns.newfuture.cc/schema/v4.1.json",
"dns": "cloudflare",
"token": "api-token",
"ipv6": [
"你的域名"
],
"index6": [
"shell:ip -6 route show default | awk '{print $5}' | head -1 | xargs -I{} ip -6 addr show dev {} scope global | grep -v 'fdeb\\|fd7a\\|fe80\\|2a09\\|fdcc\\|t
emporary' | grep -oP '(?<=inet6 )[0-9a-f:]+(?=/)' | head -1",
"url:https://v6.myip.la",
"url:https://api-ipv6.ip.sb/ip"
],
"ipv4": [],
"index4": [],
"ttl": 600,
"proxied": false,
"cache": true,
"log": {
"level": "INFO"
}
}
搞定~ 官方仓库地址:https://github.com/NewFuture/DDNS