操作环境为 Mac,其他系统大同小异。

1. 下载 Nginx 容器镜像

docker pull nginx

【注】默认下载的是 latest 最新版本,如果需要其他版本请前往 Docker 官方 Nginx 镜像库查看: https://hub.docker.com/_/nginx?tab=tags

2. 查看本地是否有 Nginx 镜像

docker images

【注】此步可以跳过,但最好还是看看,防止下载失败

3. 启动前的准备工作

一般启动容器的时候,只需要挂载相应的目录即可,不用做太多的操作;但是 Nginx 比较特殊,因为它还需要以下3个特殊的配置文件,只有3个文件都有了,我们才可以访问并看到实际成功的效果,知道 Nginx 启动成功了。

在存放配置文件的路径建立以下配置文件结构,并创建相应的文件与目录。

/roc/docker/nginx  -- 自己的根目录
├── nginx.conf -- 主配置文件
├── html 
	└──  index.html -- 存放 nginx 默认 index.html
├── conf.d 
	└──  default.conf -- 默认的子配置文件
└── log -- nginx 日志存放目录
	└──  xxx.log  
  • nginx.confnginx 主配置文件
# nginx.conf 官方原文件

user  nginx;
worker_processes  1;

error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    keepalive_timeout  65;

    #gzip  on;

    include /etc/nginx/conf.d/*.conf;
}
  • default.conf:位于 conf.d 目录下,默认的子配置文件,配置了默认的根路径,这样当启动功能的时候才能看到默认的网页。
# default.conf 官方原文件

server {
    listen       80;
    listen  [::]:80;
    server_name  localhost;

    #charset koi8-r;
    #access_log  /var/log/nginx/host.access.log  main;

    location / {
        root   /usr/share/nginx/html;
        index  index.html index.htm;
    }

    #error_page  404              /404.html;

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

    # proxy the PHP scripts to Apache listening on 127.0.0.1:80
    #
    #location ~ \.php$ {
    #    proxy_pass   http://127.0.0.1;
    #}

    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
    #
    #location ~ \.php$ {
    #    root           html;
    #    fastcgi_pass   127.0.0.1:9000;
    #    fastcgi_index  index.php;
    #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
    #    include        fastcgi_params;
    #}

    # deny access to .htaccess files, if Apache's document root
    # concurs with nginx's one
    #
    #location ~ /\.ht {
    #    deny  all;
    #}
}
  • index.html:位于 /usr/share/nginx/html 目录下,这样当 nginx 启动成功后,能够看到下面的网页。
    在这里插入图片描述
<!DOCTYPE html>
<!-- index.html 官方原文件 -->
<html>
<head>
<title>Welcome to nginx!</title>
<style>
    body {
        width: 35em;
        margin: 0 auto;
        font-family: Tahoma, Verdana, Arial, sans-serif;
    }
</style>
</head>
<body>
<h1>Welcome to nginx!</h1>
<p>If you see this page, the nginx web server is successfully installed and
working. Further configuration is required.</p>

<p>For online documentation and support please refer to
<a href="http://nginx.org/">nginx.org</a>.<br/>
Commercial support is available at
<a href="http://nginx.com/">nginx.com</a>.</p>

<p><em>Thank you for using nginx.</em></p>
</body>
</html>

4. 启动容器,并挂载配置文件

docker run \
  --name nginx81 \
  -d -p 81:80 \
  -v /Users/roc/docker/nginx/html:/usr/share/nginx/html \
  -v /Users/roc/docker/nginx/nginx.conf:/etc/nginx/nginx.conf \
  -v /Users/roc/docker/nginx/conf.d:/etc/nginx/conf.d \
  -v /Users/roc/docker/nginx/log:/var/log/nginx \
  nginx

每个路径的作用:

  • /usr/share/nginx/html : nginx 默认的网页文件存放目录,如果需要部署前端的代码,建议提前规划挂载其他目录;或者在该目录下建立目录,并在配置文件中指定即可(为了安全,需要删除默认的 default.conf,指定网页被访问的域名)
  • /etc/nginx/nginx.confnginx 主配置文件。
  • /etc/nginx/conf.dnginx 子配置文件,一般域名配置,端口映射都放在该目录下,当然也可以放在其他目录;如果放置其他目录需要提前规划好,并设置相应的目录挂载。
  • /var/log/nginxnginx 的日志文件。

5. 测试是否启动成功

访问 http://localhost:81/ 查看 nginx 是否正常启动。

在这里插入图片描述
Nginx 有很多的玩法,只不过使用 Docker 的话操作上或许有些复杂,但是配置文件挂载到宿主机器上还是有保障的,最起码不会因为容器的挂掉而束手无策。

如果觉着这样麻烦也可以直接在 Docker 的容器中进行更改,具体请参考:Docker 进入容器,并在容器内执行命令

博客地址: Docker 安装 Nginx 并自定义挂载配置文件

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐