在Docker部署HubProxy，加速Github和镜像服务

简单的介绍一下HubProxy：
一个轻量级、高性能的多功能代理服务，提供 Docker 镜像加速、GitHub 文件加速、下载离线镜像、在线搜索 Docker 镜像等功能。


项目地址：HubProxy-Github
解决痛点：
咱们在git拉取Github资源时候，docker拉取ghcr.io镜像时候经常出现拉不下来，下载特别慢的情况。
搭建这个代理是通过自动更新最快的host方式和可选叠加魔方上网的方式来加速下载
部署成功后可在Web端Hosts处查看当前host值



Compose:

1. services:
   
2.   hubproxy:
   
3.     image: ghcr.io/sky22333/hubproxy
   
4.     container_name: hubproxy
   
5.     network_mode: host
   
6.     ports:
   
7.       - 5000:5000
   
8.     restart: unless-stopped
   
9.     volumes:
   
10.       - ./config.toml:/root/config.toml

复制代码

搭建后通过本地ip:5000来访问web界面
host还添加了ports是为了方便快捷访问，实际使用不冲突


部署方法：
1.手动创建config.toml文件：因为Volume配置中config.toml是个文件，绿联NAS的Volume他会当文件夹去创建，会导致启动失败，所以需要部署之前在直接在Docker存放路径处的目录里创建config.toml文件，防止生成文件夹。

2.创建好后把下面的配置复制到文件内（可以在此处修改配置，包含魔法代理等）

1. [server]
   
2. host = "0.0.0.0"
   
3. # 监听端口
   
4. port = 5000
   
5. # Github文件大小限制（字节），默认2GB
   
6. fileSize = 2147483648
   
7. # HTTP/2 多路复用，提升下载速度
   
8. enableH2C = false
   
9. 
   
10. [rateLimit]
    
11. # 每个IP每周期允许的请求数(注意Docker镜像会有多个层，会消耗多个次数)
    
12. requestLimit = 500
    
13. # 限流周期（小时）
    
14. periodHours = 3.0
    
15. 
    
16. [security]
    
17. # IP白名单，支持单个IP或IP段
    
18. # 白名单中的IP不受限流限制
    
19. whiteList = [
    
20.     "127.0.0.1",
    
21.     "172.17.0.0/16",
    
22.     "192.168.1.0/24"
    
23. ]
    
24. 
    
25. # IP黑名单，支持单个IP或IP段
    
26. # 黑名单中的IP将被直接拒绝访问
    
27. blackList = [
    
28.     "192.168.100.1",
    
29.     "192.168.100.0/24"
    
30. ]
    
31. 
    
32. [access]
    
33. # 代理服务白名单（支持GitHub仓库和Docker镜像，支持通配符）
    
34. # 只允许访问白名单中的仓库/镜像，为空时不限制
    
35. whiteList = []
    
36. 
    
37. # 代理服务黑名单（支持GitHub仓库和Docker镜像，支持通配符）
    
38. # 禁止访问黑名单中的仓库/镜像
    
39. blackList = [
    
40.     "baduser/malicious-repo",
    
41.     "*/malicious-repo",
    
42.     "baduser/*"
    
43. ]
    
44. 
    
45. # 代理配置，支持有用户名/密码认证和无认证模式
    
46. # 无认证: socks5://127.0.0.1:1080
    
47. # 有认证: socks5://username:[email protected]:1080
    
48. # 留空不使用代理
    
49. proxy = ""
    
50. 
    
51. [download]
    
52. # 批量下载离线镜像数量限制
    
53. maxImages = 10
    
54. 
    
55. # Registry映射配置，支持多种镜像仓库上游
    
56. [registries]
    
57. 
    
58. # GitHub Container Registry
    
59. [registries."ghcr.io"]
    
60. upstream = "ghcr.io"
    
61. authHost = "ghcr.io/token"
    
62. authType = "github"
    
63. enabled = true
    
64. 
    
65. # Google Container Registry
    
66. [registries."gcr.io"]
    
67. upstream = "gcr.io"
    
68. authHost = "gcr.io/v2/token"
    
69. authType = "google"
    
70. enabled = true
    
71. 
    
72. # Quay.io Container Registry
    
73. [registries."quay.io"]
    
74. upstream = "quay.io"
    
75. authHost = "quay.io/v2/auth"
    
76. authType = "quay"
    
77. enabled = true
    
78. 
    
79. # Kubernetes Container Registry
    
80. [registries."registry.k8s.io"]
    
81. upstream = "registry.k8s.io"
    
82. authHost = "registry.k8s.io"
    
83. authType = "anonymous"
    
84. enabled = true
    
85. 
    
86. [tokenCache]
    
87. # 是否启用缓存(同时控制Token和Manifest缓存)显著提升性能
    
88. enabled = true
    
89. # 默认缓存时间(分钟)
    
90. defaultTTL = "20m"

复制代码

3.通过Compose部署

使用方法：
部署成功后通过ip:5000来访问Web端
Github：
例如https://github.com/sky22333/hubproxy.git的git地址加速粘贴后他给到了一个https://192.168.3.32:5000/https://github.com/sky22333/hubproxy.git
厉害的人已经看出来他是在原链接前边加了https://192.168.3.32:5000/，但是会发现访问不了，是因为咱们访问192.168.3.32:5000默认用的是http，而不是https。
所以咱们使用的时候需要改成http://192.168.3.32:5000/https://github.com/sky22333/hubproxy.git才能正常使用，局域网内可实现加速效果

Docker：
Docker 官方镜像：docker pull 192.168.3.32:5000/nginx
Docker 镜像：docker pull 192.168.3.32:5000/user/image
ghcr.io 镜像：docker pull 192.168.3.32:5000/ghcr.io/user/image
Quay.io 镜像：docker pull 192.168.3.32:5000/quay.io/org/image
Kubernetes 镜像：docker pull 192.168.3.32:5000/registry.k8s.io/pause:3.8

上边是使用方案，如果是在当前nas里加速，则ip直接修改为127.0.0.1:5000/user/image

也可在Compose里使用，例如原镜像为image: ghcr.io/sky22333/hubproxy，修改后为image: 127.0.0.1:5000/ghcr.io/sky22333/hubproxy


其他功能可以自行探索

懒得搭建也可使用作者搭建的线上版本：https://gh-proxy.com/

谢谢，那我先试试你的这个看看效果如何。😁

mark