YOURLS

🔗 The 𝘥𝘦 𝘧𝘢𝘤𝘵𝘰 standard, self hosted, powerful and customizable, URL shortener in PHP

项目简介

YOURLS 全称「Your Own URL Shortener」，是一款开源的自托管 URL 短链接服务程序。与 bit.ly、TinyURL 等商业服务不同，YOURLS 让你完全掌控自己的数据——所有短链接、访问统计、用户信息都存储在你自己的服务器上。这个项目由 PHP 开发，需要至少一台安装了 PHP 和 MySQL 的服务器即可部署运行。

对于需要管理大量链接的营销人员、社交媒体运营者，或者希望拥有独立品牌短域名的企业来说，YOURLS 提供了一个强大且灵活的解决方案。截至目前，该项目在 GitHub 上已获得超过 12,000 颗星标和 2,000 多次 Fork，足以证明其在开源社区的受欢迎程度。

核心功能与架构

主要功能特性

YOURLS 的核心价值在于为用户提供完整的短链接生命周期管理能力。在链接创建环节，系统支持自动生成随机短码，用户也可以自定义想要的有意义别名，比如将 abc123 替换为自己品牌相关的 promo2024。每个短链接都配有独立的统计面板，记录点击次数、访问来源、地理位置、时间分布等关键数据。

API 接口是 YOURLS 的另一大亮点。通过 RESTful API，开发者可以将短链接生成功能集成到任何第三方应用中——无论是 WordPress 站点、Chrome 插件还是自动化脚本，都能轻松调用。这意味着你可以把 YOURLS 作为后台服务，在多个平台复用同一套短链接基础设施。

插件扩展系统

YOURLS 拥有活跃的插件生态。社区开发者贡献了涵盖社交分享、验证码保护、自定义跳转页面、SEO 优化等多个领域的插件。你可以安装 Google Analytics 集成插件来统一管理流量数据，使用「只允许注册用户创建链接」插件来控制团队使用权限，或者部署地理位置重定向插件根据访客所在地区跳转到不同页面。

数据存储架构

系统默认使用 MySQL 数据库存储所有链接数据，数据库表结构经过精心设计，包含链接别名、原始 URL、创建时间、点击统计、访问日志等核心字段。对于访问量较小的个人使用场景，也可以选择 SQLite 数据库，无需额外部署 MySQL 服务。

快速上手

环境准备

YOURLS 对运行环境有一定要求。在开始安装前，请确保你的服务器满足以下条件：

• PHP 7.4 或更高版本
• PHP 扩展：pdo、pdo_mysql（或 pdo_sqlite）、mbstring、gd、curl
• MySQL 5.0+ 或 MariaDB 或 SQLite 3
• Web 服务器（Apache、Nginx 或 LiteSpeed）

对于初学者来说，推荐使用宝塔面板或 cPanel 等可视化管理工具来简化环境配置。如果你是开发者，可以直接通过 Docker 快速搭建测试环境。

通过 Docker 部署

Docker 是最便捷的部署方式，一条命令即可启动完整的 YOURLS 服务：

docker run -d \
  --name yourls \
  -p 8080:80 \
  -e YOURLS_SITE='http://short.example.com' \
  -e YOURLS_USER='admin' \
  -e YOURLS_PASS='your-password' \
  -v /data/yourls:/var/www/html \
  yourls:latest

这条命令会下载最新的 YOURLS 镜像，将容器内部 80 端口映射到宿主机的 8080 端口，并配置管理员账号密码。数据持久化通过 /data/yourls 卷实现，容器删除后数据不会丢失。

如果你需要使用 MySQL 数据库存储数据，可以配合 Docker Compose 编排多容器服务：

version: '3'
services:
  yourls:
    image: yourls:latest
    ports:
      - "8080:80"
    environment:
      YOURLS_SITE: http://short.example.com
      YOURLS_USER: admin
      YOURLS_PASS: your-password
      YOURLS_DB_HOST: mysql
      YOURLS_DB_NAME: yourls
      YOURLS_DB_USER: yourls_user
      YOURLS_DB_PASS: yourls_password
    volumes:
      - ./yourls_data:/var/www/html
    depends_on:
      - mysql

  mysql:
    image: mysql:8
    environment:
      MYSQL_DATABASE: yourls
      MYSQL_USER: yourls_user
      MYSQL_PASSWORD: yourls_password
    volumes:
      - ./mysql_data:/var/lib/mysql

传统安装方式

对于不使用 Docker 的用户，可以手动安装。首先从 GitHub Releases 页面下载最新的稳定版压缩包，解压到 Web 服务器的网站根目录，然后按照以下步骤完成配置。

将 user/config.php 文件复制并重命名为 config.php，填入数据库连接信息和管理员账号密码。数据库部分需要指定主机地址、数据库名、用户名和密码，如果使用 SQLite 则只需配置文件路径即可。

配置完成后，访问你的域名或 IP 地址，YOURLS 会自动检测并引导完成数据库初始化。成功安装后，你将看到管理后台界面，可以在其中创建短链接、查看统计数据。

绑定自定义域名

YOURLS 支持使用任意域名作为短链接的域名，这与系统默认安装路径完全独立。你可以在 DNS 服务商处添加一条 CNAME 记录，将你的短域名（如 link.example.com）指向 YOURLS 服务器的地址，然后在配置文件中修改 YOURLS_SITE 为新的域名即可。这样生成的短链接就会显示为你自己的品牌域名。

使用场景

个人链接管理

对于经常需要在社交媒体分享文章或作品的用户，自建短链接服务能带来诸多便利。与每次手动复制长 URL 相比，YOURLS 可以让你在一条短链接失效时随时修改其指向的目标地址，而无需更新已经发布的帖子内容。此外，详细的访问统计能帮助你了解哪些内容更受关注，优化内容策略。

团队协作与品牌建设

营销团队通常需要在多平台投放大量链接，统一管理这些链接的指向和统计至关重要。YOURLS 的多用户模式支持为团队成员创建独立账号，每个账号创建的链接独立统计，既便于管理也利于绩效考核。对于追求品牌一致性的企业，使用自定义域名的短链接能显著提升专业形象。

API 集成开发

开发者可以利用 YOURLS 的 API 实现自动化工作流。例如，当博客发布新文章时自动生成短链接并推送到社交媒体账号；或者在客服系统中自动生成包含追踪参数的短链接，用于评估不同渠道的咨询转化率。API 返回 JSON 格式数据，与主流编程语言的 HTTP 客户端都能良好配合。

注意事项

安全防护

部署在公网的 YOURLS 服务需要做好基础安全防护。强烈建议使用 HTTPS 加密所有通信，防止短链接在传输过程中被篡改。YOURLS 自带的管理后台路径可以通过修改 .htaccess 或重写规则来更改默认的 /admin/ 地址，增加攻击者暴力破解的难度。对于公开访问的场景，务必安装验证码插件防止恶意灌水和自动化请求。

性能优化

随着链接数量和访问量增长，数据库可能成为性能瓶颈。建议定期分析慢查询日志，为点击次数较高的链接对应的数据库表添加索引。YOURLS 支持与 Redis 等内存缓存系统集成，将热点数据缓存在内存中减少数据库压力。如果访问量特别大，可以考虑在服务器前端部署 Nginx 并开启页面缓存。

数据备份

任何服务都存在数据丢失的风险。建议配置自动化的数据库备份策略，至少每天执行一次完整备份，并将备份文件同步到独立的存储位置。对于使用 Docker 部署的用户，绑定卷的正确路径至关重要，确保备份范围包含所有持久化数据目录。

总结

YOURLS 为需要自建短链接服务的用户提供了一个成熟、功能丰富且易于扩展的解决方案。它既有开箱即用的基础功能，也提供了充足的定制空间来满足个性化需求。无论是个人用于链接管理，还是团队用于营销协作，都能从中获得价值。结合 Docker 的便捷部署方式，即使是没有服务器运维经验的开发者，也能在几分钟内搭建起自己的短链接服务。

项目信息

参考链接

• GitHub 仓库
• 项目主页