萬盛學電腦網

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

從零打造 Docker 私有倉庫:Registry + Nginx + HTTPS 完整實戰

為什麼需要私有倉庫?

Docker Hub 官方倉庫在國內下載緩慢、甚至失敗。自建私有倉庫可實現本地推送/拉取鏡像,大幅提升 CI/CD 效率,並掌控鏡像分發權限。

環境與版本

  • Docker 版本:1.5.0(示範用,實務請用最新穩定版)
  • 作業系統:Linux(CentOS/Ubuntu 均可)
  • 域名:registry.wpython.com(請替換為你的實際域名)

步驟 1:啟動 Registry 容器

docker run -d \
  -e SETTINGS_FLAVOR=dev \
  -e STORAGE_PATH=/tmp/registry \
  -v /alidata/registry:/tmp/registry \
  -p 5000:5000 \
  registry
  • -v 掛載本地目錄持久化鏡像資料
  • -p 5000:5000 映射埠口

步驟 2:客戶端基本操作

# 查詢倉庫鏡像列表
curl https://registry.wpython.com:5000/v1/search

# 拉取鏡像
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 反向代理 + HTTPS + 基礎認證

新版 Docker 強制要求 HTTPS,否則會報錯。以下建立自簽憑證並配置 Nginx:

3.1 建立 htpasswd 認證檔

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

3.2 產生自簽 CA 與伺服器憑證

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

# 產生 CA 私鑰
openssl genrsa -out /etc/pki/CA/private/cakey.pem 2048

# 產生 CA 憑證
openssl req -new -x509 -key /etc/pki/CA/private/cakey.pem -out /etc/pki/CA/cacert.pem -subj "/C=CN/ST=Beijing/L=Chaoyang/O=MyOrg/CN=registry.wpython.com"

# 產生 Nginx 私鑰
openssl genrsa -out /alidata/server/nginx/ssl/nginx.key 2048

# 產生 CSR
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"

# CA 簽發伺服器憑證
openssl ca -in /alidata/server/nginx/ssl/nginx.csr -out /alidata/server/nginx/ssl/nginx.crt -config /etc/pki/tls/openssl.cnf

3.3 將 CA 憑證加入系統信任

cp /etc/pki/tls/certs/ca-bundle.crt{,.bak}
cat /etc/pki/CA/cacert.pem >> /etc/pki/tls/certs/ca-bundle.crt

3.4 Nginx 配置範例

upstream docker-registry {
  server localhost:5000;
}

server {
  listen 8080 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 /_ping { auth_basic off; proxy_pass https://docker-registry; }
  location /v1/_ping { auth_basic off; proxy_pass https://docker-registry; }
}

步驟 4:驗證登入

docker login https://registry.wpython.com:8080
# 輸入帳號 admin 及密碼

生產環境補充建議

  • 使用 Let's Encrypt 免費憑證替代自簽憑證
  • 啟用 Token 認證(Registry 2.7+ 內建)取代 htpasswd
  • 配置 儲存驅動(S3、Azure Blob、NAS 等)提升擴展性
  • 設定 清理策略 定期刪除未使用層節省空間
copyright © 萬盛學電腦網 all rights reserved