jusaba/dns Docker 镜像 - 轩辕镜像

miniDynDns客户端Docker镜像

镜像概述和主要用途

本镜像为miniDynDns的客户端实现，用于在DNS服务器上动态更新主机的IP地址。适用于需要保持DNS记录与主机当前IP一致的场景，支持同时配置多个DNS服务器，通过环境变量灵活设置，并定期自动刷新IP信息。

核心功能和特性

• 多DNS服务器支持：可配置任意数量的DNS服务器，通过环境变量统一管理
• 定期IP刷新：自定义刷新间隔（分钟），自动执行IP更新
• 灵活配置方式：支持两种服务器配置模式（推荐的逗号分隔变量或兼容旧版本的编号变量）
• 环境变量驱动：所有配置通过环境变量注入，无需修改容器内部文件
• 轻量级基础：基于debian:bookworm-slim，体积小且资源占用低

使用场景和适用范围

适用于主机IP地址可能动态变化的环境，需要保持DNS记录实时更新的场景，例如：

• 家庭服务器或个人主机使用动态公网IP
• 需要从互联网访问的本地设备
• 多DNS服务器架构下的IP同步需求

安装方法

拉取镜像

bash
docker pull jusaba/dns:latest

镜像构建说明

依赖文件

构建镜像需准备以下文件：

Dockerfile

dockerfile
FROM debian:bookworm-slim

ENV TZ=Europe/Madrid

LABEL version=2.0
LABEL autor=Julian_Salas

RUN apt-get update -y && \
    apt-get upgrade -y && \
    apt-get install -y --no-install-recommends \
        cron \
        python3 \
        python3-requests && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

COPY ./start.sh /home/pi/ip/start.sh
WORKDIR /home/pi/ip

CMD ["bash", "start.sh"]

start.sh脚本

bash
#!/bin/bash
# /home/pi/ip/start.sh
# 支持任意数量的DNS服务器
# 服务器通过SERVIDORES变量传入，以逗号分隔
# 示例: SERVIDORES=dns1.com,dns2.com,dns3.com
# 或通过servidor1, servidor2等变量（兼容旧版本）

rm -f /home/pi/ip/ActualizaDNS.py
touch /home/pi/ip/ActualizaDNS.py
rm -f /var/spool/cron/crontabs/root
touch /var/spool/cron/crontabs/root

# 生成获取公网IP并发送更新请求的Python脚本
echo "import requests" >> /home/pi/ip/ActualizaDNS.py
echo "from requests.auth import HTTPBasicAuth" >> /home/pi/ip/ActualizaDNS.py
echo "" >> /home/pi/ip/ActualizaDNS.py
echo "# 获取公网IP" >> /home/pi/ip/ActualizaDNS.py
echo "try:" >> /home/pi/ip/ActualizaDNS.py
echo "    myip = requests.get('[***] timeout=10).text.strip()" >> /home/pi/ip/ActualizaDNS.py
echo "except:" >> /home/pi/ip/ActualizaDNS.py
echo "    myip = requests.get('[***] timeout=10).text.strip()" >> /home/pi/ip/ActualizaDNS.py
echo "" >> /home/pi/ip/ActualizaDNS.py

# 使用SERVIDORES变量（推荐方式）
if [ -n "$SERVIDORES" ]; then
    echo "$SERVIDORES" | tr ',' '\n' | while read servidor; do
        servidor=$(echo "$servidor" | tr -d ' ')
        if [ -n "$servidor" ]; then
            echo "requests.get(f'[***]{servidor}:8001/?myip={myip}', auth=HTTPBasicAuth('$host', '$password'))" >> /home/pi/ip/ActualizaDNS.py
        fi
    done
else
    # 使用编号变量（兼容旧版本）
    i=1
    while true; do
        eval servidor=\$servidor$i
        if [ -z "$servidor" ]; then
            break
        fi
        echo "requests.get(f'[***]{servidor}:8001/?myip={myip}', auth=HTTPBasicAuth('$host', '$password'))" >> /home/pi/ip/ActualizaDNS.py
        i=$((i + 1))
    done
fi

# 配置定时任务
service cron stop
chmod 600 /var/spool/cron/crontabs/root
echo "*/${refresco} * * * * python3 /home/pi/ip/ActualizaDNS.py" >> /var/spool/cron/crontabs/root
service cron reload
cron -f

手动构建（多平台）

使用buildx构建多平台镜像：

bash
docker buildx build --platform=linux/amd64,linux/arm64,linux/arm/v7 -t jusaba/dns:latest . --push

自动构建（GitHub Actions）

项目包含GitHub Actions工作流，在以下情况自动构建并推送镜像：

• 推送至main分支
• 创建格式为v*的标签（如v1.0.0）
• 手动触发

需配置GitHub Secrets：

• DOCKER_USERNAME：Docker Hub用户名
• DOCKER_PASSWORD：Docker Hub密码或访问令牌

容器启动与配置

环境变量说明

启动方式

方式1：使用SERVIDORES变量（推荐）

bash
docker run -e host=lleida \
           -e refresco=1 \
           -e password=passlleida \
           -e SERVIDORES=dns1.com,dns2.com \
           -d --name dns jusaba/dns:latest

方式2：使用编号变量（兼容旧版本）

bash
docker run -e host=lleida \
           -e refresco=1 \
           -e password=passlleida \
           -e servidor1=dns1.com \
           -e servidor2=dns2.com \
           -d --name dns jusaba/dns:latest

方式3：使用.env文件

创建parametros.env文件：

env
host=lleida
refresco=1
password=passlleida
SERVIDORES=dns1.com,dns2.com

启动容器：

bash
docker run --env-file parametros.env -d --name dns jusaba/dns:latest

作者

Julián Salas Barolome - 开发与文档

许可协议

本项目可作为miniDynDns客户端自由使用。