NamelessMC安装向导逐步实战：从数据库配置到管理员账户搭建全流程教程

NamelessMC安装向导逐步实战：从数据库配置到管理员账户搭建全流程教程

【免费下载链接】NamelessNamelessMC is a free, easy to use & powerful website software for your Minecraft server, which includes a large range of features.项目地址: https://gitcode.com/gh_mirrors/na/Nameless

NamelessMC 是一款免费、易用且功能强大的 Minecraft 服务器网站程序，内置论坛、自定义页面、Discord 登录、服务器状态显示等丰富功能。本教程带你逐步走完 NamelessMC 安装向导：从环境要求检测、数据库配置、数据库初始化，到站点设置、管理员账户搭建和模块选择，完成一次完整的 NamelessMC 安装实战。全程约 10 分钟，零基础也能照着做完。

一、安装前准备：检查你的服务器环境

在安装 NamelessMC 之前，请先确认服务器满足以下基础条件（安装向导第一步会自动逐项检测）：

检测逻辑位于 core/installation/steps/requirements_validation.php，任何一项不通过都会提示红色错误条，需要先修复对应环境再继续。

准备好环境后，获取 NamelessMC 代码并上传到网站根目录：

git clone https://gitcode.com/gh_mirrors/na/Nameless cd Nameless && composer install

二、启动安装向导：访问 install.php

将浏览器访问地址改为你的域名/install.php，即可进入安装向导首页。向导入口是根目录下的 install.php，主流程界面由 core/installation/installer.php 渲染，左侧会显示完整的步骤进度条：

1. 首页（欢迎）
2. 系统要求检测
3. 常规配置
4. 数据库配置
5. 站点配置
6. 管理员账户
7. 选择模块
8. 完成

阅读并同意服务条款后，点击Continue开始。

三、第1步：系统要求检测（Requirements）

向导会自动列出 PHP 版本、各项扩展和core目录可写性的检测结果，全部显示绿色对勾后，点击Proceed进入下一步。如果看到红色提示 "Requirements error"，请按上文表格排查 PHP 版本或扩展是否缺失。

四、第2步：常规配置（主机名与友好链接）

这一步对应 core/installation/steps/general_configuration.php，只需填两项：

• Host（主机名）：填你的域名，如mc.example.com。注意不要带http://或https://前缀，否则会报错。
• Friendly URLs（友好链接）：决定是否使用干净的 URL（如/forum而不是index.php?route=/forum）。Nginx/Apache 需开启 mod_rewrite 等重写支持后才能启用。

五、第3步：数据库配置（核心步骤）

数据库配置是整个 NamelessMC 安装流程中最关键的一步，表单逻辑在 core/installation/steps/database_configuration.php。需要填写：

几个实用要点：

• 向导会自动使用utf8mb4字符集与utf8mb4_unicode_ci排序规则，避免中文和表情乱码；
• 如果数据库里已存在NamelessMC 的表（检测到modules表），会拒绝继续，防止误覆盖；
• 提交成功后，连接信息会写入core/config.php，此后的站点访问都依赖这个配置文件；
• 出现 "config write failed" 错误时，检查core目录写权限。

六、第4步：数据库初始化

点击 Proceed 后，页面会显示加载动画，后台自动执行全部数据表迁移（项目使用 Phinx 管理迁移脚本，脚本位于 core/migrations/，包含用户表、论坛表、群组表等数十张表）。无需任何手动操作，等待几秒即可跳转到下一步。

七、第5步：站点配置（名称、邮箱、语言、时区）

对应 core/installation/steps/site_configuration.php，填写 5 个字段：

• Site Name：站点名称，最长 32 个字符；
• Contact Email（收信邮箱）：用户来信接收地址；
• Outgoing Email（发信邮箱）：系统通知发出地址，建议用专业邮箱；
• Language：默认语言，支持 20 多种语言（含简体中文）；
• Timezone：时区，页面会自动探测你本地时区并预选，确认无误即可。

保存后会自动执行"站点初始化"，写入默认设置并生成缓存。

八、第6步：搭建管理员账户

这是安装向导的收尾核心，逻辑在 core/installation/steps/admin_account_setup.php。账户规则请记牢：

• 用户名：3~20 个字符，同时会作为昵称；
• 邮箱：合法邮箱格式，4~64 个字符；
• 密码：6~30 个字符，需二次输入确认，系统使用 bcrypt（cost 13）加密存储。

向导会自动为你：分配管理员权限组、订阅默认消息通知；如果该用户名对应一个真实存在的 Minecraft 账号，还会自动查询并绑定游戏 UUID。完成后立即以管理员身份登录。

九、第7步：选择功能模块

对应 core/installation/steps/select_modules.php，以卡片形式展示 modules/ 目录下的全部模块：

点击卡片即可勾选/取消（卡片变灰为未选）。新手建议保持默认全选，之后可在后台随时开关。

十、第8步：完成安装并登录后台

最后的转换步骤（Conversion）用于从 Nameless v1 迁移数据，全新安装直接点击No跳过即可。

完成页会将core.installed置为true（见 core/installation/steps/finish.php），此后再次访问 install.php 会提示 "Nameless has already been installed"，并引导你进入后台。

点击Finish按钮，即可用第 6 步创建的管理员账号登录后台面板，开始配置导航、论坛版块和模板外观。

常见问题速查（FAQ）

Q1：数据库连接失败（Connection failed）？检查地址、端口、账号密码是否正确，数据库是否已创建，且该账号有建表权限；远程部署时注意 MySQL 是否允许远程连接。

Q2：配置写入失败（Config write failed）？core目录不可写。给目录添加写权限后重试。

Q3：启用友好链接后出现 404？Nginx 可参考仓库中的 nginx.example，Apache 需要启用 mod_rewrite 并允许 .htaccess。

Q4：想重装怎么办？需要删除数据库中的所有 NamelessMC 数据表，并移除core/config.php配置文件，即可重新开始向导。

总结

NamelessMC 安装向导把环境检测、数据库配置、初始化、站点设置、管理员账户搭建和模块选择串成了一条清晰的流水线，只要按步骤填写，几分钟就能拥有一台功能完整的 Minecraft 服务器网站。安装完成后，建议第一时间在后台修改默认模板、配置论坛版块并开启服务器状态模块，让你的社区网站尽快上线。祝搭建顺利！🎉

【免费下载链接】NamelessNamelessMC is a free, easy to use & powerful website software for your Minecraft server, which includes a large range of features.项目地址: https://gitcode.com/gh_mirrors/na/Nameless