2025萌次元(异次元4.0)发卡网搭建教程

🚀 萌次元系统安装指南

1. 下载与部署

• 获取安装包：https://wiki.mcy.im/download.php
  • 老用户提示：如果您之前使用过异次元 V3.0 版本，整体安装流程基本一致，但请务必注意伪静态规则已更新，请勿沿用旧规则。
• 上传与解压：将安装包上传至服务器指定目录并解压。
• 权限设置（关键）：
  • 必须将解压后的所有文件权限设置为 755。
  • ⚠️ 注意：若不设置此权限，系统将无法正常运行。

2. 高级权限配置（仅限 VPS/云服务器）

说明：以下步骤仅适用于拥有 Root 权限的 VPS 或云服务器用户。虚拟主机/空间用户请直接跳过此部分，不影响基础功能使用。

sudo echo "www ALL=(ALL) NOPASSWD: /usr/bin/nginx" | sudo tee -a /etc/sudoers

• 执行位置要求：必须在程序根目录下执行（即包含 bin 文件的目录，该文件无后缀名）。
• 操作命令：
  sudo echo "www ALL=(ALL) NOPASSWD: $(pwd)/bin" | sudo tee -a /etc/sudoers

• 如何确认位置：在执行命令前，请先 ls 查看当前目录，确保能看到一个名为 bin 且无后缀的文件，即代表已位于正确的程序根目录。

💡 温馨提示：
即使跳过“步骤 B”，系统仍可正常安装和运行。仅在后续启用特定插件时，若检测到缺少依赖，系统会提示您手动安装或通过其他方法补全依赖，不会导致系统崩溃。

3. 开始安装

• PHP >= 8.1, MySQL >= 5.6 环境就绪
• 文件权限已设为 755
• (VPS用户) 已正确执行 sudoers 授权命令
• 伪静态规则已应用新版配置

⚠️ 虚拟主机/空间用户请跳过此步。
本步骤旨在为极少数依赖 Composer 的插件提供自动安装环境。即使您略过此操作，也不会影响系统正常运行；若后续启用相关插件时缺失依赖，系统会自动提示手动安装方法，届时按需处理即可。

1. 创建站点
   • 通过 Nginx 创建一个新的网站站点。
   • 推荐方式：如果您使用宝塔（Baota）等可视化服务器面板，可直接使用“一键建站”功能。
   • 关键设置：务必将网站的运行目录（Root Directory）指向您刚才解压出来的程序文件夹。
2. 配置伪静态规则
   为了让系统 URL 正常访问，必须配置伪静态。请根据您的 Web 服务器类型选择对应方案：
   • 🔹 Nginx 用户
     请在站点配置中添加以下规则：

     # 禁止访问核心敏感文件
     if ( $uri ~ "^/(LICENSE|README.md|config|kernel|runtime|vendor)" ) {
         return 404;
     }
     
     # URL 重写规则
     location / {
         if (!-e $request_filename){
             rewrite  ^(.*)$  /index.php?_route=$1  last;   
             break;
         }
     }

   • 🔹 Apache 用户
     无需手动配置。系统根目录已内置 .htaccess 文件，Apache 会自动识别并应用规则（请确保已开启 mod_rewrite 模块）。

🛠️ 执行安装与初始化

1. 开始安装
   在浏览器中访问您的域名，系统将自动跳转至安装向导页面。按照提示完成数据库配置及管理员账号设置。
2. 进入后台
   安装完成后，访问 http://你的域名/admin 即可登录管理后台。
3. ⚠️ 重要提示：关于“域名未绑定”
   • 现象：刚安装完成时，若直接访问网站首页，可能会提示“域名未绑定”。
   • 说明：这代表您已经成功安装！ 此提示是系统的安全机制，并非错误。
   • 解决方法：只需登录后台（/admin），在设置中找到“域名绑定”选项，填入您的主站域名并保存。之后即可正常访问首页。

ℹ️ 补充说明（仅限 VPS/云服务器用户）

虚拟主机/空间用户请直接忽略本段内容。

• 关于 Composer 依赖授权：
  前文提到的“授权 Composer 执行权限”步骤，仅用于支持极少数需要动态安装依赖的插件。
  • 非必须性：即使您跳过此步骤，系统也能正常安装和运行。
  • 后续处理：若未来启用某个插件时提示缺少依赖，系统会明确告知您手动安装该插件依赖的方法，届时按需操作即可。

另有一种方法可供选择，其优势在于更高的稳定性，但代价是配置步骤更为复杂。

1. 上传与解压

# 进入程序目录
cd /www/wwwroot/mcy-shop

2. 设置关键权限（⚠️ 重要）

chmod 777 bin console.sh

3. 启动安装程序

./bin index.php

🚨 严重警告：
执行上述命令后，切勿关闭当前的 SSH 窗口！
该命令运行的是一个常驻进程，如果关闭 SSH 窗口，等同于强制终止安装程序，导致安装中断。请保持窗口开启直到安装完全结束。

4. 访问安装界面

• 浏览器访问：http://服务器IP:端口
• 故障排查：如果无法访问，请务必检查服务器防火墙（及安全组）是否已放行对应的端口。

5. 配置反向代理

• 根据该地址配置 Nginx 反向代理（参考下方具体配置教程）。
• 配置完成后，即可通过您的域名访问后台：http://你的域名/admin。

6. 完成初始化（域名绑定）

• 现象：刚安装完成时，直接访问首页可能会提示“域名未绑定”。
• 结论：这代表安装已成功！
• 解决：登录后台 (/admin)，在设置中绑定您的主站域名，保存后即可正常访问首页。

Nginx 反向代理配置指南（以新版宝塔面板为例）

1. 本站所有资源来源于用户上传和网络，如有侵权请联系站长！
2. 分享目的仅供大家学习和交流，您必须在下载后24小时内删除！
3. 不得使用于非法商业用途，不得违反国家法律。否则后果自负！
4. 本站提供的源码、模板、插件等等其他资源，都不包含技术服务请大家谅解！
5. 如有链接无法下载、失效或广告，请联系站长处理！
6. 本站不售卖代码，资源标价只是站长收集整理的辛苦费！如果您喜欢该程序，请支持正版软件，购买注册，得到更好的正版服务。