本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

mietzen/porkbun-ddns

porkbun-ddns是Porkbun域名的非***DDNS客户端，用于动态更新域名的A（IPv4）和AAAA（IPv6）记录，仅在IP变更或记录不存在时执行更新。

0 次下载activemietzen镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

porkbun-ddns Docker镜像文档

镜像概述

porkbun-ddns是一个非***的Porkbun域名DDNS（动态域名系统）客户端。该工具用于动态更新Porkbun域名的DNS记录，仅在公网IP发生变更或记录不存在时执行更新操作，同时支持设置和更新A记录（IPv4）与AAAA记录（IPv6）。

免责声明：本工具与Porkbun无任何关联或开发关系。所有商标、徽标和品牌名称均为其各自所有者的财产。本工具中使用的所有公司、产品和服务名称仅用于识别目的，不表示认可。

核心功能与特性

智能更新机制：仅在公网IP发生变更或DNS记录不存在时执行更新操作，减少不必要的API请求
双协议支持：同时支持A记录（IPv4）和AAAA记录（IPv6）的更新
灵活的IP获取方式：
- 手动指定静态公网IP
- 通过Fritz!BOX设备自动获取公网IP
可配置更新间隔：自定义DNS记录检查和更新的时间间隔（秒）
多子域名支持：可同时管理多个子域名（含多级子域名）的DNS记录

使用场景

适用于需要将Porkbun域名动态解析到当前公网IP的场景，特别是：

家庭网络或小型办公网络，使用动态公网IP
需要通过域名访问本地服务（如NAS、服务器），但IP频繁变化
同时需要IPv4和IPv6解析支持的环境

使用方法与配置说明

基本部署方式

推荐使用Docker Compose进行部署，以下是完整配置示例：

version: "3"
services:
  porkbun-ddns:
    image: "mietzen/porkbun-ddns:latest"
    container_name: porkbun-ddns
    environment:
      DOMAIN: "domain.com" # 你的Porkbun主域名
      SUBDOMAINS: "my_subdomain,my_other_subdomain,my_subsubdomain.my_subdomain" # 子域名，多个用逗号分隔
      SECRETAPIKEY: "<YOUR-SECRETAPIKEY>" # 你的Porkbun Secret-API-Key
      APIKEY: "<YOUR-APIKEY>" # 你的Porkbun API-Key
      # PUBLIC_IPS: "1.2.3.4,2001:043e::1" # 可选，静态公网IP，IPv4和IPv6用逗号分隔
      # FRITZBOX: "192.168.178.1" # 可选，Fritz!BOX路由器IP，用于获取公网IP
      # SLEEP: "300" # 可选，更新间隔（秒），默认300秒
      # IPV4_ONLY: "FALSE" # 可选，是否仅更新IPv4记录，默认FALSE
      # IPV6_ONLY: "FALSE" # 可选，是否仅更新IPv6记录，默认FALSE
      # DEBUG: "FALSE" # 可选，是否启用调试日志，默认FALSE
    restart: unless-stopped

环境变量配置说明

环境变量	必选	说明
DOMAIN	是	Porkbun主域名（如`example.com`）
SUBDOMAINS	是	子域名列表，多个子域名用逗号分隔，支持多级子域名（如`sub,sub.sub2`）
SECRETAPIKEY	是	Porkbun账户的Secret API Key（从Porkbun控制台获取）
APIKEY	是	Porkbun账户的API Key（从Porkbun控制台获取）
PUBLIC_IPS	否	静态公网IP，格式为IPv4和IPv6用逗号分隔（如`1.2.3.4,2001:db8::1`）
FRITZBOX	否	Fritz!BOX路由器IP地址，用于自动获取公网IP（如`192.168.1.1`）
SLEEP	否	DNS检查和更新间隔（秒），默认300秒（5分钟）
IPV4_ONLY	否	是否仅更新IPv4记录，设为`TRUE`时禁用IPv6记录更新，默认`FALSE`
IPV6_ONLY	否	是否仅更新IPv6记录，设为`TRUE`时禁用IPv4记录更新，默认`FALSE`
DEBUG	否	是否启用调试日志，设为`TRUE`可输出详细调试信息，默认`FALSE`

注意事项

API密钥获取：需从Porkbun账户控制台生成API Key和Secret API Key，确保该密钥具有域名DNS管理权限。
IP获取优先级：若同时配置PUBLIC_IPS和FRITZBOX，则PUBLIC_IPS优先生效。
子域名格式：子域名无需包含主域名，如主域为example.com，子域名sub将生成sub.example.com记录。
重启策略：推荐使用unless-stopped确保容器在后台持续运行，实现DNS自动更新。

示例配置场景

场景1：基本动态IP配置

environment:
  DOMAIN: "home.example.com"
  SUBDOMAINS: "server,nas"
  SECRETAPIKEY: "sk***abcdef"
  APIKEY: "pk***abcdef"
  SLEEP: "600" # 每10分钟检查一次

场景2：通过Fritz!BOX获取IP

environment:
  DOMAIN: "example.com"
  SUBDOMAINS: "router"
  SECRETAPIKEY: "sk***abcdef"
  APIKEY: "pk***abcdef"
  FRITZBOX: "192.168.178.1" # Fritz!BOX路由器IP

场景3：静态IP配置

environment:
  DOMAIN: "example.com"
  SUBDOMAINS: "static"
  SECRETAPIKEY: "sk***abcdef"
  APIKEY: "pk***abcdef"
  PUBLIC_IPS: "192.0.2.1,2001:db8::1" # 静态IPv4和IPv6地址