如何为Docker内启动的嵌套Docker容器配置可解析主机名

你当前属于Docker嵌套运行场景：测试任务本身运行在Docker容器内，再通过testcontainers-go启动业务子容器。你在ContainerRequest里设置的Hostname: "server"仅会修改子容器自身的主机名配置，不会自动在测试进程所在容器的DNS解析表中添加对应记录，且默认配置下testcontainers启动的子容器和运行测试的外层容器不在同一个自定义Docker网络内，自然无法通过http://server:9000连通。

方案1：共用自定义Docker网络（最稳定，支持固定主机名访问） #

这是嵌套Docker场景下最推荐的方案，配置完成后可直接用固定主机名通信，不需要动态获取地址：

1. 提前创建一个自定义Docker网络，将运行测试任务的外层容器加入该网络；
2. 调整testcontainers容器请求配置，移除硬编码的Hostname字段，增加网络关联和网络别名配置，注意同步修正端口配置：

req := testcontainers.ContainerRequest{
    Image:        "my-image",
    // 同网络内容器通信不需要配置宿主机端口映射，仅声明容器内部监听端口即可
    ExposedPorts: []string{"9000/tcp"},        
    SkipReaper: true,
    WaitingFor: wait.
        ForLog("Server started").
        WithPollInterval(time.Second * 10).
        WithStartupTimeout(time.Minute * 10),
    RegistryCred: getRegistryCred(),
    // 替换为你提前创建的、测试容器已加入的自定义网络名称/ID
    Networks: []string{"your-test-shared-network"},
    // 配置网络别名，该别名就是测试容器内可直接解析的主机名
    NetworkAliases: map[string][]string{
        "your-test-shared-network": {"server"},
    },
}

3. 配置校验点：
   • 不要在ExposedPorts里写9000:9000这种宿主机端口映射格式，同网络下容器直接通过内部端口通信，端口映射仅对宿主机访问生效
   • 确保运行测试的外层容器已经提前加入配置的共享网络，否则依然无法解析别名
   • 配置完成后直接在测试代码中访问http://server:9000即可正常连通，不需要额外修改hosts或DNS配置

方案2：动态获取映射地址访问（无需配置共享网络） #

如果不方便调整容器网络配置，可以放弃固定主机名，通过testcontainers提供的API动态获取子容器的可访问地址：

// 启动子容器后拿到容器实例
c, err := testcontainers.GenericContainer(ctx, testcontainers.GenericContainerRequest{
    ContainerRequest: req,
    Started:          true,
})
if err != nil {
    panic(err)
}
// 获取子容器映射到当前可访问层级的主机IP
host, err := c.Host(ctx)
if err != nil {
    panic(err)
}
// 获取9000端口映射后的实际访问端口
mappedPort, err := c.MappedPort(ctx, "9000/tcp")
if err != nil {
    panic(err)
}
// 实际访问地址拼接格式：http://{host}:{mappedPort.Port()}

该方案的缺点是无法使用固定的server主机名，每次容器启动后端口、IP都可能变化，适合对访问地址没有固定要求的场景。

方案3：动态写入hosts记录（不推荐） #

如果必须使用http://server:9000固定地址，且无法调整网络配置，可以在拿到子容器的可访问IP后，在测试代码中动态修改外层测试容器的/etc/hosts文件，将server域名指向子容器IP。但该方案需要测试容器持有修改系统hosts文件的权限，兼容性和稳定性差，不推荐在CI环境使用。

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