本文記錄在 Linux 伺服器上建置 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 存取。# 查詢倉庫鏡像列表
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
htpasswd -c /alidata/server/nginx/docker-registry.htpasswd admin
# 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
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; }
}
在每台 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
auth_basic_user_file 路徑、權限、Nginx 重載。client_max_body_size 0、chunked_transfer_encoding on、Proxy 讀寫超時設定。/v2/_catalog),舊文檔常誤導。完成上述步驟,即擁有一個安全、可控、可擴展的 Docker 私有倉庫。更多容器化運維實戰,請關注本站 DevOps 專欄。