HQY 一个和谐有爱的空间

简单部署开源短链工具-YOURLS

YOURLS（Your Own URL Shortener）是一个开源、免费、轻量级且功能强大的短网址生成系统。它允许用户在自己的服务器上搭建属于自己的个性化短网址服务。通过YOURLS，用户可以将长网址缩短为易于记忆、分享的短网址，以便在社交媒体、电子邮件或短信中传播。

自定义URL关键字：用户可以选择随机或自定义URL关键字来创建短连接。

跟踪点击数：YOURLS可以跟踪每个短连接的点击数，为用户提供有关其短连接使用情况的统计数据。

整洁的AJAX化界面：YOURLS提供了一个简洁、易用的Web界面，使用户能够轻松地创建和管理短连接。

支持开放者API：YOURLS还提供了开发者API，允许用户将其集成到其他服务中，实现更多自定义功能。

YOURLS是一款使用PHP+Mysql开发的短链接程序，相比公共短网址好处是数据掌握在自己手中，可控性更高。开源地址：https://github.com/YOURLS/YOURLS

前期准备

window系统推荐phpStudy等集成PHP环境

linux系统：LNMP（Linux+Nginx+Mysql+PHP）环境

域名，如果服务器在国内，则需要备案，笔者使用二级域名，http://y.xgss.net

示例

http://y.xgss.net/aliyun | http://y.xgss.net/tx

部署

YOURLS 的安装流程类似于PHP站点。

将安装包解压并上传至服务器； 将 user/config-sample.php 重命名为 user/config.php； 编辑 user/config.php 文件，填入数据库信息和配置站点选项； 访问 http://yoursite.com/admin/ 开始使用吧！

下载YOURLS

YOURLS免费开源，可以在Github下载最新版本（https://github.com/YOURLS/YOURLS/releases），解压后放到站点根目录，并将config-sample.php更名为config.php。

wget https://github.com/YOURLS/YOURLS/archive/refs/tags/1.8.2.tar.gz

配置MySQL数据库

需要先新建一个MySQL数据库，并设置好账号、密码，然后修改user/config.php配置文件，填写正确的MySQL信息，配置信息如下。

修改数据库配置

修改 user/config.php

//配置数据库
define( 'YOURLS_DB_USER', 'your db user name' );
define( 'YOURLS_DB_PASS', 'your db password' );
define( 'YOURLS_DB_NAME', 'yourls' );
define( 'YOURLS_DB_HOST', 'localhost' );
define( 'YOURLS_DB_PREFIX', 'yourls_' );

//设置你的域名
define( 'YOURLS_SITE', 'http://y.xgss.net' );

//设置用户名和密码
$yourls_user_passwords = [
'admin' => '123456', // 设置好密码
];

输入管理员账号密码登录后如果出现“Could not auto-encrypt passwords. Error was: “cannot write file”.”报错，请将user/config.php文件的权限改为666，然后刷新网页，再把权限改回644，因为你刚才填写密码时用的是明文，这样很危险，所以程序需要对其加密。

配置nginx反向代理

server {
listen 80;
server_name y.xgss.net;
root /data/wwwroot/web/y.xgss.net/;
access_log /data/wwwroot/log/y.xgss.net-access.log main_aliyun;
error_log /dev/null;

location / {
index index.php
try_files $uri $uri/ /yourls-loader.php
}
location ~ ^/.+\.php {
fastcgi_index index.php;
fastcgi_split_path_info ^(.+\.php)(.*)$;
fastcgi_param SCRIPT_FILENAME $request_filename;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
}
}

重启nginx

安装：http://y.xgss.net/admin/install.php

登录：http://y.xgss.net/admin/

添加短链接

yourls汉化

汉化包的git地址为https://github.com/guox/yourls-zh_CN，下载中文包然后解压后放在放在user/languages/目录下

YOURLS默认是中文界面，不方便操作，看到有网友提供了汉化，访问yourls-zh_CN下载汉化包，并解压至user/languages目录，然后修改user/config.php

#语言包放到languages
[root@aliyun-hz languages]# ll
total 68
-rw-r--r-- 1 www www 210 Apr 23 2017 index.html
-rw-r--r-- 1 www www 51 Mar 24 2013 README.md
-rw-r--r-- 1 www www 22123 Mar 24 2013 zh_CN.mo
-rw-r--r-- 1 www www 32783 Mar 24 2013 zh_CN.po
#修改配置文件启用中文
vi user/config.php
#启用中文
define( 'YOURLS_LANG', 'zh_CN' );

YOURLS- API

请求地址：http://域名//yourls-api.php 参数：username(用户名)、password（密码）、format（格式 json）、url（长地址）、action（功能，shorturl）

1、GET请求，构建下get请求，可以直接访问也可以用python构建请求

http://y.xgss.net/yourls-api.php?username=user&password=password&url=http://www.baidu.com&format=json&action=shorturl

python构建get请求

import requests, json

url = "http://10.0.0.101/yourls-api.php?"
data = {"username":"wangxiaoyu","password":"123456","url":"http://www.baidu.com","format":"json","action":"shorturl"}
response = requests.get(url, data)
print(json.loads(response.text))

访问返回的http://10.0.0.101/q94n1k这个短链接可以跳转到百度 返回信息为

'url': {
'keyword': 'q94o0a',
'url': 'http://www.baidu.com',
'title': '百度一下，你就知道',
'date': '2020-04-21 07:40:58',
'ip': '10.0.0.1'
},
'status': 'success',
'message': 'http://www.baidu.com 已保存为',
'title': '百度一下，你就知道',
'shorturl': 'http://10.0.0.101/q94o0a',
'statusCode': 200

如果不指定format为json的话，默认是XML格式

2、POST请求 用python来发送POST请求测试 这里以form表单形式提交数据，所以不需要将POST的data转为json格式 POST请求的几种编码方式可以参考：https://www.cnblogs.com/android-it/p/9558751.html

import requests, json

url = "http://10.0.0.101/yourls-api.php?"
data = {"username":"wangxiaoyu","password":"123456","url":"http://www.baidu.com","format":"json","action":"shorturl"}
response = requests.post(url, data)
print(json.loads(response.text))

返回的信息为

'url': {
'keyword': 'q94nkx',
'url': 'http://www.baidu.com',
'title': '百度一下，你就知道',
'date': '2020-04-21 07:31:45',
'ip': '10.0.0.1'
},
'status': 'success',
'message': 'http://www.baidu.com 已保存为',
'title': '百度一下，你就知道',
'shorturl': 'http://10.0.0.101/q94nkx',
'statusCode': 200

3、使用token而不使用账号密码

YOURLS允许使用username和password参数（如果您的设置是私有的话）以老式的方式调用API 。如果您担心将自己的凭证发送出去，还可以使用秘密签名令牌进行API调用。 signature在API请求中使用参数。例：

http://yoursite/yourls-api.php?signature=1002a612b4&action=...

python示例

import requests, json

url = "http://10.0.0.101/yourls-api.php?"
data = {"signature":"6962355501","url":"http://www.baidu.com","format":"json","action":"shorturl"}
response = requests.post(url, data)
print(json.loads(response.text))

安装Sleeky主题，美化YOURLS

YOURLS界面显得非常古老，风格挺老的，前几天在Github上看到一款YOURLS主题Sleeky，这篇文章分享下Sleeky主题的安装，希望对你有所帮助。

安装Sleeky主题

最新版Sleeky主题可前往Github下载：https://github.com/Flynntes/Sleeky/releases

Sleeky主题主题包括两部分，一部分是YOURLS前端，另一部分是YOURLS后台管理。下载Sleeky主题主题后可看到有2个文件夹：

sleeky-frontend: 前端主题
sleeky-backend：后端主题

将sleeky-frontend文件夹下的内容放到YOURLS站点根目录下即可，不需要额外的设置，直接访问YOURLS主界面即可看到效果。

将后端文件夹sleeky-backend放到YOURLS下的/user/plugins目录，并在YOURLS后台启用Sleeky主题插件，如下图。

旧的后台地址：

新的后台界面：