darthminion/aliddns

Ali DDNS (阿里云动态域名解析)

镜像概述

Ali DDNS 是一款轻量级的阿里云动态域名解析（DDNS）工具。该镜像采用 Golang 开发，旨在解决官方 PHP SDK 使用体验不佳的问题，提供高效、稳定的域名解析刷新服务。它支持通过 HTTP 服务（Server 模式）或命令行（CLI 模式）两种方式调用阿里云 API，自动将指定域名的解析记录更新为当前的公网 IP 地址。

核心功能与特性

• 双模式运行：支持作为后台 HTTP 服务持续运行，或作为命令行工具单次执行。
• 自动获取公网 IP：在未指定 IP 的情况下，可自动通过外部接口获取当前设备的公网 IP。
• 灵活的域名配置：支持配置主域名及子域名（RR 记录），满足多级域名解析需求。
• 低资源占用：基于 Golang 编译，镜像体积小，运行内存占用极低。

使用前提与适用范围

• 网络要求：设备必须拥有公网 IP。如果设备处于 NAT 网络后（分配的是内网 IP），则无法使用此工具，需联系运营商申请公网 IP。
• 适用场景：家庭 NAS 外网访问、内网穿透服务、个人博客动态 IP 绑定、无固定公网 IP 的 VPS 域名解析等。
• 阿里云账号：需要拥有阿里云账号，并获取具有 DNS 管理权限的 AccessKey。

---

使用方式一：作为 HTTP 服务运行 (Server 模式)

此模式需要一台外网可访问的服务器或本地设备，启动后通过 HTTP GET 请求触发域名解析更新。

环境变量配置

Docker 部署示例

使用 docker run：

bash
docker run -d \
  --name aliddns-server \
  -p 8888:8888 \
  -e ACCESS_KEY="your_access_key" \
  -e ACCESS_KEY_SECRET="your_access_key_secret" \
  -e REGION="cn-hangzhou" \
  darthminion/aliddns

使用 docker-compose：

yaml
version: "3"

services:
  aliddns-server:
    image: darthminion/aliddns
    container_name: aliddns-server
    restart: always
    ports:
      - "8888:8888"
    environment:
      - ACCESS_KEY=your_access_key
      - ACCESS_KEY_SECRET=your_access_key_secret
      - REGION=cn-hangzhou

API 请求说明

服务启动后，可通过发送 GET 请求来触发解析更新。

请求格式： GET http://<host>:<port>/?domain_name=<主域名>&rr=<子域名>

参数说明：

• domain_name (必填)：要解析的主域名（例如 example.com），注意不是完整的子域名。
• rr (选填)：解析的 RR 值（子域名前缀），默认为 @。例如填写 blog，则最终解析的完整域名为 blog.example.com。

请求示例：

bash
# 将 example.com 解析到当前公网 IP
curl 'http://localhost:8888/?domain_name=example.com&rr=@'

# 将 blog.example.com 解析到当前公网 IP
curl 'http://localhost:8888/?domain_name=example.com&rr=blog'

---

使用方式二：作为命令行工具运行 (CLI 模式)

此模式适用于通过 Cron 定时任务或自动化脚本单次触发解析更新。

命令参数说明

基础命令格式：

bash
aliddns sync <主域名> [flags]

Flags 参数：

(提示：可通过 aliddns sync --help 查看完整的命令行帮助信息。)

运行示例

1. 直接在 Docker 中执行单次命令：

bash
docker run --rm \
  -e ACCESS_KEY="your_access_key" \
  -e ACCESS_KEY_SECRET="your_access_key_secret" \
  darthminion/aliddns \
  aliddns sync example.com --rr='blog'

此命令将自动获取当前公网 IP，并将 blog.example.com 解析到该 IP。

2. 指定固定 IP 进行解析：

bash
docker run --rm \
  -e ACCESS_KEY="your_access_key" \
  -e ACCESS_KEY_SECRET="your_access_key_secret" \
  darthminion/aliddns \
  aliddns sync example.com --ip='203.0.113.10' --rr='@'