由于需要使用Jenkins构建项目Docker镜像,安装好Jenkins Docker插件后需要远程连接管理Docker,记录下如何在Docker使用TLS加密开启远程TCP管理端口。

普通情况下我们在内网使用Docker只需简单在docker中开启-H tcp://0.0.0.0:2375就可以远程管理Docker了,但是为了安全我们建议使用TLS加密远程Docker端口,防止非法操作。我们宿主机为CentOS7,下面步骤基于该系统。

一、 防火墙开启TCP:2376端口,Docker官方建议2375为非加密端口,2376为加密端口。

firewall-cmd --zone=public --add-port=2376/tcp --permanent
firewall-cmd --reload

二、生成Docker TLS加密证书,我们把证书放在/opt/docker/certs目录下,使用下面证书生成shell,生成对应证书(注意替换参数)。

#!/bin/bash

#相关配置信息
HOST="xxx.xxx.xxx.xxx"
PASSWORD="xxxxxxx"
COUNTRY="CN"
STATE="SiChuan"
CITY="Chengdu"
ORGANIZATION="XXXX"
ORGANIZATIONAL_UNIT="XXXX"
EMAIL="xxx@xxx.com"

###开始生成文件###
echo "开始生成文件"

#切换到生产密钥的目录
mkdir -p /opt/docker/certs
cd /opt/docker/certs
#生成ca私钥(使用aes256加密)
openssl genrsa -aes256 -passout pass:$PASSWORD -out ca-key.pem 4096
#生成ca证书,填写配置信息(签发了100年)
openssl req -new -x509 -passin "pass:$PASSWORD" -days 36500 -key ca-key.pem -sha256 -out ca.pem -subj "/C=$COUNTRY/ST=$STATE/L=$CITY/O=$ORGANIZATION/OU=$ORGANIZATIONAL_UNIT/CN=$HOST/emailAddress=$EMAIL"

#生成server证书私钥文件
openssl genrsa -out server-key.pem 4096
#生成server证书请求文件
openssl req -subj "/CN=$HOST" -sha256 -new -key server-key.pem -out server.csr
#使用CA证书及CA密钥以及上面的server证书请求文件进行签发,生成server自签证书
sh -c 'echo "subjectAltName=DNS:'$HOST',IP:'$HOST'" > extfile.cnf'
sh -c 'echo "extendedKeyUsage=serverAuth" >> extfile.cnf'

openssl x509 -req -days 36500 -sha256 -in server.csr -CA ca.pem -CAkey ca-key.pem -passin "pass:$PASSWORD" -CAcreateserial -out server-cert.pem -extfile extfile.cnf

#生成client证书RSA私钥文件
openssl genrsa -out key.pem 4096
#生成client证书请求文件
openssl req -subj '/CN=client' -new -key key.pem -out client.csr

sh -c 'echo "extendedKeyUsage=clientAuth" > extfile-client.cnf'
#生成client自签证书(根据上面的client私钥文件、client证书请求文件生成)
openssl x509 -req -days 36500 -sha256 -in client.csr -CA ca.pem -CAkey ca-key.pem -passin "pass:$PASSWORD" -CAcreateserial -out cert.pem -extfile extfile-client.cnf

#更改密钥权限
chmod 0400 ca-key.pem key.pem server-key.pem
#更改密钥权限
chmod 0444 ca.pem server-cert.pem cert.pem
#删除无用文件
rm client.csr server.csr

echo "生成文件完成"
###生成结束###

三、Docker服务开启TCP监听,创建/etc/systemd/system/docker.service.d/tcp.conf 或者编辑/usr/lib/systemd/system/docker.service 文件,并执行systemctl daemon-reload systemctl restart docker使之立即生效。

[Service]
ExecStart=
ExecStart=/usr/bin/dockerd \
        --tlsverify --tlscacert=/opt/docker/certs/ca.pem \
                    --tlscert=/opt/docker/certs/server-cert.pem \
                    --tlskey=/opt/docker/certs/server-key.pem \
        -H unix:///var/run/docker.sock -H tcp://0.0.0.0:2376
ExecReload=/bin/kill -s HUP $MAINPID