前言

Hexo 作为静态博客，对外链的统计能力是有限的，为了增强这一能力，决定另外启动一个程序对外链进行统一管理，在检索一番后决定使用 Yourls 这个开源项目。(后来发现太麻烦，还是随缘使用了 hhh)

一、安装

1.1 数据库配置

由于服务器都统一使用宝塔面板进行部署，故数据库也基于该工具进行安装，在管理界面中选择左侧数据库标签页，选择 安装Mysql环境，个人选择的版本是 Mysql 5.7，页面提示推荐 编译安装，但具体需要根据个人云服务器情况进行选择，低于 4C16G 的配置建议使用 急速安装。

安装完成后创建用户，可以通过宝塔面板添加：(数据库名 yourls，用户名 yourls，密码 yourls123456，选择本地服务器)

（可选）也可以登录系统后通过命令行添加，shell 命令参考如下：

shell
1
2
3
4
5
6
7
8
9
10
#登录数据库，root密码在面板数据库页面可以看到
mysql -u root -p
#为提高安全性，仅创建本地用户yourls，密码自行修改
create user yourls@localhost identified by 'yourls123456';
#创建yourls数据库
create database yourls;
#授予yourls用户数据库权限
grant all privileges on yourls.* to 'yourls'@'localhost';
#刷新权限以生效
flush privileges;

1.2 Yourls 安装配置

1. 在网站中选择添加 PHP 项目，创建对应目录，随后从 YOURLS releases 下载完整网站内容，并解压至宝塔对应目录。
2. 在 yourls-translation-zh_CN 项目中下载 .mo，.po 文件，放入网站目录 /user/languages/。
3. 找到网站目录 /user/config-sample.php 文件，复制为 /user/config.php 并进行修改 YOURLS_DB_USER，YOURLS_DB_PASS，YOURLS_SITE，YOURLS_LANG，YOURLS_COOKIEKEY，yourls_user_passwords，内容参考如下：

PHP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
   /** 数据库用户名 */
   define( 'YOURLS_DB_USER', 'yourls' );

   /** 数据库密码，请根据上一节自定义密码进行修改*/
   define( 'YOURLS_DB_PASS', 'yourls123456' );

   /** YOURLS 域名
    ** 全小写，结尾不能有`/`*/
   define( 'YOURLS_SITE', 'http://your-own-domain-here.com' );

   /** YOURLS 语言选择
    ** 第二已经提前添加了翻译文件，此次直接配置即可 */
   define( 'YOURLS_LANG', 'zh_CN' );

   /** cookie 加密
   ** 从该网站直接生成 http://yourls.org/cookie */
   define( 'YOURLS_COOKIEKEY', 'modify this text with something random' );

   /** 用户名密码配置
    ** 通过用户名与密码登录管理后台，此处请自行定义，明文密码会在一次访问后自动加密 */
   $yourls_user_passwords = [
     'username' => 'password',
     // 'username2' => 'password2',
     // You can have one or more 'login'=>'password' lines
   ];

4. 修改宝塔面板对应网站的伪静态配置，添加如下内容：

PHP
1
2
3
4
5
6
     location / {
    try_files $uri $uri/ /yourls-loader.php$is_args$args;
    # if YOURLS is installed in a subdirectory, change the path
    # to yourls-loader.php accordingly, eg
    # try_files $uri $uri/ /subdir/yourls-loader.php$is_args$args;
    }

5. (可选) 修改主题为 Sleeky: 从该项目主页获取 sleeky-backend 目录，放入网站目录的 /user/plugins/，后续在管理页面的插件管理中启用。

二、使用

在网站部署完成以后，可以访问根目录的 readme.html获取操作指南，访问 /admin/进入管理页面。

参考

• Installation | YOURLS