开始安装前，请先确认下面这些条件都已满足

• Linux 服务器推荐系统版本：Debian 12
• 域名已解析到你的服务器 IP（买域名、怎么解析本篇不写，在你们注册商那边自己弄好就行）
• 宝塔面板如果你习惯用其他的面板，也行。看个人喜好，没有硬性要求
• 服务器环境NginxPHP 7.4+MySQL 5.6+PHP 扩展Swoole 4 必装

1. 创建站点

在宝塔左侧进入 「网站」，点击 「添加站点」，按下图完成：

1. 域名：填写你的域名（无域名可填服务器 IP）。
2. 数据库：选择 MySQL，字符集选 utf8mb4，并记下自动生成的数据库名与密码。
3. PHP 版本：选择与已安装 Swoole 4 扩展对应的 PHP 版本。
4. 点击 「确定」 创建站点。

2. 配置伪静态（Nginx）

1. 在网站列表中，找到你的站点，点击 「设置」。
2. 左侧选择 「伪静态」。
3. 规则框中填入以下内容（新版推荐规则）：
4. 点击 「保存」。

location / {
    try_files $uri $uri/ /index.php$is_args$args;
}

3. 进入网站根目录

在 「网站」 列表中，点击该站点 根目录 一列的路径链接，即可进入该站点的文件管理根目录。

4. 上传并解压程序包

1. 根目录里宝塔自带的 404.html、index.html、.user.ini 等可暂时不用删除，不影响后续安装。
2. 将 EMSHOP 安装包（.zip）上传到当前网站根目录。
3. 在压缩包上 右键 → 选择 「解压」。

在解压窗口中，解压目标一般为当前站点根目录，解压密码留空即可，然后点击 「解压」。

解压完成后，可在文件列表中确认已出现程序目录与文件。

5. 打开网页安装向导

在浏览器访问你的 域名（如 https://你的域名/），系统会自动进入安装页，地址通常为 **/install/**。

左侧会进行 环境检查（PHP 版本、mysqli、pdo_mysql、目录与 config.php 可写等），全部为通过状态后再继续。

1. 配置数据库：主机一般为 127.0.0.1，端口 3306，数据库名、用户名、密码填写 创建站点时 宝塔给出的信息（或你自建的数据库账号）。表前缀默认 em_ 一般无需修改。
2. 创建管理员：设置后台登录账号、邮箱与密码。
3. 可先点击 「测试数据库连接」 确认无误，再点击 「执行安装」。

安装成功后按页面提示进入后台；若提示删除 install 目录等安全操作，请按说明处理。

6. 安装进程守护（Supervisor）

EMSHOP通过 Swoole 运行发货等服务，需在宝塔中安装 进程守护管理器（基于 Supervisor）：

1. 左侧菜单打开 「软件商店」。
2. 在搜索框输入 Supervisor 或 进程守护。
3. 找到 「进程守护管理器」，点击 「安装」 → 「立即安装」。

安装完成后，在已安装软件中找到该插件，点击 「设置」 进入管理界面。

7. 添加 EMSHOP 守护进程

在进程守护管理器中：

1. 点击 「添加守护进程」。
2. 名称：任意英文标识即可，例如 EMSHOP-001（名称不支持中文）。
3. 运行目录：选择你的网站根目录（与程序解压位置一致，例如 /www/wwwroot/网站目录/）。
4. 启动命令

php server

（⚠ 命令后面不要加 -d**；上一步 **运行目录 已选网站根目录时，无需再写完整路径。）

注意：运行该命令使用的是 PHP CLI（命令行）版本，不一定等于网站当前绑定的 PHP 版本。宝塔用户可在网站菜单中点击 「高级设置」 查看 PHP 命令行版本，也可以在服务器终端执行 php -v 查看。运行 Swoole 命令时，必须使用 PHP 8.0 及以上，且 Swoole 必须安装 4.x 版本。 如果不想更改系统默认的 PHP 命令行版本，也可以在启动命令中直接指定版本，例如：php82 server（**⚠ 命令后面不要加 -d**）

1. 启动用户 一般为 root，进程数量 默认 1 即可。
2. 点击 「确定」 保存。

保存后确认该进程状态为运行中；若启动失败，可到该守护进程的 日志 中查看报错（常见为 PHP 路径不对、未装 Swoole、运行目录错误等）。如果仍无法启动，建议把守护进程日志信息复制出来，发给豆包协助排查。

8. 安装完成自检

使用安装时设置的管理员账号登录后台（一般为 你的域名/admin）。

在控制台中找到 「Swoole 监控」 卡片：状态为 「启动中」（或运行正常）即表示 Swoole 进程已就绪，可以开始正常使用店铺功能。