我是如何使用docker安装nginx并配置https服务的

---

前言

嗨，大家好，我是希留，一个被迫致力于全栈开发的老菜鸟。

因为最近新学习了个uni-app的项目。想要运行成小程序，但微信小程序的接口都是需要https请求才能访问到。这一下就难住了，该怎么把我的接口服务配置成可以https访问呢？

我的域名是腾讯云的域名，也已经备案好了的。正好可以申请免费的域名型（DV）SSL 证书，而且可以免费申请20个，够我用了。

这篇文章就来介绍一下，我是怎么使用docker安装nginx并配置https服务的。

---

一、前期准备

1、备案好的域名

想要申请SSL正书，就需要有个备案好的域名（以腾讯云为例）。想了解个人域名怎么备案的可以移步这篇文章了解一下个人域名备案详细流程（图文并茂）

2、安装nginx

为了图方便，这里是使用docker安装nginx的。所以需要具备一些docker的基础知识，相信会点开阅读的朋友也是对docker有一定了解的，这里就不啰嗦怎么安装docker了。

2.1 下载nginx的docker镜像

docker pull nginx

2.2 新建用于映射的目录

了解docker的都知道，docker容器启动后，容器内部有自己的文件系统，配置文件也在里面。因此我们需要把配置文件挂载到容器外部，也就是我们的linux服务器上。

例如我是在根目录下新建了如下目录：

mkdir /mydata/nginx/html -p
mkdir /mydata/nginx/log -p
mkdir /mydata/nginx/cert -p

2.3 从容器中拷贝nginx配置

• （1）先运行一次容器（为了拷贝配置文件）。

docker run -p 80:80 --name xiliu-nginx \
-v /mydata/nginx/html:/usr/share/nginx/html \
-v /mydata/nginx/logs:/var/log/nginx  \
-d nginx

• （2）将容器内的配置文件拷贝到指定目录。

docker container cp xiliu-nginx:/etc/nginx /mydata/nginx/

• （3）进入 /mydata/nginx/ 目录下，修改文件名称，把名称改为 conf。

mv nginx conf

• （4）终止并删除容器。

# 停止容器
docker stop xiliu-nginx
# 删除容器
docker rm xiliu-nginx

2.4 启动 nginx

经过2.3的步骤后，我们在linux服务器上就得到了nginx相关的配置文件了，接下来只需要挂载这些目录。

这样我们每次需要修改nginx的配置文件的时候，只要修改挂载到外部的文件，容器内的文件也会相应改变，能省很多功夫。（强烈建议挂载！！！）

docker run -p 80:80 -p 443:443 --name xiliu-yz-nginx \
-v /mydata/nginx/html:/usr/share/nginx/html \
-v /mydata/nginx/logs:/var/log/nginx  \
-v /mydata/nginx/conf:/etc/nginx \
-v /mydata/nginx/cert:/etc/nginx/cert \
-d nginx

启动完成后， 输入 docker ps 命令，可以看到正在运行的 docker 容器。当 nginx 启动成功后，我们只需要修改配置文件，就可以实现多个域名和https访问的需求啦。

二、配置步骤

1、申请免费的证书

进入腾讯云的控制台，找到 SSL证书，点击进入，然后申请免费版证书。需要注意的是：（免费版的证书只能是1个域名1个证书，不能通配。假如你是添加了多个子域名，则每个子域名都需要申请1个证书，腾讯云最多支持免费申请20个证书。）

申请步骤如下图所示：

2、下载证书

因为是在Nginx里面配置的，所以下载 Nginx类型的证书

3、把证书上传至服务器

下载到本地的证书压缩包解压后，把后缀名为 .key 和 .crt 的两个文件通过ftp等工具上传至服务器。最好放在服务器安装nginx的目录下。我的nginx是用docker安装的，所以放在了映射的目录里。如下图所示：

4、配置 .conf 文件

证书上传好之后，就可以配置 https 了。nginx的配置文件这里有必要说明一下（因为我的项目是前后端分离的项目，有多个域名。所以是拆分成了api.conf文件和lms.conf文件）

nginx.conf文件只做一个引入

真正的配置是在api.conf文件和lms.conf文件。

4.1 后端接口服务 api.conf 配置

• 配置如下所示，需要注意的是证书的路径（是nginx容器里面的路径，不是服务器的映射目录）

server {
    listen 80;
    listen 443 ssl;    #表示监听443端口即https
    server_name  api.xiliu.online; #域名
    ssl_certificate /etc/nginx/cert/api.xiliu.online_bundle.crt;   #证书文件路径
    ssl_certificate_key /etc/nginx/cert/api.xiliu.online.key;      #证书私钥文件路径
    ssl_session_timeout 5m;                                         #5分钟session会话保持
    #请按照以下协议配置
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;
    
    location / {
    	proxy_pass   http://xx.xx.xx.xx:xxxx; #接口服务的ip地址
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

}

• 配置完成后，重启 nginx 容器，使用 https 访问接口地址，如下图所示，可以成功访问。
  

4.2 前端项目 lms.conf 配置

• 上面只是配置的api接口服务的https，我们把前端项目也配置一下。因为我的前端项目有两个子域名，所以需要配置两个server ，具体配置如下所示：

server {
    listen 80;
    listen 443 ssl; #侦听443端口，用于SSL
    server_name yzht.xiliu.online; #域名
    ssl_certificate /etc/nginx/cert/yzht.xiliu.online_bundle.crt;   #证书文件路径
    ssl_certificate_key /etc/nginx/cert/yzht.xiliu.online.key;      #证书私钥文件路径
    ssl_session_timeout 5m;                                         #5分钟session会话保持
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;

    location / {
        root   /usr/share/nginx/html; #代理目录
        index  index.html index.htm;
        try_files $uri $uri/ /index.html;
    }
    location /prod-api { #反向代理
        rewrite ^.+prod-api/?(.*)$ /$1 break;
        proxy_pass https://api.xiliu.online;
            
   }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

• 配置完成后，重启 nginx 容器，使用 https 访问接口地址，可以成访问到页面，也能成功调用api的接口。
  
  
  

---

总结

以上就是本文的全部内容了，感谢大家的阅读。本文介绍了使用docker安装nginx服务，并使用腾讯云免费的SSL证书配置项目支持https访问。

如果觉得文章对你有帮助，还不忘帮忙点赞、收藏、关注、评论哟，您的支持就是我创作最大的动力！