billghifun/gogdns repository overview

# 检查占用 53 端口的进程
sudo lsof -i :53

# 若为 systemd-resolved 占用，可修改 /etc/systemd/resolved.conf
# 将 DNSStubListener 设置为 no，然后重启服务：
sudo systemctl restart systemd-resolved

sudo mkdir -p /opt/gogdns

docker run -d \
  --name gogdns \
  --restart unless-stopped \
  --network host \
  --cap-add=NET_BIND_SERVICE \
  --cap-add=NET_ADMIN \
  -e TZ=Asia/Shanghai \
  -e GOGDNS_BASE_PATH=/gogdns/workstation \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /opt/gogdns:/gogdns/workstation \
  billghifun/gogdns:latest

services:
  gogdns:
    image: billghifun/gogdns:latest  # 镜像名称
    container_name: gogdns  # 容器名称
    restart: unless-stopped  # 自动重启
    # 权限优化：精简 Capability
    cap_add:
      - NET_BIND_SERVICE  # 网络管理权限 允许绑定 53 低位端口
      - NET_ADMIN         # 如果不需要在容器内修改宿主机路由表，可以尝试去掉 NET_ADMIN 以增强安全性

    # 网络模式
    network_mode: host    # DNS 服务使用 host 模式性能最高，且避免了 NAT 转换带来的源 IP 丢失

    # 环境变量
    environment:
      - TZ=Asia/Shanghai     # 推荐通过环境变量传递时区，配合 Dockerfile 中的 tzdata
      - GOGDNS_BASE_PATH=/gogdns/workstation    # 环境变量设置基础路径

    # 存储卷优化
    volumes:
      # Docker 守护进程访问
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 建议设为只读 (ro)
      
      # 数据目录映射
      # 注意：宿主机路径建议使用绝对路径/path/gogdns
      # 需要用户自行确认目录/path/gogdns存在
      - /opt/gogdns:/gogdns/workstation

docker-compose up -d