Nginx 站点与认证

# Nginx 站点与认证

Nginx制作下载站点
Nginx用户认证模块

# Nginx制作下载站点

首先我们先要清楚什么是下载站点？

我们先来看一个网站 http://nginx.org/download/ (opens new window)

这个是大家去下载 Nginx 时经常访问的网站，该网站主要就是用来提供用户来下载相关资源的网站，就叫做下载网站。

如何制作一个下载站点：

Nginx 使用的是模块 ngx_http_autoindex_module 来实现的（自带），该模块处理以斜杠(『 / 』)结尾的请求，并生成目录列表。
Nginx 编译的时候会自动加载该模块，但是该模块默认是关闭的，我们需要使用下来指令来完成对应的配置

# autoindex

autoindex 指令启用或禁用目录列表的输出

语法	默认值	位置
autoindex <on \| off>;	autoindex off;	http、server、location

# autoindex_exact_size

autoindex_exact_size 指令对应 HTLM 格式，指定是否在目录列表展示文件的详细大小。

默认为 on，显示出文件的确切大小，单位是 bytes。

改为 off 后，显示出文件的大概大小，单位是 kB 或者 MB 或者 GB。

语法	默认值	位置
autoindex_exact_size <on \| off>;	autoindex_exact_size on;	http、server、location

# autoindex_format

autoindex_format 指令设置目录列表的格式。

语法	默认值	位置
autoindex_format <html \| xml \| json \| jsonp>;	autoindex_format html;	http、server、location

只有当 autoindex_format 指令设置为 html 时候，上方的 autoindex_exact_size 指令才会起作用。

注意

该指令在 1.7.9 及以后版本中出现。

# autoindex_localtime

autoindex_localtime 指令对应 HTML 格式，是否在目录列表上显示时间。

默认为 off，显示的文件时间为 GMT 时间。

改为 on 后，显示的文件时间为文件的服务器时间。

语法	默认值	位置
autoindex_localtime <on \|off>;	autoindex_localtime off;	http、server、location

# 实现案例

自行准备几个文件或者压缩包，我这里准备了 4 个用过的压缩包。

创建一个目录，将压缩包放入其中，我这里创建的路径是 /opt/download

mkdir /opt/download

效果如下:

[root@master download]# pwd
/opt/download
[root@master download]# ll
总用量 545504
-rw-r--r--. 1 root root 408587111 3月  12 22:02 hadoop-2.10.1.tar.gz
-rw-r--r--. 1 root root 145520298 3月  12 21:29 jdk-8u301-linux-x64.tar.gz
-rw-r--r--  1 root root     25680 4月  27 2017 mysql57-community-release-el7-11.noarch.rpm
-rw-r--r--  1 root root   4456335 5月   9 19:40 mysql-connector-java-5.1.48.tar.gz

1
2
3
4
5
6
7
8

打开 Nginx 的配置文件

vim /usr/local/nginx/conf/nginx.conf

添加配置如下内容：

注意

root 指令后面必须是下载路径，因为我的下载路径是 /opt/download，所以这里填写 /opt，而 location 的 /download 会自动拼接到后面，形成完整的下载路径。

访问 192.168.91.200/download

JSON和XML格式(一般不用这两种格式)

# Nginx用户认证模块

对应系统资源的访问，我们往往需要限制谁能访问，谁不能访问。这块就是我们通常所说的认证部分，认证需要做的就是根据用户输入的用户名和密码来判定用户是否为合法用户，如果是则放行访问，如果不是则拒绝访问。

Nginx 对应用户认证这块是通过 ngx_http_auth_basic_module 模块来实现的，它允许通过使用「HTTP基本身份验证」协议验证用户名和密码来限制对资源的访问。默认情况下 Nginx 是已经安装了该模块，如果不需要则使用 --without-http_auth_basic_module 删除认证模块。

该模块的指令比较简单。

# auth_basic

auth_basic 指令使用「HTTP基本身份验证」协议启用用户名和密码的验证。默认关闭。

语法	默认值	位置
auth_basic <string \| off>;	auth_basic off;	http、server、location、limit_except

开启后，服务端会返回 401，指定的字符串会返回到客户端，给用户以提示信息，但是不同的浏览器对内容的展示不一致。

# auth_basic_user_file

auth_basic_user_file 指令指定用户名和密码所在文件，包括所在的路径。

语法	默认值	位置
auth_basic_user_file ;	—	http、server、location、limit_except

指定文件路径，该文件中设置用户名和密码，密码需要进行加密。可以采用工具自动生成。

# 实现案例

在配置文件 nginx.conf 添加如下内容：

我们需要使用 htpasswd 工具生成包含用户名和密码的文件

yum install -y httpd-tools

该工具基本操作指令如下：

htpasswd -c /usr/local/nginx/conf/htpasswd username   # 创建一个新文件记录用户名和密码，密码后面弹出输入
htpasswd -b /usr/local/nginx/conf/htpasswd username password   # 在指定文件新增一个用户名和密码
htpasswd -D /usr/local/nginx/conf/htpasswd username   # 从指定文件删除一个用户信息
htpasswd -v /usr/local/nginx/conf/htpasswd username   # 验证用户名和密码是否正确

1
2
3
4

根据需求指定生成路径的位置。

我们创建一个 frx 的用户名，密码是 123456

可以查看生成的文件内容

[root@master conf]# cat /usr/local/nginx/conf/htpasswd
frx:$apr1$wDXdSh0O$yR66Agylnta9zupO7cD3k.

1
2

浏览器访问 192.168.91.200/download

上述方式虽然能实现用户名和密码的验证，但是大家也看到了，所有的用户名和密码信息都记录在文件里面，如果用户量过大的话，这种方式就显得有点麻烦了，这时候我们就得通过后台业务代码来进行用户权限的校验了。

帮助我改善此页面

#Nginx

上次更新: 2024年3月20日

← Nginx 部署与集群 Nginx Lua学习→