萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

建立 Docker 私有映像倉庫完整實戰:Registry + Nginx + TLS + Basic Auth

從零搭建生產級 Docker Registry:解決中國大陸拉取緩慢、權限控制與傳輸加密

Docker Hub 國內拉取極慢,自建私有 Registry 並配置 Nginx 反向代理、TLS 加密與 Basic Auth,是團隊內部分發映像的標準方案。本文記錄基於 Docker 1.5+(適用現代版本)的完整流程。

1. 啟動 Registry 容器

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 掛載宿主目錄持久化資料
  • 預設儲存驅動為 filesystem,生產環境建議改用 S3、Azure Blob 等

2. 客戶端基本操作

# 查看倉庫列表
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

3. Nginx 反向代理 + TLS + Basic Auth

生成憑證(自簽或 Let's Encrypt)

# 自簽示例
openssl req -newkey rsa:2048 -nodes -keyout registry.key -x509 -days 365 -out registry.crt

建立 htpasswd

htpasswd -Bc /etc/nginx/registry.htpasswd admin

Nginx 設定

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; }
}

4. Docker 客戶端登入

docker login https://registry.example.com
# 輸入帳號密碼

5. 進階議題

  • 儲存驅動:生產環境務必配置 S3/GCS/Azure Blob,避免單點儲存風險。
  • Token 認證:企業級建議部署 Portus、Harbor 或 Docker Distribution 原生 Token Server,支援 RBAC、掃描、複寫。
  • 清理策略:定期執行 registry garbage-collect 釋放未引用層空間。
  • 監控:暴露 /metrics 接入 Prometheus,監控請求延遲、儲存用量、錯誤率。

完成上述部署,團隊即擁有安全、高速、可控的私有映像分發中樞。

copyright © 萬盛學電腦網 all rights reserved