konradkleine/docker-registry-frontend

docker-registry-frontend 镜像文档

镜像概述

docker-registry-frontend 是一个基于浏览器的解决方案，用于浏览和修改私有Docker仓库。该镜像仅支持Docker Registry V2版本，V1版本已弃用且不再接收重要更新。当前V2版本仍在积极开发中，部分功能可能尚未实现，建议使用前查看项目Issues了解最新状态。

核心功能与特性

• 提供浏览器可视化界面，支持浏览私有Docker仓库内容
• 支持仓库和标签的管理操作
• 可配置SSL加密，保障数据传输安全
• 集成Kerberos认证，增强访问控制
• 支持浏览模式（仅查看，无管理功能）
• 可自定义每页显示的仓库数量

使用场景

适用于需要对私有Docker Registry进行可视化管理的开发和运维团队，方便查看仓库内容、管理镜像标签，以及通过浏览器进行日常操作。

使用方法与配置说明

基本使用

通过以下命令启动容器，连接到指定的Docker Registry：

bash
sudo docker run \
  -d \
  -e ENV_DOCKER_REGISTRY_HOST=ENTER-YOUR-REGISTRY-HOST-HERE \
  -e ENV_DOCKER_REGISTRY_PORT=ENTER-PORT-TO-YOUR-REGISTRY-HOST-HERE \
  -p 8080:80 \
  konradkleine/docker-registry-frontend:v2

参数说明：

• -e ENV_DOCKER_REGISTRY_HOST：Docker Registry的主机地址
• -e ENV_DOCKER_REGISTRY_PORT：Docker Registry的端口
• -p 8080:80：将容器的80端口映射到主机的8080端口

启动后，通过浏览器访问 http://localhost:8080 即可使用。

连接使用SSL加密的Docker Registry

若Docker Registry通过HTTPS访问（如位于代理后），使用以下命令：

bash
sudo docker run \
  -d \
  -e ENV_DOCKER_REGISTRY_HOST=ENTER-YOUR-REGISTRY-HOST-HERE \
  -e ENV_DOCKER_REGISTRY_PORT=ENTER-PORT-TO-YOUR-REGISTRY-HOST-HERE \
  -e ENV_DOCKER_REGISTRY_USE_SSL=1 \
  -p 8080:80 \
  konradkleine/docker-registry-frontend:v2

参数说明：

• -e ENV_DOCKER_REGISTRY_USE_SSL=1：启用SSL连接到Docker Registry

为前端启用SSL加密

若需为前端本身启用SSL，使用以下命令：

bash
sudo docker run \
  -d \
  -e ENV_DOCKER_REGISTRY_HOST=ENTER-YOUR-REGISTRY-HOST-HERE \
  -e ENV_DOCKER_REGISTRY_PORT=ENTER-PORT-TO-YOUR-REGISTRY-HOST-HERE \
  -e ENV_USE_SSL=yes \
  -v $PWD/server.crt:/etc/apache2/server.crt:ro \
  -v $PWD/server.key:/etc/apache2/server.key:ro \
  -p 443:443 \
  konradkleine/docker-registry-frontend:v2

参数说明：

• -e ENV_USE_SSL=yes：启用前端SSL
• -v $PWD/server.crt:/etc/apache2/server.crt:ro：挂载SSL证书
• -v $PWD/server.key:/etc/apache2/server.key:ro：挂载SSL密钥
• -p 443:443：映射HTTPS端口

启动后，通过 https://localhost访问。

将前端作为Registry代理

若Docker Registry仅在本地可访问（如监听127.0.0.1），可将前端作为代理，并自定义显示的主机和端口：

bash
sudo docker run \
  -d \
  -e ENV_DOCKER_REGISTRY_HOST=localhost \
  -e ENV_DOCKER_REGISTRY_PORT=5000 \
  -e ENV_REGISTRY_PROXY_FQDN=ENTER-YOUR-APPLICATION-HOST-HERE \
  -e ENV_REGISTRY_PROXY_PORT=ENTER-PORT-TO-YOUR-APPLICATION-HOST-HERE \
  -e ENV_USE_SSL=yes \
  -v $PWD/server.crt:/etc/apache2/server.crt:ro \
  -v $PWD/server.key:/etc/apache2/server.key:ro \
  -p 443:443 \
  konradkleine/docker-registry-frontend:v2

参数说明：

• ENV_REGISTRY_PROXY_FQDN：前端应用的主机名
• ENV_REGISTRY_PROXY_PORT：前端应用的端口（80或443会被Docker默认忽略）

Kerberos认证

启用Kerberos认证保护前端访问：

bash
sudo docker run \
  -d \
  -e ENV_DOCKER_REGISTRY_HOST=ENTER-YOUR-REGISTRY-HOST-HERE \
  -e ENV_DOCKER_REGISTRY_PORT=ENTER-PORT-TO-YOUR-REGISTRY-HOST-HERE \
  -e ENV_AUTH_USE_KERBEROS=yes \
  -e ENV_AUTH_NAME="Kerberos login" \
  -e ENV_AUTH_KRB5_KEYTAB=/etc/apache2/krb5.keytab \
  -v $PWD/krb5.keytab:/etc/apache2/krb5.keytab:ro \
  -e ENV_AUTH_KRB_REALMS="ENTER.YOUR.REALMS.HERE" \
  -e ENV_AUTH_KRB_SERVICE_NAME=HTTP \
  -p 80:80 \
  konradkleine/docker-registry-frontend:v2

参数说明：

• ENV_AUTH_USE_KERBEROS=yes：启用Kerberos认证
• ENV_AUTH_KRB5_KEYTAB：Kerberos keytab文件路径
• ENV_AUTH_KRB_REALMS：Kerberos领域
• ENV_AUTH_KRB_SERVICE_NAME：服务名称（通常为HTTP）

浏览模式

启用仅浏览模式（无管理功能）：

bash
sudo docker run \
  -d \
  -e ENV_DOCKER_REGISTRY_HOST=ENTER-YOUR-REGISTRY-HOST-HERE \
  -e ENV_DOCKER_REGISTRY_PORT=ENTER-PORT-TO-YOUR-REGISTRY-HOST-HERE \
  -e ENV_MODE_BROWSE_ONLY=true \
  -p 8080:80 \
  konradkleine/docker-registry-frontend:v2

参数说明：

• ENV_MODE_BROWSE_ONLY：设置为true启用浏览模式（当前版本强制为true）

调整每页默认仓库数量

默认每页显示20个仓库，可通过以下命令调整（如改为50）：

bash
sudo docker run \
  -d \
  -e ENV_DOCKER_REGISTRY_HOST=ENTER-YOUR-REGISTRY-HOST-HERE \
  -e ENV_DOCKER_REGISTRY_PORT=ENTER-PORT-TO-YOUR-REGISTRY-HOST-HERE \
  -e ENV_DEFAULT_REPOSITORIES_PER_PAGE=50 \
  -p 8080:80 \
  konradkleine/docker-registry-frontend:v2

贡献与反馈

项目欢迎贡献，可在GitHub页面（https://github.com/kwk/docker-registry-frontend%EF%BC%89%E6%8A%A5%E5%91%8Abug%E6%88%96%E6%8F%90%E5%87%BA%E5%8A%9F%E8%83%BD%E9%9C%80%E6%B1%82%E3%80%82%E5%BC%80%E5%8F%91%E7%9B%B8%E5%85%B3%E6%96%87%E6%A1%A3%E8%AF%B7%E5%8F%82%E8%80%83%E9%A1%B9%E7%9B%AE%E7%9A%84%60develop/README.md%60%E3%80%82