docker registry v2 nginx 安全訪問控制

環境準備：

docker 版本：1.9.1

registry版本：2.2.1

本文之前也有發過一篇自建倉庫nginx認證，但是對新出的registry v2版本不適用，特重更一篇。

一、創建相關目錄及文件

(1)目錄結構

auth
│   ├── domain.crt
│   ├── domain.key
│   ├── nginx.conf
│   └── nginx.htpasswd
├── data

mkdir -p auth
mkdir -p data
openssl req -newkey rsa:4096 -nodes -sha256 -keyout auth/domain.key -x509 -days 365 -out auth/domain.crt

例如：

Country Name (2 letter code) [AU]:China
string is too long, it needs to be less than  2 bytes long
Country Name (2 letter code) [AU]:CH
State or Province Name (full name) [Some-State]:BeiJing
Locality Name (eg, city) []:BeiJing      
Organization Name (eg, company) [Internet Widgits Pty Ltd]:BeiJing
Organizational Unit Name (eg, section) []:BeiJing  
Common Name (e.g. server FQDN or YOUR name) []:registry.test.com
Email Address []:[email protected]

(2)生成對應nginx配置文件

cat <<EOF > auth/nginx.conf
upstream docker-registry {  
    server registry:5000;
}

server {
  listen 443 ssl;
  server_name default_server;

  # SSL
  ssl on;
  ssl_certificate /etc/nginx/conf.d/domain.crt;
  ssl_certificate_key /etc/nginx/conf.d/domain.key;

  # Recommendations from https://raymii.org/s/tutorials/Strong_SSL_Security_On_nginx.html
  ssl_protocols TLSv1.1 TLSv1.2;
  ssl_ciphers 'EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH';
  ssl_prefer_server_ciphers on;
  ssl_session_cache shared:SSL:10m;

  # disable any limits to avoid HTTP 413 for large p_w_picpath uploads
  client_max_body_size 0;

  # required to avoid HTTP 411: see Issue #1486 (https://github.com/docker/docker/issues/1486)
  chunked_transfer_encoding on;

  location /v2/ {
    # Do not allow connections from docker 1.5 and earlier
    # docker pre-1.6.0 did not properly set the user agent on ping, catch "Go *" user agents    
    if (\$http_user_agent ~ "^(docker\/1\.(3|4|5(?!\.[0-9]-dev))|Go ).*\$" ) 
    {      
        return 404;
    }

    # To add basic authentication to v2 use auth_basic setting.
    auth_basic "Registry realm";
    auth_basic_user_file /etc/nginx/conf.d/nginx.htpasswd;

    set $test "";
        if ($remote_user ~* "^admin?" ) {
             set $test "${test}admin";
        }
        if ($request_method ~* "^(DELETE|PUT)$" ) {
             set $test "${test}write";
        }

        if ($test = "write") {
             return 401;
        }
        
    ## If $docker_distribution_api_version is empty, the header will not be added.
    ## See the map directive above where this variable is defined.
    add_header 'Docker-Distribution-Api-Version' 'registry/2.0' always;

    proxy_pass                          http://docker-registry;
    proxy_set_header  Host              \$http_host;   # required for docker client's sake
    proxy_set_header  X-Real-IP         \$remote_addr; # pass on real client's IP
    proxy_set_header  X-Forwarded-For   \$proxy_add_x_forwarded_for;
    proxy_set_header  X-Forwarded-Proto \$scheme;
    proxy_read_timeout                  900;
  }
}
EOF

(3)創建登錄用戶文件

   創建2個用戶：

   admin 權限：管理員 可以pull push 等

   readonly 權限： 只有pull 權限

htpasswd -b auth/nginx.htpasswd admin admin
htpasswd -b auth/nginx.htpasswd readonly readonly

(4)使用docker-compose啓動

cat <<EOF > docker-compose.yml
nginx:
  p_w_picpath: "nginx:latest"
  ports:
    - 443:443
  restart: always
  links:
    - registry:registry
  volumes:
    - `pwd`/auth/:/etc/nginx/conf.d

registry:
  p_w_picpath: registry:2.2.1
  ports:
    - 127.0.0.1:5000:5000
  restart: always
  volumes:
    - `pwd`/data:/var/lib/registry
EOF

啓動命令：

docker-compose up -d
(5)驗證
curl -i -k -v https://admin:[email protected]/v2/
登錄： docker login registry.test.com
查看上傳的鏡像信息： curl -i -k -v https://admin:[email protected]/v2/_catalog

客戶端docker配置

  2種方式

一.修改/etc/default/docker:
DOCKER_OPTS="--dns 223.5.5.5 --dns 223.6.6.6 --insecure-registry registry.test.com"
並重啓: service docker restart
或者
二.
cat domain.crt | sudo tee -a /etc/ssl/certs/ca-certificates.crt
並重啓: service docker restart

附贈 ansible模塊： 自動安裝nginx+registry私有倉庫創建

地址： https://github.com/vTNT/ansible-docker-registry-v2.git