cxbdasheng/dnet repository overview

⁠主要功能

• 动态 CDN 管理 (DCDN)： 根据 IP 变化自动更新 CDN 源站，支持阿里云（CDN、DCDN、ESA）、腾讯云（CDN、EdgeOne）、百度云（CDN、DRCDN）、Cloudflare、又拍云、自定义回调（Callback）
• 动态 DNS 管理 (DDNS)： 根据 IP 变化自动更新 DNS 解析，支持 A / AAAA / CNAME / TXT 记录，支持阿里云、腾讯云、百度云、Cloudflare、华为云、Dnspod、NameSilo、GoDaddy、DNSLA、Porkbun、自定义回调（Callback）。DNSLA 和 Porkbun 均支持上述四种记录类型；Porkbun 需开启目标域名的 API 访问。两者均要求同名同类型只有一条受管理记录，多条时会报错而不修改；CNAME 不能与同名其他记录同时配置。
• 端口转发 (DPF)： IPv4 / IPv6 入口转发到指定 IP 或域名，支持来源白名单、连接 / 会话数限制、超时设置和运行日志，支持 TCP/UDP 协议。
• Web 服务 (DWS)： 支持反向代理、URL 跳转、HTTP 重定向和在线测速，支持 IPv4 / IPv6 双栈监听、多域名共用端口、WebSocket、HTTPS 入口和访问认证。
• SSL 证书管理（DSSL）： 独立管理上传证书、本地证书文件及 ACME 自动申请和续期，支持 Let's Encrypt、HTTP 和 Cloudflare / 阿里云 / 腾讯云 DNSPod DNS。
• Webhook 通知： 实时推送 IP 变更通知
• Web 管理界面： 可视化配置和管理

⁠界面

⁠快速开始

⁠方式一：使用二进制文件

⁠1. 下载安装

从 Releases⁠ 页面下载适合您系统的版本并解压。

⁠2. 安装为系统服务

Mac/Linux:

sudo ./dnet -s install

Windows（管理员权限）：

.\dnet.exe -s install

⁠3. 访问 Web 界面

浏览器访问 http://localhost:9877 进行配置。

⁠服务管理

# 卸载服务
sudo ./dnet -s uninstall          # Mac/Linux
.\dnet.exe -s uninstall           # Windows (管理员)

# 重启服务
sudo ./dnet -s restart            # Mac/Linux
.\dnet.exe -s restart             # Windows (管理员)

⁠高级选项

安装服务时可以指定以下参数：

使用示例：

# 自定义同步间隔和配置文件路径
./dnet -s install -f 300 -c /path/to/config.yaml

# 重置密码
./dnet -resetPassword 123456

⁠方式二：使用 Docker

Linux（推荐 Host 模式）：

docker run -d --name dnet --net=host -v /opt/dnet:/root --restart=always cxbdasheng/dnet:latest

macOS / Windows（端口映射）：

docker run -d --name dnet -p 9877:9877 -v /opt/dnet:/root --restart=always cxbdasheng/dnet:latest

常用命令：

# 重置密码
docker exec dnet ./dnet -resetPassword 123456 && docker restart dnet

# 查看日志
docker logs -f dnet

本地构建镜像：

make docker          # 使用容器内 Go 工具链构建 dnet:<version>，不会推送
make docker-buildx   # 将四平台 OCI archive 输出到 dist/

make docker-buildx 会先检查当前 Buildx builder 是否支持全部目标平台；若缺少 linux/arm/v7 等平台，请启用 Docker Desktop 的 QEMU/binfmt 仿真，或切换到兼容的 builder。推送镜像必须显式指定目标，例如 make docker-push PUSH_IMAGE=example.com/user/dnet。

⁠方式三：从源码构建

make build                              # 构建当前平台
goreleaser build --snapshot --clean     # 构建所有平台
go run main.go                          # 直接运行

⁠Webhook 通知

支持的变量：

请求方式：

• RequestBody 为空 → 发送 GET 请求
• RequestBody 不为空 → 发送 POST 请求

配置示例：

• 钉钉机器人

  • 钉钉群设置 -> 智能群助手 -> 添加机器人 -> 自定义
  • 安全设置勾选 自定义关键词，关键词需包含在 RequestBody 中，如：D-NET
  • URL 中输入钉钉提供的 Webhook 地址
  • RequestBody 中输入

    {
      "msgtype": "markdown",
      "markdown": {
        "title": "D-NET 同步通知",
        "text": "#### D-NET 同步通知 \n - 服务类型：#{serviceType} \n - 服务名称：#{serviceName} \n - 更新结果：#{serviceStatus} \n - 变更明细：#{changeDetail} \n - 主机名称：#{hostname} \n - 通知时间：#{datetime} \n"
      }
    }
    

    Copy
• 飞书

  • 飞书电脑端 -> 群设置 -> 添加机器人 -> 自定义机器人
  • 安全设置只勾选 自定义关键词，输入的关键字必须包含在 RequestBody 的 content 中，如：D-NET
  • URL 中输入飞书给你的 Webhook 地址
  • RequestBody 中输入

    {
      "msg_type": "post",
      "content": {
        "post": {
          "zh_cn": {
            "title": "D-NET 同步通知",
            "content": [
              [{"tag": "text", "text": "服务类型：#{serviceType}"}],
              [{"tag": "text", "text": "服务名称：#{serviceName}"}],
              [{"tag": "text", "text": "更新结果：#{serviceStatus}"}],
              [{"tag": "text", "text": "变更明细：#{changeDetail}"}],
              [{"tag": "text", "text": "主机名称：#{hostname}"}],
              [{"tag": "text", "text": "通知时间：#{datetime}"}]
            ]
          }
        }
      }
    }
    

    Copy
• Server酱

  • 在 Server酱⁠ 获取 SendKey
  • URL 中输入

    https://sctapi.ftqq.com/[SendKey].send?title=D-NET通知&desp=#{serviceName} - #{serviceStatus} - #{changeDetail}
    

    Copy
  • RequestBody 留空（发送 GET 请求）
• pushplus 推送加

  • 在 pushplus⁠ 获取 token
  • URL 中输入 https://www.pushplus.plus/send
  • RequestBody 中输入

    {
      "token": "your token",
      "title": "D-NET 同步通知",
      "content": "#### D-NET 同步通知 \n - 服务类型：#{serviceType} \n - 服务名称：#{serviceName} \n - 更新结果：#{serviceStatus} \n - 变更明细：#{changeDetail} \n - 主机名称：#{hostname} \n - 通知时间：#{datetime} \n"
    }
    

    Copy
• Discord

  • Discord 任意客户端 -> 服务器 -> 频道设置 -> 整合 -> 查看 Webhook -> 新 Webhook -> 复制 Webhook 网址
  • URL 中输入 Discord 复制的 Webhook 网址
  • RequestBody 中输入

    {
      "content": "D-NET 同步通知",
      "embeds": [
        {
          "description": "#### D-NET 同步通知 \n - 服务类型：#{serviceType} \n - 服务名称：#{serviceName} \n - 更新结果：#{serviceStatus} \n - 变更明细：#{changeDetail} \n - 主机名称：#{hostname} \n - 通知时间：#{datetime}",
          "color": 15258703,
          "author": {"name": "D-NET"},
          "footer": {"text": "D-NET #{serviceStatus}"}
        }
      ]
    }
    

    Copy
• 微信

  • 通过 微信 ClawBot 协议⁠ 推送消息到微信
  • 需要先通过协议获取 $your_bot_token 和 $your_user_id，可参考 weixin-bot-api⁠
  • URL 中输入 https://ilinkai.weixin.qq.com/ilink/bot/sendmessage
  • RequestBody 中输入

    {
      "msg": {
        "from_user_id": "",
        "to_user_id": "[email protected]",
        "client_id": "dnet-#{timestamp}",
        "message_type": 2,
        "message_state": 2,
        "item_list": [
          {
            "type": 1,
            "text_item": {
              "text": "📡 D-NET 同步通知\n   服务类型：#{serviceType}\n   服务名称：#{serviceName}\n   更新结果：#{serviceStatus}\n   变更明细：#{changeDetail}\n   主机名称：#{hostname}\n   通知时间：#{datetime}"
            }
          }
        ]
      },
      "base_info": {
        "channel_version": "2.1.7"
      }
    }
    

    Copy
  • Headers 中输入

    Content-Type: application/json
    AuthorizationType: ilink_bot_token
    Authorization: Bearer $your_bot_token
    iLink-App-Id: bot
    iLink-App-ClientVersion: 131335
    

    Copy

⁠反向代理与客户端 IP

默认仅使用连接来源地址判断客户端 IP，不信任客户端提供的 X-Forwarded-For 和 X-Real-IP。 通过反向代理部署时，请设置环境变量 DNET_TRUSTED_PROXIES，以逗号分隔可信代理的 IP 或 CIDR，例如 127.0.0.1,::1,10.0.0.2/32。 仅填写实际代理地址，不要将所有客户端网段加入可信列表。代理应覆盖 X-Real-IP，或在 X-Forwarded-For 末尾追加真实连接来源地址。 程序从右向左检查转发链，取第一个不受信任的地址作为客户端 IP；可信代理缺少有效客户端信息时，无法通过“禁止公网访问”检查。

⁠贡献与许可

欢迎贡献代码或提出建议，详见 贡献指南⁠。本项目采用 MIT⁠ 许可证。