jarylc/docker-hosts-sync

Docker Hosts Sync

!Docker Hosts Sync Logo

镜像概述和主要用途

Docker Hosts Sync是一个轻量级Docker镜像，用于在容器启动和销毁时同步Docker主机的/etc/hosts文件。此应用程序使通过容器名称在Docker主机上与Docker容器进行网络通信成为可能，就像在同一网络中与其他容器通信一样。

核心功能和特性

• 超轻量级：最终Docker镜像基于scratch构建，资源占用极低
• 高效更新：仅在容器启动和销毁时更新/etc/hosts，不会通过周期性检查（如每5秒）浪费资源
• 灵活重置：提供EXIT_RESET标志，可设置退出时是否重置对/etc/hosts的修改

环境变量

技术架构

• 开发语言：golang
• Docker客户端库：https://github.com/fsouza/go-dockerclient

使用方法和配置说明

Docker Run 部署

shell
docker run -d \
  --name docker-hosts-sync \
  --privileged \
  -e EXIT_RESET=1 \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /etc/hosts:/etc/hosts \
  --restart unless-stopped \
  jarylc/docker-hosts-sync

Docker Compose 配置

docker
docker-hosts-sync:
    image: jarylc/docker-hosts-sync
    privileged: true
    environment:
      - EXIT_RESET=1
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /etc/hosts:/etc/hosts
    restart: unless-stopped

适用范围

适用于需要在Docker主机上通过容器名称直接访问容器服务的场景，无需手动配置/etc/hosts文件，简化容器网络通信配置。

路线图

请查看开放问题以获取拟议功能列表（和已知问题）。

许可证

根据MIT许可证分发。有关更多信息，请参见LICENSE。

联系方式

Jaryl Chng - ***
[***]

项目链接：[***]