如何在Keycloak Docker容器中修改/etc/hosts及解决编辑器缺失问题

方法一：启动容器时直接添加host映射（推荐） #

Docker提供--add-host参数，可在启动容器时直接向/etc/hosts注入主机记录，无需进入容器编辑。执行以下命令启动Keycloak：

docker run -d --name keycloak --add-host ldap.demo.local:127.0.0.1 quay.io/keycloak/keycloak:latest start-dev

这条命令会自动在容器的/etc/hosts中添加127.0.0.1 ldap.demo.local的映射，且容器重启后依然有效。

方法二：向运行中的容器临时添加host记录 #

如果容器已经在运行，可以通过docker exec结合echo命令直接追加内容到/etc/hosts（默认镜像自带基础shell命令）：

docker exec -it keycloak sh -c "echo '127.0.0.1    ldap.demo.local' >> /etc/hosts"

注意：这种方式仅临时生效，容器重启后记录会消失，适合临时测试场景。

方法三：自定义Keycloak镜像（持久化修改或添加编辑工具） #

如果需要永久保留host映射，或者希望容器内有编辑工具（如vi/nano），可以自定义镜像：

方式1：直接在镜像中添加host记录 #

创建Dockerfile：

FROM quay.io/keycloak/keycloak:latest
RUN echo '127.0.0.1    ldap.demo.local' >> /etc/hosts

构建镜像并运行：

docker build -t my-keycloak .
docker run -d --name keycloak my-keycloak start-dev

方式2：安装编辑工具 #

如果需要后续能手动编辑/etc/hosts，在Dockerfile中添加安装命令（Keycloak基于RHEL系镜像，使用microdnf）：

FROM quay.io/keycloak/keycloak:latest
RUN microdnf install -y nano vi && microdnf clean all

构建后启动容器，就能用vi/nano编辑/etc/hosts了。

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