进阶 yourls.org 2026-11-19 17:39:56 · 2 阅读
第20章 配置详解
第20章 配置
本页介绍如何编辑 user/config.php 文件(请使用纯文本编辑器,如记事本)
MySQL 设置
YOURLS_DB_USER
MySQL 用户名。示例:
define( 'YOURLS_DB_USER', 'joe' );
YOURLS_DB_PASS MySQL 密码。示例: define( 'YOURLS_DB_PASS', 'MySeCreTPaSsW0rd' );
YOURLS_DB_NAME 数据库名称。示例: define( 'YOURLS_DB_NAME', 'yourls' );
YOURLS_DB_HOST 数据库主机地址。示例: define( 'YOURLS_DB_HOST', 'localhost' );
YOURLS_DB_PREFIX YOURLS 所有数据表的前缀名。示例: define( 'YOURLS_DB_PREFIX', 'yourls_' );
站点选项 YOURLS_SITE 你的域名地址(建议尽量简短),不带末尾斜杠,使用小写字母。如果选定了不带 www 的域名形式,浏览器访问时也不要用带 www 的版本(反之亦然)。示例: define( 'YOURLS_SITE', 'https://your-own-domain-here.com' );
YOURLS_PRIVATE 设为 true(私有模式)时,后台管理区域将使用下方定义的用户名和密码进行保护。 详见相关页面。 示例: define( 'YOURLS_PRIVATE', true );
YOURLS_UNIQUE_URLS 是否允许同一个长链接对应多个短链接。 设为 true 表示一个短链接只能对应一个长链接(YOURLS 默认行为);设为 false 则允许多个短链接指向同一个长链接(类似 bit.ly 的做法)。 示例: define( 'YOURLS_UNIQUE_URLS', true );
YOURLS_COOKIEKEY 用于加密 cookie 的随机密钥哈希。不需要记住它,但建议设置得足够长、足够复杂。提示:可在 yourls.org/cookie 生成一个独一无二的值。 示例: define( 'YOURLS_COOKIEKEY', 'qQ4KhL_pu|s@Zm7n#%:b^{A[vhm' );
$yourls_user_passwords 私有模式下,允许访问站点的用户名和密码列表。 密码可以是明文,也可以是加密形式。详见相关页面。 示例: $yourls_user_passwords = array(
'joe' => 'MyPassword',
);
短链接生成设置 YOURLS_URL_CONVERT 短链接的生成方式。详见相关页面。示例: define('YOURLS_URL_CONVERT', 36);
$yourls_reserved_URL 保留关键字列表,这些关键字不会被用作短链接。可在此定义负面、不希望使用或容易引起误解的关键字。 示例: 'porn', 'faggot', 'sex', 'nigger', 'fuck', 'cunt', 'dick'
可选设置 YOURLS_PRIVATE_INFOS 即使 YOURLS_PRIVATE 设为 true,你仍然可以将统计页面设为公开。示例: define('YOURLS_PRIVATE_INFOS', false);
YOURLS_DB_PASS MySQL 密码。示例: define( 'YOURLS_DB_PASS', 'MySeCreTPaSsW0rd' );
YOURLS_DB_NAME 数据库名称。示例: define( 'YOURLS_DB_NAME', 'yourls' );
YOURLS_DB_HOST 数据库主机地址。示例: define( 'YOURLS_DB_HOST', 'localhost' );
YOURLS_DB_PREFIX YOURLS 所有数据表的前缀名。示例: define( 'YOURLS_DB_PREFIX', 'yourls_' );
站点选项 YOURLS_SITE 你的域名地址(建议尽量简短),不带末尾斜杠,使用小写字母。如果选定了不带 www 的域名形式,浏览器访问时也不要用带 www 的版本(反之亦然)。示例: define( 'YOURLS_SITE', 'https://your-own-domain-here.com' );
YOURLS_PRIVATE 设为 true(私有模式)时,后台管理区域将使用下方定义的用户名和密码进行保护。 详见相关页面。 示例: define( 'YOURLS_PRIVATE', true );
YOURLS_UNIQUE_URLS 是否允许同一个长链接对应多个短链接。 设为 true 表示一个短链接只能对应一个长链接(YOURLS 默认行为);设为 false 则允许多个短链接指向同一个长链接(类似 bit.ly 的做法)。 示例: define( 'YOURLS_UNIQUE_URLS', true );
YOURLS_COOKIEKEY 用于加密 cookie 的随机密钥哈希。不需要记住它,但建议设置得足够长、足够复杂。提示:可在 yourls.org/cookie 生成一个独一无二的值。 示例: define( 'YOURLS_COOKIEKEY', 'qQ4KhL_pu|s@Zm7n#%:b^{A[vhm' );
$yourls_user_passwords 私有模式下,允许访问站点的用户名和密码列表。 密码可以是明文,也可以是加密形式。详见相关页面。 示例: $yourls_user_passwords = array(
'joe' => 'MyPassword',
);
短链接生成设置 YOURLS_URL_CONVERT 短链接的生成方式。详见相关页面。示例: define('YOURLS_URL_CONVERT', 36);
$yourls_reserved_URL 保留关键字列表,这些关键字不会被用作短链接。可在此定义负面、不希望使用或容易引起误解的关键字。 示例: 'porn', 'faggot', 'sex', 'nigger', 'fuck', 'cunt', 'dick'
可选设置 YOURLS_PRIVATE_INFOS 即使 YOURLS_PRIVATE 设为 true,你仍然可以将统计页面设为公开。示例: define('YOURLS_PRIVATE_INFOS', false);
YOURLS_PRIVATE_API
将 YOURLS_PRIVATE 设为 true 后,仍可选择开放 API。示例:
define('YOURLS_PRIVATE_API', false);
YOURLS_NOSTATS
将 YOURLS_NOSTATS 设为 true 后,系统将不记录重定向,且无法提供统计功能。示例:
define('YOURLS_NOSTATS', true);
保护你的配置文件
尤其是在共享主机环境中,良好的实践是修改文件权限以禁止写入。最佳做法是用新密码编辑 config.php,运行 YOURLS 使其加密,然后移除写入权限。
根据你的主机配置,建议将 config.php 权限设为 400、440 或 600。可通过命令行实现(chmod 0440 config.php),或使用 FTP 客户端。如需进一步了解,请咨询主机支持。