From 0183a3e52f5933d327d313fae4b9d74bfef92c90 Mon Sep 17 00:00:00 2001 From: dqzboy Date: Thu, 4 Jul 2024 19:30:25 +0800 Subject: [PATCH] docs: Issue/issue.md --- Issue/issue.en.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++ Issue/issue.md | 55 +++++++++++++++++++++++++++++++++++++++++++++ Koyeb/README.md | 2 +- README.en.md | 38 +++++-------------------------- README.md | 56 +++++++++++----------------------------------- Render/README.md | 2 +- 6 files changed, 133 insertions(+), 77 deletions(-) create mode 100644 Issue/issue.en.md create mode 100644 Issue/issue.md diff --git a/Issue/issue.en.md b/Issue/issue.en.md new file mode 100644 index 0000000..1babc39 --- /dev/null +++ b/Issue/issue.en.md @@ -0,0 +1,57 @@ +

+ 中文 | English +

+

+ +
+ Deployment and Usage Issues Summary for Docker Proxy Service. +

+ + +--- + +[Docker Proxy-Communication Group](https://t.me/+ghs_XDp1vwxkMGU9) + +--- + +## 👨🏻‍💻 Problem Summary + +#### 1. Unable to delete a specific image tag through the UI. +**Known Issue：** Deletion is not supported when using `registry` as a proxy cache. + +**Related Issues：** [#3853](https://github.com/distribution/distribution/issues/3853) + +#### 2. The pull speed from within China is not ideal. +**Known Issue：** The network route from your foreign server to China is suboptimal. + +**Solutions：** +- (1) Enable BBR on the server to optimize network performance (with limited effect). +- (2) Switch to a server that has better network optimization for routes to China. + +#### 3. How long does the registry image cache last, and how to adjust it? +**Known Issue：** The default cache time is 168 hours, which is 7 days. Adjust the cache time by modifying the ttl in the proxy configuration section of the configuration file + +#### 4. Regarding the scheme for pulling images from the `Hub` public space without adding `library` when using an image acceleration + +- This scheme was provided by a senior member in the communication group and has been implemented and tested through Nginx. +```shell +location ^~ / { + if ($request_uri ~ ^/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; +} +``` + +#### 5. An error occurs when pulling an image `tls: failed to verify certificate: x509: certificate signed by unknown authority` + +**Known Issue：** Certificate issue. Indicates that the certificate was issued by an unknown or untrusted certificate Authority (CA). \ No newline at end of file diff --git a/Issue/issue.md b/Issue/issue.md new file mode 100644 index 0000000..89a249d --- /dev/null +++ b/Issue/issue.md @@ -0,0 +1,55 @@ +
+

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

+ + +--- + +[Docker Proxy-交流群](https://t.me/+ghs_XDp1vwxkMGU9) + +--- + +## 👨🏻‍💻 问题总结 + +#### 1、无法通过UI界面删除某一镜像的TAG +- [x] **已知问题：** 使用`registry`作为代理缓存时不支持删除 + +- [x] **issues：** [#3853](https://github.com/distribution/distribution/issues/3853) + +#### 2、搭建好了，但是国内拉取速度不理想 +- [x] **已知问题：** 你的国外服务器到国内的网络线路不理想 + +- [x] **解决方案：** + - (1) 开启服务器BBR，优化网络性能(效果有限) + - (2) 更换对国内网络线路优化更好的服务器 + +#### 3、registry 镜像缓存多少时间，如何调整 +- [x] **已知问题：** 默认缓存`168h`，也就是`7天`。修改配置文件`proxy`配置部分`ttl`调整缓存时间 + +#### 4、使用镜像加速拉取`hub`公共空间下的镜像时如何不添加`library` + +- 此方案来自交流群里大佬提供，通过nginx实现并实测 +```shell +location ^~ / { + if ($request_uri ~ ^/v2/([^/]+)/(manifests|blobs)/(.*)$) { + # 重写路径并添加 library/ + 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; +} +``` + +#### 5、拉取镜像报错 `tls: failed to verify certificate: x509: certificate signed by unknown authority` +- [x] **已知问题：** 证书问题。表示证书是由一个未知的或不受信任的证书颁发机构（CA）签发的。 \ No newline at end of file diff --git a/Koyeb/README.md b/Koyeb/README.md index d8c5671..2fb5fd2 100644 --- a/Koyeb/README.md +++ b/Koyeb/README.md @@ -8,7 +8,7 @@ --- -[Telegram Group](https://t.me/+ghs_XDp1vwxkMGU9) +[Docker Proxy-交流群](https://t.me/+ghs_XDp1vwxkMGU9) --- diff --git a/README.en.md b/README.en.md index 4ae308c..12e39d7 100644 --- a/README.en.md +++ b/README.en.md @@ -225,41 +225,15 @@ If you find this project helpful, please give it a Star. And if possible, you ca ## 👨🏻‍💻 Issue -#### 1、Unable to delete a specific image tag through the UI. -**Known Issue：** Deletion is not supported when using `registry` as a proxy cache. +
+Problem Summary +
-**Related Issues：** [#3853](https://github.com/distribution/distribution/issues/3853) +> Summary of common issues related to deployment and usage, welcome to add more！ -#### 2、The pull speed from within China is not ideal. -**Known Issue：** The network route from your foreign server to China is suboptimal. +Problem Summary: [Click to view](Issue/issue.en.md) -**Solutions：** -- (1) Enable BBR on the server to optimize network performance (with limited effect). -- (2) Switch to a server that has better network optimization for routes to China. - -#### 3、How long does the registry image cache last, and how to adjust it? -**Known Issue：** The default cache time is 168 hours, which is 7 days. Adjust the cache time by modifying the ttl in the proxy configuration section of the configuration file - -#### 4、Regarding the scheme for pulling images from the `Hub` public space without adding `library` when using an image acceleration - -- This scheme was provided by a senior member in the communication group and has been implemented and tested through Nginx. -```shell -location ^~ / { - if ($request_uri ~ ^/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; -} -``` +
--- diff --git a/README.md b/README.md index abc3ad0..69531e7 100644 --- a/README.md +++ b/README.md @@ -207,6 +207,19 @@ docker pull gcr.your_domain_name/google-containers/pause:3.1 --- +## 👨🏻‍💻 问题 + +
+问题总结 +
+ +> 部署、使用相关等常见问题总结，欢迎补充！ + +相关问题总结: [点击查看](Issue/issue.md) + +
+ +--- ## 🫶 赞助 如果你觉得这个项目对你有帮助，请给我点个Star。并且情况允许的话，可以给我一点点支持，总之非常感谢支持😊 @@ -224,49 +237,6 @@ docker pull gcr.your_domain_name/google-containers/pause:3.1 ---- -## 👨🏻‍💻 问题 - -#### 1、无法通过UI界面删除某一镜像的TAG -**已知问题：** 使用`registry`作为代理缓存时不支持删除 - -**issues：** [#3853](https://github.com/distribution/distribution/issues/3853) - -#### 2、搭建好了，但是国内拉取速度不理想 -**已知问题：** 你的国外服务器到国内的网络线路不理想 - -**解决方案：** -- (1) 开启服务器BBR，优化网络性能(效果有限) -- (2) 更换对国内网络线路优化更好的服务器 - -#### 3、registry 镜像缓存多少时间，如何调整 -**已知问题：** 默认缓存`168h`，也就是`7天`。修改配置文件`proxy`配置部分`ttl`调整缓存时间 - -#### 4、使用镜像加速拉取`hub`公共空间下的镜像时如何不添加`library` - -- 此方案来自交流群里大佬提供，通过nginx实现并实测 -```shell -location ^~ / { - if ($request_uri ~ ^/v2/([^/]+)/(manifests|blobs)/(.*)$) { - # 重写路径并添加 library/ - 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; -} -``` - -#### 5、拉取镜像报错 `tls: failed to verify certificate: x509: certificate signed by unknown authority` -**已知问题：** 证书问题。表示证书是由一个未知的或不受信任的证书颁发机构（CA）签发的。 - --- ## 😺 其他 diff --git a/Render/README.md b/Render/README.md index 025622e..5cc1af4 100644 --- a/Render/README.md +++ b/Render/README.md @@ -8,7 +8,7 @@ --- -[Telegram Group](https://t.me/+ghs_XDp1vwxkMGU9) +[Docker Proxy-交流群](https://t.me/+ghs_XDp1vwxkMGU9) ---