嗨，我正好碰到过类似的问题，这其实是Docker Registry本身的特性导致的——它的V2 API会在响应里返回绝对路径的链接，而不是相对路径，单纯用Git服务器那套rewrite+proxy_pass配置是不够的，得额外处理响应里的URL替换。

问题根源 #

Git服务器的响应大多用相对路径或者能自动适配子目录，但Docker Registry不一样，它默认认为自己运行在域名根路径下，所以返回的API链接（比如/v2/）都是基于根的，客户端拿到后就会跳转到example.com/v2，而不是example.com/registry/v2。

完整的Nginx配置方案 #

直接替换你的Registry相关location配置为下面这段，我会逐个解释关键部分：

location /registry/ {
    # 保留原来的rewrite规则，把/registry/xxx转成/xxx传给Registry
    rewrite ^/registry/(.*) /$1 break;

    # 给Registry传递必要的头信息，让它知道请求的来源和前缀
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme; # 如果用HTTPS必须加这个
    proxy_set_header X-Forwarded-Prefix /registry;

    # 代理到你的Registry容器端口（这里假设是5000，根据实际修改）
    proxy_pass http://localhost:5000;

    # 核心：替换响应里的绝对路径，把根路径的链接改成带/registry前缀的
    sub_filter '"/v2/' '"/registry/v2/';
    sub_filter 'href="/' 'href="/registry/';
    sub_filter 'src="/' 'src="/registry/';
    sub_filter_once off; # 确保所有匹配的内容都被替换，而不是只替换第一个
}

关键配置说明 #

1. X-Forwarded-Prefix：这个头告诉Registry它是在/registry子目录下提供服务的，部分Registry的扩展或UI会依赖这个头来生成正确的链接。
2. sub_filter系列规则：这是解决跳转问题的核心——把Registry响应里所有以/开头的链接，替换成以/registry/开头的，比如把/v2/改成/registry/v2/，这样客户端跳转时就会停留在子目录下。
3. X-Forwarded-Proto：如果你的Nginx配置了HTTPS，一定要加这个头，否则Registry会认为请求是HTTP的，返回的链接也会是HTTP的，导致混合内容错误。

额外检查 #

• 确认你的Nginx安装了ngx_http_sub_module模块：执行nginx -V，查看输出里有没有--with-http_sub_module。如果没有，你需要重新编译Nginx或者安装带这个模块的版本（比如Debian/Ubuntu下的nginx-full包就包含这个模块）。
• 如果你用了Registry的Web UI（比如docker-registry-ui），也要确保UI的配置里设置了正确的子路径，比如启动容器时加-e BASE_URL=/registry这样的环境变量。

这样配置后，访问example.com/registry/v2就不会跳转到根路径了，所有API请求和页面链接都会正确指向/registry子目录下的路径。

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