Docker-Proxy/Issue/issue.md at dc9ff854160207370e8da9dfaad91ce309f170fd

mirror of https://github.com/dqzboy/Docker-Proxy.git synced 2026-01-12 16:25:42 +08:00

Files

wnark 2acd65ad3a 解决国内服务器上hubcmdui无法使用http代理请求

已撰写完整的修改过程，已验证可行.

2025-06-05 19:46:52 +08:00

12 KiB

Raw Blame History

部署Docker Proxy服务和后期使用相关等问题总结.

Docker Proxy-交流群

👨🏻‍💻 问题总结

1、无法通过UI界面删除某一镜像的TAG

已知问题： 使用registry作为代理缓存时不支持删除
issues： #3853
代码片段： configure as a pull through cache

2、搭建好了，但是国内拉取速度不理想

已知问题： 你的国外服务器到国内的网络线路不理想
解决方案：
- (1) 开启服务器BBR，优化网络性能(效果有限)
- (2) 更换对国内网络线路优化更好的服务器

3、registry 镜像缓存多少时间，如何调整，如何禁用

已知问题： 默认缓存168h，也就是7天。修改配置文件中proxy配置块中的ttl 参数调整缓存时间，0 禁用缓存过期。默认单位ns
- - 要是调度程序正常清理旧数据，需要配置中将 delete 开启（本项目默认已开启）

4、使用镜像加速拉取`hub`公共空间下的镜像时兼容不添加`library`的情况

此方案来自交流群里大佬提供，通过nginx实现并实测

# 将下面的$http_upgrade $connection_upgrade变量添加到http块中
http {
    # 用于支持WebSocket
    map $http_upgrade $connection_upgrade {
        default upgrade;
        ''      close;
    }

    server {
        listen 80;
        server_name hub.your_domain.com;

        # 在docker hub的配置中添加下面的location规则
        location ~ ^/v2/([^/]+)/(manifests|blobs)/(.*)$ {
            rewrite ^/v2/(.*)$ /v2/library/$1 break;
            proxy_pass http://127.0.0.1:51000;
            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 REMOTE-HOST $remote_addr;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            proxy_http_version 1.1;
            add_header X-Cache $upstream_cache_status;
        }

        location  / {
            proxy_pass http://127.0.0.1:51000;
            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 REMOTE-HOST $remote_addr;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            proxy_http_version 1.1;
            add_header X-Cache $upstream_cache_status;
        }
    }
}

5、拉取镜像报错 `tls: failed to verify certificate: x509: certificate signed by unknown authority`

已知问题： 证书问题。表示证书是由一个未知的或不受信任的证书颁发机构（CA）签发的。
解决方案： 修改Docker配置 daemon.json 添加 insecure-registries 并填入您的加速域名(非URL)

6、通过docker-compose部署，如何设置Proxy认证

已知问题： 查看教程：自建Docker镜像加速服务

7、对于服务器的规格要求，内存、CPU、磁盘、带宽网络等

已知问题： 建议最低使用1C1G的服务器，磁盘大小取决于你拉取镜像的频率以及保存镜像缓存的时长决定(默认缓存7天,部署时可自定义)；如果对拉取速度有要求，最好选择针对中国大陆进行网络优化的服务器

8、缓存在本地磁盘上的数据是否会自动清理？如何判断缓存是否被清理？

已知问题： Registry会定期删除旧内容以节省磁盘空间。下面为官方原文解释：

In environments with high churn rates, stale data can build up in the cache. When running as a pull through cache the Registry periodically removes old content to save disk space. Subsequent requests for removed content causes a remote fetch and local re-caching. To ensure best performance and guarantee correctness the Registry cache should be configured to use the filesystem driver for storage.

已知问题： 当我们在配置文件开启了 delete.enabled.true 那么调度程序会自动清理过期的镜像层或未使用的镜像标签
⚠️ 注意：不要通过在UI上查看某个镜像是否被删除来判断调度程序是否已自动执行删除操作。而是查看对应代理服务的容器日志
解决方案： 目前 registry 的清理效果对于磁盘小的机器并不理想，如果并不希望镜像文件长时间缓存在本地磁盘，建议通过脚本结合系统crontab实现定时清理

9、拉取了一个镜像之后，发现UI界面没有显示？

已知问题： Docker-Proxy部署的服务器上的存储空间不足。宿主机默认的挂载目录 ./registry/data

10、开启认证后，配置`daemon.json`指定了代理地址，可以正常登入，但是`docker pull`镜像时无法拉取镜像

已知问题： 因为对于私有镜像仓库，docker客户端对镜像的相关操作，比如pull push支持不友好（历史遗留问题）相关 issues
解决方案：
- （1）首先通过docker login <私有镜像地址> 登入私有镜像仓库，登入成功之后，会在对应的用户家目录下生成 .docker/config.json 配置文件
- （2）通过vi命令打开配置文件，然后手动在auths配置块里面添加官方地址https://index.docker.io/v1/，auth哈希值与你的私有镜像地址的auth保持一致，然后重启docker即可直接通过docker pull拉取了

vi $HOME/.docker/config.json
{
      "auths": {
              "https://index.docker.io/v1/": {
                      "auth": "复制下面私有镜像登入认证的哈希值填到这里"
              },
              "你的私有镜像地址": {
                      "auth": "自动生成的认证哈希值"
              }
      }
}

# 重启 docker
systemctl restart docker

# 拉取镜像
docker pull nginx

11、如何配置才能让数据不保留到磁盘中？

已知问题： 默认使用的存储系统为filesystem 使用本地磁盘存储注册表文件
解决方案： 修改对应Registry的配置，将Storage driver 存储驱动改为 inmemory，⚠️ 注意：此存储驱动程序不会在运行期间保留数据。这就是为什么它只适合测试。切勿在生产中使用此驱动程序。

12、关于Docker Hub免费拉取政策再次变更后的解决方案？

已知问题： Docker Hub从 2020年11月2日起就已经限制非付费用户的拉取频率了，只是这次又变更了拉取政策。匿名用户每小时10次，登入用户每小时100次
解决方案： 修改项目中Docker Hub对应的配置文件registry-hub.yml 添加Docker Hub用户，添加后重新启动Docker Registry容器即可！

...

# username 输入docker hub账号，password 输入对应账号密码
proxy:
remoteurl: https://registry-1.docker.io
username: 
password:
ttl: 168h

13、解决国内服务器上hubcmdui无法使用http代理请求

简单的讲,需要解决两个问题:

dns污染,请自行搭建smartdns服务
修改axios.get相关代码

亦可使用socket5方式,为了代理方案一致性,仅在pr中介绍

# 拉取代码
git clone https://github.com/dqzboy/Docker-Proxy.git
# 前往文件夹,根据自己使用的代理情况,修改相应的代码
cd Docker-Proxy/hubcmdui/

关键生效的代码:

const { HttpsProxyAgent } = require('https-proxy-agent');
// 如果环境变量设置https_proxy则使用该代理
const proxyUrl = process.env.https_proxy || process.env.HTTPS_PROXY;
const agent = proxyUrl ? new HttpsProxyAgent(proxyUrl) : undefined;

... ...
        const response = await axios.get(`${DOCKER_HUB_API}/search/repositories`, {
            params: {
                query: term,
                page,
                page_size: limit
            },
            httpsAgent: agent, // 使用 HttpsProxyAgent 作为http proxy
            proxy: false, // 不使用 axios 自身代理
            timeout: 10000
        });
... ...

需要修改使用了axios.get的三个文件:

vim routes/dockerhub.js
vim compatibility-layer.js
# 下面这个文件好像没调用,可以不修改
vim services/dockerHubService.js

解决误删的文件,当前仓库并不存在所需的const { executeOnce } = require('../lib/initScheduler');文件,而作者制作的镜像中存在,可能是误删了

$ mkdir Docker-Proxy/lib
# 将所需文件放入该lib文件夹,从dockerhub中的镜像获取
initScheduler.js
logFilter.js
logger.js
systemInit.js
utils.js

还需要修改Dockerfile,补充需要的库

vim Docker-Proxy/Dockerfile

内容如下:

FROM node:lts-alpine
# 设置工作目录
WORKDIR /app
# 复制项目文件到工作目录
COPY hubcmdui/ .
# 安装项目依赖
RUN npm install
# 推荐更新到最新版本axios,不更新好像也行,推荐更新
RUN npm install axios@latest
# 安装所需库
RUN npm install https-proxy-agent
# 暴露应用程序的端口
EXPOSE 3000
# 运行应用程序
CMD ["node", "server.js"]

制作镜像并尝试启动

$ cd Docker-Proxy
$ docker build --no-cache -f Dockerfile -t dqzboy/hubcmd-ui:test .

接下来编辑docker-compose.yaml,设置dns,添加域名解析的ip,使用的http代理

$ cd Docker-Proxy/hubcmdui

$ vim docker-compose.yaml

services:
  ## HubCMD UI
  hubcmd-ui:
    container_name: hubcmd-ui
    image: dqzboy/hubcmd-ui:test
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /data/registry-proxy/hubcmdui/data:/app/data
    ports:
      - 30080:3000
    dns:
      # 如果使用http代理,必须要处理dns解析过慢的情况
      # 可以尝试自建dns服务器/smartdns
      # 推荐参考上面的研究使用socket5代理
      - smartdns_server_ip
    environment:
      - http_proxy=http://http_proxy_url:http_proxy_port
      - https_proxy=http://http_proxy_url:http_proxy_port
      # 日志配置
      - LOG_LEVEL=DEBUG # 可选: TRACE, DEBUG, INFO, SUCCESS, WARN, ERROR, FATAL
      - SIMPLE_LOGS=true # 启用简化日志输出，减少冗余信息
      # - DETAILED_LOGS=false # 默认关闭详细日志记录（请求体、查询参数等）
      # - SHOW_STACK=false # 默认关闭错误堆栈跟踪
      # - LOG_FILE_ENABLED=true # 是否启用文件日志，默认启用
      # - LOG_CONSOLE_ENABLED=true # 是否启用控制台日志，默认启用
      # - LOG_MAX_SIZE=10 # 单个日志文件最大大小(MB)，默认10MB
      # - LOG_MAX_FILES=14 # 保留的日志文件数量，默认14个

重新启动容器,尝试解析能正常访问输出

$ docker-compose -f docker-compose.yaml up -d  --force-recreate 
# 查看日志
$ docker logs hubcmd-ui -f
# 本地测试
$ curl "http://localhost:30080/api/dockerhub/search?term=redis&page=1"
# 删除容器
$ docker-compose -f docker-compose.yaml down
# 配置文件在本地的位置
$ ls /data/registry-proxy/hubcmdui/data

12 KiB Raw Blame History Unescape Escape