EMSHOP 是一套专为虚拟商品交易打造的开源数字商品销售系统,支持自动发货、多规格 SKU、分站运营、支付对接、博客 SEO 与丰富扩展能力,适合搭建专业的数字商品销售平台开源系统。
这篇文章就详细的教大家使用宝塔来搭建EMSHOP发卡程序,教程十分详细且简单,也是我安装几十次以后的经验,也是我认为目前最快、最简单、最不会踩坑的方式!就算是毫无建站经验的小白,看着一篇文章也就够了!
准备工作
- 一台服务器且已安装好宝塔(请使用linux系统,极不推荐Windows系统)
- 准好了域名,并做好了域名解析
- 下载好EMSHOP发卡程序的.zip压缩文件【点击下载】
流程概要
- 宝塔安装(含 Nginx、PHP 7.4+、MySQL 5.7+ 与 PHP 安装 Swoole4)安装进程守护(Supervisor)等基础运行环境
- 创建网站及数据库并做网站配置
- 配置伪静态(Nginx)
- 上传EMSHOP发卡程序
- 完成网站的基本配置
安装基础运行环境
登录到宝塔后台,进入软件商店,搜索并安装以下程序(备注:已经安装了这些的可跳过)
创建站点
在宝塔左侧进入 「网站」,点击 「添加站点」,按下图完成:
- 域名:填写你的域名(无域名可填服务器 IP)。
- 数据库:选择 MySQL,字符集选 utf8mb4,并记下自动生成的数据库名与密码。
- PHP 版本:选择与已安装 Swoole 4 扩展对应的 PHP 版本。
- 点击 「确定」 创建站点。

配置伪静态(Nginx)
- 在网站列表中,找到你的站点,点击 「设置」。
- 左侧选择 「伪静态」。
- 规则框中填入以下内容(新版推荐规则):
- 点击 「保存」。
location / {
try_files $uri $uri/ /index.php$is_args$args;
}

进入网站根目录
在 「网站」 列表中,点击该站点 根目录 一列的路径链接,即可进入该站点的文件管理根目录。
上传并解压程序包
- 根目录里宝塔自带的
404.html、index.html、.user.ini等可暂时不用删除,不影响后续安装。 - 将 EMSHOP 安装包(
.zip)上传到当前网站根目录。 - 在压缩包上 右键 → 选择 「解压」。
在解压窗口中,解压目标一般为当前站点根目录,解压密码留空即可,然后点击 「解压」。
解压完成后,可在文件列表中确认已出现程序目录与文件。
打开网页安装向导
在浏览器访问你的 域名(如 https://你的域名/),系统会自动进入安装页,地址通常为 **/install/**。
左侧会进行 环境检查(PHP 版本、mysqli、pdo_mysql、目录与 config.php 可写等),全部为通过状态后再继续。
- 配置数据库:主机一般为
127.0.0.1,端口3306,数据库名、用户名、密码填写 创建站点时 宝塔给出的信息(或你自建的数据库账号)。表前缀默认em_一般无需修改。 - 创建管理员:设置后台登录账号、邮箱与密码。
- 可先点击 「测试数据库连接」 确认无误,再点击 「执行安装」。

安装成功后按页面提示进入后台;若提示删除 install 目录等安全操作,请按说明处理。
安装进程守护(Supervisor)
EMSHOP通过 Swoole 运行发货等服务,需在宝塔中安装 进程守护管理器(基于 Supervisor):
- 左侧菜单打开 「软件商店」。
- 在搜索框输入 Supervisor 或 进程守护。
- 找到 「进程守护管理器」,点击 「安装」 → 「立即安装」。

安装完成后,在已安装软件中找到该插件,点击 「设置」 进入管理界面。
添加 EMSHOP 守护进程
在进程守护管理器中:
- 点击 「添加守护进程」。
- 名称:任意英文标识即可,例如
EMSHOP-001(名称不支持中文)。 - 运行目录:选择你的网站根目录(与程序解压位置一致,例如
/www/wwwroot/网站目录/)。 - 启动命令
php server
(⚠ 命令后面不要加 -d**;上一步 **运行目录 已选网站根目录时,无需再写完整路径。)
注意:运行该命令使用的是 PHP CLI(命令行)版本,不一定等于网站当前绑定的 PHP 版本。宝塔用户可在网站菜单中点击 「高级设置」 查看 PHP 命令行版本,也可以在服务器终端执行 php -v 查看。运行 Swoole 命令时,必须使用 PHP 8.0 及以上,且 Swoole 必须安装 4.x 版本。 如果不想更改系统默认的 PHP 命令行版本,也可以在启动命令中直接指定版本,例如:php82 server(**⚠ 命令后面不要加 -d**)
- 启动用户 一般为
root,进程数量 默认1即可。 - 点击 「确定」 保存。
保存后确认该进程状态为运行中;若启动失败,可到该守护进程的 日志 中查看报错(常见为 PHP 路径不对、未装 Swoole、运行目录错误等)。如果仍无法启动,建议把守护进程日志信息复制出来,发给豆包协助排查。
安装完成自检
使用安装时设置的管理员账号登录后台(一般为 你的域名/admin)。
在控制台中找到 「Swoole 监控」 卡片:状态为 「启动中」(或运行正常)即表示 Swoole 进程已就绪,可以开始正常使用店铺功能。


