---
url: /tools/ohurlshortener.md
description: >-
  ohUrlShortener 是一个基于 Spring Boot 的短链接服务，支持自定义短链接、统计、防刷、黑名单等功能，本文将介绍如何快速部署
  ohUrlShortener。
---

# 五分钟完成企业级短链接服务部署——ohUrlShortener

短链接服务有什么用？我只想说那真是太有用了。

举几个例子：

* 如果你要给用户发送短信需要包含跳转链接，通常链接都会比较长，再加上需要带上一些个性化参数，一条短信就会变成多条短信，费用增加还对用户体验不友好

* 如果你有多个广告位，你配置了同一个第三方的商品链接，此时你想要知道每个广告位带来了多少点击量

* 如果你需要设定一个不变的链接，但是又想不同的时间段跳转到不用的内容上

……

上述场景，都可以通过使用短链接实现。本文我将为大家介绍一款免费、开源的短链接项目——ohUrlShortener。

## 什么是ohUrlShortener

ohUrlShortener是适合中小型社区网站使用的企业级短链接服务系统，支持短链接生产、查询及302转向，并自带点击量统计、独立IP数统计、访问日志查询。

![](/img/2eadbbbc-9723-435a-a459-5f5a9800d098.png)

## ohUrlShortener的功能

* 支持 Docker One Step Start 部署启动
* 支持短链接生产、查询、存储、302转向
* 支持访问日志查询、访问量统计、独立IP数统计
* 支持 HTTP API 方式新建短链接、禁用/启用短链接、查看短链接统计信息、管理员设置
* 支持访问日志导出，方便线下分析

## 快速使用

1. 克隆项目代码

```sh
git clone https://github.com/barats/ohUrlShortener.git
```

2. 项目根目录下 `ohUrlShortener/docker` 目录中，包含 Docker 一键启动相关的配置脚本，执行命令

```sh
./one_step_start.sh
```

需要注意的是，首先要确保已经安装好了`docker`和`docker-compose`。

3. 访问`http://localhost:9092/`

![](/img/41f4af9b-c6bd-407a-a4bf-1d5f6e41301d.png)

![](/img/2451d3df-e4d2-42b2-94a2-2d692fa76a7b.png)

4. 创建短链

![](/img/1e6ac609-62f0-4172-9983-48cef421b9d3.png)

5. 查看访问数据

![](/img/3dcbba50-a462-4aa9-8aae-861aa90f7988.png)

## 进阶

ohUrlShortener不仅支持页面操作，对于企业来说，更需要的是将短链接服务集成到自有系统中。ohUrlShortener拥有对应API，开发者可以通过调用API的方式创建短链接或者查看数据。

了解了ohUrlShortener，如果你也正好需要短链接服务，不妨部署一个。如果你需要了解更多，可以关注公众号：遇码，回复**ohurls**获取官方文档。