10. docker nginx官方镜像使用方法

        本文介绍docker nginx官方镜像使用方法，因为第一次用，在加上对docker也不是很熟，中间踩了一些坑，为了避免下一次用又踩坑，因此记录如下，也希望能够帮到其它小伙伴。

        官方镜像页面：https://hub.docker.com/_/nginx

        镜像拉取 docker pull nginx

        拉取镜像后可以启动镜像 docker run --name nginx -p 80:80 -d 1ee494ebb83f

        但是光启动镜像，用处不大，因为首先你需要有个有意义的配置文件才比较有用。

        不过也不是一点儿用处没有，至少你可以用它验证你的nginx配置文件有没有错，比如这样：docker exec nginx(容器名称) nginx -t -c /tmp/nginx.conf

        下面就来讲讲配置文件，是我踩坑比较多的地方，我配置文件大概是这样的，中间隐去了我项目中的一些具体内容，不过没关系，不妨碍演示：

user admin;
worker_processes auto;
error_log /home/admin/nginx/logs/nginx_error.log warn;
pid /home/admin/nginx/logs/nginx.pid;
worker_rlimit_nofile 65535;

events {
    use epoll;
    worker_connections 65535;
}

http {
    include mime.types;
    default_type application/octet-stream;
    server_tokens off;

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

    # charset utf-8;
    server_names_hash_bucket_size 128;
    client_header_buffer_size 32k;
    large_client_header_buffers 4 32k;
    client_max_body_size 300m;
    sendfile on;
    tcp_nopush on;
    keepalive_timeout 0;
    tcp_nodelay on;
    client_body_buffer_size 512k;
    fastcgi_intercept_errors on;

    proxy_connect_timeout 90;
    proxy_read_timeout 180;
    proxy_send_timeout 180;
    proxy_buffer_size 256k;
    proxy_buffers 4 256k;
    proxy_busy_buffers_size 256k;
    proxy_temp_file_write_size 256k;
    proxy_intercept_errors on;
    server_name_in_redirect off;
    proxy_hide_header X-Powered-By;

    gzip on;
    gzip_min_length 100;
    gzip_buffers 4 16k;
    gzip_http_version 1.0;
    gzip_comp_level 9;
    gzip_types text/plain application/x-javascript application/javascript text/javascript text/css application/xml application/json;
    gzip_vary on;
    gzip_proxied any;

    error_page 400 401 402 403 404 405 408 410 412 413 414 415 500 501 502 503 506 = http://www.xx.com/error.html;

    server {
        listen 80;
        server_name localhost;

        location /web {
            alias /home/admin/api;
        }

        access_log /home/admin/nginx/logs/api_access.log;
        error_log /home/admin/nginx/logs/api_error.log;
    }
}

        我是这么启动镜像的
docker run --name nginx -p 80:80 -v /home/admin/nginx/api.conf:/etc/nginx/conf.d/default.conf -d 1ee494ebb83f
        我启动的时候，把我的nginx配置文件放到了/home/admin/nginx/api.conf 下，并把它映射到了容器的/etc/nginx/conf.d/default.conf文件上，但是这样启动的时候，容器启动不起来，启动报错信息可以用命令 docker logs nginx（容器名称）看到。

        报错原始信息我没有记录下来，意思是说配置文件开头的user admin;这一行不合法，出现在了不该出现的位置。但是我明明用nginx -t -c 验证过的。我把user admin 这行注释掉了，然后docker start nginx 发现还是起不来，查看日志说 worker_processes auto; 这一行不合法，出现在了不应该出现的位置。

        我想了下，觉得肯定是我没明白docker nginx容器的启动方式，然后我大模型了一下，果然，nginx启动的时候，默认会加载/etc/nginx/nginx.conf下的配置文件，这个文件内容大概是这样的

user  nginx;
worker_processes  auto;

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;
    keepalive_timeout  65;

    include /etc/nginx/conf.d/*.conf;
}

        这个文件会include /etc/nginx/conf.d/*.conf;怪不得说我配置文件格式不对呢。

        然后我把配置文件修改成了两部分，一部分作为nginx.conf,一部分作为default.conf, nginx.conf如下：

user admin;
worker_processes auto;
error_log /home/admin/nginx/logs/nginx_error.log warn;
pid /home/admin/nginx/logs/nginx.pid;
worker_rlimit_nofile 65535;

events {
    use epoll;
    worker_connections 65535;
}

http {
    include mime.types;
    default_type application/octet-stream;
    server_tokens off;

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

    # charset utf-8;
    server_names_hash_bucket_size 128;
    client_header_buffer_size 32k;
    large_client_header_buffers 4 32k;
    client_max_body_size 300m;
    sendfile on;
    tcp_nopush on;
    keepalive_timeout 0;
    tcp_nodelay on;
    client_body_buffer_size 512k;
    fastcgi_intercept_errors on;

    proxy_connect_timeout 90;
    proxy_read_timeout 180;
    proxy_send_timeout 180;
    proxy_buffer_size 256k;
    proxy_buffers 4 256k;
    proxy_busy_buffers_size 256k;
    proxy_temp_file_write_size 256k;
    proxy_intercept_errors on;
    server_name_in_redirect off;
    proxy_hide_header X-Powered-By;

    gzip on;
    gzip_min_length 100;
    gzip_buffers 4 16k;
    gzip_http_version 1.0;
    gzip_comp_level 9;
    gzip_types text/plain application/x-javascript application/javascript text/javascript text/css application/xml application/json;
    gzip_vary on;
    gzip_proxied any;

    error_page 400 401 402 403 404 405 408 410 412 413 414 415 500 501 502 503 506 = http://www.xx.com/error.html;
}

        另一部分作为default.conf(文件名api.conf)的配置如下：

server {
        listen 80;
        server_name localhost;

        location /web {
            alias /home/admin/api;
        }

        access_log /home/admin/nginx/logs/api_access.log;
        error_log /home/admin/nginx/logs/api_error.log;
    }

        然后我用这个命令启动：docker run --name nginx -p 80:80 -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf -v $(pwd)/api.conf:/etc/nginx/conf.d/default.conf -d 1ee494ebb83f

        这次终于不报错格式不对了，但是报错/home/admin/nginx/logs/目录不存在，报错原因是nginx容器中没有这个目录，解决方法是把本地目录挂载到docker中，启动命令我修改成了这样 ：docker run --name nginx -p 80:80 -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf -v $(pwd)/api.conf:/etc/nginx/conf.d/default.conf -v /home:/home -d 1ee494ebb83f

        我启动了一把，还是报错，报错的意思是说/etc/mime.types文件不存在，指向这一行代码 include mime.types;我查看了一下，我宿主机中有这个文件，于是我又修改了一把启动命令：docker run --name nginx -p 80:80 -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf -v $(pwd)/api.conf:/etc/nginx/conf.d/default.conf -v /home:/home -v /etc/mime.types:/etc/mime.types -d 1ee494ebb83f

        这次终于起来了！