当前位置： 首页>后端>正文

通过nginx访问静态文件

后端2024-05-03 15:03:31

有时候我们想通过浏览器来访问某台电脑上的文件，如在某台远程机器上进行了测试，生成了网页版测试报告，不想把文件拷贝回来在本地打开，而是通过浏览器直接查看；又或者是本地有很多份报告，一个一个文件夹打开浏览不方便，想要借助浏览器前进回退的功能直接浏览。要实现该操作，可以在机器上安装httpd服务，或者是nginx服务，本文介绍nginx方式。

起nginx服务有2种方案，一种是在主机上直接安装nginx，另一种是起一个nginx容器。

主机安装nginx方案(推荐)

nginx安装及配置文件

  • 安装： apt install -y nginx或brew install -y nginx
  • 配置文件路径查看：执行nginx -t命令即可看到。编辑配置文件，添加下面的内容即可。

配置静态资源访问

  • alias关健字方案
server{
    listen 7001;
    location /file/ {
         alias /home/china/areas/; # 结尾一定要带上/
         autoindex on;   #打开目录浏览功能
         autoindex_exact_size off; #默认为on，显示出文件的确切大小，单位是bytes。   off显示出文件的大概大小，单位是kB或者MB或者GB
         autoindex_localtime on; #默认为off，显示的文件时间为GMT时间。 改为on后，显示的文件时间为文件的服务器时间
         add_header Cache-Control no-store; #让浏览器不保存临时文件
         charset utf-8,gbk; # 避免中文乱码
    }
}

此时访问http://127.0.0.1:7001/file/t.txt，则访问服务器的文件是/home/china/areas/t.txt

  • root关键字方案
server{
    listen 7001;
    location /test/ {
         root /home/china/areas/; # 结尾一定要带上/
         autoindex on;   #打开目录浏览功能
         autoindex_exact_size off; #默认为on，显示出文件的确切大小，单位是bytes。   off显示出文件的大概大小，单位是kB或者MB或者GB
         autoindex_localtime on; #默认为off，显示的文件时间为GMT时间。 改为on后，显示的文件时间为文件的服务器时间
         add_header Cache-Control no-store; #让浏览器不保存临时文件
         charset utf-8,gbk; # 避免中文乱码
    }
}

此时，通过浏览器访问http://127.0.0.1:7001/test/t.txt，则访问服务器的文件是/home/china/areas/test/t.txt。

  • 简单来说，alias是做路径替换，root是做拼接。

注意，浏览器打开地址时，如果不是访问具体文件，而是访问目录，最后一定要带上/，如http://127.0.0.1:7001/test/

docker容器nginx方案

容器nginx方案踩坑点比较多，一般建议采用主机上安装nginx方案。

启动nginx及配置文件内容

  • 启动命令
    docker run -d -v /root/nginx/nginx.conf:/etc/nginx/nginx.conf -v /home/wang/html:/usr/share/nginx/html -p 6565:80 nginx
  • nginx.conf配置文件内容
user  root;                    # 启动 Nginx 主进程的用户名，推荐用root，避免权限问题
worker_processes  auto;         # 启动的 worker 进程数，默认为 1 ，设置成 auto 则会等于 CPU 核数
# worker_shutdown_timeout 60s;  # 限制 worker 进程优雅终止的超时时间。默认没有超时时间，可能一直于 shutting down 状态
error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;  # 将 Nginx 主进程的 PID 记录到该文件中

events {
    worker_connections  512; 
}

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;
    # gzip  on;
#    include /etc/nginx/conf.d/*.conf;
    server{
    listen 80;
        location /{
            root /usr/share/nginx/;
             autoindex on;
             autoindex_exact_size off;
             autoindex_localtime on;
             add_header Cache-Control no-store;
        }
    }
}
  • 浏览器打开localhost:6565就可以看到一个html文件夹。

常见问题解决

注意，改完配置文件后，请手动nginx -s reload，或者重启一下容器。

权限问题--403报错

权限的原因有很多，下面先给解决方案，再说明原因。

解决方案

给要暴露的目录增加755的权限chmod -R 755 /your/path/to/expose
如前面nginx.conf配置的root的目录为/home/wang/html，则执行chmod -R 755 /home/wang/html

原因通过nginx访问静态文件,\uparrow,第1张

给755权限一般解决的是主机部署时的无权限问题。nginx服务创建目录索引需要有目录的rx权限，但起nginx服务的用户可能不是root，会缺少该权限。如果你是容器方式起的nginx，可以检查下nginx.conf中的user是不是root，如果不是可以改为root(挂载主机文件到容器之后，文件在容器中的权限和其在主机中的权限一致，即root会拥有最高权限)，或者是在容器内执行下前面的命令。可以用namei -l /path/to/expose来看下各层目录的权限，如namei -l /home/wang/html。

解决方案

修改nginx.conf文件中的user配置，将user nginx或者是user www等改为nginx root。
一般是容器化部署会碰到，主机部署比较少见。查看docker日志可以看到*1 directory index of "/usr/share/nginx/html/" is forbidden这种报错。

原因通过nginx访问静态文件,\uparrow,第1张

原因分析同上一个解决方案，给root权限。

解决方案

主要针对容器化部署场景，主机方式部署没碰到过，详见下面原因分析。
把nginx.conf中的include /etc/nginx/conf.d/*.conf;这一行注释掉。这是一个简单粗暴的方法，因为这种问题比较少见，

原因通过nginx访问静态文件,\uparrow,第1张

原因是/etc/nginx/conf.d目录下有一个default.conf文件，这个文件里一般会配置上/的访问配置，如果你在nginx.conf中也配置了/这个location的访问配置，而且include语句在你自己配置的地址前面，那你的配置就不会生效！！

同样的问题也会出现在/etc/nginx/conf.d目录下有多个配置文件的时候，nginx是按照顺序读取配置文件的，如果多个文件location有相同配置的话，就会有不生效的情况。

那为什么主机部署碰不到，容器会会碰到呢？ 我看了下mac，linux主机下的nginx配置目录，mac下根本没有conf.d这个目录，nginx.conf也没有那条include语句；linux下conf.d目录是个空目录；只有容器化部署不知道为啥生成了这个default.conf，可能我部署的几个nginx版本不一样？另外，linux下默认的配置文件地址为/etc/nginx/sites-enabled/default。

404问题

这种问题一般是配置文件配置错了，导致找不到文件，可以再检查下配置文件。

连接不上问题

  1. 检查端口是否开放
  2. 检查selinux、防火墙、路由规则配置。setenforce 0

访问80端口时显示欢迎页面

原因是配置文件被默认配置覆盖掉了。linux系统下有一个默认配置文件/etc/nginx/sites-enabled/default，把这个文件里80端口的配置注释掉，或者是将自己写的配置文件放到/etc/nginx/conf.d/目录下。

参考

https://blog.csdn.net/chinabestchina/article/details/73556785


https://www.xamrdz.com/backend/3kn1941309.html

相关文章：