Docker环境下PowerDNS集成Lua记录与API管理实现GSLB的配置指导

阿华AIGC实验室

2026-4-20

我来帮你梳理下在Docker化的PowerDNS环境里，集成Lua记录实现GSLB并启用API动态管理的具体步骤，结合你提供的mysql后端docker-compose配置来调整：

一、调整Docker Compose配置，启用API与Lua支持

首先，你原来的docker-compose-mysql.yml里的PowerDNS服务需要调整配置，开启API、Lua记录支持，同时挂载自定义的Lua脚本并切换到mysql后端（文件后端不支持API动态更新）：

修改PDNS服务的环境变量与挂载项
在pdns服务的environment里添加以下参数：

environment:
  - PDNS_gmysql_host=mysql
  - PDNS_gmysql_user=pdns
  - PDNS_gmysql_password=pdns
  - PDNS_gmysql_dbname=pdns
  # 启用API配置
  - PDNS_api=yes
  - PDNS_api_key=your_secure_random_key_here # 替换为你的安全API密钥
  - PDNS_webserver=yes
  - PDNS_webserver_address=0.0.0.0
  - PDNS_webserver_port=8081
  # 启用Lua记录支持
  - PDNS_lua_records=yes
  - PDNS_lua_script_file=/etc/powerdns/gslb.lua
  # 指定mysql作为后端（替代原文件后端）
  - PDNS_backend=gmysql

然后在volumes里添加Lua脚本的挂载：

volumes:
  - ./gslb.lua:/etc/powerdns/gslb.lua # 宿主机的Lua脚本挂载到容器内
  # 保留原mysql数据挂载等配置

同时暴露API端口：

ports:
  - "53:53/tcp"
  - "53:53/udp"
  - "8081:8081/tcp" # API端口映射到宿主机

二、编写Lua GSLB逻辑脚本

在宿主机创建gslb.lua文件，写入适合你的GSLB逻辑，比如根据客户端IP返回不同后端节点，或者实现轮询/加权负载均衡：

-- 示例：根据客户端IP段返回对应GSLB节点
function preresolve(dq)
    -- 获取客户端请求的IP地址
    local client_ip = dq.remoteaddr:toString()
    
    -- 自定义国内IP段判断（可替换为实际的IP库或数据库查询）
    local cn_ip_prefixes = {"106.", "113.", "114.", "120."}
    local is_china = false
    for _, prefix in ipairs(cn_ip_prefixes) do
        if client_ip:sub(1, #prefix) == prefix then
            is_china = true
            break
        end
    end
    
    -- 返回对应节点，支持添加多个实现负载均衡
    if is_china then
        dq:addAnswer("A", "1.1.1.1", 60) -- 国内节点IP
        dq:addAnswer("A", "1.1.1.2", 60) -- 备用国内节点
    else
        dq:addAnswer("A", "2.2.2.2", 60) -- 海外节点IP
    end
    
    return true -- 中断默认解析流程，使用Lua返回的结果
end

-- 可选：从mysql读取节点实现动态加权轮询
-- function preresolve(dq)
--     -- 连接mysql查询可用节点（需确保PDNS容器能访问mysql服务）
--     local db = pdns.Mysql.new("mysql", "pdns", "pdns", "pdns")
--     local node_list = db:query("SELECT ip, weight FROM gslb_nodes WHERE active=1 ORDER BY weight DESC")
--     -- 这里可添加加权轮询逻辑选择节点
--     dq:addAnswer("A", node_list[1].ip, 60)
--     return true
-- end

三、API动态管理配置与记录

启用API后，你可以通过HTTP请求完成区域创建、记录更新等操作，适配容器化环境的无文件管理需求：

测试API连通性
使用curl验证API是否正常工作：

curl -H "X-API-Key: your_secure_random_key_here" http://localhost:8081/api/v1/servers/localhost

创建新区域
比如创建example.com主区域：

curl -X POST -H "X-API-Key: your_secure_random_key_here" -H "Content-Type: application/json" \
http://localhost:8081/api/v1/servers/localhost/zones \
-d '{
    "name": "example.com.",
    "kind": "Master",
    "nameservers": ["ns1.example.com.", "ns2.example.com."]
}'