neilpang/docker-hoster

Hoster

镜像概述和主要用途

Hoster是一个轻量级工具，旨在解决本地Docker容器的名称解析问题。它通过在主机的/etc/hosts文件中自动注入容器相关条目，使主机能够直接通过容器名称、主机名、容器ID或网络别名访问运行中的Docker容器，无需手动配置DNS或修改hosts文件。

核心功能和特性

• 自动容器注册：监听Docker事件，容器启动时自动在/etc/hosts中添加条目，容器停止时自动移除
• 多别名支持：默认注册容器的名称、主机名、容器ID以及所有网络别名
• 动态更新：实时响应容器的启动/停止事件，保持/etc/hosts文件与容器状态同步
• 简单部署：通过Docker容器运行，仅需挂载必要的Docker socket和hosts文件

使用场景和适用范围

• 本地Docker开发环境，需要通过名称而非IP地址访问容器
• 多容器应用开发，需在主机上直接通过容器名称进行服务间通信
• 简化本地测试环境的网络配置，避免手动管理/etc/hosts文件

使用方法和配置说明

基本部署命令

通过以下命令启动Hoster容器：

bash
docker run -d \
    -v /var/run/docker.sock:/tmp/docker.sock \
    -v /etc/hosts:/tmp/hosts \
    docker.xuanyuan.run/dvdarias/docker-hoster

参数说明：

• -v /var/run/docker.sock:/tmp/docker.sock：挂载Docker socket，使Hoster能够监听Docker事件
• -v /etc/hosts:/tmp/hosts：挂载主机的/etc/hosts文件，实现对其的修改权限

容器注册示例

当启动具有以下配置的容器时：

bash
docker run --restart=unless-stopped -d \
    --name myname \
    --hostname myhostname \
    --network somenetwork --network-alias "myserver.com" \
    mycontainer

Hoster会自动在主机的/etc/hosts中添加以下条目（IP为容器实际IP）：

<容器IP>  myname myhostname <容器ID> myserver.com

此时，主机可通过myname、myhostname、容器ID或myserver.com访问该容器。

扩展功能

如需更高级功能（如systemd集成、DNS转发等），可参考https://hub.docker.com/r/mgood/resolvable/镜像。

注意事项

• 运行Hoster需要对主机/etc/hosts文件有写权限，通过挂载实现
• 仅支持运行中的Docker容器，停止的容器会自动从/etc/hosts中移除
• 容器名称、主机名或网络别名中包含特殊字符可能导致解析异常