https://github.com/hczs/tiny-url-app
🚀 短网址服务 Web App（基于JDK21 + SpringBoot3 + Spring WebFlux + R2DBC + Redisson + GraaLVM Native Image + Next.js + shadcn/ui 开发）
https://github.com/hczs/tiny-url-app
graalvm graalvm-native-image java jdk21 nextjs r2dbc-mysql react shadcn-ui springboot3 tiny-url typescript webflux
Last synced: 22 days ago
JSON representation
🚀 短网址服务 Web App（基于JDK21 + SpringBoot3 + Spring WebFlux + R2DBC + Redisson + GraaLVM Native Image + Next.js + shadcn/ui 开发）
- Host: GitHub
- URL: https://github.com/hczs/tiny-url-app
- Owner: hczs
- Created: 2025-01-03T03:12:45.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-20T07:53:10.000Z (over 1 year ago)
- Last Synced: 2025-03-20T08:37:36.666Z (over 1 year ago)
- Topics: graalvm, graalvm-native-image, java, jdk21, nextjs, r2dbc-mysql, react, shadcn-ui, springboot3, tiny-url, typescript, webflux
- Language: Java
- Homepage: https://tiny.powercheng.fun/
- Size: 228 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 短网址生成器（Tiny Url App）
## 主要特性
- 提供两种网址缩短方案，可根据需要自行选择：
- 分布式唯一ID + Base62：短编码最长到 9 位，常规长度在 8 位，优势生成简单快速，劣势就是短编码 8 位，会稍微长一点
- MurMurHash3 32 位 + Base62：短编码长度稳定在 6 位，优势是短编码足够短，但是需要额外操作，使用布隆过滤器处理哈希碰撞问题
- 提供了一套简单易用的 UI 界面
- 部署简单：后端部署可以直接 Docker 一键部署启动，前端可以直接 Vercel 部署，如果有自己域名可以配置，还免去了申请 SSL 证书、网站备案等繁琐操作
- 性能强劲：使用 GraaLVM Native Image 打包方式，项目启动时间仅 0.29 秒；使用 Spring WebFlux 框架，应用有更优秀的并发性能
## 体验站点
- Vercel 站点：https://tiny-url-app.vercel.app/
- 国内站点：http://101.126.68.192:31006/
## 程序部署
### 后端部署
环境说明：
- Docker: Docker version 25.0.5
- MySQL: MySQL 8.4.3 并自行创建 tiny_url 库，执行初始化脚本 tiny-url-app-backend/src/main/resources/sql/t_url_mapping.sql
- Redis: v7.4.1
在服务器创建 tiny-url-app 文件夹，建立 config 目录，在 config 目录中创建 application.yml 和 application-prod.yml 文件，写入以下内容，并根据实际情况配置 MySQL 和 Redis 的地址及端口
application.yml
```yml
spring:
# app name
application:
name: tiny-url-app-backend
profiles:
active: dev
```
application-prod.yml
```yml
spring:
# database info
r2dbc:
url: r2dbc:mysql://127.0.0.1:3306/tiny_url?useSSL=false
username: root
password: xxx
pool:
initial-size: 5
max-size: 20
max-idle-time: 30m
# redis
data:
redis:
host: 127.0.0.1
port: 6379
password: xxx
tiny-url-app:
# reference fun.powercheng.url.tiny.enums.ShortenerTypeEnum
shortener-type: MURMUR32_WITH_BASE62
# 如果用 UNIQUE_ID_WITH_BASE62 必须配置 worker id
worker-id: 1
# global cache config
cache-config:
cache-duration: 3
duration-unit: hours
```
在 config 同级目录下运行下面的命令，启动后端服务
```shell
docker run -d -p 8080:8080 -v ./config:/config -v ./log:/app/log hsunnyc/tiny-url-app-backend
```
### 前端部署
首先 fork 本项目
访问 Vercel 平台：https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme
登录自己的 GitHub 账号后，可选择自己的仓库，点击 import
选择 Next.js 框架，选择项目的 frontend 目录，点击 Deploy 即可开始部署
部署完成后，在 Vercel 的项目主界面中，点击 Settings 菜单，设置后端 API 的地址：
- key 是 NEXT_PUBLIC_API_PROXY_URL
- Value 是你的后端地址，例如 http://x.x.x.x:8080
至此，项目部署完成