docs: Issue/issue.md

This commit is contained in:
dqzboy
2024-07-04 19:30:25 +08:00
parent 043bdf0037
commit 0183a3e52f
6 changed files with 133 additions and 77 deletions

57
Issue/issue.en.md Normal file
View File

@@ -0,0 +1,57 @@
<p align="right">
<a href="./README.md">中文</a> | <strong>English</strong>
<div style="text-align: center"></div>
<p align="center">
<img src="https://github.com/dqzboy/Docker-Proxy/assets/42825450/c187d66f-152e-4172-8268-e54bd77d48bb" width="230px" height="200px">
<br>
<i>Deployment and Usage Issues Summary for Docker Proxy Service.</i>
</p>
</div>
---
[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).

55
Issue/issue.md Normal file
View File

@@ -0,0 +1,55 @@
<div style="text-align: center"></div>
<p align="center">
<img src="https://github.com/dqzboy/Docker-Proxy/assets/42825450/c187d66f-152e-4172-8268-e54bd77d48bb" width="230px" height="200px">
<br>
<i>部署Docker Proxy服务和后期使用相关等问题总结.</i>
</p>
</div>
---
[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签发的。

View File

@@ -8,7 +8,7 @@
---
[Telegram Group](https://t.me/+ghs_XDp1vwxkMGU9)
[Docker Proxy-交流群](https://t.me/+ghs_XDp1vwxkMGU9)
---

View File

@@ -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.
<details>
<summary><strong>Problem Summary</strong></summary>
<div>
**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;
}
```
</details>
---

View File

@@ -207,6 +207,19 @@ docker pull gcr.your_domain_name/google-containers/pause:3.1
---
## 👨🏻‍💻 问题
<details>
<summary><strong>问题总结</strong></summary>
<div>
> 部署、使用相关等常见问题总结,欢迎补充!
相关问题总结: [点击查看](Issue/issue.md)
</details>
---
## 🫶 赞助
如果你觉得这个项目对你有帮助请给我点个Star。并且情况允许的话可以给我一点点支持总之非常感谢支持😊
@@ -224,49 +237,6 @@ docker pull gcr.your_domain_name/google-containers/pause:3.1
</tr>
</table>
---
## 👨🏻‍💻 问题
#### 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签发的。
---
## 😺 其他

View File

@@ -8,7 +8,7 @@
---
[Telegram Group](https://t.me/+ghs_XDp1vwxkMGU9)
[Docker Proxy-交流群](https://t.me/+ghs_XDp1vwxkMGU9)
---