通过 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/fake.domain.com/fullchain1.pem;
    ssl_certificate_key /var/certs/fake.domain.com/privkey1.pem;
    ssl_trusted_certificate /var/certs/fake.domain.com/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,我们下期再见吧。

可以与作者交流

qrcode

Copyright © coding01 2017 all right reserved,powered by Gitbook该文件修订时间: 2018-06-17 22:20:20

results matching ""

    No results matching ""