系统安装指南（宝塔版）

## 一、前言
本文档记录了独立版系统在宝塔环境下的的详细安装步骤，仅适用于搭建有宝塔环境的服务器。
重要：教程中如果出现截图和文本不一致的，皆以文本说明为准，截图仅为示例

安装所需文件获取地址：https://drive.weixin.qq.com/s?k=AIAAMAdTAA8fTzJ2D5
## 二、准备工作
准备好以下资源：
● 4核CPU + 8G内存 + 5M带宽 或更高配置的服务器
● 服务器的操作系统为 CentOS 7.6及以上（不要选择 CentOS 8+ 系统）
● 服务器上已安装宝塔环境
● 两个已备案域名并解析到服务器，一个用于后端接口，一个用于后台管理。
## 三、运行环境
### （一）基础环境
对于已经存在的环境，主要检查 PHP 和 MySQL 版本，PHP 要求 7.4，MySQL 要求 5.5 或以上版本（MariaDB 要求 10.0 或以上版本）。若版本符合，可直接跳到第（二）步环境配置。

对于没有安装 Web 环境的，请先安装 Web 环境，具体的版本要求如下（1.x 的 x 表示任意数字）：
● Nginx 1.16 或更高版本，推荐 1.24
● PHP 7.4.x
● MySQL 5.7~8.0，推荐 5.7
● Redis 7.x/6.x/5.x，推荐 7.x
● Node.js 版本管理器
● Supervisor 管理器（进程管理器）
● 
![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110055_2046450.7095631668467918.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110104_0655500.9976366840305363.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110109_4535980.9725834186730445.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110125_0952220.9843121755491038.png)

## （二）环境配置
### 1. PHP配置
进入PHP设置

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110211_6990470.6785469917891719.png)

安装以下扩展：
● fileinfo
● redis
● swoole4
● imagemagick
● opcache

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110228_0902730.691817569005514.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110233_0268710.8858980316132596.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110240_2840690.8048121553262285.png)

接下来上传 Swoole Loader 扩展文件。

点击下载 swoole_loader

打开文件管理，来到 /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902 目录，
并将下载好的文件上传到此文件夹下。

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110318_0257020.13932408474787183.png)

来到软件管理->PHP-7.4管理，在配置文件的最后，添加以下内容并保存：

[swoole]
extension = swoole.so
extension = swoole_loader74_308.so

注：可能已经存在了一部分配置内容，只需补全即可。

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110400_1273380.8729882320037828.png)

如果此路径/www/server/php/74/etc下有php-cli.ini文件，则需要在此文件里也添加swoole的配置

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110411_9336010.540135638375304.png)

来到软件管理->PHP-7.4管理->禁用函数，查找并把以下函数删除：
● proc_open

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110423_8207090.28505749962331717.png)

最后重启PHP：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_110434_5596060.5632266385089861.png)

### 2. Node.js版本管理器配置
来到软件管理->Node.js版本管理器：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111550_8941630.6893313742269563.png)

找到 v16.19.1，点击安装（如果已经安装请忽略）：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111603_0989230.3144585797644913.png)

安装成功后会在列表顶部显示：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111614_3795570.4016908615449668.png)

### 3. 进程守护管理器配置
3-1 命令行工具
打开终端，执行以下命令：

yum install supervisor -y

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111641_6830540.6142663145399246.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111647_3875360.5518385881126152.png)

3-2 安装进程守护管理器
请安装 3.0.1 或者 3.0.0版本，不要使用 3.0.2 版本！3.0.2 版本存在未修复的 bug。

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111716_8181190.2653632217150017.png)

3-3 配置进程守护管理器
打开进程守护管理器设置；
打开主配置文件，复制以下配置，修改替换文本框中的所有配置：

[unix_http_server]
file=/var/run/supervisor.sock

[inet_http_server]
port=127.0.0.1:9001

[supervisord]
logfile=/var/log/supervisord.log
pidfile=/var/run/supervisord.pid

[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]
serverurl=unix:///var/run/supervisor.sock
serverurl=http://127.0.0.1:9001

[include]
files = /www/server/panel/plugin/supervisor/profile/*.ini

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111739_8916070.9823639649883004.png)

如果替换新配置文件后点击保存提示无法保存的，按照如下修改配置文件即可保存

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111753_8442580.8322788821179943.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111758_8329200.32543249982421174.png)

打开终端，粘贴输入并执行以下命令：

pkill -9 supervisord

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111814_7621840.29458775046933483.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111820_3304210.5999714861458679.png)

## 四、部署代码
### （一）后端
### 1. 创建站点
（说明：后端不要使用CDN，CDN 本质就是缓存，适用于博客、门户网站等有大量静态固定内容的站点。
我们的系统中，服务端仅提供交互接口，没有静态资源。客户端大量获取服务端的实时动态数据，会导致 CDN 频繁回源，过低的命中率使得 CDN 意义不大。对于某些不支持 WebSocket 的 CDN 会导致客户端和后台接收不到任何消息通知。因此，后端站点不要部署CDN。使用CDN会导致系统出问题）

进入网站管理页面，添加站点，填写以下内容：
● 已备案的后端域名
● 数据库选择 MySQL，编码选 utf8mb4，数据库账号与密码会自动生成，请记下这里的数据库账号和密码
● PHP 版本选 PHP-74

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111850_4243110.500249810737471.png)

### 2. 部署代码
进入刚建好的网站的根目录。

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111918_3335210.9628405871000142.png)
![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111909_4500560.373069006819604.png)

### 3. 设置站点
打开网站设置->网站目录。
关闭防跨站攻击（open_basedir）。
将运行目录设为 /public 并保存。

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111940_6712600.6724364937088764.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111947_2153960.7478590201637455.png)

打开网站设置->伪静态：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_111959_3838630.23576843039317696.png)

填写以下配置（注意，如果自定义了swoole端口，则需要将配置中的 9501 改为自定义的端口）：

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

location /make_wss {
    proxy_http_version 1.1;

proxy_set_header Upgrade websocket;
    proxy_set_header Connection "Upgrade";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $host;

proxy_read_timeout 60s;

proxy_pass http://127.0.0.1:9501;
}

location /ws {
    proxy_http_version 1.1;
    proxy_set_header Upgrade websocket;
    proxy_set_header Connection "Upgrade";

proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $host;

proxy_pass_request_headers on;

proxy_read_timeout 60s;

proxy_pass http://127.0.0.1:9501;
}
location ^~/addons/make_speed/core/public/index.php/apis {
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  proxy_pass "https://127.0.0.1:443/integration/apis/";
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

打开网站设置->SSL->宝塔SSL，为域名申请证书并部署。
部署成功后开启强制HTTPS。

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112028_0164880.7890821923940939.png)

### （二）后台
### 1. 创建站点
此处创建的是管理系统的后台页面站点。
进入网站管理页面，添加站点，填写以下内容：
● 域名填写后台域名
● 数据库不创建
● PHP版本选择纯静态

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112052_5600310.052068379742139625.png)

打开新建好的站点设置->伪静态，添加以下内容并保存：

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

打开网站设置->SSL->宝塔SSL，申请域名证书。
部署证书成功后开启强制 HTTPS。
进入独立版后台站点根目录，上传下载好的后台安装包文件：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112117_4039030.953809130704628.png)

## 五、安装系统
### （一）后端
### 5-1-1. 基本配置
访问安装地址：
https://后端域名/install
例如，假设后端域名是 api.example.com，那么安装地址就是：
https://api.example.com/install

进入安装界面后，请根据页面提示内容进行操作。

关于第三步中的路径设置：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112150_9972130.45579554377321496.png)

请填写以下内容（注意，请先设置 Node 路径，再设置 npm 路径）：
● PHP 路径填 /www/server/php/74/bin/php
● Node 路径填 /www/server/nodejs/v16.19.1/bin/node
● npm 路径填 /www/server/nodejs/v16.19.1/lib/node_modules/npm/bin/npm-cli.js

如果提示  Node 或者 npm 路径设置失败，请检查是否已经安装 Node.js v16.19.1，可以查看上文所述第三步第（二）节第2点（点击查看）。

如果报错，如下图

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112206_6482370.7167038689868093.png)

请到宝塔终端执行这条命令

chmod +x -R /www/server/nodejs

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112229_1172050.0036966720920260654.png)

### 5-1-2. 添加守护进程
打开Supervisor管理器设置；
切换到守护进程管理，点击添加守护进程：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112245_4035270.3147608190187412.png)

名称填写make-swoole；当同一台中服务器部署多套码科系统时，应配置使用不同的进程名称。
如果使用不同的进程名称，请在该系统后端根目录下的 .env 文件中配置，NAME 即为进程名，此处示例为 make-swoole-2：

[SUPERVISOR]
URL = "http://127.0.0.1:9001"
NAME = "make-swoole-2"

启动用户选择 www：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112308_9760180.6596528698227307.png)

运行目录选择后端站点根目录：
每个人的后端站点根目录都不一样，请根据自己的实际情况进行选择。

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112320_5962460.3679231550611668.png)

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112325_8364530.19099903504239713.png)

启动命令填写：

/www/server/php/74/bin/php vendor/bin/easyswoole server start -mode=produce

进程数量必须是1:

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112348_6342400.18508214100136666.png)

填写完毕后，点击确定。

如图所示，说明守护进程成功启动：

![](https://xls.samejk.cn/img/2024/02/23/2024-02-23_112400_8766110.5345378695238933.png)

如果进程列表不显示刚才添加的进程，请重启 SuperVisord 服务。
### （二）后台
访问安装地址：
https://后端域名/install/admin
例如，假设后端域名是 api.example.com，那么安装地址就是：
https://api.example.com/install/admin
环境检查通过后，按照页面的提示填写相关内容进行安装即可。