Docker 安装 Nginx 并自定义挂载配置文件

比眉伴天荒 2022-11-07 14:38 297阅读 0赞

### 目录 ###

*  1. 下载 Nginx 容器镜像
 *  2. 查看本地是否有 Nginx 镜像
 *  3. 启动前的准备工作
 *  4. 启动容器，并挂载配置文件
 *  5. 测试是否启动成功

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

# 1. 下载 Nginx 容器镜像 #

`docker pull nginx`

【注】默认下载的是 `latest` 最新版本，如果需要其他版本请前往 `Docker` 官方 `Nginx` 镜像库查看： [https://hub.docker.com/\_/nginx?tab=tags][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.conf`：`nginx` 主配置文件

# 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` 启动成功后，能够看到下面的网页。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BlbmcyaHVpMTMxNA_size_16_color_FFFFFF_t_70]

<!DOCTYPE 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.conf`：`nginx` 主配置文件。
 *  `/etc/nginx/conf.d`： `nginx` 子配置文件，一般域名配置，端口映射都放在该目录下，当然也可以放在其他目录；如果放置其他目录需要提前规划好，并设置相应的目录挂载。
 *  `/var/log/nginx`：`nginx` 的日志文件。

# 5. 测试是否启动成功 #

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

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

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

博客地址： [Docker 安装 Nginx 并自定义挂载配置文件][Docker _ Nginx]

[https_hub.docker.com_nginx_tab_tags]: https://hub.docker.com/_/nginx?tab=tags
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BlbmcyaHVpMTMxNA_size_16_color_FFFFFF_t_70]: /images/20221023/f7565553fa3e4035af111434912d9871.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BlbmcyaHVpMTMxNA_size_16_color_FFFFFF_t_70 1]: /images/20221023/2d74944d35ef44f799c7eaf296ee0657.png
[Docker]: http://roc.havemail.cn/archives/843.html
[Docker _ Nginx]: http://roc.havemail.cn/archives/889.html