首页/文章列表/StoreX 安装部署教程 — 从零到上线的完整指南

StoreX 安装部署教程 — 从零到上线的完整指南

置顶 2026-07-27 16:42 21 次阅读

环境要求

  • PHP 7.3 或更高版本（兼容 7.3 – 8.3，推荐 8.0+）
  • MySQL 5.7 或更高版本（推荐 8.0）
  • Web 服务器 Apache 或 Nginx
  • PHP 扩展 — mysqli、gd、mbstring、curl、json、fileinfo

系统含域名授权与文件完整性校验：部署域名需与授权一致，且勿随意改动核心 .php 文件，否则会触发安全校验失败导致站点无法访问。

第一步：上传源码

将发行包 storex.zip 解压后，把 app-store/ 目录下的全部文件上传到服务器网站根目录（如 /www/wwwroot/your-site/）。

目录结构说明

├── admin/           # 后台管理
├── assets/          # 静态资源（CSS、JS、图片）
│   ├── css/
│   ├── js/
│   └── images/
│       └── avatar-frames/  # 头像框图片
├── mobile/          # 移动端模块
│   └── ajax/        # 移动端 API 接口
├── sql/             # 数据库初始化脚本
│   └── install.sql
├── uploads/         # 上传目录（已预建，需可写权限）
│   ├── icons/       # 应用图标
│   ├── apps/        # 应用文件
│   └── chat/        # 聊天图片
├── install.php      # 安装向导入口
├── config.php       # 数据库配置文件（安装后自动生成）
└── index.php        # 网站首页

第二步：配置 Web 服务器

StoreX 通过 router.php 统一接收请求，需配置伪静态将所有非文件请求转发至 router.php。

Apache 配置

确保已开启 mod_rewrite 模块，项目根目录自带 .htaccess 文件，无需额外配置。核心规则如下：

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ router.php [L,QSA]
</IfModule>

Nginx 配置

在站点配置文件的 server 块中添加以下伪静态规则（宝塔等面板可在「伪静态」处直接粘贴）：

if (!-e $request_filename) {
    rewrite ^(.*)$ /router.php last;
}

注意：Nginx 下不可使用 try_files ... /router.php 的简单写法替代，本站路由依赖上述 if (!-e) 转发规则才能正确解析 .html / 分类 / 详情等前端路由。

第三步：设置目录权限

发行包已预建上传目录，只需赋予写入权限：

chmod -R 755 uploads/

如果服务器环境要求 777 权限（如部分虚拟主机），可执行：

chmod -R 777 uploads/

第四步：运行安装向导

浏览器访问 http://你的域名/install.php 进入安装页面。

安装步骤

  1. 环境检测 — 系统自动检测 PHP 版本和扩展是否满足要求。如有未通过的红色项，请先修复后再继续。
  2. 数据库配置 — 填写 MySQL 连接信息：
    • 数据库主机：通常填 localhost
    • 数据库端口：默认 3306
    • 数据库名称：提前在 MySQL 中创建好（如 app_store）
    • 用户名 / 密码：MySQL 数据库账号
  3. 管理员账号 — 设置后台管理员用户名和密码（密码至少 6 位）。
  4. 点击安装 — 系统自动创建数据表、写入站点配置、生成安全校验码。

安装成功后页面会提示跳转到首页和后台。

第五步：后台初始化配置

访问 http://你的域名/admin，使用安装时设置的管理员账号登录。

必做配置清单

  1. 系统设置 — 填写站点名称、Logo、描述、关键词、ICP 备案号
  2. 系统设置 > 个人中心背景图 — 设置 VIP 和普通用户的个人主页背景
  3. 移动端设置 — 按需开启水印、音乐播放器、视频播放器、天气卡片、Epic 免费游戏等模块
  4. 头像框设置 — 在移动端设置中配置管理员和 VIP 会员的头像框图片

添加应用

  1. 进入 分类管理 — 先创建应用分类（如工具、游戏、社交等）
  2. 进入 APP 管理 — 点击"添加应用"逐个录入
  3. 或进入 应用采集 — 配置远程源自动批量采集应用
  4. 进入 幻灯片 — 添加首页轮播推荐图

第六步：发布上线

完成以上配置并添加一批应用后，即可将站点对外公开。建议发布前自查：

  • 站点名称和 Logo 是否正确
  • 首页幻灯片是否正常展示
  • 至少添加了 2-3 个分类和 10 个以上应用
  • 公告弹窗内容是否需要更新或关闭
  • 移动端各模块开关是否符合预期
  • ICP 备案号是否已填写（如已备案）

常见问题

Q: 安装时提示数据库连接失败

检查数据库主机地址、端口、用户名密码是否正确。确认 MySQL 服务已启动，且已提前创建好数据库。

Q: 访问页面出现 404

检查伪静态配置是否生效。Apache 确认 mod_rewrite 已开启；Nginx 确认 if (!-e) 转发规则已添加并重启服务。

Q: 上传图片/文件失败

检查 uploads 目录及其子目录的写入权限是否已设置，PHP upload_max_filesize 是否足够。

Q: 提示「安全验证失败 / 文件完整性校验未通过」

该错误表示核心 PHP 文件被改动或与授权哈希不一致。请用原始发行包中对应文件覆盖，或重新上传完整源码；不要通过重新运行安装向导来绕过。若你是开发者在本地改动了 .php，需重新计算并刷新授权哈希后方可运行。

Q: 移动端天气/音乐等模块不显示

进入后台 移动端设置，确认对应模块的开关已开启，接口地址正确可访问。

Q: 如何更换管理员头像框或 VIP 头像框

进入后台 移动端设置 > 头像框，填写图片 URL 或本地路径保存即可。

运维建议

  • 定期备份数据库和 uploads 目录
  • 关注 PHP 和 MySQL 安全更新并及时升级
  • 监控服务器磁盘空间，uploads 目录会随应用增多而增长
  • 建议配置 HTTPS 证书，提升安全性和用户体验

部署完成后如需授权咨询或技术支持，请联系 QQ：2260354231。

评论区 (0)

图片预览