很多时候我们需要对一些网站进行密码保护,比如团队内部的站点、demo站点等等。这里所说的密码保护是服务器级的,并非网站应用层的注册登录那一套,而是利用服务器配置和htpasswd文件来实现访问的密码验证。
最后的效果就类似(不同浏览器的界面有所不同):
Authorization Required
![](https://box.kancloud.cn/2f09d309c232536ac39168ea17c48f37_970x416.png)
如果认证失败,就会报HTTP错误:401 Authorization Required。
要实现这样的功能,就需要更改服务器的配置,并设定好用于登录的用户名和密码。
首先我们需要更改网站的Nginx的server配置,Ubuntu服务器的话这个配置文件通常位于/etc/nginx/sites-enabled/,比如我这里就使用默认的配置文件/etc/nginx/sites-enabled/default来做一个例子:
server {
server_name www.fancycedar.info
root /www/fancycedar
# ...
location / {
# 添加下面两行
auth_basic "Restricted";
auth_basic_user_file htpasswd;
# ...
}
# ...
}
接下来需要创建htpasswd文件,这里有一些细节需要注意:
htpasswd的路径
和nginx.conf在同一级目录即可。Ubuntu服务器的话一般就在/etc/nginx/下面。
htpasswd的内容
每一行为一个用户,格式为username:password。但是要注意,这里的password不是明文,而是将password进行crypt(3)加密后的字符串。
你可以使用一段PHP代码来生成htpasswd中的password:
// 密码明文
$password = 'some password';
// 对密码进行加密
$password = crypt($password, base64_encode($password));
// 获得加密后的密码
echo $password;
然后将字符串写入htpasswd文件中:
username1:xucqMk13TfooE
username2:YXTfb3xWKOMBM
htpasswd的权限
【linux系统下】
需要更改htpasswd文件的权限,执行如下命令:
sudo chown root:www-data htpasswd
sudo chmod 640 htpasswd
重启Nginx服务器:
sudo /etc/init.d/nginx reload | sudo /etc/init.d/nginx restart
【windows下】
重启Nginx服务器:
# 补充:
nginx basic auth
主要包含两个值:auth_basic 和auth_basic_user_file
auth_basic
语法: auth_basic string | off;
默认值: auth_basic off;
配置段: http, server, location, limit_except
默认表示不开启认证,后面如果跟上字符,这些字符会在弹窗中显示。
auth_basic_user_file
语法: auth_basic_user_file file;
默认值: —
配置段: http, server, location, limit_except
htpasswd
基本格式:
htpasswd [-cmdpsD] passwordfile username
htpasswd -b[cmdpsD] passwordfile username password
htpasswd -n[mdps] username
htpasswd -nb[mdps] username password
参数说明:
b
使用批处理方式,从命令行中获得密码,而不显示提示要求输入。 此选项的使用应该极为谨慎,因为命令行中的密码是清晰可见的。
c
建立passwdfile文件。如果passwdfile已经存在,则它被重写并截断。 此选项不能与-n选项同时使用。
n
在标准输出设备上显示结果,而不更新文件。 用于生成可以为Apache非文本输出存储格式所接受的密码记录。 此选项在命令行中的语法有所改变,因为passwdfile参数(通常是第一个)被省略了。 此选项不能与-c选项同时使用。
m
使用MD5加密密码。在Windows, Netware 和TPF上,这是默认的。
d
使用crypt()加密密码。在除了Windows, Netware和TPF的平台上(比如linux),这是默认的。 虽然它在所有平台上可以为htpasswd所支持, 但是在Windows, Netware和TPF上不能为httpd服务器所支持。
s
使用SHA加密密码。 它是为了方便转入或移植到使用LDAP Directory Interchange Format (ldif)的Netscape而设计的。
p
使用纯文本的密码。虽然在所有平台上htpasswd都可以建立这样的密码, 但是httpd后台只在Windows, Netware和TPF上支持纯文本的密码。
passwdfile
包含用户名和密码的文件的名称。 如果使用了-c,而此文件不存在则建立,如果已经存在,则重写并截断此文件。
username
需要在passwdfile中建立或更新的用户名。 如果此文件中username不存在,则增加一项,如果已经存在,则改变其密码。
password
将被加密并存储到文件中的纯文本的密码。仅用于和-b选项同时使用。
注:htpasswd所管理的文件可以包含两种类型的密码,有些用户的密码使用MD5加密的,而同一个文件中的其他用户是用crypt()加密的。