概述

系统基于 ThinkPHP 8.0 + Swoole 4 构建，运行于 Linux 服务器环境。本文档列出系统运行所需的服务器硬件推荐、核心运行软件及扩展要求。

---

推荐服务器硬件配置

规模	CPU	内存	带宽	适用场景
入门推荐	2核	4G	5M+	小型商户、单店运营、测试环境
标准商用	4核	8G	10M+	连锁多门店、中等流量日常运营
高并发	8核+	16G+	20M+ (配合按量/CDN)	促销大促、高并发租赁/商城业务

---

核心软件与版本要求

软件/组件	推荐版本	说明
操作系统	Ubuntu 20.04+ / Debian 11+ / CentOS 7.9 / Rocky Linux 8+	推荐 Linux 64 位系统，CPU 架构必须为 x86_64 (AMD64)
Web 服务器	Nginx >= 1.18 (推荐 1.20+)	反向代理 Swoole 服务与静态资源分发
PHP	PHP 8.0.x	核心后端运行环境（必须为 NTS 非线程安全版本）
MySQL	MySQL 5.7 / 8.0+	关系型数据库（需支持 InnoDB）
Redis	Redis 6.0+	缓存、队列、WebSocket Room 与分布式锁
Swoole	Swoole 4.0.10+ (推荐 4.8.x 或 5.x)	常驻内存 HTTP / WebSocket 引擎
Supervisor	Supervisor 3.0+	守护 php think swoole 进程

---

PHP 必需扩展与配置

基础与核心扩展清单

• 基础扩展：swoole (版本 4.0.10+，推荐 4.8.x), redis, fileinfo, pdo_mysql, openssl, bcmath, curl, mbstring, gd
• 专属核心加载扩展：ebaozu_loader.so（商业版核心驱动扩展，随发布包 loader/ 目录提供，在 php.ini 中通过 extension=ebaozu_loader.so 加载）

商业授权文件与安全配置

• 授权证书：商业版需在 config/ebaozu/license.key 放置专属授权文件，文件权限设置为 600，属主为 www:www。
• Web 防下载规则：Nginx 必须配置规则禁止外部直接下载 .key 授权文件与 .ebz 核心组件容器：

  location ~* \.(key|ebz)$ {
      deny all;
      return 404;
  }

PHP 解禁函数

在 PHP 配置的 disable_functions 禁用函数列表中，必须删除并解禁以下函数：

• proc_open（消息队列与 CLI 进程派发必需）
• pcntl_signal / pcntl_alarm（多进程调度与信号处理必需）

PHP 内存与 Swoole 配置

在 php.ini 中调整：

memory_limit = 512M
max_execution_time = 300
swoole.use_shortname = off

---

防火墙与端口开放

服务器安全组与本地防火墙需放行以下端口：

端口	用途	访问来源
80 / 443	HTTP / HTTPS 网站访问	0.0.0.0/0 (全网放行)
8888	宝塔 Linux 面板端口	建议仅限管理员 IP 或全网
3306	MySQL 数据库	建议仅限本机 127.0.0.1
6379	Redis 缓存服务	建议仅限本机 127.0.0.1
20698 / 20697	Swoole 内部监听端口	本机 127.0.0.1 (禁止暴露给外网)