Porkbun DDNS 使用教程

Porkbun DDNS 使用教程

porkbun-ddnsporkbun-ddns is an unoffical DDNS-Client for Porkbun Domains.项目地址:https://gitcode.com/gh_mirrors/po/porkbun-ddns

项目介绍

porkbun-ddns 是一个非官方的动态域名解析（DDNS）客户端，专门为 Porkbun 域名服务设计。该项目允许用户通过简单的配置更新其域名的 DNS 记录，支持 IPv4 和 IPv6。它提供了 Python 库、Docker 容器以及命令行接口（CLI），使得用户可以轻松地集成和使用。

项目快速启动

安装

首先，确保你已经安装了 Python 3.10 或更高版本。然后，通过 pip 安装 porkbun-ddns：

pip install porkbun-ddns

配置文件

创建一个配置文件 config.json，内容如下：

{
  "endpoint": "https://porkbun.com/api/json/v3",
  "apikey": "pk1_xxx",
  "secretapikey": "sk1_xxx"
}

使用 CLI

更新域名 example.com 的 DNS 记录：

porkbun-ddns -c config.json example.com my_subdomain

应用案例和最佳实践

案例一：家庭网络动态 IP 更新

如果你有一个家庭网络，其公网 IP 经常变化，可以使用 porkbun-ddns 来保持你的域名始终指向正确的 IP 地址。

最佳实践

1. 定期更新：设置一个 cron 任务，定期运行 porkbun-ddns 以确保 DNS 记录始终是最新的。
2. 安全配置：确保你的 API 密钥和密钥 API 密钥存储在安全的地方，避免泄露。

典型生态项目

Docker 容器

porkbun-ddns 提供了 Docker 容器，使得部署更加方便。以下是一个 docker-compose.yml 示例：

version: "3"
services:
  porkbun-ddns:
    image: "mietzen/porkbun-ddns:latest"
    container_name: porkbun-ddns
    environment:
      DOMAIN: "example.com"
      SUBDOMAINS: "my_subdomain,my_other_subdomain"
      SECRETAPIKEY: "<YOUR-SECRETAPIKEY>"
      APIKEY: "<YOUR-APIKEY>"

通过运行以下命令启动容器：

docker-compose up -d

这样，你的域名 DNS 记录将会自动更新。

---

通过以上步骤，你可以快速启动并使用 porkbun-ddns 项目，确保你的域名始终指向正确的 IP 地址。

porkbun-ddnsporkbun-ddns is an unoffical DDNS-Client for Porkbun Domains.项目地址:https://gitcode.com/gh_mirrors/po/porkbun-ddns