萬盛學電腦網

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

建置 Docker 私有倉庫完整實戰:Registry、Nginx、HTTPS、認證一站式部署

架構概覽

本文記錄在 Linux 伺服器上建置 Docker Registry 私有倉庫 的完整流程,包含:

  1. 啟動 Registry 容器(資料持久化、Port 映射)
  2. 客戶端操作:搜尋、拉取、標籤、推送鏡像
  3. Nginx 反向代理 + Basic Auth 認證
  4. 自簽 SSL 憑證建立(CA → Server Cert)
  5. Nginx HTTPS 設定與驗證

1. 啟動 Docker Registry

docker run -d \
  -e SETTINGS_FLAVOR=dev \
  -e STORAGE_PATH=/tmp/registry \
  -v /alidata/registry:/tmp/registry \
  -p 5000:5000 \
  --name registry \
  registry:2
  • -v 將宿主機 /alidata/registry 掛載至容器 /tmp/registry,實現資料持久化。
  • -p 5000:5000 映射埠號,僅供內部/Nginx 存取。

2. 客戶端驗證流程

# 查詢倉庫鏡像列表
curl -X GET https://registry.wpython.com:5000/v2/_catalog

# 拉取官方鏡像
docker pull library/centos6

# 打標籤指向私有倉庫
docker tag 8552ea9a16f9 registry.wpython.com:5000/centos6_x86_64.mini

# 推送至私有倉庫
docker push registry.wpython.com:5000/centos6_x86_64.mini

3. Nginx 反向代理 + Basic Auth

建立密碼檔

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

自簽 CA 與 Server 憑證

# 1. 建立 CA 目錄結構
mkdir -p /etc/pki/CA/{newcerts,private}
touch /etc/pki/CA/index.txt
echo 01 > /etc/pki/CA/serial

# 2. 產生 CA 私鑰與根憑證
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 "/C=CN/ST=Beijing/L=Chaoyang/O=MyOrg/CN=MyCA"

# 3. 產生 Server 私鑰與 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 "/C=CN/ST=Beijing/L=Chaoyang/O=MyOrg/CN=registry.wpython.com"

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

# 5. 將 CA 憑證加入系統信任庫
cp /etc/pki/tls/certs/ca-bundle.crt{,.bak}
cat /etc/pki/CA/cacert.pem >> /etc/pki/tls/certs/ca-bundle.crt

Nginx 設定檔

upstream docker-registry {
  server localhost:5000;
}

server {
  listen 443 ssl;
  server_name registry.wpython.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 "Restricted";
    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 Client 機器:

# 複製 CA 憑證至 Docker 信任目錄
sudo mkdir -p /etc/docker/certs.d/registry.wpython.com:443
sudo cp cacert.pem /etc/docker/certs.d/registry.wpython.com:443/ca.crt

# 重啟 Docker
sudo systemctl restart docker

# 登入測試
docker login registry.wpython.com:443
docker push registry.wpython.com:443/my-image:latest

常見坑點與解決

  • HTTP 401/403:檢查 auth_basic_user_file 路徑、權限、Nginx 重載。
  • 憑證不信任:Client 未正確安裝 CA 憑證,或 CN 與 hostname 不符。
  • 大檔上傳斷線:確認 client_max_body_size 0、chunked_transfer_encoding on、Proxy 讀寫超時設定。
  • Registry v1 vs v2 API:新版 Docker 僅支援 v2 API(/v2/_catalog),舊文檔常誤導。

生產環境建議

  • 使用 Let's Encrypt 或企業 CA 簽發正式憑證,避免自簽維護成本。
  • 啟用 Registry 內建 Token 認證(配合 Auth Server)替代 Basic Auth,支援細粒度權限。
  • 儲存後端改用 S3、GCS、Azure Blob、Ceph 等物件儲存,支援高可用與擴展。
  • 監控:Prometheus + Grafana 監控 Registry 指標(請求延遲、錯誤率、儲存用量)。

完成上述步驟,即擁有一個安全、可控、可擴展的 Docker 私有倉庫。更多容器化運維實戰,請關注本站 DevOps 專欄。

copyright © 萬盛學電腦網 all rights reserved