萬盛學電腦網

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

Docker 私有倉庫搭建全紀錄 (Registry v2 + Nginx HTTPS + Basic Auth)

架構概覽

  • Docker Registry v2:官方開源映像倉庫
  • Nginx:反向代理、SSL 終結、Basic Auth
  • OpenSSL:自簽 CA 與伺服器憑證

1. 啟動 Registry 容器

docker run -d \
  --name registry \
  -e SETTINGS_FLAVOR=dev \
  -e STORAGE_PATH=/tmp/registry \
  -v /alidata/registry:/tmp/registry \
  -p 5000:5000 \
  registry:2

資料持久化於宿主機 /alidata/registry,API 監聽 localhost:5000。

2. 客戶端基本操作

# 查詢倉庫列表
curl -X GET https://registry.example.com/v2/_catalog

# 拉取映像
docker pull library/centos:6

# 打標籤
docker tag centos:6 registry.example.com/centos6_x86_64:mini

# 推送
docker push registry.example.com/centos6_x86_64:mini

3. Nginx 設定 HTTPS + Basic Auth

建立帳號密碼

htpasswd -c /alidata/server/nginx/docker-registry.htpasswd admin

自簽 CA 與伺服器憑證

# 1. 建立 CA
mkdir -p /etc/pki/CA/{newcerts,private}
touch /etc/pki/CA/index.txt
echo 01 > /etc/pki/CA/serial
openssl genrsa -out /etc/pki/CA/private/cakey.pem 2048
openssl req -new -x509 -key /etc/pki/CA/private/cakey.pem -out /etc/pki/CA/cacert.pem -days 3650 -subj "/CN=MyCA"

# 2. 伺服器私鑰 + CSR
openssl genrsa -out /alidata/server/nginx/ssl/nginx.key 2048
openssl req -new -key /alidata/server/nginx/ssl/nginx.key -out /alidata/server/nginx/ssl/nginx.csr -subj "/CN=registry.example.com"

# 3. CA 簽發
openssl ca -in /alidata/server/nginx/ssl/nginx.csr -out /alidata/server/nginx/ssl/nginx.crt -days 365 -batch

# 4. 信任 CA (客戶端需匯入 cacert.pem)
cp /etc/pki/CA/cacert.pem /etc/pki/ca-trust/source/anchors/
update-ca-trust

Nginx 設定檔

upstream docker-registry {
  server localhost:5000;
}

server {
  listen 443 ssl;
  server_name registry.example.com;

  ssl_certificate /alidata/server/nginx/ssl/nginx.crt;
  ssl_certificate_key /alidata/server/nginx/ssl/nginx.key;

  client_max_body_size 0;          # 不限制上傳大小
  chunked_transfer_encoding on;

  location / {
    auth_basic "Registry";
    auth_basic_user_file /alidata/server/nginx/docker-registry.htpasswd;
    proxy_pass https://docker-registry;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
  }

  # 健康檢查不需驗證
  location /v2/_ping { auth_basic off; proxy_pass https://docker-registry; }
  location /_ping { auth_basic off; proxy_pass https://docker-registry; }
}

4. Docker 客戶端信任自簽憑證

# Linux
mkdir -p /etc/docker/certs.d/registry.example.com
cp cacert.pem /etc/docker/certs.d/registry.example.com/ca.crt
systemctl restart docker

# Windows (Docker Desktop)
# 將 ca.crt 匯入「受信任的根憑證授權機構」

5. 常見問題

  • HTTP 413:調大 client_max_body_size。
  • 推送失敗 "http: server gave HTTP response to HTTPS client":Docker Daemon 未信任憑證,確認 /etc/docker/certs.d/ 掛載正確。
  • Registry API v1/v2 混淆:v2 使用 /v2/_catalog,v1 已棄用。
copyright © 萬盛學電腦網 all rights reserved