玄灵云商城系统安装教程

官网：https://mall.xuanling.cn/

{
  "mcpServers": {
    "玄灵云商城 API - API 文档": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "apifox-mcp-server@latest",
        "--site-id=5461260"
      ]
    }
  }
}

选择云服务器

推荐Linux系统云服务器，各大平台有售，要求至少2核2G。

本司云服务器选购：https://cloud.xuanling.cn/cart

环境准备

在部署商城系统之前，需要确保服务器上已经安装了必要的环境和工具。以下是该商城基本的环境要求：

1. 操作系统：推荐使用Debian 12，Ubuntu 22，Centos 9及以上版本。
2. Web服务器：安装Nginx或Apache等支持伪静态的平台。
3. PHP：安装PHP 7.4(推荐)及以上版本。
4. 数据库：安装MySQL 5.6及以上版本(推荐5.7)。
5. 缓存：安装Redis以提高系统性能(可选)。

PHP基本扩展：

Core PDO pdo_mysql pdo_sqlite curl openssl json mbstring session zip filter hash pcre SPL standard ctype dom xml libxml simplexml fileinfo bcmath gd

可选PHP扩展(这些扩展可优化体验)：

redis imagick exif zlib zstd igbinary opcache Zend

未来插件可能用到的PHP扩展(非必须)：

当然以上必须安装的PHP扩展在一些面板安装时，会默认自自带，仅可选部分需要自行安装。

宝塔

1Panel

推荐使用宝塔作为运维面板，安装教程：https://wxsnote.cn/360.html

宝塔面板安装登录后，会推荐选择安装基本项，按需求选择后，会安装如图以下：

在宝塔仅需安装可选扩展，例如Redis及PHPRedis扩展，注意，这非必须。

redis imagick exif zlib zstd igbinary mbstring opcache Zend

1Panel不适合搭建PHP站点，若有需要，请按下方操作

为什么不推荐，因为1Panel主要为容器服务，你创建的PHP网站运行环境，其本质还是容器，会不可避免的遇到各种问题，1Panel需要安装以下容器镜像：OpenResty，MySQL，Redis，PHP运行环境

添加扩展模板，填入以下必装扩展

core,pdo_mysql,pdo_sqlite,curl,openssl,json,mbstring,session,zip,filter,hash,pcre,spl,standard,ctype,dom,xml,libxml,simplexml,fileinfo,bcmath,gd

可选以下这些提高体验，非必选项目，注意：若要使用Redis扩展，要先安装Redis容器，否则PHPRedis扩展无法使用！若添加在必选扩展中，请注意英文逗号分割

redis,imagick,exif,zlib,zstd,igbinary,opcache,zend

在创建环境时，选择你创建的扩展模板

安装商城系统

解析域名

将域名解析到服务器IP：https://wxsnote.cn/4551.html

创建网站

在基本环境准备好后，开始创建网站，一般只需要在添加站点中填写域名，开启数据库即可，如图顺序操作。

进入网站根目录。

全选删除文件，删除后仅会保留.user.ini。

部署程序压缩包

激活码获取：https://mall.xuanling.cn/goods/goodsList

凭获取的产品激活密钥下载程序压缩包，前两种是新用户，最后一种是已授权老用户

官网下载

本站下载

已获取授权

前往官网下载：https://mall.xuanling.vip/download

前往玄灵云商城下载页下载

已经授权的用户，由于产品激活码已经使用，失效的缘故，可在我的站点，详情中下载安装包，以及管理修改域名

下载后，将程序压缩包拖入网站根目录上传，或是其它方式上传。

点击压缩包更多按钮的解压。

确保解压目录权限为755，填写解压密码，也请在解压时输入，解压后，压缩包就可以删除了。

关于文件权限

宝塔

1Pane

在解压后，再次设置一遍，部分版本的宝塔有bug，导致表层文件夹是755www权限但其中文件是root，导致后续使用有问题

权限需要是0777，root权限，否则会出现权限不足的情况

设置运行目录

设置网站PHP脚本运行目录，选择后点击保存，切记是public目录，看清楚！

设置伪静态

设置伪静态，Nginx适用于宝塔及本文，Apache也就一些虚拟主机，康乐面板在使用的Web服务器了。

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

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>
    RewriteEngine On
    # Handle Front Controller...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="FrontController" stopProcessing="true">
                    <match url="^(.*)$" ignoreCase="false" />
                    <conditions logicalGrouping="MatchAll">
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="index.php/{R:1}" appendQueryString="true" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

配置SSL证书

SSL证书，这个建议在建站初期就直接使用，不建议运营后再添加，因为涉及到协议改变。

推荐一些工具：

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

使用以上项目，支持自动免费申请并自动更新SSL证书。

配置后，你的网站在浏览器就不会提示链接不安全了，同时也保障网页内容不被篡改，要开启强制HTTPS，但请注意CDN等的协议，要选择跟随，若是两处都开启强制HTTPS会导致无限301，无法访问网站。

WAF关闭弱密码

在安装前，由于默认密码是123456，所以需要临时关闭WAF的弱密码，您在修改密码后可再次打开。

激活产品

访问网站域名，会自动跳转到激活页。

点击快捷登录，可以登录或注册，用于绑定，此平台可以方便您管理授权。

您也可先注册，再进入绑定页：https://mall.xuanling.cn

确认授权即可绑定成功。

自动回到您的网站中，此时输入您获取到的产品密钥即可激活产品，若暂未获取可在关于我们页面获取到联系方式。(若您是已经授权的域名，说明您是重新安装，会自动跳过该步骤，直接激活，如果更改域名请前往官网修改授权域名)

安装商城系统

勾选同意协议，下滑并仔细阅读本程序的全部许可协议。

第一步环境检查一般是没问题的，如有问题请联系客服反馈。

来到安装向导第二步，填写数据库及配置开关。

数据库名，数据库用户名，数据库密码，都可在宝塔面板数据库MySQL页找到。

配置Redis，此项可选，首先确保您的服务器已经安装Redis及PHPRedis扩展。在勾选后，点配置打开设置页，填写IP，端口等，一般都是默认的。若是没有改动过，直接与图中一致即可。

关于Redis数据库下标，就是Redis为了防止缓存数据窜站而设计的，你在填写时，若有多个网站使用了Redis服务器。建议选一个为空的库，如下图，共有16个库(0到15)，也就是说数据库下标可填写0到15数字。

预装应用选择，默认全部勾选的

最底部为自定义账号密码

第三步就为数据库安装好表了，记住您设置的账号密码，前往管理后台即可。

输入您自定义的密码。

必要操作

1.计划任务

前往定时任务开启任务，并点击更多，进程守护，查看监控API。

复制监控地址。

任务类型选择get，填写监控地址，设置执行周期。

如果是使用的是推荐环境搭建，你可以设置任意频率，甚至24小时一次，它的存在不是执行任务，是探针，只是守护监控进程是否在运行中。举个例子，就是怕它打瞌睡，过一段时间看看它是否睡着了，睡着就叫醒它。但一定切记，非宝塔Nginx环境必须设置1分钟一次！

说一下为什么要监控，这种设计起源可追溯至1975年，一直存留至今。在web商城系统中，首要目的就是把慢业务从用户访问流程里剥离出去，不让访客体验到卡顿、等待、超时，总结就是业务解耦+提速防抖。任何需要提升用户体验的程序都有内置，有的是隐性的，有的则是本程序中这种显性的，看不到不代表没有。例如二进制程序可能无需手动设置计划任务，因为他是常驻系统进程。但PHP脚本不同，因为他是一次性执行，结束即销毁，不是常驻任务，这可以减少内存及CPU算力的占用，这就是监控的原因。

2.插件模板应用的使用

需要在应用列表手动开启及设置所需应用，注意有多页。

其次注意后续升级插件方式，插件的更新一遍随着版本一起更新，当升级版本后，需检查此页的管理安装包，进行手动升级，内置插件请务必查看更新日志。三方插件的升级则需要点安装应用，会直接提示升级。

3.模板设置

选择各个客户端的模板样式，及各种客户端是否开启

在应用列表设置主题的各种信息

4.设置

在系统管理，通用设置中，可设置各种内容，及应用设置。

站点设置，用户设置，功能，合规信息，快捷键偏好等

后续可选配置

1.CDN设置

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

基本规则：

1. HTTP头部缓存 关闭
2. 节点缓存过期规则(全部文件 全部静态文件 遵循源站 不忽略参数)
3. 文件后缀 php html 不缓存
4. 目录规则 /admin /api 不缓存

2.自定义后台管理员路径

找到配置文件：/config/option.php，在admin配置数组中补充path，后面即可填写路径，如下图，注意18行overview_data_cache_time后要补充英文逗号，或直接粘贴以下代码。其中/ba，就会将后台路径从/admin变为/ba

,
        'path' => '/ba'

总结

通过以上步骤，你可以在云服务器上成功部署商城系统，希望本文能帮助你快速搭建一个高效、稳定的电子商务平台，为你的业务发展提供有力支持。