前言

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

一、安装

1.1 数据库配置

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

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

（可选）也可以登录系统后通过命令行添加，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,内容参考如下：

    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. 修改宝塔面板对应网站的伪静态配置，添加如下内容：

    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/进入管理页面。

参考