> ## 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.

# 本地部署

# 本地部署

53AIHub 提供了支持一键安装的本地部署安装包，可一键部署到你的本地服务器/阿里云/腾讯云/华为云等云计算厂商的云服务器 上。它适合以下场景：

* 你有自己的云服务器，并且非常关心数据私有化。
* 你对 [53AIHub 云服务](https://docs.53ai.com/zh-cn/getting-started/cloud)感兴趣，希望先在本地快速体验 53AIHub的产品。
* 你企业希望在购买 53AI Hub商业版之前进行场景的 POC 验证。

### 快速开始

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

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

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

2. 解压下载的文件

* Linux/MacOS:

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

* Windows:

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

3. 启动 53AIHub

* Linux/MacOS:

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

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

### 配置说明

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

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

如果需要特定功能，可以在运行目录下创建 `.env`文件，配置以下环境变量：

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

### 产品升级

升级分为以下步骤：

1. 备份数据
2. 下载新版
3. 安装升级

**1. 备份数据**

* Linux/MacOS:

  * 1.1  运行 `cd` 命令至你的 53AI Hub 项目路径，新建备份分支。
  * 1.2  运行命令停止服务，在 Docker 目录中执行备份数据命令。

```bash theme={null}
docker compose down
tar -cvf volumes-$(date +%s).tgz volumes
```

* Windows:
  * 打开文件管理进入到你的53AI Hub所在目录，新建备份文件夹
  * 退出原来的 `53AIHub.exe` ，复制当前目录至备份文件夹中

**2. 下载新版**

在官网或github仓库下载新的版本，解压到当前目录

**3. 安装升级**

按照“快速开始”中的说明重新启动 53AIHub

你可以根据需要修改目录下 `.env` 文件里的环境变量。然后重新启动 53AI Hub