开源短链工具YOURLS-1.8.1完整部署包

明月清风晓星

1322人浏览 · 2025-09-07 15:12:18

明月清风晓星 · 2025-09-07 15:12:18 发布

简介：YOURLS是一款专为个人和企业打造的开源短网址生成系统，1.8.1版本在功能和稳定性方面进行了多项优化。该压缩包包含完整部署文件，支持快速搭建自有的短链接服务。系统支持自定义域名、API集成、访问统计、插件扩展等功能，适用于社交媒体分享、邮件营销及数据分析等场景。通过YOURLS，用户可在无需依赖第三方服务的前提下，实现短链的私有化管理和品牌化运营。

1. YOURLS简介与部署流程

YOURLS（Your Own URL Shortener）是一款开源的短链接生成工具，允许用户在自己的服务器上搭建独立的短链服务，从而实现对链接管理的完全控制。相比Bitly、TinyURL等第三方服务，YOURLS不仅避免了数据外泄风险，还提供了更高的定制性和可扩展性。

在现代Web应用中，短链服务广泛应用于社交媒体推广、营销活动追踪、API接口优化等场景。YOURLS凭借其轻量、高效、可插拔的架构，成为企业与开发者构建私有短链系统的首选方案。

本章将从YOURLS的核心特性入手，分析其部署优势，并概述整个搭建流程的关键环节，为后续章节的实操打下坚实基础。

2. YOURLS安装与PHP环境配置

YOURLS 的安装过程涉及多个技术环节，包括源码包的获取、PHP运行环境的配置、本地测试服务器的搭建等。本章将深入讲解如何在不同环境中部署 YOURLS，并结合 PHP 的配置优化，帮助开发者构建稳定、高效的短链服务环境。

2.1 YOURLS的安装包获取与结构解析

YOURLS 是一个基于 PHP 的开源项目，其安装包通常以 ZIP 或 TAR.GZ 格式发布。通过官方 GitHub 仓库或官网下载安装包后，开发者需要对其结构进行深入分析，以便后续配置和定制。

2.1.1 从官方下载YOURLS-1.8.1.zip并校验文件完整性

首先，访问 YOURLS 官方网站（https://yourls.org/），点击 “Download” 按钮下载最新稳定版本，当前为 YOURLS-1.8.1.zip 。

下载命令（使用 wget ）：

wget https://github.com/YOURLS/YOURLS/archive/refs/tags/1.8.1.zip -O YOURLS-1.8.1.zip

为了确保下载文件的完整性，可以通过校验 SHA256 哈希值：

sha256sum YOURLS-1.8.1.zip

将输出结果与官网提供的哈希值进行比对，若一致则说明文件完整。

参数说明：
- wget ：用于从网络上下载文件；
- -O ：指定输出文件名；
- sha256sum ：用于生成和校验 SHA256 哈希值。

2.1.2 解压后的文件结构与核心目录说明

解压 ZIP 文件后，进入 YOURLS-1.8.1 文件夹，其目录结构如下：

YOURLS-1.8.1/
├── user/
│   ├── config.php
│   └── plugins/
├── includes/
├── admin/
├── yourls-go.php
├── yourls-loader.php
├── index.php
└── README.md

核心目录说明：

目录/文件	功能说明
`user/`	包含用户配置文件和插件目录
`user/config.php`	主配置文件，用于设置数据库连接、站点信息等
`includes/`	核心逻辑处理文件，包括数据库连接、路由处理等
`admin/`	后台管理界面文件，包含登录、控制台、设置等
`yourls-go.php`	短链跳转核心文件
`yourls-loader.php`	系统启动加载器
`index.php`	主页入口文件
`README.md`	安装和使用说明文档

逻辑分析：
整个结构设计遵循 MVC 模式， includes 负责核心逻辑处理， admin 处理后台请求， user 提供用户可配置的接口。 yourls-go.php 是短链跳转的核心逻辑文件，其通过 $_GET['shorturl'] 获取短码并进行跳转。

2.1.3 配置文件（如config.php）的初始设置要点

YOURLS 的配置文件位于 user/config.php ，首次安装时需手动复制模板文件 user/config-sample.php 并重命名为 config.php 。

配置项说明：

define( 'YOURLS_DB_USER', 'root' );
define( 'YOURLS_DB_PASS', 'password' );
define( 'YOURLS_DB_NAME', 'yourls_db' );
define( 'YOURLS_DB_HOST', 'localhost' );
define( 'YOURLS_SITE', 'http://yourls.example.com' );
define( 'YOURLS_HOURS_OFFSET', 0 );
define( 'YOURLS_COOKIEKEY', 'your_cookie_key_here' );

参数说明：
- YOURLS_DB_USER / YOURLS_DB_PASS ：数据库用户名和密码；
- YOURLS_DB_NAME ：数据库名称；
- YOURLS_SITE ：部署站点的完整 URL；
- YOURLS_COOKIEKEY ：用于加密用户会话的密钥，建议使用随机字符串生成工具生成；
- YOURLS_HOURS_OFFSET ：时区偏移，单位为小时。

逻辑分析：
YOURLS 使用 PHP 常量定义配置项，避免了频繁读取数据库，提高了性能。 YOURLS_COOKIEKEY 需要保证唯一性与复杂性，以防止会话劫持。

2.2 PHP环境搭建与兼容性要求

YOURLS 依赖于 PHP 环境运行，因此必须确保服务器中安装了合适的 PHP 版本及其扩展模块。本节将介绍 PHP 环境的搭建、Apache/Nginx 的配置，以及常见问题的排查方法。

2.2.1 PHP版本需求与扩展模块安装（如MySQLi、cURL、GD）

YOURLS 推荐使用 PHP 7.2 或更高版本，且必须启用以下扩展模块：

mysqli ：用于连接 MySQL 数据库；
curl ：支持 API 调用和远程请求；
gd ：用于生成二维码等图像；
mbstring ：多字节字符串处理；
json ：JSON 数据解析；
session ：会话管理；
iconv ：字符编码转换。

Ubuntu 安装命令：

sudo apt update
sudo apt install php php-mysqli php-curl php-gd php-mbstring php-json php-session php-iconv

Windows 环境下（WAMP/XAMPP）：
在 php.ini 中取消以下扩展的注释：

extension=mysqli
extension=curl
extension=gd
extension=mbstring
extension=json
extension=session
extension=iconv

参数说明：
- extension= ：启用指定扩展；
- php.ini ：PHP 主配置文件，控制模块加载、性能优化等。

2.2.2 部署Apache/Nginx服务器并配置虚拟主机

YOURLS 可运行于 Apache 或 Nginx 服务器。以下是两种服务器的虚拟主机配置示例。

Apache 虚拟主机配置（ `/etc/apache2/sites-available/yourls.conf` ）：

<VirtualHost *:80>
    ServerName short.example.com
    DocumentRoot /var/www/html/YOURLS-1.8.1
    <Directory /var/www/html/YOURLS-1.8.1>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

启用配置：

sudo a2ensite yourls.conf
sudo systemctl restart apache2

Nginx 配置（ `/etc/nginx/sites-available/yourls` ）：

server {
    listen 80;
    server_name short.example.com;
    root /var/www/html/YOURLS-1.8.1;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
    }
}

启用配置：

sudo ln -s /etc/nginx/sites-available/yourls /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

参数说明：
- ServerName ：绑定域名；
- DocumentRoot ：指定 YOURLS 文件路径；
- try_files ：Nginx 的 URL 重写机制；
- fastcgi_pass ：指定 PHP-FPM 的 socket 地址。

2.2.3 PHP.ini配置优化与常见错误排查

为了提升 YOURLS 的性能和稳定性，建议对 php.ini 进行如下优化：

max_execution_time = 30
memory_limit = 128M
post_max_size = 8M
upload_max_filesize = 2M
display_errors = Off
error_reporting = E_ALL & ~E_NOTICE

常见错误排查：

500 Internal Server Error ：
- 检查 php.ini 中的语法错误；
- 查看 Apache/Nginx 错误日志；
- 确保 config.php 中数据库连接信息正确。
404 Not Found（短链跳转失败） ：
- 确保 .htaccess 文件存在且配置正确；
- Nginx 需启用 URL 重写规则。
数据库连接失败 ：
- 检查 config.php 中的数据库用户名、密码是否正确；
- 确认 MySQL 服务是否正在运行；
- 检查防火墙是否阻止数据库端口。

逻辑分析：
PHP 的配置直接影响脚本的执行效率与安全性。 display_errors = Off 可防止错误信息暴露给用户，提高安全性。 error_reporting 设置可帮助开发者在调试阶段发现潜在问题。

2.3 本地测试环境搭建实践

在正式部署之前，建议在本地搭建测试环境，以验证 YOURLS 的运行情况。本节将介绍如何使用 XAMPP/WAMP 快速部署本地服务器，并测试 YOURLS 的访问与权限问题。

2.3.1 使用XAMPP/WAMP快速部署本地服务器

XAMPP 和 WAMP 是常见的本地服务器集成环境，支持快速搭建 PHP + MySQL 环境。

XAMPP 安装步骤（Windows）：

下载并安装 XAMPP：https://www.apachefriends.org/index.html
启动 Apache 和 MySQL 服务；
将 YOURLS 文件夹复制到 htdocs/ 目录下；
访问 http://localhost/YOURLS-1.8.1 测试。

WAMP 安装步骤：

下载并安装 WAMP：http://www.wampserver.com/en/
启动服务后，将 YOURLS 文件夹复制到 www/ 目录；
访问 http://localhost/YOURLS-1.8.1 测试。

逻辑分析：
XAMPP 和 WAMP 提供了图形化界面，便于快速启动和管理服务，适合本地调试和测试。

2.3.2 将YOURLS部署至本地并测试访问

部署完成后，需访问 YOURLS 的安装页面进行初始化。

访问流程：

打开浏览器，访问 http://localhost/YOURLS-1.8.1 ；
如果出现安装向导页面，表示环境配置成功；
按照提示填写数据库信息、管理员账户等；
安装完成后，访问后台管理界面 /admin 。

错误排查：
- 若提示 “Could not connect to database”，请检查 config.php 中的数据库配置；
- 若提示 “Headers already sent”，检查文件编码是否为 UTF-8 无 BOM；
- 若无法访问 /admin 页面，检查 .htaccess 文件是否存在。

2.3.3 检查服务器权限与目录访问限制问题

在部署过程中，服务器权限配置不当可能导致 YOURLS 无法正常运行。

权限设置建议：

sudo chown -R www-data:www-data /var/www/html/YOURLS-1.8.1
sudo chmod -R 755 /var/www/html/YOURLS-1.8.1
sudo chmod -R 644 /var/www/html/YOURLS-1.8.1/*.php

参数说明：
- chown ：更改文件所属用户和组；
- chmod 755 ：对目录设置权限（读写执行）；
- chmod 644 ：对文件设置权限（读写只读）；

逻辑分析：
合理的权限设置可以防止文件被恶意篡改，同时确保服务器进程有权限读取和执行 PHP 文件。建议避免使用 777 权限，以提高安全性。

小结

本章详细介绍了 YOURLS 的安装流程、PHP 环境配置以及本地测试环境的搭建。通过逐步讲解安装包的获取与校验、文件结构分析、PHP 模块配置、服务器部署与权限管理，帮助开发者全面掌握 YOURLS 的部署流程，为后续数据库连接和功能扩展打下坚实基础。

3. YOURLS数据库连接与MySQL集成

3.1 MySQL数据库的准备与初始化

3.1.1 创建数据库与用户权限配置

在部署YOURLS之前，必须确保MySQL数据库已正确安装并配置。YOURLS通常使用MySQL作为其后端数据库来存储短链接数据、用户信息以及配置信息。

创建数据库：

CREATE DATABASE yourls_db;

创建用户并分配权限：

CREATE USER 'yourls_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON yourls_db.* TO 'yourls_user'@'localhost';
FLUSH PRIVILEGES;

上述SQL语句中：
- yourls_db 是你为YOURLS准备的数据库名称；
- yourls_user 是你创建的数据库用户名；
- your_password 是该用户的密码；
- GRANT ALL PRIVILEGES 授予用户对数据库的所有权限；
- FLUSH PRIVILEGES 用于刷新权限，使更改立即生效。

安全性提示 ：建议使用强密码，并避免使用默认用户名（如 root）以增强安全性。

3.1.2 导入YOURLS初始数据表结构

YOURLS项目中包含一个SQL文件，通常位于 user/install.sql ，它定义了所有必要的数据表结构和初始数据。

执行导入命令：

mysql -u yourls_user -p yourls_db < /path/to/yourls/user/install.sql

该SQL文件将创建如 yourls_url 、 yourls_options 等关键表，确保YOURLS能够正常运行。

3.1.3 修改配置文件连接数据库参数

YOURLS的数据库连接配置位于 config.php 文件中。打开该文件并修改以下配置项：

define( 'YOURLS_DB_USER', 'yourls_user' );
define( 'YOURLS_DB_PASSWORD', 'your_password' );
define( 'YOURLS_DB_NAME', 'yourls_db' );
define( 'YOURLS_DB_HOST', 'localhost' );

其中：
- YOURLS_DB_USER ：数据库用户名；
- YOURLS_DB_PASSWORD ：数据库用户密码；
- YOURLS_DB_NAME ：使用的数据库名称；
- YOURLS_DB_HOST ：数据库服务器地址，通常为 localhost 或远程数据库IP。

调试建议 ：若部署在远程服务器，请确保MySQL允许远程连接，并配置防火墙规则。

3.2 数据库表结构解析与数据关系梳理

3.2.1 主要数据表（如 yourls_url、yourls_options）功能说明

YOURLS 的核心数据结构由几个关键表组成，主要包括：

表名	功能描述
yourls_url	存储所有短链接及其对应的原始URL
yourls_options	存储系统配置选项，如站点标题、允许的短码长度等
yourls_log	记录每个短链接的访问日志，包括时间、IP、用户代理等
yourls_plugins	存储插件启用状态信息
yourls_users	存储管理员用户信息（可选，若启用多用户模式）

yourls_url 示例字段：

字段名	类型	描述
keyword	VARCHAR(200)	短链关键字，如 abc
url	TEXT	原始URL地址
title	TEXT	页面标题（可选）
timestamp	TIMESTAMP	创建时间
ip	VARCHAR(45)	创建者IP地址

yourls_options 示例字段：

字段名	类型	描述
option_name	VARCHAR(255)	配置项名称，如 site_title
option_value	TEXT	配置值，如 “My YOURLS Site”

3.2.2 短链接存储机制与点击统计表设计

YOURLS 使用 yourls_url 表存储短链映射关系，每次用户访问短链时，会向 yourls_log 表写入访问记录。

yourls_log 示例字段：

字段名	类型	描述
id	INT	日志ID
shorturl	VARCHAR(200)	对应的短链关键字
referrer	TEXT	引导来源页面（可为空）
user_agent	TEXT	用户浏览器信息
ip	VARCHAR(45)	访问者IP地址
time	DATETIME	访问时间

这种设计使得每个短链接的访问次数、来源、时间等信息都能被详细记录，并可用于后续统计分析。

3.2.3 自定义字段与扩展表结构实践

YOURLS 允许开发者通过插件或直接修改数据库结构来添加自定义字段。例如，可以为 yourls_url 表添加一个 campaign_id 字段，用于区分不同营销活动的短链。

添加字段的SQL语句：

ALTER TABLE yourls_url ADD COLUMN campaign_id INT DEFAULT NULL;

随后，你可以在插件中调用该字段，实现更细粒度的短链分析与管理。

3.3 数据库性能优化与维护策略

3.3.1 常用SQL查询语句分析与优化建议

YOURLS 在处理短链跳转和统计时，会频繁查询 yourls_url 表。为了提升性能，建议为 keyword 字段添加索引：

ALTER TABLE yourls_url ADD INDEX idx_keyword (keyword);

此外，对于访问日志表 yourls_log ，如果数据量较大，建议对 shorturl 和 time 字段建立复合索引，以加快访问统计查询速度：

ALTER TABLE yourls_log ADD INDEX idx_shorturl_time (shorturl, time);

示例查询优化：

获取某个短链的所有访问日志：

SELECT * FROM yourls_log WHERE shorturl = 'abc';

添加索引后，查询速度将显著提升。

3.3.2 数据备份与恢复方案（如 mysqldump、phpMyAdmin）

为了确保数据安全，建议定期备份数据库。以下是使用 mysqldump 工具备份数据库的命令：

mysqldump -u yourls_user -p yourls_db > yourls_backup.sql

恢复数据库的方法如下：

mysql -u yourls_user -p yourls_db < yourls_backup.sql

如果你使用 phpMyAdmin，也可以通过其图形界面导出和导入数据库，操作更为直观。

3.3.3 使用缓存机制提升数据库访问效率

YOURLS 可通过缓存机制减少对数据库的直接访问，从而提升响应速度。例如，可以使用 Memcached 或 Redis 缓存短链映射信息。

集成 Redis 的示例代码：

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

$shorturl = 'abc';
$cached_url = $redis->get("url:{$shorturl}");

if (!$cached_url) {
    // 如果缓存中没有，则从数据库获取
    $result = $pdo->query("SELECT url FROM yourls_url WHERE keyword = '{$shorturl}'");
    $row = $result->fetch(PDO::FETCH_ASSOC);
    $cached_url = $row['url'];
    // 缓存5分钟
    $redis->setex("url:{$shorturl}", 300, $cached_url);
}

header("Location: {$cached_url}");
exit;

该代码逻辑说明：
- 首先尝试从 Redis 中获取短链对应的原始 URL；
- 若未命中缓存，则从数据库查询并将结果缓存5分钟；
- 最后跳转至原始URL。

通过这种方式，可以有效减少数据库访问频率，提高服务响应速度。

流程图：YOURLS 数据访问流程

graph TD
    A[用户访问短链] --> B{缓存是否存在?}
    B -->|是| C[从缓存获取原始URL]
    B -->|否| D[从数据库查询原始URL]
    D --> E[缓存原始URL]
    C --> F[跳转至原始URL]
    E --> F

本章从数据库准备、结构解析到性能优化，全面介绍了YOURLS如何与MySQL集成。通过合理配置数据库、优化查询语句以及引入缓存机制，可以显著提升YOURLS系统的性能与稳定性，为后续的高并发访问提供保障。

4. 短链接生成与自定义域名配置

在搭建好YOURLS服务之后，我们已经完成了环境部署、数据库集成等基础配置。接下来，我们将进入核心功能模块之一： 短链接生成机制与自定义域名绑定 。本章将深入解析YOURLS中短链接生成的底层逻辑，包括哈希算法、短码生成规则，以及自定义域名的配置流程，帮助你构建一个可定制、可扩展的短链服务系统。

4.1 短链接生成算法与机制解析

YOURLS 的核心功能之一是将长链接转换为简短、可读性强的短链接。这个过程依赖于算法设计、数据库存储以及重定向机制。

4.1.1 哈希算法与唯一性保障机制

YOURLS 使用 base62 编码 来生成短链接标识符（shortcode），即一个由大小写字母（a-zA-Z）和数字（0-9）组成的 62 进制字符串。该机制基于 自增主键（ID） 和 base62 转换函数 实现。

示例代码：base62 编码函数

function base62_encode($num) {
    $index = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
    $base = strlen($index);
    $str = '';
    while ($num > 0) {
        $rem = $num % $base;
        $str = $index[$rem] . $str;
        $num = ($num - $rem) / $base;
    }
    return $str;
}

逻辑分析：

$num 是数据库中记录的自增 ID。
$index 定义了 62 个字符，作为编码字符集。
每次取模（ % $base ）得到当前位的字符，然后将 $num 整除 $base ，继续下一轮。
最终拼接出的字符串即为短码。

唯一性保障：

由于短码是基于数据库自增 ID 生成，因此保证了全局唯一性。
若短码被占用，YOURLS 会自动跳过冲突，使用下一个 ID 生成新的短码。

4.1.2 自定义短码功能的实现原理

YOURLS 支持用户手动输入自定义短码（custom keyword），例如：

https://short.example.com/cool

实现机制：

在添加短链接时，用户输入自定义关键词。
YOURLS 首先检查该关键词是否已被占用。
若未被占用，则直接插入数据库，使用该关键词作为 shortcode。
若已被占用，则提示用户重新输入。

数据库验证逻辑（伪代码）：

SELECT COUNT(*) FROM yourls_url WHERE keyword = 'cool';

若返回值为 0，表示可用；否则提示冲突。

4.1.3 短链跳转流程与HTTP重定向技术

短链跳转是 YOURLS 的核心功能之一。其流程如下：

用户访问短链，如 http://short.example.com/abc123
服务器接收到请求，解析 abc123 并查询数据库。
若存在该短码，返回 301（永久重定向）或 302（临时重定向）状态码。
浏览器根据响应跳转至原始长链接地址。

重定向实现代码（简化版）：

// 获取短码
$keyword = $_GET['k'];

// 查询数据库
$stmt = $pdo->prepare("SELECT url FROM yourls_url WHERE keyword = ?");
$stmt->execute([$keyword]);
$row = $stmt->fetch();

if ($row) {
    header("Location: " . $row['url'], true, 301);
    exit;
} else {
    echo "Short link not found.";
}

参数说明：

$_GET['k'] ：从 URL 中获取短码。
$pdo ：PDO 数据库连接对象。
header("Location: ...", true, 301) ：执行 301 重定向。

4.2 自定义域名绑定与虚拟主机配置

默认情况下，YOURLS 使用服务器的主域名提供服务。但在实际应用中，通常需要绑定一个独立的短链域名，如 short.example.com 。

4.2.1 购买并解析自定义域名至服务器IP

操作步骤：

购买域名 ：
- 可在阿里云、腾讯云、GoDaddy 等平台购买域名。
- 例如：购买 short.example.com
DNS 解析 ：
- 登录域名管理平台。
- 添加一条 A 记录，指向你的服务器公网 IP。
- TTL 设置为 300 秒，加快生效速度。

示例 DNS 配置表：

类型	主机名	值（IP地址）	TTL
A	short	192.0.2.1	300

4.2.2 Apache/Nginx配置虚拟主机支持短链域名

Apache 配置（/etc/apache2/sites-available/short.conf）：

<VirtualHost *:80>
    ServerName short.example.com
    DocumentRoot /var/www/yourls

    <Directory /var/www/yourls>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

启用配置：

sudo a2ensite short.conf
sudo systemctl restart apache2

Nginx 配置（/etc/nginx/sites-available/short）：

server {
    listen 80;
    server_name short.example.com;

    root /var/www/yourls;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }
}

启用配置：

sudo ln -s /etc/nginx/sites-available/short /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

4.2.3 测试短链访问与重定向规则验证

步骤一：访问测试

在浏览器中访问：

http://short.example.com

应看到 YOURLS 的主页界面。

步骤二：测试短链跳转

创建一个短链接，例如：

http://short.example.com/abc123

应跳转至你设置的原始 URL。

步骤三：查看重定向状态码

使用命令行工具 curl 查看：

curl -I http://short.example.com/abc123

返回结果应包含：

HTTP/1.1 301 Moved Permanently
Location: https://example.com/

4.3 多域名支持与短链分发策略

在大型企业或多个项目中，可能需要支持多个短链域名。YOURLS 提供了多域名管理功能。

4.3.1 在YOURLS中配置多个自定义域名

YOURLS 默认只绑定一个域名。若需支持多个域名，需修改配置文件 config.php ：

define('YOURLS_SITE', 'http://short1.example.com');
define('YOURLS_COOKIE_KEY', 'your_cookie_key_here');
define('YOURLS_FQDN', 'short1.example.com');

若要支持多个域名，可以使用如下方式：

$yourls_site = [
    'short1.example.com' => 'http://short1.example.com',
    'short2.example.com' => 'http://short2.example.com',
];

// 动态设置 YOURLS_SITE
define('YOURLS_SITE', $yourls_site[$_SERVER['HTTP_HOST']]);

这样，当访问 short2.example.com 时，YOURLS 会自动识别并返回对应的短链页面。

4.3.2 分发策略与短链分组管理

YOURLS 支持通过标签（tags）或自定义字段来对短链接进行分组管理。

示例：通过标签分组

UPDATE yourls_url SET tags = 'marketing,2025' WHERE keyword = 'promo';

在后台界面中，可通过标签筛选短链接，便于管理和分析。

分发策略建议：

按业务线划分域名（如 marketing.short.com、dev.short.com）
按项目分组（如 2025_campaign、internal_tools）
按地域分发（如 zh.short.com、en.short.com）

4.3.3 实现短链的负载均衡与故障转移

对于高并发场景，可通过以下方式实现负载均衡与容灾：

架构图（Mermaid 流程图）：

graph TD
    A[客户端访问] --> B[负载均衡器]
    B --> C[短链服务器1]
    B --> D[短链服务器2]
    B --> E[短链服务器3]
    C --> F[(共享数据库)]
    D --> F
    E --> F

实现方案：

使用 Nginx 或 HAProxy 做负载均衡。
多台 YOURLS 实例共享一个 MySQL 数据库。
使用 Redis 缓存热门链接的跳转数据，提升性能。
配置 Keepalived 或云平台的负载均衡服务实现故障转移。

Nginx 负载均衡配置示例：

upstream short_servers {
    least_conn;
    server 192.168.1.10:80;
    server 192.168.1.11:80;
    server 192.168.1.12:80;
}

server {
    listen 80;
    server_name short.example.com;

    location / {
        proxy_pass http://short_servers;
    }
}

参数说明：

least_conn ：最少连接数算法，提升性能。
proxy_pass ：将请求转发至后端服务器组。

小结提示： 本章详细介绍了 YOURLS 中短链接的生成机制、自定义域名的绑定方式，以及多域名支持和负载均衡策略。通过本章内容，你不仅可以搭建一个基础的短链服务，还可以扩展为多域名、多实例的高可用短链平台。下一章我们将进入 YOURLS 的用户界面与前端管理功能，进一步提升用户体验和操作效率。

5. 用户界面操作与前端管理功能

YOURLS 提供了一个直观、易用的后台管理界面，使用户能够高效地管理短链接、查看统计信息并执行批量操作。本章将深入探讨 YOURLS 的用户界面设计、短链接管理流程以及统计功能的实现机制。通过本章内容，读者将全面掌握 YOURLS 前端管理功能的操作方式与底层逻辑。

5.1 YOURLS后台管理界面概览

YOURLS 的后台管理界面是用户与系统交互的核心部分。从登录验证到功能模块展示，界面设计兼顾了功能性与用户体验。

5.1.1 登录与权限验证机制

YOURLS 使用基于用户名和密码的认证机制。系统默认支持一个管理员账户，也可以通过配置文件（如 config.php ）添加多个用户权限组。

登录流程如下：

graph TD
    A[用户输入用户名与密码] --> B{验证凭证}
    B -- 正确 --> C[创建会话并跳转至管理界面]
    B -- 错误 --> D[返回错误信息并提示重新输入]

权限控制逻辑：

在 includes/functions-auth.php 文件中，核心权限判断函数如下：

function yourls_is_valid_user() {
    if ( isset($_SERVER['PHP_AUTH_USER']) && isset($_SERVER['PHP_AUTH_PW']) ) {
        return yourls_check_login($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW']);
    }
    return false;
}

$_SERVER['PHP_AUTH_USER'] 和 $_SERVER['PHP_AUTH_PW'] 分别获取用户输入的用户名和密码。
yourls_check_login() 函数负责验证用户名与密码是否匹配数据库中的记录。

5.1.2 控制台功能模块与数据展示

YOURLS 后台主要包含以下功能模块：

模块名称	功能描述
短链管理	创建、编辑、删除短链接
统计分析	查看短链点击次数、来源 IP、用户代理等信息
用户管理	配置用户权限、添加新用户
插件中心	安装和管理扩展插件
设置与配置	修改全局配置，如网站标题、短链生成规则、API 密钥等

每个模块的数据展示采用分页加载机制，避免一次性加载过多数据影响性能。

5.1.3 用户操作界面的响应式设计

YOURLS 的前端界面采用响应式设计，适配 PC 端与移动端访问。其核心实现依赖于 Bootstrap 框架：

<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="vendor/bootstrap/css/bootstrap.min.css">

响应式布局的实现逻辑如下：

断点设置 ：使用媒体查询（Media Queries）对不同屏幕尺寸进行适配。
栅格系统 ：采用 Bootstrap 的 12 列栅格系统，自动调整布局。
触摸优化 ：按钮和表单控件增大，适应触控操作。

5.2 短链接的创建、编辑与批量管理

短链接的管理是 YOURLS 的核心功能之一。用户可以通过手动创建、批量导入或 API 接口来管理短链。

5.2.1 手动创建短链与设置自定义参数

在后台首页，用户可以通过输入原始链接和自定义短码来创建短链接：

<form method="post" action="index.php">
    <input type="text" name="url" placeholder="输入原始链接" required>
    <input type="text" name="keyword" placeholder="自定义短码（可选）">
    <button type="submit">生成短链</button>
</form>

参数说明：

url ：目标跳转链接，必填。
keyword ：可选参数，用于自定义短链后缀（如 /abc ）。
若未指定 keyword ，系统将自动生成一个唯一的短码。

逻辑分析：

提交后，数据被发送至 index.php 。
系统调用 yourls_add_new_link() 函数，插入数据库表 yourls_url 。
若短码冲突，返回错误提示。

5.2.2 批量导入链接与CSV文件处理

YOURLS 支持通过 CSV 文件批量导入短链，适用于大量短链的快速部署。

CSV 文件格式如下：

url,keyword
https://example.com/page1,page1
https://example.com/page2,page2

导入流程代码片段：

if ( isset($_POST['import']) && is_uploaded_file($_FILES['csv']['tmp_name']) ) {
    $file = fopen($_FILES['csv']['tmp_name'], 'r');
    while ( ($data = fgetcsv($file)) !== FALSE ) {
        $url = $data[0];
        $keyword = $data[1] ?? '';
        yourls_add_new_link( $url, $keyword );
    }
    fclose($file);
}

fopen() ：打开上传的 CSV 文件。
fgetcsv() ：逐行读取 CSV 内容。
yourls_add_new_link() ：调用接口添加短链。

5.2.3 编辑与删除操作的安全确认机制

为防止误操作，YOURLS 在编辑和删除短链时均设有确认机制。

删除短链的 HTML 表单：

<form method="post" onsubmit="return confirm('确定要删除此短链？')">
    <input type="hidden" name="action" value="delete_link">
    <input type="hidden" name="shorturl" value="abc123">
    <button type="submit">删除</button>
</form>

安全性增强措施：

CSRF 令牌 ：在表单中加入一次性令牌，防止跨站请求伪造。
权限验证 ：在执行删除前，再次验证用户权限。
日志记录 ：所有删除操作都会记录到系统日志中，便于审计。

5.3 统计图表与访问记录查询

YOURLS 提供了丰富的统计功能，用户可以查看短链接的访问频率、来源 IP、用户代理等信息，并支持导出与筛选。

5.3.1 查看点击统计与来源分析

YOURLS 在数据库中记录每次短链访问的详细信息，包括时间戳、IP 地址、User-Agent 和 Referer。

数据库表结构示例（yourls_clicks）：

字段名	类型	说明
click_id	INT	自增主键
shorturl	VARCHAR(200)	短链标识符
user_agent	VARCHAR(255)	用户代理信息
referer	VARCHAR(255)	来源页面
ip	VARCHAR(45)	用户IP地址
click_time	DATETIME	点击时间

统计查询示例：

SELECT COUNT(*) AS total_clicks, shorturl
FROM yourls_clicks
WHERE shorturl = 'abc123'
GROUP BY shorturl;

查询特定短链的点击总数。
可扩展为按小时、按日统计，用于生成趋势图。

5.3.2 导出访问数据与CSV导出功能

YOURLS 支持将统计信息导出为 CSV 文件，便于外部分析。

导出功能实现代码片段：

header('Content-Type: text/csv');
header('Content-Disposition: attachment;filename=shorturl_stats.csv');
$output = fopen('php://output', 'w');

fputcsv($output, ['Short URL', 'Click Time', 'IP', 'User Agent', 'Referer']);

$results = $db->get_results("SELECT * FROM yourls_clicks WHERE shorturl = 'abc123'");
foreach ($results as $row) {
    fputcsv($output, (array)$row);
}

fclose($output);

设置响应头为 CSV 格式。
使用 fputcsv() 函数逐行写入数据。
支持自定义导出字段与筛选条件。

5.3.3 实现自定义时间范围的数据筛选与图表生成

YOURLS 支持按时间范围筛选访问记录，并生成可视化图表。

筛选逻辑实现：

$start_date = $_GET['start_date'] ?? date('Y-m-01');
$end_date = $_GET['end_date'] ?? date('Y-m-d');

$query = $db->prepare("SELECT * FROM yourls_clicks 
                       WHERE shorturl = %s 
                       AND click_time BETWEEN %s AND %s",
                      $shorturl, $start_date, $end_date);

使用 prepare() 防止 SQL 注入。
允许用户通过表单选择时间范围。

图表生成（使用 Chart.js）：

<canvas id="clickChart"></canvas>
<script src="vendor/chart.js/Chart.min.js"></script>
<script>
    var ctx = document.getElementById('clickChart').getContext('2d');
    var chart = new Chart(ctx, {
        type: 'line',
        data: {
            labels: ['2024-01-01', '2024-01-02', '2024-01-03'],
            datasets: [{
                label: '点击次数',
                data: [12, 19, 3],
                borderColor: 'rgba(75, 192, 192, 1)',
                fill: false
            }]
        }
    });
</script>

使用 Chart.js 渲染折线图。
数据可通过 AJAX 动态加载，支持实时更新。

本章深入解析了 YOURLS 的前端管理界面，涵盖登录机制、功能模块、响应式设计、短链管理操作及统计功能实现。通过代码分析与图表展示，帮助开发者更好地理解 YOURLS 的用户交互逻辑与前端架构设计。

6. API接口调用与自动化集成

6.1 YOURLS内置API的使用方法

YOURLS 提供了丰富的 RESTful API 接口，支持远程创建短链、查询短链信息、获取访问统计等功能。使用 API 接口可以实现与外部系统的无缝集成，适用于自动化任务、内容管理系统（CMS）联动、数据分析等场景。

6.1.1 API密钥的获取与安全性管理

YOURLS 的 API 接口默认是关闭的，需要在配置文件 config.php 中启用并设置密钥：

define('YOURLS_PRIVATE', true);  // 启用私有模式
define('YOURLS_HMAC_KEY', 'your-secret-key');  // 设置HMAC签名密钥

API 密钥可以在后台管理页面中获取，路径为： Tools > API 。

注意： API 密钥具有创建短链和读取数据的权限，务必妥善保管，避免泄露。

6.1.2 创建短链的API调用示例（如cURL、Python请求）

使用 cURL 创建短链：

curl -G \
  --data-urlencode "url=http://example.com" \
  --data "keyword=myshortlink" \
  --data "format=json" \
  --data "signature=your_api_key_here" \
  http://yourls.example.com/yourls-api.php

参数说明：

参数名	含义	是否必填
`url`	需要缩短的原始链接	是
`keyword`	自定义短码（可选）	否
`format`	返回格式（json/xml/text）	否
`signature`	API 密钥	是

使用 Python 创建短链：

import requests

api_url = "http://yourls.example.com/yourls-api.php"
params = {
    "url": "http://example.com",
    "keyword": "myshortlink",
    "format": "json",
    "signature": "your_api_key_here"
}

response = requests.get(api_url, params=params)
print(response.json())

6.1.3 获取点击统计与短链信息的接口调用

查询短链详细信息：

curl -G \
  --data "action=stats" \
  --data "shorturl=myshortlink" \
  --data "format=json" \
  --data "signature=your_api_key_here" \
  http://yourls.example.com/yourls-api.php

响应示例（JSON）：

{
  "keyword": "myshortlink",
  "url": "http://example.com",
  "clicks": 42,
  "created": "2025-04-05 12:34:56"
}

6.2 与第三方系统集成实践

YOURLS 的 API 接口可以轻松集成到各种第三方系统中，提升自动化和可扩展性。

6.2.1 与CMS系统（如WordPress）的插件集成

在 WordPress 中可以使用插件如 YOURLS for WordPress ，它支持在文章发布时自动生成短链，并显示在文章页或后台。

集成流程：

安装插件： YOURLS for WordPress
配置插件设置，输入 YOURLS 地址和 API 密钥
设置自动创建短链规则（如新文章发布时）

6.2.2 与自动化工具（如Zapier、IFTTT）联动

使用 Zapier 实现自动创建短链：

创建一个新 Zap，选择触发器（如 Google Sheets 新行添加）
添加动作步骤，选择 Webhooks by Zapier
设置请求 URL 为 YOURLS 的 API 地址
构建请求体，包含 url 和 signature 参数
测试连接并激活 Zap

6.2.3 构建RESTful服务接口实现多平台调用

可以通过 Node.js 或 Python 构建中间服务，封装 YOURLS API 调用逻辑，提供统一的 REST 接口供多个平台调用。

Node.js 示例：

const express = require('express');
const axios = require('axios');
const app = express();

app.get('/shorten', async (req, res) => {
    const { url, keyword } = req.query;
    const api_url = "http://yourls.example.com/yourls-api.php";
    const params = {
        url,
        keyword,
        format: "json",
        signature: "your_api_key_here"
    };

    try {
        const response = await axios.get(api_url, { params });
        res.json(response.data);
    } catch (error) {
        res.status(500).json({ error: "Shorten failed" });
    }
});

app.listen(3000, () => console.log("Server running on port 3000"));

6.3 自动化脚本与定时任务配置

自动化脚本可以帮助我们定期清理数据、生成短链、推送内容等，提高运维效率。

6.3.1 使用Cron Job定时执行数据清理与备份

示例：每天凌晨2点备份数据库

0 2 * * * /usr/bin/mysqldump -u your_user -p'your_password' yourls_db > /backup/yourls_$(date +\%F).sql

注意： 建议结合日志记录和备份保留策略，避免磁盘空间耗尽。

6.3.2 自动化生成短链并推送到社交媒体平台

Python 脚本示例：将文章URL转换为短链并发布到Twitter

import requests
import tweepy

# 创建短链
def shorten_url(url):
    api_url = "http://yourls.example.com/yourls-api.php"
    params = {
        "url": url,
        "format": "json",
        "signature": "your_api_key_here"
    }
    response = requests.get(api_url, params=params)
    return response.json()['shorturl']

# 发布到Twitter
def post_to_twitter(short_url):
    auth = tweepy.OAuthHandler('consumer_key', 'consumer_secret')
    auth.set_access_token('access_token', 'access_token_secret')
    api = tweepy.API(auth)
    api.update_status(f"New post: {short_url}")

# 主流程
if __name__ == "__main__":
    long_url = "http://example.com/blog-post"
    short_url = shorten_url(long_url)
    post_to_twitter(short_url)

6.3.3 日志记录与错误处理机制设计

建议在脚本中添加日志记录功能，便于排查问题：

import logging

logging.basicConfig(filename='shorten.log', level=logging.INFO)

try:
    # ... your code ...
    logging.info(f"Shortened {url} to {short_url}")
except Exception as e:
    logging.error(f"Error: {str(e)}")

此外，可结合邮件或 Slack 通知机制，在出错时发送警报。

后续章节将继续探讨 YOURLS 的高级功能扩展、插件开发、性能调优等内容，敬请期待。

本文还有配套的精品资源，点击获取

DAMO开发者矩阵

DAMO开发者矩阵，由阿里巴巴达摩院和中国互联网协会联合发起，致力于探讨最前沿的技术趋势与应用成果，搭建高质量的交流与分享平台，推动技术创新与产业应用链接，围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐

测试集--2

网络爬虫（又称为网页蜘蛛或网络机器人）是一种按照一定规则自动抓取互联网信息的程序。它模拟浏览器的行为，向目标网站发送请求，接收响应数据，提取有用信息并保存到本地或数据库中编辑阿里云+1。爬虫技术在大数据时代显得尤为重要，因为它能够高效地获取和处理海量数据编辑知乎。

DAMO开发者矩阵

个人微信二次开发如何做机器人暂停策略？WechatApi 防止异常规则持续影响客户

DAMO开发者矩阵

国产宇树科技！全球顶流四足机器人独角兽

作为全球第I梯队的四足机器人商业化龙头，2016年诞生的宇树科技，彻底打破海外技术垄断，从初创团队逆袭成估值10亿美金的科创独角兽，产品远销全球50多个国家和地区，妥妥的国产科技名片！以技术自研为根基，精准布局全梯度产品，打通从核心零部件、终端设备到行业解决方案的全产业链，完美解决科创企业研发难、落地难、量产难的痛点。20kg持续负载、IP66防尘防水，适配户外恶劣环境，搞定巡检、高危作业、物资拖

DAMO开发者矩阵

所有评论(0)

查看更多评论

明月清风晓星

@weixin_33750664

已为社区贡献24条内容

开源短链工具YOURLS-1.8.1完整部署包

明月清风晓星

1. YOURLS简介与部署流程

2. YOURLS安装与PHP环境配置

2.1 YOURLS的安装包获取与结构解析

2.1.1 从官方下载YOURLS-1.8.1.zip并校验文件完整性

2.1.2 解压后的文件结构与核心目录说明

2.1.3 配置文件（如config.php）的初始设置要点

2.2 PHP环境搭建与兼容性要求

2.2.1 PHP版本需求与扩展模块安装（如MySQLi、cURL、GD）

2.2.2 部署Apache/Nginx服务器并配置虚拟主机

Apache 虚拟主机配置（ /etc/apache2/sites-available/yourls.conf ）：

Nginx 配置（ /etc/nginx/sites-available/yourls ）：

2.2.3 PHP.ini配置优化与常见错误排查

2.3 本地测试环境搭建实践

2.3.1 使用XAMPP/WAMP快速部署本地服务器

2.3.2 将YOURLS部署至本地并测试访问

2.3.3 检查服务器权限与目录访问限制问题

小结

3. YOURLS数据库连接与MySQL集成

3.1 MySQL数据库的准备与初始化

3.1.1 创建数据库与用户权限配置

3.1.2 导入YOURLS初始数据表结构

3.1.3 修改配置文件连接数据库参数

3.2 数据库表结构解析与数据关系梳理

3.2.1 主要数据表（如 yourls_url、yourls_options）功能说明

3.2.2 短链接存储机制与点击统计表设计

3.2.3 自定义字段与扩展表结构实践

3.3 数据库性能优化与维护策略

3.3.1 常用SQL查询语句分析与优化建议

3.3.2 数据备份与恢复方案（如 mysqldump、phpMyAdmin）

3.3.3 使用缓存机制提升数据库访问效率

流程图：YOURLS 数据访问流程

4. 短链接生成与自定义域名配置

4.1 短链接生成算法与机制解析

4.1.1 哈希算法与唯一性保障机制

示例代码：base62 编码函数

逻辑分析：

唯一性保障：

4.1.2 自定义短码功能的实现原理

实现机制：

数据库验证逻辑（伪代码）：

4.1.3 短链跳转流程与HTTP重定向技术

重定向实现代码（简化版）：

参数说明：

4.2 自定义域名绑定与虚拟主机配置

4.2.1 购买并解析自定义域名至服务器IP

操作步骤：

示例 DNS 配置表：

4.2.2 Apache/Nginx配置虚拟主机支持短链域名

Apache 配置（/etc/apache2/sites-available/short.conf）：

启用配置：

Nginx 配置（/etc/nginx/sites-available/short）：

启用配置：

4.2.3 测试短链访问与重定向规则验证

步骤一：访问测试

步骤二：测试短链跳转

步骤三：查看重定向状态码

4.3 多域名支持与短链分发策略

4.3.1 在YOURLS中配置多个自定义域名

4.3.2 分发策略与短链分组管理

示例：通过标签分组

分发策略建议：

4.3.3 实现短链的负载均衡与故障转移

架构图（Mermaid 流程图）：

实现方案：

Nginx 负载均衡配置示例：

参数说明：

5. 用户界面操作与前端管理功能

5.1 YOURLS后台管理界面概览

5.1.1 登录与权限验证机制

5.1.2 控制台功能模块与数据展示

5.1.3 用户操作界面的响应式设计

5.2 短链接的创建、编辑与批量管理

5.2.1 手动创建短链与设置自定义参数

5.2.2 批量导入链接与CSV文件处理

5.2.3 编辑与删除操作的安全确认机制

5.3 统计图表与访问记录查询

5.3.1 查看点击统计与来源分析

5.3.2 导出访问数据与CSV导出功能

Apache 虚拟主机配置（ `/etc/apache2/sites-available/yourls.conf` ）：

Nginx 配置（ `/etc/nginx/sites-available/yourls` ）：