宝塔面板部署

本文档介绍如何在宝塔面板环境下完成凌悦易游系统的完整部署。

一、安装宝塔面板

# CentOS
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh ed8484bec

# Ubuntu / Debian
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh ed8484bec

安装完成后，访问面板地址登录。

二、安装环境软件

在宝塔面板 软件商店 中安装：

软件	版本	说明
Nginx	1.22+	Web 服务器
PHP	8.0 / 8.1	服务端运行环境
MySQL	5.7 / 8.0	数据库
Redis	6.0+	缓存（可选）

安装 PHP 扩展

进入 软件商店 → PHP-8.0 → 安装扩展，确保以下扩展已安装：

• fileinfo ✅ （必须，否则上传报错）
• redis ✅
• curl ✅
• openssl ✅
• mbstring ✅

解除 PHP 函数禁用

进入 PHP-8.0 → 禁用函数，移除以下函数的禁用：

• putenv
• proc_open
• symlink
• exec（Composer 需要）

三、上传程序文件

系统提供的管理后台和 H5 前端均为已构建好的文件，无需自行打包，直接上传部署即可。

1. 将 server 目录上传至服务器，例如 /www/wwwroot/lyyyserver
2. 将 admin 目录上传至服务器，例如 /www/wwwroot/lyyypadmin（已构建，直接使用）
3. 将 h5 目录上传至服务器（如部署 H5），例如 /www/wwwroot/lyyh5（已构建，直接使用）

四、创建数据库

在宝塔面板 数据库 中：

1. 点击 添加数据库
2. 数据库名：lingyue（自定义）
3. 用户名 / 密码：自行设置
4. 编码：utf8mb4
5. 创建完成后，导入 server/sql 目录下的 SQL 文件

五、配置服务端

5.1 安装 Composer 依赖

cd /www/wwwroot/lyyyserver
composer install --no-dev

TIP

如果服务器没有 Composer，可在宝塔 软件商店 搜索安装，或手动安装：

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

5.2 配置 .env 文件

复制环境配置文件：

cp .env.example .env

编辑 .env，修改数据库连接信息：

[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1
DATABASE = lingyue
USERNAME = lingyue
PASSWORD = 你的数据库密码
HOSTPORT = 3306
CHARSET = utf8mb4
PREFIX = la_

[REDIS]
REDIS_HOST = 127.0.0.1
REDIS_PORT = 6379
REDIS_PASSWORD =

5.3 设置目录权限

chmod -R 755 /www/wwwroot/lyyyserver
chown -R www:www /www/wwwroot/lyyyserver
chmod -R 777 /www/wwwroot/lyyyserver/runtime
chmod -R 777 /www/wwwroot/lyyyserver/public/uploads

六、创建网站

6.1 API 站点

在宝塔面板 网站 → 添加站点：

• 域名：api.example.com
• 根目录：/www/wwwroot/lyyyserver/public
• PHP 版本：PHP-8.0

Nginx 伪静态配置（网站设置 → 伪静态）：

location / {
    if (!-e $request_filename){
        rewrite ^(.*)$ /index.php?s=$1 last;
        break;
    }
}

设置跨域（网站设置 → 配置文件），在 server 块内添加：

add_header Access-Control-Allow-Origin *;
add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS, PUT, DELETE';
add_header Access-Control-Allow-Headers 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization,token,version';
if ($request_method = 'OPTIONS') {
    return 204;
}

6.2 管理后台站点

• 域名：admin.example.com
• 根目录：/www/wwwroot/lyyypadmin
• 纯静态，PHP 版本选「纯静态」

Nginx 伪静态：

location / {
    try_files $uri $uri/ /index.html;
}

6.3 H5 前端站点（可选）

• 域名：h5.example.com
• 根目录：/www/wwwroot/lyyh5
• 纯静态

Nginx 伪静态：

location / {
    try_files $uri $uri/ /index.html;
}

七、SSL 证书

强烈建议为所有站点开启 HTTPS：

1. 网站设置 → SSL
2. 选择 Let's Encrypt 免费证书
3. 勾选域名 → 申请
4. 开启 强制 HTTPS

八、验证部署

1. 访问 https://api.example.com — 应返回 JSON 欢迎信息
2. 访问 https://admin.example.com — 应显示管理后台登录页
3. 默认管理员：admin / 123456（部署后请立即修改密码）

安全提醒

• 部署完成后务必修改默认管理员密码
• MySQL 和 Redis 端口不要对外开放
• 生产环境务必关闭 PHP 的 display_errors
• 定期备份数据库