bpholt/docker-registry-frontend

Docker Registry Frontend (代理兼容版)

镜像概述

本镜像为konradkleine/docker-registry-frontend的分支版本，主要改进是增加了对代理环境的支持，解决了原版本在代理服务器后无法正常访问Docker registry的问题。它提供了一个直观的Web界面，用于浏览、搜索和管理Docker registry中的镜像仓库及标签信息。

核心功能与特性

基础功能

• 浏览Docker registry中的所有镜像仓库
• 查看每个仓库的标签列表及详细信息
• 搜索镜像仓库和标签
• 响应式Web界面，支持多种设备访问

代理支持特性

• 优化网络配置，支持在代理服务器环境下正常访问后端Docker registry
• 解决原版本在代理环境中可能出现的连接问题和跨域访问限制

使用场景与适用范围

• 企业内网环境：需要通过代理服务器访问Docker registry的企业内部网络
• 受限网络环境：网络访问需经过HTTP/HTTPS代理的场景
• 需要前端管理界面：希望通过Web界面直观管理Docker registry的用户或团队

使用方法与配置说明

环境变量配置

Docker部署示例

基本运行命令

bash
docker run -d \
  -p 8080:80 \
  -e REGISTRY_URL=http://your-registry:5000 \
  --name registry-frontend \
  docker.xuanyuan.run/bpholt/docker-registry-frontend

代理环境下运行

如果需要通过代理访问后端registry，可结合环境变量和网络配置：

bash
docker run -d \
  -p 8080:80 \
  -e REGISTRY_URL=http://your-registry:5000 \
  -e http_proxy=http://your-proxy:port \
  -e https_proxy=https://your-proxy:port \
  --name registry-frontend \
  docker.xuanyuan.run/bpholt/docker-registry-frontend

Docker Compose配置示例

yaml
version: '3'
services:
  registry-frontend:
    image: docker.xuanyuan.run/bpholt/docker-registry-frontend
    ports:
      - "8080:80"
    environment:
      - REGISTRY_URL=http://registry:5000
      - REGISTRY_NAME=My Company Registry
      - http_proxy=http://proxy:3128
      - https_proxy=https://proxy:3129
    depends_on:
      - registry

  registry:
    image: docker.xuanyuan.run/registry:2
    ports:
      - "5000:5000"
    volumes:
      - registry-data:/var/lib/registry

volumes:
  registry-data:

注意事项

• 确保后端Docker registry已启用CORS支持，或通过代理配置解决跨域问题
• 代理服务器需允许前端容器与registry之间的网络通信
• 如遇到访问问题，可检查容器日志获取详细错误信息：docker logs registry-frontend

相关链接

• 原项目：https://github.com/konradkleine/docker-registry-frontend
• 代理支持相关 issue：https://github.com/kwk/docker-registry-frontend/issues/50
• 本分支项目：https://github.com/bpholt/docker-registry-frontend