/jump-jump

开箱即用,Golang 开发的一个功能完善的短链接系统。URL shortener service developed with golang.

Primary LanguageGoMIT LicenseMIT


Jump Jump

开箱即用,Golang 开发的一个功能完善的短链接系统。

license



快速体验

访问这里,来体验一下 Jump Jump 吧!(体验账号/密码:guest/guest)

功能与使用

功能模块,后续功能的方向/安排可以持续留意 issues:

截图

截图

本地启动

使用 docker-compose 启动,能够快速帮你启动 redis, apiserver, landingserver,使用如下命令:

# 克隆或下载项目源码到本地
git clone https://github.com/jwma/jump-jump.git

# 进入项目源码目录
cd jump-jump/

# 在本地构建容器镜像
make dockerimage

# 启动
docker-compose -f deployments/docker-compose.yaml -p jumpjump up -d

# 查看服务运行状态
docker-compose -f deployments/docker-compose.yaml -p jumpjump ps

# 如果看到 apiserver/landingserver 未启动成功,重启一下就好
docker-compose -f deployments/docker-compose.yaml -p jumpjump restart

# 创建用户,在服务正常运行的情况,运行 createuser 可以创建用户,使用如下
docker-compose -f deployments/docker-compose.yaml -p jumpjump exec apiserver ./createuser --help

Usage of ./createuser:
  -password string
        password.
  -role int
        role, 1: normal user, 2: administrator. (default 1)
  -username string
        username.

# 创建一个管理员角色的用户
docker-compose -f deployments/docker-compose.yaml -p jumpjump exec apiserver ./createuser -username=mj
 -password=12345 -role=2

在服务启动完毕且已经创建好用户之后,可以打开浏览器,访问 http://localhost:8080 进入管理后台进行短链接的管理工作。

如何访问短链接?

设置短链接域名

登入到管理后台之后,你能够看到短链接域名设置(只有管理员有权修改),在这里设置好你部署的域名/IP:Port,如: http://127.0.0.1:8000/ 或者 http://yourdomain.com/,这里有一点需要注意的是,需要以 / 结尾。

获取完整短链接

访问短链接列表页面,如果你已经创建了短链接,那么可以在列表的第一个字段,悬停一下,会出现一个带有域名的完整短链接,点击就可以自动拷贝到 剪切板,你可以到需要使用的地方进行粘贴或者使用浏览器访问。

Pin

如果你特别关心某个短链接近期的访问情况,不妨试一下在短链接列表中把它 Pin 到 Dashboard 首页,这样你就能方便的观察到它的访问情况啦~

部署到服务器

这里提供了使用 docker-compose 的部署方案,点击查看

接口文档

使用 Swagger UI 提供了一个可调试文档,具体使用方法查看这个 PR,希望这份文档能够帮助 到大家!

感谢

在这里感谢所有为 Jump Jump 提供建议和反馈 bug 的朋友们,有你们 Jump Jump 会变得更好!

MJ_STUDIO