参考文档:
https://goharbor.io/docs/1.10/install-config/configure-https/
https://goharbor.io/docs/1.10/install-config/troubleshoot-installation/#https
默认情况下,Harbor不附带证书。可以在没有安全性的情况下部署Harbor,以便您可以通过HTTP连接到它。但是,只有在没有外部网络连接的空白测试或开发环境中,才可以使用HTTP。在没有空隙的环境中使用HTTP会使您遭受中间人攻击。在生产环境中,请始终使用HTTPS。如果启用Content Trust with Notary来正确签名所有图像,则必须使用HTTPS。
要配置HTTPS,必须创建SSL证书。您可以使用由受信任的第三方CA签名的证书,也可以使用自签名证书
1. 生成证书颁发机构证书
在生产环境中,您应该从CA获得证书。在测试或开发环境中,您可以生成自己的CA。要生成CA证书,请运行以下命令。
1.1 生成CA证书私钥。
openssl genrsa -out ca.key 4096
1.2 生成CA证书
调整-subj
选项中的值以反映您的组织。如果使用FQDN连接Harbor主机,则必须将其指定为通用名称(CN
)属性。
openssl req -x509 -new -nodes -sha512 -days 3650 \
-subj "/C=CN/ST=Beijing/L=Beijing/O=example/OU=Personal/CN=harbor.od.com" \
-key ca.key \
-out ca.crt
如果是ip访问, 将 harbor.od.com
改成 ip地址
2. 生成服务器证书
证书通常包含一个.crt
文件和一个.key
文件
2.1 生成私钥
openssl genrsa -out harbor.od.com.key 4096
2.2 生成证书签名请求(CSR)
openssl req -sha512 -new \
-subj "/C=CN/ST=Beijing/L=Beijing/O=example/OU=Personal/CN=harbor.od.com" \
-key harbor.od.com.key \
-out harbor.od.com.csr
如果是ip访问, 将 harbor.od.com
改成 ip地址
2.3 生成一个x509 v3扩展文件
无论您使用FQDN还是IP地址连接到Harbor主机,都必须创建此文件,以便可以为您的Harbor主机生成符合主题备用名称(SAN)和x509 v3的证书扩展要求。替换DNS
条目以反映您的域
cat > v3.ext <<-EOF
authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
extendedKeyUsage = serverAuth
subjectAltName = @alt_names
[alt_names]
DNS.1=harbor.od.com
DNS.2=harbor.od.com
DNS.3=harbor.od.com
EOF
- 如果是ip访问
cat > v3.ext <<-EOF
authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.31.200
EOF
2.4 使用该v3.ext
文件为您的Harbor主机生成证书
openssl x509 -req -sha512 -days 3650 \
-extfile v3.ext \
-CA ca.crt -CAkey ca.key -CAcreateserial \
-in harbor.od.com.csr \
-out harbor.od.com.crt
如果是ip访问, 将 harbor.od.com
改成 ip地址
3. 提供证书给Harbor和Docker
生成后ca.crt
,harbor.od.com.crt
和harbor.od.com.key
文件,必须将它们提供给Harbor
和docker
,重新配置它们
3.1 将服务器证书和密钥复制到Harbor主机上的/data/cert/
文件夹中
mkdir -p /data/cert/
cp harbor.od.com.crt /data/cert/
cp harbor.od.com.key /data/cert/
3.2 转换harbor.od.com.crt
为harbor.od.com.cert
,供Docker使用
Docker守护程序将.crt
文件解释为CA证书,并将.cert
文件解释为客户端证书
openssl x509 -inform PEM -in harbor.od.com.crt -out harbor.od.com.cert
3.3 将服务器证书,密钥和CA文件复制到Harbor主机上的Docker证书文件夹中。您必须首先创建适当的文件夹
mkdir -p /etc/docker/certs.d/harbor.od.com/
cp harbor.od.com.cert /etc/docker/certs.d/harbor.od.com/
cp harbor.od.com.key /etc/docker/certs.d/harbor.od.com/
cp ca.crt /etc/docker/certs.d/harbor.od.com/
如果将默认nginx
端口443 映射到其他端口,请创建文件夹/etc/docker/certs.d/yourdomain.com:port
或/etc/docker/certs.d/harbor_IP:port
3.4 重新启动Docker Engine
systemctl restart docker
3.5 证书的目录结构
/etc/docker/certs.d/
└── harbor.od.com
├── ca.crt
├── harbor.od.com.cert
└── harbor.od.com.key
4. 部署或重新配置Harbor
harbor.yml
hostname: harbor.od.com
http:
port: 80
https:
port: 443
certificate: /data/cert/harbor.od.com.crt
private_key: /data/cert/harbor.od.com.key
external_url: https://harbor.od.com
harbor_admin_password: Harbor12345
database:
password: root123
max_idle_conns: 50
max_open_conns: 100
data_volume: /data/harbor
clair:
updaters_interval: 12
jobservice:
max_job_workers: 10
notification:
webhook_job_max_retry: 10
chart:
absolute_url: disabled
log:
level: info
local:
rotate_count: 50
rotate_size: 200M
location: /data/harbor/logs
_version: 1.10.0
proxy:
http_proxy:
https_proxy:
no_proxy:
components:
- core
- jobservice
- clair
4.1 运行prepare
脚本以启用HTTPS
Harbor将nginx
实例用作所有服务的反向代理。您可以使用prepare
脚本来配置nginx
为使用HTTPS
./prepare
4.2 如果Harbor正在运行,请停止并删除现有实例
您的图像数据保留在文件系统中,因此不会丢失任何数据
docker-compose down -v
4.3 重启docker
docker-compose up -d
5. 验证HTTPS连接
打开浏览器,然后输入https://harbor.od.com。它应该显示Harbor界面
注意
然后登陆推送镜像测试, 如果服务器要推送代码到harbor, 必须在docker的配置文件的目录 /etc/docker/certs.d/harbor.od.com/
配置 服务器证书(harbor.od.com.cert
),密钥(harbor.od.com.key
)和CA文件(ca.crt
)