配置 Nginx 的目录浏览功能

   <p>有时候我们需要将服务器上的某些目录共享出来，让其他人可以直接通过浏览器去访问、浏览或者下载这些目录里的一些文件。</p>    <p>最近我就正好需要将一些静态的 HTML 页面部署到服务器上，让自己的多台设备能随时随地进行查看。</p>    <p>经过搜索之后找到了两个方法：一是使用 Node 的 http-server ，二是使用 Nginx 自带的 ngx_http_autoindex_module 模块。由于我自己的博客就是使用 Nginx 部署的，所以我就选择了第二种方法。</p>    <p>本篇文章介绍如何打开 Nginx 的目录浏览功能，配置简单的密码保护，并对索引页面进行美化。</p>    <h2>配置目录浏览</h2>    <p>要开启 Nginx 的目录浏览功能很简单，只需要打开 nginx.conf 或者对应的虚拟主机配置文件，在 server 或 location 段里面中上 autoindex on; 就可以了。</p>    <p>除了 autoindex 外，该模块还有两个可用的字段：</p>    <pre>  <code class="language-nginx">autoindex_exact_size on;  # 默认为 on，以 bytes 为单位显示文件大小；  # 切换为 off 后，以可读的方式显示文件大小，单位为 KB、MB 或者 GB。    autoindex_localtime on;  # 默认为 off，以 GMT 时间作为显示的文件时间；  # 切换为 on 后，以服务器的文件时间作为显示的文件时间。  </code></pre>    <p>除此之外，如果二级目录使用的是虚拟目录，则需要使用 alias 字段进行配置。</p>    <p>下面是一个完整的配置文件：</p>    <pre>  <code class="language-nginx">location /download {      alias /home/user/static_files/;            autoindex on;      autoindex_exact_size off;      autoindex_localtime on;  }  </code></pre>    <h2>中文乱码问题</h2>    <p>如果开启了 Nginx 的目录浏览功能后发现中文目录名或者文件名显示为乱码，则要加上 charset 字段：</p>    <pre>  <code class="language-nginx">location /download {      # ... 其它同上      charset utf-8,gbk; # 两个字符集间不要加空格  }  </code></pre>    <h2>添加目录密码保护</h2>    <p>如果该目录是隐私目录，就需要为其增加密码保护。方法如下：</p>    <pre>  <code class="language-nginx">location /download {      # ... 其它同上            auth_basic "Enter your name and password";      auth_basic_user_file /var/www/html/.htpasswd;  }  </code></pre>    <p>其中， auth_basic 字段是用户名、密码弹框上显示的文字（貌似在 Chrome 和 Safari 上面都没有用到），而 auth_basic_user_file 指定了记录登录用户名与密码的文件 .htpasswd ，这个文件需要使用 htpasswd 命令或者 在线工具 来生成。</p>    <p>htpasswd 命令是 MacOS 系统自带的命令，如果是 Windows 系统，建议直接使用在线生成工具比较方便。</p>    <pre>  <code class="language-nginx"># 创建一个全新的文件，会清除文件里的全部用户  $ htpasswd -c /var/www/html/.htpasswd user1    # 添加一个用户，如果用户已存在，则修改密码  $ htpasswd -b /var/www/html/.htpasswd user2 password  # 删除一个用户  $ htpasswd -D /var/www/html/.htpasswd user2  </code></pre>    <p>到目前为止，我们已经完成了对 Nginx 目录浏览的全部配置。但是，默认的页面样式有点难看，我们要对其进行一些美化（装扮QQ空间即视感）。</p>    <p>如果对页面样式没有要求，下面的部分就不需要阅读了。</p>    <h2>使用 FancyIndex 进行美化</h2>    <h3>安装 FancyIndex</h3>    <p>网上的 FancyIndex 安装教程大多数是在编译 nginx 时，添加这个插件。但是，由于我的服务器是 ubuntu 系统，安装时图方便直接使用了 apt-get install nginx 安装了 nginx。如果说现在为了安装一个 FancyIndex 要重新进行一次 nginx 的编译和配置，我想我也没那个折腾的心情。</p>    <p>幸好 ubuntu 最好的地方就在于它的仓库源很多。在 ubuntu 系统上，我们可以通过安装 nginx-extras 来安装 FancyIndex 插件。</p>    <pre>  <code class="language-nginx">$ sudo apt-get install nginx-extras  </code></pre>    <p>安装完成之后，就要对页面进行美化了。</p>    <p>由于我不是前端，要真让我自己手写来对页面进行调整，那估计就不是美化，而是对页面的摧毁了。幸好，对于美化的东西，网上正常都能找到主题或者模板，FancyIndex 也不例外。 这里 就有一个简洁大方的主题可以直接拿来使用。</p>    <h3>配置 FancyIndex</h3>    <p>首先，将 这个主题 克隆下来。</p>    <p>在网站根目录（如 /var/www/html ）下新建一个 fancyindex 目录，然后将下面的文件复制到该目录中：</p>    <ul>     <li>header.html</li>     <li>footer.html</li>     <li>css/fancyindex.css</li>     <li>fonts/*</li>     <li>images/breadcrumb.png</li>    </ul>    <p>最后修改 nginx 配置文件，下面是完整的配置文件：</p>    <pre>  <code class="language-nginx">location /download {   alias /home/user/static_files/;   charset utf-8,gbk;     auth_basic "Enter your name and password";   auth_basic_user_file /var/www/html/.htpasswd;     fancyindex on;   fancyindex_exact_size off;   fancyindex_localtime on;   fancyindex_header "/fancyindex/header.html";   fancyindex_footer "/fancyindex/footer.html";   fancyindex_ignore "fancyindex";  }  </code></pre>    <p>注意，使用 fancyindex 之后需要将 autoindex 相关的字段去掉，否则可能会造成冲突。</p>    <p>文档 上面说明了有两个字段 fancyindex_default_sort 和 fancyindex_name_length 可以分别用来指定文件排序和文件名的最大长度，但是我试过之后都不起作用，可能是由于 nginx-extras 里面的 FancyIndex 版本比较低的缘故。</p>    <p>下图是配置完后的最终效果：</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/bee617c6ce408f6a6f9c7a34e78633e7.png"></p>    <p> </p>    <p>来自：http://www.swiftyper.com/2016/12/08/nginx-autoindex-configuration/</p>    <p> </p>