helloz/zurl

Zurl

Zurl 是一款简单且实用的短链接系统，可快速生成短链接，方便分享和管理。它旨在提供轻量级解决方案，帮助用户更好地管理和跟踪链接。

!970c82f82f62fe5c.png

!c57c3cce4618acd3.png

功能特点

• 短链接生成：将长链接转换为短链接，便于分享和传播。
• 链接管理：提供直观界面，支持查看、编辑和删除链接。
• 延迟计数：延迟记录短链接点击次数，避免高并发压力。
• 自动获取标题：添加链接时自动获取长链接标题，便于识别。
• UA屏蔽：支持自定义屏蔽特定User-Agent，防止***访问。
• 数据迁移：可将YOURLS数据迁移至Zurl，便于用户过渡。
• API接口：提供API，支持二次开发和系统集成。
• 支持设置短链有效期
• 自定义站点信息
• API Token管理
• 高级分析
• 中英文双语支持
• 登录会话管理

安装方法

目前仅支持Docker安装，请确保已安装Docker和Docker Compose

1. 创建配置文件

新建docker-compose.yaml文件，内容如下：

yaml
version: '3.8'

services:
  zurl:
    container_name: zurl
    image: helloz/zurl
    ports:
      - "3080:3080"
    restart: always
    volumes:
      - ./data:/opt/zurl/app/data

2. 启动服务

执行以下命令启动容器：

bash
docker-compose up -d

3. 初始化设置

访问http://IP:3080，根据页面提示完成初始化配置。

升级方法

1. 备份挂载目录下的data文件夹
2. 停止并删除当前容器：

   bash
   docker-compose down
   

3. 拉取最新镜像：

   bash
   docker-compose pull
   

4. 重新启动容器：

   bash
   docker-compose up -d
   

注意：升级前请务必备份数据，升级造成的数据风险由用户自行承担。

配置说明

UA屏蔽

在挂载目录的config.toml文件中，通过app.DENY_UA配置需要屏蔽的User-Agent，默认屏蔽以下关键词：

• *信
• *Q

修改配置后需重启容器生效：docker-compose restart zurl

重置密码

若忘记管理员账号或密码，可删除挂载目录下的config.toml文件，重启容器后重新访问http://IP:3080完成初始化（此操作不影响链接数据）。

警告：切勿删除挂载目录下的db文件夹，否则将导致链接数据丢失。

演示站点

• 演示地址：[***]
• 用户名：xiaoz
• 密码：blog.xiaoz.org

问题反馈

• 可在 https://github.com/helloxz/zurl/issues 提交问题
• 或添加微信：xiaozme（请备注"Zurl"）

技术栈

• 后端：Python3 + FastAPI
• 前端：Vue3 + Element Plus
• 数据库：SQLite3
• 缓存：Redis

其他产品

• Zdir - 轻量级多功能文件分享程序
• OneNav - 高效浏览器书签管理工具
• ImgURL - 免费图床服务（2017年上线）