> ## Documentation Index
> Fetch the complete documentation index at: https://docs.53ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 全站后端

# 53AI Hub

53AI Hub 是一个强大的 AI 门户管理平台，支持多种智能体开发平台的接入。本指南将帮助您快速上手并开始使用 53A IHub。

## 目录

* [环境要求](#环境要求)
* [快速开始](#快速开始)
  * [使用 Docker Compose 启动](#使用-docker-compose-启动)
  * [源代码编译启动](#源代码编译启动)
  * [使用预编译文件启动](#使用预编译文件启动)
* [配置说明](#配置说明)
* [常见问题排查](#常见问题排查)

## 环境要求

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

## 快速开始

### 使用 Docker Compose 启动

1. 克隆仓库到本地

```bash theme={null}
git clone https://github.com/53AI/53AIHub.git
cd 53AIHub
```

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

```bash theme={null}
cd docker
docker-compose up -d
```

这将启动 53AI Hub 应用 (端口 80)。

服务将在 `http://localhost` 上运行。

### 源代码编译启动

1. 克隆仓库到本地

```bash theme={null}
git clone https://github.com/53AI/53AIHub.git
cd 53AIHub
```

2. 安装依赖并编译

```bash theme={null}
go mod tidy
go build -o bin/53AIHub main.go
```

3. 启动 53AIHub 服务

```bash theme={null}
./bin/53AIHub
```

服务将在默认端口上运行（默认是 80，可通过 PORT 环境变量修改）。

### 使用预编译文件启动

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

访问 [GitHub Releases](https://github.com/53AI/53AIHub/releases) 下载适合您操作系统的预编译文件。

2. 解压下载的文件

```bash theme={null}
# Linux/MacOS
tar -xzvf 53aihub-[版本号]-[系统].tar.gz

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

3. 启动 53AI Hub

* Linux/MacOS:

  ```bash theme={null}
  chmod +x 53aihub
  ./53AIHub
  ```
* Windows:
  双击 `53aihub.exe` 文件启动

服务将在默认端口上`80`运行。

## 配置说明

53AI Hub 默认不需要任何配置即可启动，它使用以下默认配置：

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

如果需要特定功能，可以配置以下环境变量：

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

## 常见问题排查

### 1. 服务无法启动

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

```bash theme={null}
cat logs/53AIHub.log
```

### 2. 数据库问题

默认情况下，53AI Hub 使用 SQLite 数据库，无需额外配置。如果您配置了 MySQL 数据库但连接失败：

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

### 3. 微信支付配置

如需支持微信支付功能，必须配置 `API_HOST` 环境变量：

```bash theme={null}
export API_HOST="http://your-domain.com"
```

或在启动时指定：

```bash theme={null}
API_HOST="http://your-domain.com" ./53aihub
```

### 4. Token 编码器初始化失败

错误信息示例：

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

可能原因：

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

解决方法：

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

如果您遇到其他问题，请提交 GitHub Issue 获取支持。

```
```