​

53AI Hub

​

目录

• 环境要求
• 快速开始
  • 使用 Docker Compose 启动
  • 源代码编译启动
  • 使用预编译文件启动
• 配置说明
• 常见问题排查

​

环境要求

• Docker 和 Docker Compose (如使用容器化部署)
• Go 1.24+ (如从源码编译)

​

快速开始

​

使用 Docker Compose 启动

1. 克隆仓库到本地

git clone https://github.com/53AI/53AIHub.git
cd 53AIHub

2. 进入 docker 目录并启动服务

cd docker
docker-compose up -d

​

源代码编译启动

1. 克隆仓库到本地

git clone https://github.com/53AI/53AIHub.git
cd 53AIHub

2. 安装依赖并编译

go mod tidy
go build -o bin/53AIHub main.go

3. 启动 53AIHub 服务

./bin/53AIHub

​

使用预编译文件启动

1. 从 GitHub Releases 页面下载预编译文件

2. 解压下载的文件

# Linux/MacOS
tar -xzvf 53aihub-[版本号]-[系统].tar.gz

# Windows
# 使用解压软件解压 53aihub-[版本号]-windows.zip

3. 启动 53AI Hub

• Linux/MacOS:
  chmod +x 53aihub
  ./53AIHub
  
• Windows: 双击 53aihub.exe 文件启动

​

配置说明

• 数据库：SQLite（默认，无需配置）
• 端口：默认为 3000（可通过 PORT 环境变量修改）

• SQL_DSN: 数据库连接字符串，默认使用 SQLite
• PORT: 服务监听端口，默认为 3000
• LOG_LEVEL: 日志级别，可选值为 DEBUG、INFO（默认）
• API_HOST: API 主机地址，如需支持微信支付，必须配置此项

​

常见问题排查

​

1. 服务无法启动

• 检查端口是否被占用
• 查看日志文件中的错误信息

cat logs/53AIHub.log

​

2. 数据库问题

• 确认 MySQL 服务是否正常运行
• 检查数据库连接参数是否正确
• 确认数据库用户是否有足够的权限

​

3. 微信支付配置

export API_HOST="http://your-domain.com"

API_HOST="http://your-domain.com" ./53aihub

​

4. Token 编码器初始化失败

panic: runtime error: invalid memory address or nil pointer dereference

• billingratio.ModelRatio 为 nil
• logger 未正确初始化

• 确保在使用 logger 前已正确初始化