春节前,我看到 Nginx 加入了 HTTP/2 的 server push 功能,就很想试一下。
正好这些天,我在学习 Docker,就想到可以用 Nginx 容器。万一哪里改乱了,直接删掉,再重启一个容器就可以了。
下面就是我搭建 Nginx 容器的过程,以及如何加入 SSL 证书。你会看到 Docker 用来测试软件的新功能,真的很方便,很值得学习。如果你还不会 Docker,可以先看《Docker 入门教程》,非常简单,半小时以内就能学会。
一、HTTP 服务
Nginx 的最大作用,就是搭建一个 Web Server。有了容器,只要一行命令,服务器就架设好了,完全不用配置。
$ docker container run \ -d \ -p 127.0.0.2:8080:80 \ --rm \ --name mynginx \ nginx
上面命令下载并运行官方的 Nginx image,默认是最新版本(latest),当前是 1.13.9。如果本机安装过以前的版本,请删掉重新安装,因为只有 1.13.9 才开始支持 server push。
上面命令的各个参数含义如下。
-d
:在后台运行-p
:容器的80
端口映射到127.0.0.2:8080
--rm
:容器停止运行后,自动删除容器文件--name
:容器的名字为mynginx
如果没有报错,就可以打开浏览器访问 127.0.0.2:8080 了。正常情况下,显示 Nginx 的欢迎页。
然后,把这个容器终止,由于--rm
参数的作用,容器文件会自动删除。
$ docker container stop mynginx
二、映射网页目录
网页文件都在容器里,没法直接修改,显然很不方便。下一步就是让网页文件所在的目录/usr/share/nginx/html
映射到本地。
首先,新建一个目录,并进入该目录。
$ mkdir nginx-docker-demo $ cd nginx-docker-demo
然后,新建一个html
子目录。
$ mkdir html
在这个子目录里面,放置一个index.html
文件,内容如下。
<h1>Hello World</h1>
接着,就可以把这个子目录html
,映射到容器的网页文件目录/usr/share/nginx/html
。
$ docker container run \ -d \ -p 127.0.0.2:8080:80 \ --rm \ --name mynginx \ --volume "$PWD/html":/usr/share/nginx/html \ nginx
打开浏览器,访问 127.0.0.2:8080,应该就能看到 Hello World 了。
三、拷贝配置
修改网页文件还不够,还要修改 Nginx 的配置文件,否则后面没法加 SSL 支持。
首先,把容器里面的 Nginx 配置文件拷贝到本地。
$ docker container cp mynginx:/etc/nginx .
上面命令的含义是,把mynginx
容器的/etc/nginx
拷贝到当前目录。不要漏掉最后那个点。
执行完成后,当前目录应该多出一个nginx
子目录。然后,把这个子目录改名为conf
。
$ mv nginx conf
现在可以把容器终止了。
$ docker container stop mynginx
四、映射配置目录
重新启动一个新的容器,这次不仅映射网页目录,还要映射配置目录。
$ docker container run \ --rm \ --name mynginx \ --volume "$PWD/html":/usr/share/nginx/html \ --volume "$PWD/conf":/etc/nginx \ -p 127.0.0.2:8080:80 \ -d \ nginx
上面代码中,--volume "$PWD/conf":/etc/nginx
表示把容器的配置目录/etc/nginx
,映射到本地的conf
子目录。
浏览器访问 127.0.0.2:8080,如果能够看到网页,就说明本地的配置生效了。这时,可以把这个容器终止。
$ docker container stop mynginx
五、自签名证书
现在要为容器加入 HTTPS 支持,第一件事就是生成私钥和证书。正式的证书需要证书当局(CA)的签名,这里是为了测试,搞一张自签名(self-signed)证书就可以了。
下面,我参考的是 DigitalOcean 的教程。首先,确定你的机器安装了 OpenSSL,然后执行下面的命令。
$ sudo openssl req \ -x509 \ -nodes \ -days 365 \ -newkey rsa:2048 \ -keyout example.key \ -out example.crt
上面命令的各个参数含义如下。
req
:处理证书签署请求。-x509
:生成自签名证书。-nodes
:跳过为证书设置密码的阶段,这样 Nginx 才可以直接打开证书。-days 365
:证书有效期为一年。-newkey rsa:2048
:生成一个新的私钥,采用的算法是2048位的 RSA。-keyout
:新生成的私钥文件为当前目录下的example.key
。-out
:新生成的证书文件为当前目录下的example.crt
。
执行后,命令行会跳出一堆问题要你回答,比如你在哪个国家、你的 Email 等等。
其中最重要的一个问题是 Common Name,正常情况下应该填入一个域名,这里可以填 127.0.0.2。
Common Name (e.g. server FQDN or YOUR name) []:127.0.0.2
回答完问题,当前目录应该会多出两个文件:example.key
和example.crt
。
conf
目录下新建一个子目录certs
,把这两个文件放入这个子目录。
$ mkdir conf/certs $ mv example.crt example.key conf/certs
六、HTTPS 配置
有了私钥和证书,就可以打开 Nginx 的 HTTPS 了。
首先,打开conf/conf.d/default.conf
文件,在结尾添加下面的配置。
server { listen 443 ssl http2; server_name localhost; ssl on; ssl_certificate /etc/nginx/certs/example.crt; ssl_certificate_key /etc/nginx/certs/example.key; ssl_session_timeout 5m; ssl_ciphers HIGH:!aNULL:!MD5; ssl_protocols SSLv3 TLSv1 TLSv1.1 TLSv1.2; ssl_prefer_server_ciphers on; location / { root /usr/share/nginx/html; index index.html index.htm; } }
然后,启动一个新的 Nginx 容器。
$ docker container run \ --rm \ --name mynginx \ --volume "$PWD/html":/usr/share/nginx/html \ --volume "$PWD/conf":/etc/nginx \ -p 127.0.0.2:8080:80 \ -p 127.0.0.2:8081:443 \ -d \ nginx
上面命令中,不仅映射了容器的80端口,还映射了443端口,这是 HTTPS 的专用端口。
打开浏览器,访问 https://127.0.0.2:8081/ 。因为使用了自签名证书,浏览器会提示不安全。不要去管它,选择继续访问,应该就可以看到 Hello World 了。
至此,Nginx 容器的 HTTPS 支持就做好了。有了这个容器,下一篇文章,我就来试验 HTTP/2 的 server push 功能。
七、参考链接
- Tips for deploying nginx(official image) with docker, by Mario Ponticello
- How To Run Nginx in a Docker Container on Ubuntu 14.04, by Thomas Taege
- Official Docker Library docs, by Docker
- How To Create a Self-Signed SSL Certificate for Nginx in Ubuntu 16.04, by Justin Ellingwood
(完)
islishude 说:
官方现在推荐使用 `--mount` 替代 `--volume`
2018年2月27日 08:16 | # | 引用
ryan 说:
请问,能否把配置好的容器,共享给其他人使用的方法也贴出来。
2018年2月27日 08:30 | # | 引用
业余草 说:
内容有点少,讲的不是很全!
2018年2月27日 09:39 | # | 引用
cnBruceHong 说:
这文章有点水了
2018年2月27日 13:24 | # | 引用
Orange 说:
如果有个视频该多好啊 文字看着有时候不太直观
2018年2月27日 14:16 | # | 引用
昨夜风 说:
写的很好,由浅入深,娓娓道来
2018年2月27日 14:27 | # | 引用
yayang 说:
windows 下 --volume "$PWD/html" 输入了不显示,而且也不成功。
2018年2月27日 14:42 | # | 引用
阮一峰 说:
@yayang:
那行命令只能在 Bash 下运行。Windows 下,你需要把 $PWD/html 替换成绝对路径。
2018年2月27日 15:31 | # | 引用
Seahurt 说:
挺好的,对于新手来说这个教程足够了
2018年2月27日 16:08 | # | 引用
smite 说:
django 集成 nginx http2 server push demo: https://github.com/DistPub/nginx-http2-django-server-push
2018年2月27日 17:51 | # | 引用
牟勇 说:
在 windows 的 git-for-bash 中 ,使用该方式可以避免一些报错 winpty docker container run --rm --publish 80:80 --publish 443:443 --volume /`pwd`/html:/usr/share/nginx/html --volume /`pwd`/nginx:/etc/nginx nginx
2018年2月28日 08:59 | # | 引用
ITGeeker 说:
谢谢分享,不过我在centos 7底下运行有两个问题:
# docker: 'container' is not a docker command.
# Conflicting options: --rm and -d
第一个把container去掉就可以了
第二个把--rm去掉可以了,但需要手动删除container,否则有冲突
2018年2月28日 09:54 | # | 引用
Jae 说:
啥时候讲讲 iptables 和 docker 一起使用。
2018年2月28日 23:07 | # | 引用
rui 说:
它们本来就是一起使用的。映射端口就是通过iptables
2018年3月 1日 11:43 | # | 引用
onbing 说:
ssl 证书,阿里云有免费的
2018年3月 1日 18:57 | # | 引用
hooyes 说:
哈哈,阮老师写这文章的时候有点着急了。
2018年3月 2日 11:00 | # | 引用
pain 说:
太水了。。。
2018年3月 6日 19:51 | # | 引用
Sue 说:
非常有用,谢谢阮老师
2018年3月15日 09:35 | # | 引用
里恩 说:
我看到了 GitLab 的 icon 了
2018年3月15日 16:41 | # | 引用
陈天赐 说:
阮叔 你到底会多少东西 拜服!
2018年3月31日 22:26 | # | 引用
sgqm 说:
为什么是127.0.0.2而不是127.0.0.1呢?折腾半天一直报错,发现改成127.0.0.1就对了。
2018年4月17日 10:36 | # | 引用
小明同学 说:
这个教程的容器要怎么创建一个 image, docker commit container-id 吗?
但是将容器里程序目录复制出来, 并更改了配置这些操作怎么能包含进去?
2018年4月24日 21:06 | # | 引用
java小子 说:
非常有用,最近正在学
2018年5月25日 17:15 | # | 引用
发哥 说:
哈哈,我看第一眼,就觉得这里会是个坑。。。
2018年6月 4日 17:14 | # | 引用
翻跟头 说:
教程只是个示例参考,自己做测试的时候使用-p 8080:80就行了的
2018年6月 5日 16:57 | # | 引用
koreadragon 说:
阮老师的文章一直是这种大道至简的,那些评论说文章水的,一看就是第一次来
2018年7月 6日 15:25 | # | 引用
Andy Chen 说:
太感谢这片文章了,一开始用apache的docker image,各种问题,看到阮老师的nginx教程,全部搞定!非常感谢!
2018年7月20日 11:08 | # | 引用
jackma 说:
非常实用,赞????
2018年7月26日 20:19 | # | 引用
king 说:
二、映射网页目录
$ docker container run \
-d \
-p 127.0.0.2:8080:80 \
--rm \
--name mynginx \
--volume "$PWD/html":/usr/share/nginx/html \
nginx
为什么访问是 403 Forbidden
2018年7月31日 14:43 | # | 引用
Being 说:
@king:
可能是$PWD/html路径有问题,建议写成本地绝对路径。$PWD指当前目录。
2018年9月15日 17:35 | # | 引用
Jonas 说:
docker container run \
--rm \
--name mynginx \
--volume "$PWD/html":/usr/share/nginx/html \
--volume "$PWD/conf":/etc/nginx \
-p 127.0.0.2:8080:80 \
-d \
nginx
上面的地址应该是 127.0.0.1 吧
2019年3月 1日 15:21 | # | 引用
jake 说:
在第一部分,用 docker 启动 nginx 时,应该是
docker container run \
-d \
-p 127.0.0.1:8080:80 \
--rm \
--name mynginx \
nginx
2019年4月10日 18:52 | # | 引用
栀子浅香 说:
您好,您的有些命令会自动加了转义符 导致命令报错 例如:运行容器的相关命令 docker container run
2019年7月 8日 09:16 | # | 引用
Jacky 说:
想请教下,基于docker安装了nginx,现在想加一些nginx的第三方扩展模块,请问该如何操作?
2019年7月21日 17:49 | # | 引用
iwhyer 说:
Mac电脑 HTTPS 配置之后,运行失败。那创建容器,但是运行不了。
2019年12月16日 00:50 | # | 引用
aaa 说:
受益终身!!!
2020年4月26日 18:20 | # | 引用
子非鱼 说:
/usr/share/nginx/html 这个目录在哪里,自己随便创建吗,小白不太懂
2020年8月 4日 15:44 | # | 引用
路过啊 说:
有人就是看完了懂了,然后扔一句 太水 太简单
戾气太重,可能被加班加的哈哈
2020年8月12日 10:09 | # | 引用
w 说:
有人就是看完了懂了,然后扔一句 太水 太简单
戾气太重,可能被加班加的哈哈
2021年8月16日 10:32 | # | 引用
Prometheus 说:
--volume参数可以用-v代替
2022年11月23日 22:50 | # | 引用