进阶 yourls.org 2026-11-19 17:39:56 · 2 阅读
第21章 YOURLS 配置文件密码加密指南
Credentials
在配置文件中如何使用加密密码。
在 config.php 中,变量 $yourls_user_passwords 应包含一个由用户名和密码组成的数组。
为提升安全性和用户体验,YOURLS 会自动加密配置文件中的这些密码。
在 config.php 中编辑登录名和密码
以简单的键 => 值关联数组形式编辑并保存你的配置文件,示例如下:
单组登录名/密码:
$yourls_user_passwords = array(
'joe' => 'MyPassword',
);
多组用户及登录名/密码对: $yourls_user_passwords = array(
'joe' => 'MyPassword',
'Randall' => 'correct horse battery staple',
'leetboy' => 'h3ll0w0rld!',
'api' => 'passwordfortheapi',
);
密码自动加密 下次运行 YOURLS 时,该数组会被重写,明文密码将替换为不可逆的加密哈希值。此时若查看你的 config.php,应能看到类似以下的内容: $yourls_user_passwords = array(
'joe' => 'phpass:!2a!08!gRCCvpvK22BgiNzN9q9fXOnjCXqQoZP/P0wydAj7bB2',
'api' => 'phpass:!2a!08!m4IbkpuC0jjDIab7yRvjXeljjvcOJTASFL5nagml1Dm',
// etc.
);
用户仍然可以使用用户名 joe 和密码 MyPassword 登录,但密码不会再以明文形式出现在配置文件的任何地方。 极客小贴士:我们使用的是 PHP 默认的密码哈希算法——截至撰写时的 Blowfish,这是业界标准的高强度单向哈希算法。它会把你的密码加密得滴水不漏,连 NSA 也无从破解。 FAQ 报错:"Could not auto-encrypt passwords" 如果 YOURLS 无法编辑并保存你的 config.php 文件,会看到如下提示: Could not auto-encrypt passwords. Error was: "cannot write file". 这通常是因为你的配置文件被设置了只读或禁止写入的权限(例如通过 chmod),而这本身也是一种不错的安全措施。解决办法:在终端里先记下当前的权限(stat -c "%a" config.php),临时放开限制(chmod 0666 config.php),重新加载一次 YOURLS 页面,然后再把权限改回原值(例如 chmod 600 config.php)。 报错:"Password stored as MD5 hash" 如果你的 config.php 中还是用旧式的 md5() 加密密码,建议改用更健壮的哈希方式。方法很简单:把形如 md5:<5位数字>:<32个字符> 的字符串替换为明文密码,再重新加载一次 YOURLS 页面即可,之后密码会自动以新方式加密。 为什么要对密码做哈希? 以加密哈希的形式存储密码更安全:即使有人拿到了你的 config.php,也无法推算出你的密码,也就无法登录你的系统。缺点是如果你自己忘了密码,就没法找回来了——参见下文。 我不记得密码了 / 想修改密码 直接编辑 config.php,写入新的明文密码即可。下次加载 YOURLS 时,它会自动重新加密。 我不想加密密码 如果出于某些原因,你就是想让密码以明文形式保存在配置里,只需在 config.php 末尾加上: define( 'YOURLS_NO_HASH_PASSWORD', true );
'joe' => 'MyPassword',
);
多组用户及登录名/密码对: $yourls_user_passwords = array(
'joe' => 'MyPassword',
'Randall' => 'correct horse battery staple',
'leetboy' => 'h3ll0w0rld!',
'api' => 'passwordfortheapi',
);
密码自动加密 下次运行 YOURLS 时,该数组会被重写,明文密码将替换为不可逆的加密哈希值。此时若查看你的 config.php,应能看到类似以下的内容: $yourls_user_passwords = array(
'joe' => 'phpass:!2a!08!gRCCvpvK22BgiNzN9q9fXOnjCXqQoZP/P0wydAj7bB2',
'api' => 'phpass:!2a!08!m4IbkpuC0jjDIab7yRvjXeljjvcOJTASFL5nagml1Dm',
// etc.
);
用户仍然可以使用用户名 joe 和密码 MyPassword 登录,但密码不会再以明文形式出现在配置文件的任何地方。 极客小贴士:我们使用的是 PHP 默认的密码哈希算法——截至撰写时的 Blowfish,这是业界标准的高强度单向哈希算法。它会把你的密码加密得滴水不漏,连 NSA 也无从破解。 FAQ 报错:"Could not auto-encrypt passwords" 如果 YOURLS 无法编辑并保存你的 config.php 文件,会看到如下提示: Could not auto-encrypt passwords. Error was: "cannot write file". 这通常是因为你的配置文件被设置了只读或禁止写入的权限(例如通过 chmod),而这本身也是一种不错的安全措施。解决办法:在终端里先记下当前的权限(stat -c "%a" config.php),临时放开限制(chmod 0666 config.php),重新加载一次 YOURLS 页面,然后再把权限改回原值(例如 chmod 600 config.php)。 报错:"Password stored as MD5 hash" 如果你的 config.php 中还是用旧式的 md5() 加密密码,建议改用更健壮的哈希方式。方法很简单:把形如 md5:<5位数字>:<32个字符> 的字符串替换为明文密码,再重新加载一次 YOURLS 页面即可,之后密码会自动以新方式加密。 为什么要对密码做哈希? 以加密哈希的形式存储密码更安全:即使有人拿到了你的 config.php,也无法推算出你的密码,也就无法登录你的系统。缺点是如果你自己忘了密码,就没法找回来了——参见下文。 我不记得密码了 / 想修改密码 直接编辑 config.php,写入新的明文密码即可。下次加载 YOURLS 时,它会自动重新加密。 我不想加密密码 如果出于某些原因,你就是想让密码以明文形式保存在配置里,只需在 config.php 末尾加上: define( 'YOURLS_NO_HASH_PASSWORD', true );