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

一、简介

• 这是一个超高性能唯一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_id
      privileged: true
      restart: always
      environment:
        - 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=root
      ports:
        - 2023:3000
      volumes:
        - ./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生成的业务系统中，都有用武之地

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