grachev/docker-hosts-updater

docker-hosts-updater镜像说明

镜像概述

本镜像用于自动管理主机的/etc/hosts文件，当带有特定标签的Docker容器启动或停止时，自动添加或移除对应的主机名与容器IP的映射关系，帮助开发者在本地环境中快速访问容器服务，无需手动修改hosts文件。

核心功能

1. 动态更新hosts：监听容器生命周期事件，自动维护hosts文件
2. 多主机名支持：通过分号分隔添加多个主机名映射
3. 子域名批量配置：使用{sub1,sub2}.domain格式快速生成子域名映射
4. 优先级冲突解决：通过优先级参数指定同名主机名的优先容器
5. 负载均衡映射：支持将主机名指向指定容器或固定IP

使用场景

• 本地开发环境中快速访问容器化服务（如Web应用、API接口）
• 需要自定义容器主机名的场景
• 多环境隔离时的主机名管理
• 需通过负载均衡容器转发流量的场景

配置说明

启动镜像

bash
docker run -d --restart=always \
    --name docker-hosts-updater \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /etc/hosts:/opt/hosts \
    grachev/docker-hosts-updater

容器标签使用示例

1. 基础映射

bash
docker run -d --label ru.grachevko.dhu=nginx.local nginx
# 测试：ping nginx.local

2. 多主机名

bash
docker run -d --label ru.grachevko.dhu="nginx.local;nginx.ru" nginx
# 测试：ping nginx.local 或 ping nginx.ru

3. 子域名

bash
docker run -d --label ru.grachevko.dhu="{www,api}.nginx.local" nginx
# 测试：ping www.nginx.local 或 ping api.nginx.local

4. 优先级设置

bash
docker run -d --label ru.grachevko.dhu="nginx.local" nginx  # 默认优先级0
docker run -d --label ru.grachevko.dhu="nginx.local:10" nginx  # 优先级10（更高）
# 访问nginx.local将指向优先级更高的容器

5. 负载均衡映射

bash
# 启动负载均衡容器
docker run -d --name lb nginx
# 映射到负载均衡容器
docker run -d --label ru.grachevko.dhu="nginx1.local:0:lb" nginx
# 映射到固定IP
docker run -d --label ru.grachevko.dhu="nginx2.local:0:127.0.0.1" nginx
# 测试：ping nginx1.local（指向lb容器IP）或 ping nginx2.local（指向127.0.0.1）

注意：该工具仅在原生Linux环境有效，macOS/Windows需通过负载均衡方式使用（因Docker运行在虚拟机中无法直接访问容器IP）。