当前位置：首页 > news >正文

Go语言打造：超高性能分布式唯一ID生成工具

news 来源：原创 2025/7/1 4:19:21

一、简介

这是一个超高性能唯一ID生成工具，支持docker一键部署，提供API接入功能
支持高性能生成Snowflake ID、Sonyflake ID、UUID v1、UUID v4、XID、KSUID以及自定义ID的服务
可以用来生成订单编号、学号、高标准唯一标识、有序ID等等
开源地址参考：GitHub - luler/hello_id: 高性能生成snowflake id、sonyflake id、uuid v1、uuid v4、xid、ksuid以及自定义ID的服务

二、安装部署

提前准备好docker、docker-compose环境（这里不再赘述）

新增docker-compose.yml文件，配置内容如下，需要设置正确的MySQL连接配置：

version: "3"
services:hello_id:image: ccr.ccs.tencentyun.com/luler/hello_idprivileged: truerestart: alwaysenvironment:- ADMIN_NAME=admin      #管理员账号- ADMIN_PASSWORD=admin  #管理员登录密码- JWT_SECRET=FYDE7x5A   #页面访问token加密秘钥，自定义一个复杂的- DB_NAME=hello_id  #数据库名称，提前创建好- DB_HOST=10.10.11.195 #数据库ip地址- DB_PORT=3306- DB_USERNAME=root- DB_PASSWORD=rootports:- 2023:3000volumes:- ./runtime:/app/runtime

在文件下执行启动命令
```
docker-compose up -d
```

三、使用示例

1. 自带后台管理页面

后台页面地址：http://127.0.0.1:2023 ，默认登录账号：admin，密码：admin
登录之后，新增一个自定义ID
在页面上测试生成一个ID，如下

2. 使用服务提供的API示例

2.1 使用API之前，需要在后台增加一个授权码，用于API调用授权

2.2 API使用示例

postman调用生成自定义ID示例

2.3 更多接口文档信息

2.3.1 生成雪花id（基于时间、机器id、随机数生成，有序，整数类型）

接口: /api/snowflake
方法：GET
请求参数：

字段	是否必填	类型	描述
workerId	否	int	机器ID，取值范围0-1023，默认0
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["1711927875550052352"],"type": "snowflake","workerId": 0},"message": "创建成功"
}

2.3.2 生成sonyflake id（snowflake的改进版本，可用时间更长，有序，整数类型）

接口: /api/sonyflake
方法：GET
请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["482279196769390593"],"type": "sonyflake"},"message": "创建成功"
}

2.3.3 生成uuid V1 （根据时间、Mac地址等信息生成，有时间顺序）

接口: /api/uuid1

方法：GET

请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["c9973b96-67db-11ee-89f2-00ff0c3e16f1"],"type": "uuid1"},"message": "创建成功"
}

2.3.4 生成uuid V4 （完全随机生成，无序）

接口: /api/uuid4

方法：GET

请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["f26cb76e-574b-4797-949e-85f449c77ee3"],"type": "uuid4"},"message": "创建成功"
}

2.3.5 生成xid（基于时间戳、随机数生成，有序）

接口: /api/xid

方法：GET

请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["ckj09svfe3qiv1150kr0"],"type": "xid"},"message": "创建成功"
}

2.3.6 生成ksuid（基于时间戳、随机数生成，随机数比xid更大，唯一性更好，有序）

接口: /api/ksuid

方法：GET

请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["2Wb9ZXX2OWPOpubXAKRLwQGn7cP"],"type": "ksuid"},"message": "创建成功"
}

2.3.7 生成自定义ID（简单定制化，原子有序）

接口: /api/getId

方法：GET

请求参数：

字段	是否必填	类型	描述
type	是	string	ID标识
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": ["20230930000000114.go"],"message": "获取成功"
}

四、总结

该工具可以提供高性能的ID生成服务，特别是自定义ID，配置灵活，使用简单，基本是纯内存生成唯一有序ID，可以集群部署无限扩展性能
开发必备组件，在很多需要ID生成的业务系统中，都有用武之地

临时演示试用地址：我这个咩应用

Go语言打造：超高性能分布式唯一ID生成工具

一、简介这是一个超高性能唯一ID生成工具，支持docker一键部署，提供API接入功能支持高性能生成Snowflake ID、Sonyflake ID、UUID v1、UUID v4、XID、KSUID以及自定义ID的服务可以用来生成订单编号、学号、高标准唯一标识、有序ID等等开源地址参考&#…...

编程日记 2025/7/1 4:19:21

列表计量单位显示 E:\javaDev\tender-project-vben5\apps\web-antd\src\views\tender\material\data.ts import type { FormSchemaGetter } from #/adapter/form; import type { VxeGridProps } from #/adapter/vxe-table;import { getDictOptions } from #/utils/dict; impor…...

编程日记 2025/6/27 2:39:53

一、简介

二、安装部署

三、使用示例

1. 自带后台管理页面

2. 使用服务提供的API示例

2.1 使用API之前，需要在后台增加一个授权码，用于API调用授权

2.2 API使用示例

2.3 更多接口文档信息

2.3.1 生成雪花id（基于时间、机器id、随机数生成，有序，整数类型）

2.3.2 生成sonyflake id（snowflake的改进版本，可用时间更长，有序，整数类型）

2.3.3 生成uuid V1 （根据时间、Mac地址等信息生成，有时间顺序）

2.3.4 生成uuid V4 （完全随机生成，无序）

2.3.5 生成xid（基于时间戳、随机数生成，有序）

2.3.6 生成ksuid（基于时间戳、随机数生成，随机数比xid更大，唯一性更好，有序）

2.3.7 生成自定义ID（简单定制化，原子有序）

四、总结

相关文章：