Docker环境中反向DNS解析失败问题求助

问题重现 #

我编写了一段Go代码用于获取完全限定主机名：

func FullyQualifiedHostname() (string, error) {
    // 1. Get the machine hostname. Example: localhost
    hostname, err := os.Hostname()
    if err != nil {
        return "", fmt.Errorf("FullyQualifiedHostname: failed to retrieve the hostname of this machine: %v", err)
    }

    // 2. Look up the IP address for that hostname. Example: 127.0.0.1
    ips, err := net.LookupHost(hostname)
    if err != nil {
        return "", fmt.Errorf("FullyQualifiedHostname: failed to lookup the IP of this machine's hostname (%v): %v", hostname, err)
    }

    if len(ips) == 0 {
        return "", fmt.Errorf("FullyQualifiedHostname: lookup of the IP of this machine's hostname (%v) did not return any IP address", hostname)
    }

    // If multiple IPs are returned, we only look at the first one.
    localIP := ips[0]

    // 3. Reverse lookup the IP. Example: localhost.localdomain
    resolvedHostnames, err := net.LookupAddr(localIP)
    if err != nil {
        return "", fmt.Errorf("FullyQualifiedHostname: failed to reverse lookup this machine's local IP (%v): %v", localIP, err)
    }

    if len(resolvedHostnames) == 0 {
        return "", fmt.Errorf("FullyQualifiedHostname: reverse lookup of this machine's local IP (%v) did not return any hostnames", localIP)
    }
    
    return strings.TrimSuffix(resolvedHostnames[0], "."), nil
}

将这段代码放在Docker容器中运行时，出现以下错误：

FullyQualifiedHostname: failed to reverse lookup this machine's local IP (192.168.65.3): lookup 3.65.168.192.in-addr.arpa. on 192.168.65.7:53: no such host

问题原因 #

Docker默认桥接网络中，分配给容器的IP通常没有对应的PTR反向DNS记录，DNS服务器无法通过IP反向解析出主机名，导致net.LookupAddr调用失败。即使手动指定DNS配置，只要该服务器没有对应IP的PTR记录，问题依然存在。

解决方案 #

方案1：修改代码，添加反向解析失败的 fallback（推荐） #

放弃强制依赖反向解析，当反向解析失败时，通过主机名+默认域名后缀（或环境变量指定的后缀）生成FQDN，避免程序崩溃。修改后的代码如下：

import (
    "os"
    "fmt"
    "net"
    "strings"
)

func FullyQualifiedHostname() (string, error) {
    hostname, err := os.Hostname()
    if err != nil {
        return "", fmt.Errorf("FullyQualifiedHostname: failed to retrieve hostname: %v", err)
    }

    // 尝试正向解析主机名到IP
    ips, err := net.LookupHost(hostname)
    if err != nil || len(ips) == 0 {
        // 正向解析失败，直接返回主机名+默认后缀
        domainSuffix := os.Getenv("DOMAIN_SUFFIX")
        if domainSuffix == "" {
            domainSuffix = "local"
        }
        return fmt.Sprintf("%s.%s", hostname, domainSuffix), nil
    }

    localIP := ips[0]
    // 尝试反向解析IP到主机名
    resolvedHostnames, err := net.LookupAddr(localIP)
    if err != nil || len(resolvedHostnames) == 0 {
        // 反向解析失败，使用主机名+自定义后缀
        domainSuffix := os.Getenv("DOMAIN_SUFFIX")
        if domainSuffix == "" {
            domainSuffix = "local"
        }
        return fmt.Sprintf("%s.%s", hostname, domainSuffix), nil
    }

    return strings.TrimSuffix(resolvedHostnames[0], "."), nil
}

运行容器时可通过环境变量指定域名后缀：

docker run -e DOMAIN_SUFFIX=example.com your-image

方案2：配置Docker容器的FQDN与DNS #

如果必须依赖反向解析，需要确保容器的IP有对应的PTR记录：

1. 运行容器时指定主机名和域名，生成合法FQDN：

docker run --hostname myapp --domainname example.com your-image

2. 确保你的DNS服务器中，为容器分配的IP配置了指向myapp.example.com的PTR记录。

方案3：通过hosts文件跳过DNS解析 #

直接在容器的hosts文件中添加IP与FQDN的映射，让程序优先使用本地解析：

docker run --add-host myapp.example.com:192.168.65.3 your-image

注意替换192.168.65.3为容器实际分配的IP，或为容器配置固定IP。

内容的提问来源于stack exchange，提问作者Ezio