在宝塔面板安装玄灵云商城教程-玄灵社区

玄灵云商城是一款现代化PHP网站商城系统，具有性能优秀，外观现代，扩展广泛等特点，下面以图文的方式记录一下安装流程，方便站长们自助建站

安装前准备

您在安装玄灵云商城之前，应做好以下几点准备

云服务器租用

官方玄灵云：https://cloud.xuanling.cn/

系统环境推荐

推荐配置

Linux系统
Nginx1.19+
PHP7.4
MySQL5.7

宝塔Linux面板安装教程：https://wxsnote.cn/360.html

网站安装包部署

我们推荐您使用宝塔Linux面板，接下来，我们会使用宝塔面板为您展示如何安装玄灵云商城系统，请进入宝塔管理面板，继续观看我们的教程

在网站，点击添加站点，填写您的域名(需解析至服务器公网IP)，开启数据库，选择PHP7.4

创建好以后，点击网站的根目录

全选，删除多余的文件

上传玄灵云商城的安装包

安装包下载地址：https://bbs.xuanling.cn/xlmall-download

点击压缩包的更多，解压该压缩包(若有密码，必须填写密码，否则解压缺失内容)

解压后，回到网站，进入该网站的设置，弹窗中点击网站目录，运行目录选择/public，点击保存

有的宝塔面板存在bug，导致运行这里缺少信息，访问网站403时，请删除网站，修复或更新面板修复错误，再重新部署

弹窗中选择伪静态，填入以下配置，点击保存

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

网站安装与激活

浏览器打开您设置的网址，进入该页面，填写在玄灵软件注册的账号密码，用于验证

玄灵云商城官网：https://mall.xuanling.cn/

点击激活产品

填写激活码，激活此站点的授权

激活码获取请前往：https://bbs.xuanling.cn/about-us

此时，就可以继续安装程序了

检测环境通过

在宝塔面板的数据库页面，复制之前创建的网站数据库信息

点击数据库的设置

填写数据库名称，数据库账号，数据库密码

CDN设置(点我查看)

如果你使用了CDN，在安装时应选择CDN

若后续要开启或关闭，在/config/basics.php编辑cdn_switch即可

return [
'cdn_switch' => true, //true为开启，false为关闭
]

1.HTTP头部缓存关闭

2.节点缓存过期规则如下

全部文件全部静态文件遵循源站不忽略参数
文件后缀 php html 不缓存
目录规则 /admin /api 不缓存

3.关于SSL证书

CDN设置为跟随源站，源站服务器设置强制301到https，请务必注意，必须源站和CDN都部署SSL证书。

以下为自动SSL证书的项目，实现自动申请免费证书，自动部署SSL证书到各种面板和CDN平台。

宝塔All in SSL：https://allinssl.com/

彩虹聚合DNS管理系统：https://github.com/netcccyun/dnsmgr

redis配置(点我查看)

软件商店运行环境中找到redis软件并安装，任意5+版本

在PHP中找到redis扩展并安装

如果你需要使用redis为网站提速，在安装时应选择redis进行配置，一般默认即可

若后续要开启或关闭，在/config/redis.php编辑

return [
  'switch' => false, //true为开启，false为关闭
  'host' => '127.0.0.1', //redis服务地址
  'password' => '', //redis服务密码，若未设置可空
  'database' => 0, //不懂则默认，数据库编号范围为0到15
  'port' => 6379, //redis服务端口
  'timeout' => 60, //超时时间
  'prefix' => 'xmall:', //缓存键名，不要和其它网站的一致，后面要跟英文冒号
];

redis数据库编号范围为0到15，一共16个，可以选择一个未使用的，假如你建了多个同款商城，应选择未使用的库，以免窜站，你可以在宝塔面板中选择数据库→redis→选择redis库

DB 库编号【存储数量】

填写程序配置完成后，点击保存，进入填写后台信息页面，填写后台管理信息

安装成功，此时，你可以进入后进行管理了

恭喜您获得新成就’一个网站后台‘

网站初次运行必须设置

进程守护

前往系统运维→任务监控→获取地址，复制监控地址

添加计划任务，如图所示

如果是使用的是推荐环境搭建，你可以设置任意频率，甚至24小时一次，它的存在不是监控，只是守护监控进程是否在运行中。举个例子，就是怕它打瞌睡，过一段时间看看它是否睡着了，睡着就叫醒它。
甚至可以不添加守护任务到宝塔计划任务中，只需在系统运维开启即可
有一个例外：康乐面板环境你需要设置为1分钟一次

启动计划任务

微信客户端访问权限

设置微信内是否可访问，依据您的需求设置是否需要打开

在微信APP中查看首页是否可以访问

安装插件

安装插件通用教程：

玄灵云商城的无限可能从插件安装开始

3个月前

09269

手动下载支付插件：

免费玄灵云商城：易支付插件

8天前

063415

最后，感谢您选择玄灵云商城，我们定不负众望，无限进步！

常见问题

问：支付后，前台后台订单空白

答：一般是新站会遇到该问题，请确保您的站点是新搭建的，您没有按当前版本要求的环境使用MySQL5.7，最简单的方法就是删除站点，清空数据库，然后将安装包解压，进入网站根目录/data/install目录下，上传以下压缩包并解压，进行修复sql表，此操作将替换install.sql文件，替换后再次进入安装页面继续操作即可。

此处内容已隐藏，请评论后刷新页面查看.

由于MySQL5.6的限制，此操作后，允许你填写内容的输入框，请勿再包含任何emoji表情，例如“😆”，所有emoji不再允许被添加，如果无视本条提示，若您的行为导致损坏数据库，程序无法继续使用时，我们不承担任何责任，这是您的选择。所以建议您安装MySQL5.7使用本程序？

问：如何更换授权域名

答：登录授权管理平台，修改域名即可

管理地址：https://mall.xuanling.cn/user/site/list

点击您的授权，进行管理

编辑站点，设置新的信息

问：无法拉起支付

答：钱包支付错误请检查数据库以及Redis的连接是否正确，如果是易支付请检查支付平台配置是否正确

例如易支付插件，只是获取支付平台返回的跳转链接，若因为网络问题，或配置错误则会导致无法回调支付链接及回调支付结果。

插件为安全考虑，所以当前只支持接口支付
1.接口支付：是由插件请求支付平台获取到官方支付链接(非支付平台链接)，因为无法判断UA，这会导致在浏览器可能会创建出JSAPI链接，这会导致在非微信浏览器无法支付，配置支付通道的密钥时请使用H5或Native而不是JSAPI。
2.落地页支付(未来会增加，但不建议您使用)：就是由支付平台创建一个页面，插件会获取到支付平台的页面并跳转，在页面中可以唤起官方支付链接。但请注意，支付平台落地页会导致参数暴露，之前您可能听说过支付被撸，就是因为这个，并不安全。

问：计划任务或守护开关提示任务启动失败

{"code":-1,"msg":"任务启动失败"}----------------------------------------------------------------------------
★[2025-12-08 17:26:32] Successful

答：你可能只在CDN设置了SSL证书，源站并未配置，路由协议错误原因

方案1：为源站补充ssl证书

方案2：源站服务器设置hosts，域名指向127.0.0.1，随后计划任务中的请求url将协议https改为http

文章版权归作者所有，未经允许请勿转载。

THE END

使用手册玄灵云商城手册

在宝塔面板安装玄灵云商城教程