环境要求

服务器配置

项目	最低要求	推荐配置
CPU	1 核	2 核+
内存	1 GB	2 GB+
硬盘	20 GB	40 GB+
操作系统	CentOS 7+ / Ubuntu 18+	CentOS 7.9 / Ubuntu 22.04

软件环境

软件	版本要求	说明
宝塔面板	8.0+	推荐最新版
PHP	8.0 - 8.2	必须 8.0 及以上
MySQL	5.7+ / 8.0	推荐 MySQL 8.0
Nginx	1.18+	宝塔默认安装即可
Redis	5.0+	可选，用于缓存和队列
Composer	2.x	服务端 PHP 依赖管理

PHP 扩展要求

以下扩展必须开启（宝塔面板 PHP 管理 → 安装扩展）：

• fileinfo — 文件上传必须
• redis — 如使用 Redis 缓存
• curl — HTTP 请求
• openssl — 加密通信
• mbstring — 多字节字符处理
• pdo_mysql — 数据库连接
• json — JSON 处理
• gd — 图片处理

注意

fileinfo 扩展是最容易遗漏的，未安装会导致文件上传功能失败。

端口要求

端口	用途
80	HTTP 访问
443	HTTPS 访问（推荐）
3306	MySQL（建议仅内网访问）
6379	Redis（建议仅内网访问）

域名

至少需要准备 2 个域名（或子域名）：

• API 域名 — 服务端接口，如 api.example.com
• 管理后台域名 — 如 admin.example.com
• H5 前端域名 — 如 h5.example.com（如部署 H5 版本）