如何快速搭建自己的URL缩短服务：UrlHub完整使用指南

【免费下载链接】urlhub ✂️ URL shortener web application based on the Laravel PHP Framework. 项目地址: https://gitcode.com/gh_mirrors/ur/urlhub

UrlHub是一款基于Laravel PHP框架开发的开源URL缩短应用，让你能够轻松搭建属于自己的短链接服务。它不仅简单易用，还提供了丰富的功能，如自定义短链接、QR码生成、链接密码保护等，满足个人和企业的多样化需求。

🚀 为什么选择UrlHub？

UrlHub作为一款自托管的URL缩短工具，具有以下核心优势：

✅ 可靠的链接缩短功能

UrlHub是目前最可靠的自托管URL缩短工具之一，性能稳定且一致性高，让你无需担心链接失效问题。

✨ 丰富实用的功能特性

• 自定义URL：支持创建有意义的短链接（如 example.com/laravel），而非随机字符组合
• QR码生成：自动为短链接生成QR码，方便移动端快速访问
• 链接管理：可随时编辑或删除已创建的短链接，灵活控制你的链接资源
• 设备感知重定向：根据访问设备的操作系统，自动重定向到合适的URL
• 密码保护：可为短链接设置密码，限制对目标URL的访问
• 链接过期：支持设置链接的过期时间，创建临时短链接
• 参数传递：自动将查询参数转发到目标URL
• 预览功能：可在点击前查看目标链接，提高安全性

🎨 现代简洁的界面设计

UrlHub采用现代化的界面设计，支持深色模式，在低光环境下提供更舒适的使用体验。

📋 系统要求

在安装UrlHub之前，请确保你的服务器满足以下要求：

• PHP 8.2 或更高版本
• Apache 或 Nginx 等Web服务器
• MySQL / MariaDB / SQLite 数据库

🛠️ 快速安装步骤

1. 获取源码

首先克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/ur/urlhub
cd urlhub

2. 配置环境变量

重命名环境变量示例文件并进行必要配置：

cp .env.example .env

编辑.env文件，设置数据库连接信息和其他个性化配置。

3. 安装依赖并初始化

# 安装PHP依赖
composer install

# 生成应用密钥
php artisan key:generate

# 执行数据库迁移并填充初始数据
php artisan migrate --seed

4. 启动应用

php artisan serve

现在你可以通过 http://localhost:8000 访问UrlHub了。

5. 登录系统

使用以下默认账号登录：

• 管理员账号：admin@urlhub.test / admin
• 普通用户账号：user@urlhub.test / user

6. 构建前端资源

# 安装Node依赖
npm install

# 开发环境构建
npm run dev

# 生产环境构建
npm run build

💡 使用指南

创建你的第一个短链接

1. 登录UrlHub系统后，在首页找到链接创建表单
2. 输入目标URL（例如 https://example.com/very/long/url）
3. （可选）自定义短链接关键词（例如 mylink）
4. （可选）设置链接密码、过期时间等高级选项
5. 点击"创建"按钮，完成短链接生成

管理你的短链接

创建的短链接会显示在个人中心，你可以：

• 查看链接的访问统计
• 编辑链接的目标URL或其他属性
• 生成和下载链接的QR码
• 删除不再需要的链接

⚙️ 自定义配置

UrlHub提供了丰富的配置选项，你可以通过修改配置文件来自定义应用行为：

• 应用配置：config/app.php
• 数据库配置：config/database.php
• 认证配置：config/fortify.php

通过调整这些配置，你可以禁用用户注册、限制仅注册用户创建短链接等，打造符合自己需求的URL缩短服务。

🤝 贡献代码

UrlHub是一个开源项目，欢迎开发者贡献代码。你可以通过以下方式参与项目：

• 提交bug报告
• 提出功能建议
• 提交代码改进的Pull Request

项目的核心功能实现位于以下目录：

• 链接服务：app/Services/LinkService.php
• URL模型：app/Models/Url.php
• 控制器：app/Http/Controllers/

📄 许可证

UrlHub采用MIT许可证开源，详细信息请查看项目根目录下的LICENSE文件。

通过本指南，你已经掌握了UrlHub的安装和基本使用方法。开始创建你的第一个短链接，体验自托管URL缩短服务的便利吧！如有任何问题，欢迎查阅项目文档或参与社区讨论。

【免费下载链接】urlhub ✂️ URL shortener web application based on the Laravel PHP Framework. 项目地址: https://gitcode.com/gh_mirrors/ur/urlhub