通过Laradock学Docker-HTTPS

前言

上一篇文章我们对laradock的配置文件有了一个初步的了解，现在我们基本可以随心所欲的配置网站了，以此做为我们的开发环境可以说是方便快捷。

鉴于越来越多的平台要求接入网站提供https协议的接口。如何让我们的网站也支持https，已经迫在眉睫。

接下来我们来通过laradock学习下，如何让我们的网站支持https协议。

实现方式

目前来说，让网站支持https大概有两种方案，一种是向代理证书的公司购买证书，这种方式可以获得1年以上的服务器，当然时间的长度取决于你们之间合约的长短了。

另一种方案是通过let's encrypt或symantec等公司提供的免费证书，这种方式一般合约期短，每三个月需要重新申请一次。

laradock项目中已经集成了let's encrypt公司的证书申请工具，我们来看看如何实现的。

配置文档

docker-compose.yml

我们找到配置文件中certbot的代码

    certbot:
      build:
        context: ./certbot
      volumes:
        - ./data/certbot/certs/:/var/certs
        - ./certbot/letsencrypt/:/var/www/letsencrypt
      environment:
        - CN="fake.domain.com"
        - EMAIL="fake.email@gmail.com"
      networks:
        - frontend

配置里说明了容器基于certbot这个目录，然后把laradock/data/certbot/certs目录映射到容器内/var/certs，把laradock/certbot/letsencrypt目录映射到容器内的/var/www/letsencrypt

配合文档，我们看一下certbot目录中都有什么文件

letsencrypt  (dir)
Dockerfile
run-certbot.sh

这里有一个letsencrypt目录，这个目录是干什么用的我们先按住不表，一个dockerfile和一个shell脚本文件。

Dockerfile的内容

FROM phusion/baseimage:latest

MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>

RUN apt-get update
RUN apt-get install -y letsencrypt

COPY run-certbot.sh /root/certbot/run-certbot.sh

ENTRYPOINT bash -c "bash /root/certbot/run-certbot.sh && sleep infinity"

这是一个基于ubuntu的基础镜像，安装了let's encrypt的自动化证书下载工具。

先将run-certbot.sh复制到容器的目标目录下(/root/certbot)，并执行。

最后通过sleep infinity使得容器保持执行状态。

run-certbot.sh

#!/bin/bash

letsencrypt certonly --webroot -w /var/www/letsencrypt -d "$CN" --agree-tos --email "$EMAIL" --non-interactive --text

cp /etc/letsencrypt/archive/"$CN"/cert1.pem /var/certs/cert1.pem
cp /etc/letsencrypt/archive/"$CN"/privkey1.pem /var/certs/privkey1.pem

可以根据需要修改需要引用的文件

其实这个文件主要命令就一行

letsencrypt certonly --webroot -w /var/www/letsencrypt -d "$CN" --agree-tos --email "$EMAIL" --non-interactive --text

这行命令的是目的是：在/var/www/letsencrypt这个（容器中）目录下生成well-known/acme-challenge/这两个文件夹，文件夹中成生一个随机文件，然后let's encrypt的服务端去检测能不能访问到这个文件，如果能访问到就说明申请人拥有该域名的控制权，并将证书下载至/etc/letsencrypt/archive/"$CN"/目录下；如果不能访问此临时文件，则说明申请不拥有该域名或配置不正确。而最后两行则是把证书复制到指定目录，以便之后将文件映射到本地目录。

注意：无论能否成功访问到临时文件，工具都会在检测结束后将此文件删除。

default.conf（80端口）

所以看到这里我们就知道了，我们还不可以直接去运行这个容器，因为我们的nginx容器还无法访问到certbot这个容器中的/var/www/letsencrypt这个目录，我们看一下nginx的站点配置文件是怎么写的

server {

    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

    server_name localhost;
    root /var/www/public;
    index index.php index.html index.htm;

    location / {
         try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        try_files $uri /index.php =404;
        fastcgi_pass php-upstream;
        fastcgi_index index.php;
        fastcgi_buffers 16 16k;
        fastcgi_buffer_size 32k;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        #fixes timeouts
        fastcgi_read_timeout 600;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }

    location /.well-known/acme-challenge/ {
        root /var/www/letsencrypt/;
        log_not_found off;
    }
}

我们看到配置文件的最后写明了/.well-know/acme-challenge/这个目录指向了/var/www/letsencrypt/这个目录。这样的话我们将certbot容器中的/var/www/letsencrypt和nginx容器中的/var/www/letsencrypt映射到本地同一目录就可以了，而nginx容器是基于共用卷applications的，那么我们只要把certbot容器也改到共用卷下就可以了，也就是之前我们按住不表的部分。

修改docker-compose.yml（certbot）

certbot:
      build:
        context: ./certbot
      volumes_from:
        - applications
      volumes:
        - ./data/certbot/certs/:/var/certs
      environment:
        - CN="fake.domain.com"
        - EMAIL="fake.email@gmail.com"
      networks:
        - frontend

请将配置中fake.domain.com改为你自己的域名，并将fake.email@gmail.com改为你自己的邮箱

如此一来，我们就可以尝试运行一次certbot容器了

docker-compose up -d certbot

我们看下运行结果：

• If you lose your account credentials, you can recover through
  e-mails sent to fake.domain.com.
• Congratulations! Your certificate and chain have been saved at
  /etc/letsencrypt/live/fake.domain.com/fullchain.pem. Your
  cert will expire on 2018-06-03. To obtain a new version of the
  certificate in the future, simply run Let's Encrypt again.
• Your account credentials have been saved in your Let's Encrypt
  configuration directory at /etc/letsencrypt. You should make a
  secure backup of this folder now. This configuration directory will
  also contain certificates and private keys obtained by Let's
  Encrypt so making regular backups of this folder is ideal.
• If you like Let's Encrypt, please consider supporting our work by:

  Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate
  Donating to EFF: https://eff.org/donate-le

至此我们的certbot容器就运行成功了，并生成了证书文件。我们只需要接下来把证书文件映射到nginx可访问到的目录下并在站点配置文件中增加443端口访问的相关配置就可以了。

修改docker-compose.yml（nginx）

增加

- ./data/certbot/certs/:/var/certs

修改default.conf（443端口）

server {

    listen 443;
    listen [::]:443;

    server_name localhost;
    root /var/www/public;
    index index.php index.html index.htm;
    
    ssl on;
    ssl_certificate /var/certs/fullchain1.pem;
    ssl_certificate_key /var/certs/privkey1.pem;
    ssl_trusted_certificate /var/certs/chain1.pem;
    
    location / {
         try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        try_files $uri /index.php =404;
        fastcgi_pass php-upstream;
        fastcgi_index index.php;
        fastcgi_buffers 16 16k;
        fastcgi_buffer_size 32k;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        #fixes timeouts
        fastcgi_read_timeout 600;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

重启nginx

docker-compose build nginx
docker-compose restart nginx

结语

我们此次的配置是针对单一域名，如果想配置多域名，则在拷贝证书文件时多加一层域名目录就可以了。

至此我们就完成了整个配置，现在访问你设置好的域名就能看到域名前的小绿锁了。

最后，不要忘了证书的有效期是3个月，记得每两个月重启下容器或者配置下crontab，我们下期再见吧。