安装和运行

前置要求

• Go 1.21 或更高版本

安装依赖

go mod tidy

运行服务器

go run main.go

服务器将在 http://127.0.0.1:2998 启动。

API 接口

页面访问量统计

• URL: GET /api/page_view
• 功能: 获取并增加页面访问量计数
• 响应:

  {
    "page_view": 123
  }

WebSocket 连接

• URL: ws://127.0.0.1:2998/ws/ismismcube_online
• 功能: 建立 WebSocket 连接，接收在线用户数量更新
• 消息格式:

  {
    "online_count": 5
  }

静态文件

• Favicon: GET /favicon.ico
• 404 页面: 访问不存在的路径时返回自定义 404 页面

配置

可以通过环境变量进行配置：

• PORT: 服务器端口（默认: 2998）
• DB_HOST: 数据库主机地址（默认: 106.14.192.75）
• DB_PORT: 数据库端口（默认: 3306）
• DB_USERNAME: 数据库用户名（默认: ismismcube_connector）
• DB_PASSWORD: 数据库密码（默认: test）
• DB_DATABASE: 数据库名称（默认: ismismcube_test）

项目结构

核心文件

• main.go - 应用入口，启动服务器
• go.mod - Go 模块依赖管理

内部模块

• internal/api/router.go - API 路由注册和初始化
• internal/config/config.go - 配置管理，支持环境变量
• internal/handler/ - 请求处理器
  • page_view.go - 页面浏览量统计处理
  • ping.go - 健康检查接口
• internal/middleware/cors.go - CORS 和缓存控制中间件
• internal/router/router.go - 自定义路由系统实现
• internal/websocket/ismismcube.go - WebSocket 连接管理

数据库

• 使用MySQL数据库存储页面访问记录和AI任务执行记录

资源文件

• test/ - 测试相关文件

许可证

MIT License