fmauneko/gitlab

GitLab Web服务器Docker镜像（含反向代理修复的注册表）

概述

本镜像提供Docker化的GitLab Web服务器，集成容器注册表功能，并针对反向代理环境进行了配置优化，解决了标准GitLab镜像在反向代理后可能出现的注册表访问问题，确保Web服务和注册表均可通过反向代理正常工作。

核心功能与特性

• 完整GitLab Web服务：包含GitLab Community Edition的全部核心功能，支持代码仓库管理、用户权限控制、CI/CD流水线等
• 内置容器注册表：集成GitLab容器注册表，支持Docker镜像的存储和管理
• 反向代理兼容性：修复反向代理环境下注册表访问的配置问题，确保通过反向代理可正常访问GitLab Web界面和注册表服务
• 持久化存储支持：支持数据卷挂载，确保GitLab数据（仓库、配置、日志等）持久化保存

使用场景

• 企业内部Git仓库和容器镜像管理平台部署
• 需要通过Nginx、Apache等反向代理提供统一访问入口的场景
• 希望简化GitLab与注册表部署流程的Docker环境

使用方法

基本启动命令

bash
docker run -d \
  --name gitlab-with-registry \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/gitlab/data:/var/opt/gitlab \
  -v /path/to/gitlab/config:/etc/gitlab \
  -v /path/to/gitlab/logs:/var/log/gitlab \
  -e GITLAB_HOST=gitlab.example.com \
  -e REGISTRY_HOST=registry.example.com \
  -e NGINX_PROXY=true \
  [镜像名称]:[标签]

环境变量配置

反向代理配置示例（Nginx）

在Nginx配置文件中添加以下内容，将GitLab和注册表请求转发到容器：

nginx
server {
    listen 443 ssl;
    server_name gitlab.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://[容器IP]:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 443 ssl;
    server_name registry.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://[容器IP]:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

数据持久化

为确保数据不丢失，建议挂载以下目录：

• /var/opt/gitlab：GitLab应用数据
• /etc/gitlab：GitLab配置文件
• /var/log/gitlab：GitLab日志文件