以下是基于你提供的两个官方文档链接（看云文档 和 ShopXO官方教程），结合宝塔面板（BT Panel）环境，整理出的 ShopXO 商城系统在宝塔面板下的详细部署与配置教程。

📌 ShopXO 在宝塔面板中的详细部署教程（2025版）
适用对象：有一定服务器基础的站长、开发者
系统版本：ShopXO v6.6.0（当前最新稳定版）
环境要求：Linux（推荐 CentOS 7+/Ubuntu 20.04+）、宝塔面板 7.9+、PHP 7.4/8.0、MySQL 5.7+、Nginx/Apache

一、准备工作

1. 获取 ShopXO 源码
   官网下载地址（需授权）：https://store.shopxo.net/
   或从已购买的渠道获取 shopxo.zip 压缩包
2. 准备服务器环境
   安装 宝塔面板（官网：https://www.bt.cn/）
   在宝塔面板中安装以下环境：
   Web 服务器：Nginx 1.20+（推荐）或 Apache
   PHP：7.4 或 8.0（ShopXO v6.6.0 兼容 PHP 8.1，但建议 8.0）
   MySQL：5.7 或 8.0
   phpMyAdmin（可选，用于数据库管理）
   安装 PHP 扩展：
   fileinfo
   gd
   curl
   openssl
   mbstring
   zip
   pdo_mysql
   💡 提示：在宝塔「软件商店」中点击 PHP 版本 →「设置」→「安装扩展」

二、上传并解压 ShopXO 源码

1. 创建网站
   在宝塔面板 →「网站」→「添加站点」
   域名：如 shop.example.com
   根目录：如 /www/wwwroot/shop.example.com
   PHP 版本：选择已安装的 7.4 或 8.0
   数据库：先不创建（安装时自动建）
2. 上传源码
   将 shopxo.zip 上传到网站根目录（如 /www/wwwroot/shop.example.com）
   在宝塔文件管理器中解压：
   bash
   unzip shopxo.zip
   将 shopxo 文件夹内 所有内容 移动到网站根目录（覆盖）
   ✅ 正确结构应为：

/www/wwwroot/shop.example.com/
├── public/
├── app/
├── config/
├── runtime/ ← 需要写权限
└── admin.php

三、设置运行目录（关键步骤！）
方法一：推荐（更安全）
在宝塔「网站」→ 点击站点「设置」→「网站目录」
将 运行目录 改为：/public
保存
这样访问 https://shop.example.com 实际指向的是 public/index.php，隐藏了核心代码。
方法二：兼容虚拟主机（不推荐）
若无法设置运行目录（如某些虚拟主机），则保持根目录为运行目录
但需确保 .htaccess（Apache）或 Nginx 伪静态规则正确
Nginx 伪静态规则（宝塔中添加）：
nginx
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last; break;
}
}

四、设置目录权限

在宝塔「文件」中，对以下目录设置权限：

目录 权限 所有者

runtime/ 755 或 777 www
public/static/upload/ 755 www
config/ 755（安装后建议改为 644） www
⚠️ 注意：
所有文件建议所有者为 www（宝塔默认 PHP 运行用户）
若安装时报错“权限不足”，请全选文件 → 右键 →「权限」→ 所有者改为 www，权限 755

五、开始安装 ShopXO

1. 访问安装页面
   浏览器打开：https://你的域名/install.php
   若提示 404，请检查：
   是否设置了运行目录为 /public
   Nginx/Apache 是否重启
   是否有 .htaccess 或伪静态问题
2. 安装流程
3. 协议同意 → 点击“同意”
4. 环境检测 → 确保全部绿色（若 fileinfo 红色，请回宝塔安装）
5. 数据库配置：
   数据库地址：127.0.0.1 或 localhost
   数据库端口：3306
   数据库名：新建一个（如 shopxodb）
   用户名/密码：MySQL 的 root 或新建用户
   数据表前缀：可默认 shopxo 或自定义
   数据库编码：utf8mb4
6. 管理员账号：
   用户名：admin（可改）
   密码：务必修改！默认是 shopxo，极不安全
   邮箱：填写有效邮箱
7. 点击“安装”，等待完成

六、安装后安全设置

1. 删除安装文件
   删除网站根目录下的 install.php
   删除 install/ 文件夹（如有）
2. 修改后台入口（可选但推荐）
   默认后台地址：https://你的域名/admin.php
   可重命名为 myadmin.php 等，提高安全性：
   bash
   mv admin.php myadmin.php
   后续通过 https://你的域名/myadmin.php 登录
3. 配置 HTTPS（推荐）
   在宝塔「网站」→「SSL」→ 申请 Let's Encrypt 免费证书
   开启强制 HTTPS

七、多商户功能启用（根据官方教程）

若需开启 多商户（多店铺） 功能：

1. 后台开启
   登录后台 →「系统设置」→「基础配置」
   找到「多商户配置」或「店铺相关」
   启用：
   ✅ 申请店铺开启
   ✅ 开启经营类目资质
   ✅ 启用店铺保证金
   ✅ 启用店铺等级
2. 配置店铺页面展示
   「店铺基础配置」中开启：
   商城首页展示店铺
   商品详情页展示店铺信息
   开启卖家中心入口
3. 商家入驻流程
   前台用户可点击「卖家中心」→「申请开店」
   填写店铺信息、上传营业执照、缴纳保证金（如启用）
   详细操作参考：https://store.shopxo.net/doc-index-detail-20.html

八、常见问题排查

问题 解决方案

安装页打不开 / 404 检查运行目录是否为 /public，检查伪静态
权限错误（runtime 无法写入） 设置 runtime/ 权限为 755，所有者为 www
图片无法上传 检查 public/static/upload/ 权限
后台登录白屏 检查 PHP 是否开启 fileinfo、gd 扩展
数据库连接失败 检查 MySQL 是否运行，账号密码是否正确，是否允许本地连接

九、后续维护建议
定期备份：数据库 + 网站文件
更新 ShopXO：通过官方渠道获取新版，不要直接覆盖，注意数据迁移
安全加固：关闭调试模式（config/app.php 中 app_debug = false）
使用 CDN 加速静态资源

✅ 至此，ShopXO 已成功部署在宝塔面板，并支持多商户功能！

如需进一步开发（插件、API、小程序对接），可参考看云文档中的「二开」章节。

📚 参考资料：
ShopXO 安装文档：https://www.kancloud.cn/yx2004000/shopxo_dev_yx/1279376
多商户教程：https://store.shopxo.net/doc-index-detail-20.html
宝塔面板官方：https://www.bt.cn/

如需我帮你生成 一键部署脚本 或 Nginx 配置模板，也可以告诉我！