iamluc/docker-hostmanager

docker-hostmanager

镜像概述

docker-hostmanager 是一个自动更新系统 hosts 文件（如 /etc/hosts）的工具，旨在简化对运行中 Docker 容器的访问。其设计灵感来源于 vagrant-hostmanager，支持通过容器名称、网络别名等方式配置自定义访问域名。

项目主页：https://github.com/iamluc/docker-hostmanager

使用方法

Linux

最简单的方式是直接使用 Docker 镜像：

console
$ docker run -d --name docker-hostmanager --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /etc/hosts:/hosts iamluc/docker-hostmanager

注意：--restart=always 选项会使容器随系统自动启动（推荐配置）。

Mac OS

从 https://github.com/iamluc/docker-hostmanager/releases 下载 PHAR 可执行文件，然后运行：

console
$ sudo php docker-hostmanager.phar synchronize-hosts

注：由于需要写入 /etc/hosts 文件，命令需以 root 权限运行。若不想使用 root，可配置用户对该文件的写入权限。

运行前需导出 Docker 环境变量，例如：

console
$ eval $(docker-machine env mybox)

同时，需添加路由以访问 VM 内的容器：

console
$ sudo route -n add 172.0.0.0/8 $(docker-machine ip $(docker-machine active))

Windows

若主机未使用 Docker ToolBox 或非 Windows 10 专业版，需将 /c/Windows 文件夹挂载到 VirtualBox：

console
$ docker run -d --name docker-hostmanager --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /c/Windows/System32/drivers/etc/hosts:/hosts iamluc/docker-hostmanager

运行容器后，需添加路由以访问容器子网：

console
$ route /P add 172.17.0.0/12 192.168.99.100

配置说明

基于网络的配置

当容器属于至少一个网络（通常在使用版本 ≥2 的 docker-compose.yml 时），访问容器的名称格式为 容器名称.网络名称，也支持网络别名。

示例 1（默认网络）：

yaml
version: '2'

services:
    web:
        image: docker.xuanyuan.run/iamluc/symfony
        volumes:
            - .:/var/www/html

若 docker-compose 项目名为 myapp，容器 web 可通过 web.myapp_default 访问。

示例 2（自定义网络名称和别名）：

yaml
version: '3.5'

networks:
    default:
        name: myapp

services:
    web:
        image: docker.xuanyuan.run/iamluc/symfony
        volumes:
            - .:/var/www/html

    mysql:
        image: docker.xuanyuan.run/mysql
        networks:
            default:
                aliases:
                    - bdd

• web 容器可通过 web.myapp 访问
• mysql 容器可通过 mysql.myapp 或 bdd.myapp 访问

无网络配置

当容器未定义网络（仅使用默认 "bridge" 网络）时，可通过容器名称 + 默认顶级域名（.docker）访问。此场景适用于单容器 docker 命令运行或版本 1 的 docker-compose.yml。

通过 DOMAIN_NAME 环境变量可添加额外主机：

console
$ docker run -d -e DOMAIN_NAME=test.com,www.test.com my_image

测试

运行测试命令：

console
$ vendor/bin/phpunit

许可证

https://opensource.org/licenses/MIT