nqdinh/gobench

Gobench 基准测试框架

Gobench是一个用Golang开发的基准测试框架，无需DSL，通过Golang代码定义复杂测试场景，支持多种协议（HTTP、MQTT、NATS等），并提供实时监控仪表盘，可实现高并发连接测试。

注意：Gobench正处于活跃开发阶段。

核心功能

• 支持HTTP、MQTT、NATS协议（Websocket、GraphQL即将添加）
• 用Golang代码定义复杂测试场景，灵活度高
• 支持百万级并发连接（开发中）
• 实时展示测试结果及主机状态（CPU、内存、网络等）
• 支持Docker快速部署，数据持久化和管理员密码配置

使用场景

• API接口性能测试（HTTP）
• MQTT/NATS消息队列性能验证
• 高并发连接场景压力测试
• 系统资源消耗评估

配置说明

• 管理员密码：通过--admin-password参数设置
• 数据持久化：挂载/root/.gobench目录到主机路径
• 场景定义：通过Golang代码编写，需包含export()函数返回虚拟用户配置

Docker部署示例

基础运行

bash
docker run -p 8080:8080 nqdinh/gobench:latest

访问http://localhost:8080查看仪表盘。

带密码和数据持久化

bash
docker run -p 8080:8080 -v "/tmp/abc:/root/.gobench" nqdinh/gobench:latest --admin-password supertest

快速开始

1. 启动Gobench服务器，打开仪表盘创建新应用
2. 输入以下测试场景代码（测试本地8080端口服务）：

go
package main

import (
    "context"
    "log"
    "time"

    httpClient "github.com/gobench-io/gobench/clients/http"
    "github.com/gobench-io/gobench/dis"
    "github.com/gobench-io/gobench/executor/scenario"
)

func export() scenario.Vus {
    return scenario.Vus{
        {
            Nu:   5,
            Rate: 1000,
            Fu:   f,
        },
    }
}

func f(ctx context.Context, vui int) {
    client, err := httpClient.NewHttpClient(ctx, "home")
    if err != nil {
        log.Println("创建客户端失败：" + err.Error())
        return
    }

    url1 := "http://localhost:8080"
    timeout := time.After(2 * time.Minute)

    for {
        select {
        case <-timeout:
            return
        default:
            go client.Get(ctx, url1, nil)
            dis.SleepRatePoisson(10)
        }
    }
}

3. 在仪表盘查看实时测试结果及主机状态

编写测试场景

场景需包含func export() scenario.Vus {...}函数，返回虚拟用户（Vu）配置数组：

• Nu：虚拟用户数量
• Rate：启动速率（Poisson分布）
• Fu：虚拟用户行为函数（需为func f(ctx context.Context, vui int) {...}）

多虚拟用户类型示例：

go
func export() scenario.Vus {
    return scenario.Vus{
        {
            Nu:   5,
            Rate: 1000,
            Fu:   adminF,
        },
        {
            Nu:   7,
            Rate: 1000,
            Fu:   userF,
        },
    }
}

基准工具对比

HTTP客户端对比（测试Nginx页面）

MQTT客户端对比（测试Vernemq）

赞助