Docker Hub 國內拉取極慢,自建私有 Registry 並配置 Nginx 反向代理、TLS 加密與 Basic Auth,是團隊內部分發映像的標準方案。本文記錄基於 Docker 1.5+(適用現代版本)的完整流程。
docker run -d \
--name registry \
-e SETTINGS_FLAVOR=dev \
-e STORAGE_PATH=/var/lib/registry \
-v /data/registry:/var/lib/registry \
-p 5000:5000 \
registry:2
-v 掛載宿主目錄持久化資料# 查看倉庫列表
curl https://registry.example.com/v2/_catalog
# 拉取官方映像並重新標籤
docker pull ubuntu:22.04
docker tag ubuntu:22.04 registry.example.com/ubuntu:22.04
# 推送至私有倉庫
docker push registry.example.com/ubuntu:22.04
# 從私有倉庫拉取
docker pull registry.example.com/ubuntu:22.04
# 自簽示例
openssl req -newkey rsa:2048 -nodes -keyout registry.key -x509 -days 365 -out registry.crt
htpasswd -Bc /etc/nginx/registry.htpasswd admin
upstream docker-registry {
server localhost:5000;
}
server {
listen 443 ssl http2;
server_name registry.example.com;
ssl_certificate /etc/nginx/ssl/registry.crt;
ssl_certificate_key /etc/nginx/ssl/registry.key;
client_max_body_size 0; # 允許大層推送
chunked_transfer_encoding on;
location / {
auth_basic "Docker Registry";
auth_basic_user_file /etc/nginx/registry.htpasswd;
proxy_pass https://docker-registry;
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 X-Forwarded-Proto $scheme;
proxy_read_timeout 900;
}
# 健康檢查免認證
location /v2/ { auth_basic off; proxy_pass https://docker-registry; }
}
docker login https://registry.example.com
# 輸入帳號密碼
registry garbage-collect 釋放未引用層空間。/metrics 接入 Prometheus,監控請求延遲、儲存用量、錯誤率。完成上述部署,團隊即擁有安全、高速、可控的私有映像分發中樞。