建立私有 Docker Registry

前言

該如何自架 docker registry 呢? docker registry 可以幫助我們做什麼事情呢? docker registry 是可以將我們打包好的 docker image，放置到 docker registry 上面，在我們開始要佈署服務時，從 docker registry 拉取我們打包好的 image 進行佈署，也就是說 docker registry 是我們存放 images 的倉庫，今天我們將教大家如何自架 docker registry，建造我們的私有倉庫。

準備主機

準備一台主機，先在本機安裝 docker engine 和 docker compose，接著安裝 apache2-utils 和 mkcert，我們要使用 apache2-utils 來控管伺服器內部存取身分，Docker Registry 支援帳密登入，前提要啟用 TLS HTTPS 連線，並使用 htpasswd 工具設定雜湊密碼檔，且安裝 mkcert 建立 TLS 憑證，以下安裝指令

準備主機

準備一台主機，先在本機安裝 docker engine 和 docker compose，接著安裝 apache2-utils 和 mkcert，我們要使用 apache2-utils 來控管伺服器內部存取身分，Docker Registry 支援帳密登入，前提要啟用 TLS HTTPS 連線，並使用 htpasswd 工具設定雜湊密碼檔，且安裝 mkcert 建立 TLS 憑證，以下安裝指令

sudo apt-get install apache2-utils mkcert

建立 /var/registry/certs 路徑，並切換到此路徑

sudo mkdir -p /var/registry/certs
cd /var/registry/certs

接著在/var/registry/certs 路徑，建立 TSL 憑證

sudo mkcert -install

    |_ The local CA is already installed in the system trust store! 👍
sudo mkcert localhost
    |_ Created a new certificate valid for the following names 📜
    |_ - "localhost"
    |_
    |_ The certificate is at "./localhost.pem" and the key at "./localhost-key.pem" ✅
    |_ 
    |_ It will expire on 5 January 2026 🗓
ls *.pem
    |_ localhost-key.pem    localhost.pem

建立 /var/registry/auth 路徑，並切換此路徑

sudo mkdir -p /var/registry/auth
cd /var/registry/auth

接著在 /var/registry/auth 路徑，建立帳號密碼

sudo htpasswd -Bbn user 123456 | sudo tee ./htpasswd > /dev/null
ls -l htpasswd
    |_ -rw-r--r-- 1 root root 67 Oct  5 02:47 htpasswd
cat htpasswd
    |_ user:$2y$05$g/sNIT/FM4rWtEIDvjTLEuuj3wGWAwxzgQgcVRK0vC/6KVr6uRNtu

準備 Docker Compose 安裝 registry 以及 docker registry browser 這兩個鏡像

version: "3"

services:
    registry:
        container_name: registry
        restart: always
        image: registry:2
        ports:
            - 5000:5000
        environment:
            REGISTRY_HTTP_TLS_CERTIFICATE: /certs/localhost.pem
            REGISTRY_HTTP_TLS_KEY: /certs/localhost-key.pem
            REGISTRY_AUTH: htpasswd
            REGISTRY_AUTH_HTPASSWD_PATH: /auth/htpasswd
            REGISTRY_AUTH_HTPASSWD_REALM: Registry Realm
            REGISTRY_STORAGE_DELETE_ENABLED: true
        volumes:
            - /var/registry/data:/var/lib/registry
            - /var/registry/certs:/certs
            - /var/registry/auth:/auth
    docker_registry_browser:
        container_name: docker_registry_browser
        restart: always
        image: klausmeyer/docker-registry-browser
        ports:
            - 8080:8080
        environment:
            DOCKER_REGISTRY_URL: https://192.168.18.35:5000
            NO_SSL_VERIFICATION: true
            TOKEN_AUTH_USER: user
            TOKEN_AUTH_PASSWORD: 123456
            ENABLE_DELETE_IMAGES: true
        volumes:
            - /var/registry/certs:/certs

registry 鏡像

registry 是 docker 推出的鏡像，可以來建造我們的私有倉庫，快速提升開發效率，減少伺服器資源負擔

registry 的 environment 設定

REGISTRY_HTTP_TLS_CERTIFICATE: 取得剛才使用 mkcert 的 localhost.pem 檔案路徑

REGISTRY_HTTP_TLS_KEY: 取得剛才使用 mkcert 的 localhost-key.pem 檔案路徑

REGISTRY_AUTH: 設定驗證 http 環境變數

REGISTRY_AUTH_HTPASSWD_PATH: 設定驗證 http 檔案路徑

REGISTRY_AUTH_HTPASSWD_REALM: 設定驗證網域名稱

REGISTRY_STORAGE_DELETE_ENABLED: 啟用 registry 倉庫可被刪除

docker registry browser 鏡像

docker registry browser 是我個人推薦的一個鏡像，可以用來查看 docker registry 裡面有那些鏡像，並且提供刪除鏡像功能

docker registry browser 的 environment 設定

DOCKER_REGISTRY_URL: 設定 docker registry 位置

NO_SSL_VERIFICATION: 設定是否啟用 SSL 驗證

TOKEN_AUTH_USER: 設定 docker registry 登入使用者名稱

TOKEN_AUTH_PASSWORD: 設定 docker registry 登入密碼

ENABLE_DELETE_IMAGES: 設定是否啟用鏡像刪除按鈕

檢查 docker registry 是否運作正常

當安裝完 docker registry 後，在瀏覽器輸入我們鏡像倉庫網址: https://{自己的 ip}:{自己設定的 port}/v2，然後會要求輸入帳號密碼，輸入剛才我們設定的帳號密碼

登入完成後會進入一個空物件話面代表成功

再來輸入 https://{自己的 ip}:{自己設定的 port}/v2/_catalog，這可以看自己有上傳那些鏡像，目前當然是沒有

檢查 docker registry browser 是否運作正常

安裝完 docker registry browser 輸入 http://{自己 ip}:{自己設定的 port}，來檢查 docker registry browser 是否正常，然後會要求輸入帳號密碼，輸入剛才我們設定的帳號密碼

登入完成後會進入一個 docker registry browser 畫面，會更清楚裡面有哪些 image，現在是還沒有任何 image 的狀態

實際操作上傳 docker registry 倉庫

在所有服務建置完成後，我們來實際上傳 image 套我們的倉庫，首先先抓取 nginx 的 alpine 版本

docker pull nginx:alpine

接著我們對這個 image 給一個新的 tag image

docker tag 192.168.18.35:5000/nginx:alpine

接著先登入我們的 docker registry，輸入以下指令後，會要求我們輸入帳號密碼，也就是先前我們設定的帳號密碼

docker login 192.168.18.35:5000

登入成功後，再來上傳我們的 image

docker push 192.168.18.35:5000/nginx:alpine

如果上傳出現以下訊息

The push refers to repository [192.168.18.35:5000/nginx]
Get "https://192.168.18.35:5000/v2/": tls: failed to verify certificate: x509: cannot validate certificate for 192.168.44.136 because it doesn't contain any IP SANs

如果是 linux 在本機 /etc/docker/ 底下建立 daemon.json 檔案，建立以下內容

{
       "group": "dockerroot",
       "insecure-registries": [
               "192.168.44.136:5000"
        ],
        "live-restore": true
}

如果是 windows 直接在 docker desktop 新增相同內容

最後再輸入一次剛才的 docker push 即可上傳成功，然後在瀏覽器打開 docker registry browser 即可看到 nginx alpine 版本