文档目录

- 服务器要求 01
- 数据库配置 02
- 文件夹与权限 03
- 运行安装程序 04
- 管理员登录 05
- 定时任务 06
- 常见问题排查 07
- 需要帮助 08

需要帮助？

安装过程中遇到问题请联系技术支持。

support@unlockthemes.com
unlockthemess.com@gmail.com
安装文档 · v1.0

# CryptoMinor – 专业云挖矿系统脚本

官方安装与配置指南 —— 服务器要求、环境配置、管理员账号、定时任务设置以及常见问题的快速解决方法。

第 01 节

## 服务器要求

上传程序前，请确认您的主机环境满足以下要求。

### PHP 8.0 以上

版本 8.0 或更高（可查看 composer.json）。

### Composer

用于安装 PHP 依赖包。

### MySQL / MariaDB

需运行 MySQL 5.7+ 或 MariaDB 10.3+。

### Web 服务器

Apache（需开启 mod_rewrite）或 Nginx。

### PHP 扩展

OpenSSL、PDO、Mbstring、XML、cURL、GD、BCMath。

### SSL 证书

建议在正式环境中启用。

### 内存限制

PHP memory_limit ≥ 256M。

### 最大上传大小

upload_max_filesize 与 post_max_size ≥ 20M。

### 最大执行时间

max_execution_time ≥ 120 秒。

第 02 节

## 连接数据库

无需手动修改 .env —— 网页安装程序会自动完成全部配置。

网页安装程序

    https://yourdomain.com/install/

步骤 1

在主机面板（cPanel、phpMyAdmin、Plesk）中创建一个空的 MySQL / MariaDB 数据库以及数据库用户。

步骤 2

在浏览器中打开上面的安装地址 —— 系统会自动检测服务器环境。

步骤 3

在安装表单中填写数据库名称、用户名、密码、主机和端口。

步骤 4

安装程序会自动生成 .env 文件、导入数据表并创建管理员账号。

全自动： 您完全无需手动编辑 `.env` 或手动导入任何 SQL 文件。安装程序会处理连接、数据表和初始数据 —— 只需确保数据库已创建且用户拥有全部权限。

第 03 节

## 文件夹与权限

下载包中仅包含两个文件夹 —— 文档文件夹和主程序文件夹。

documentation/

755

安装文档（即本文件）。只读，无需上传到服务器。

main-file/

755

实际程序文件：index.php、.htaccess、assets/ 以及全部核心文件 —— 请将此文件夹内的内容上传到网站根目录。

文件夹 | 权限 | 用途
--- | --- | ---
documentation/ | 755 | 安装文档（即本文件）。只读，无需上传到服务器。
main-file/ | 755 | 实际程序文件：index.php、.htaccess、assets/ 以及全部核心文件 —— 请将此文件夹内的内容上传到网站根目录。

所属用户： 在多数共享主机上，所属用户应为 Web 服务器用户（例如 `www-data` 或您的 cPanel 用户）。

第 04 节

## 运行安装程序

网页安装程序会自动完成安装 —— 无需使用命令行。

安装地址

    https://yourdomain.com/install/

步骤 1

在浏览器中打开安装地址 —— 系统会自动检测服务器环境。

步骤 2

填写数据库信息，安装程序会写入 .env 文件并导入所有数据表。

步骤 3

按提示创建管理员账号，然后完成安装向导。

步骤 4

安装完成后请删除或锁定 /install/ 目录，防止他人重复安装。

注意： 请将 `yourdomain.com` 替换为您实际上传程序的域名。

第 05 节

## 管理员登录信息

管理后台的默认登录凭据。

后台地址

https://yourdomain.com

用户名

admin

密码

admin

安全提示： 首次登录后请立即修改默认的管理员用户名和密码。

第 06 节

## 定时任务设置

每 15 分钟运行一次定时任务，以便自动处理挖矿、收益和提现。

Crontab —— 每 15 分钟一次

    */15 * * * * curl -s https://yourdomain.com/api/run-cron >/dev/null 2>&1

*/15 * * * *

全天候每 15 分钟执行一次。

curl -s

静默模式 —— 向定时任务接口发送 GET 请求。

网址

请将 yourdomain.com 替换为您的实际安装域名。

>/dev/null 2>&1

丢弃输出内容，避免定时任务发送邮件通知。

cPanel / 共享主机

1. 登录 cPanel 并打开 高级 → Cron Jobs（定时任务）.
2. 在 常用设置，选择 每 15 分钟 （或将分钟设置为 `*/15`).
3. 在命令栏中粘贴：`curl -s https://yourdomain.com/api/run-cron >/dev/null 2>&1`
4. 点击 添加新的定时任务 并将邮箱栏留空以避免收到通知邮件。

VPS / 独立服务器

1. 使用 root 或站点用户通过 SSH 登录。
2. 打开 crontab：`crontab -e`
3. 在末尾添加以下内容：`*/15 * * * * curl -s https://yourdomain.com/api/run-cron >/dev/null 2>&1`
4. 保存并退出，然后使用以下命令验证 `crontab -l`.

重要： 定时任务是必需的 —— 否则挖矿、每日收益和提现都不会被处理。您可以在浏览器中打开 `/api/run-cron` 来测试接口，正常会返回成功响应。

第 07 节

## 常见问题排查

常见问题及快速解决方法。

上传后出现 500 服务器错误

通常是 storage/ 与 bootstrap/cache/ 权限不正确，或缺少 APP_KEY。请将权限设置为 775，并确认 .env 中已生成 APP_KEY。

页面空白

可临时设置 APP_DEBUG=true 查看真实报错，并查看 storage/logs/laravel.log 中的详细日志。

数据库连接错误

请仔细检查 DB_HOST、DB_DATABASE、DB_USERNAME、DB_PASSWORD，并确认数据库已存在且用户拥有全部权限。

图片或上传文件无法显示

请确认存在 storage 软链接（public/storage），且 FILESYSTEM_DISK 配置正确。

无法登录管理后台

请确认访问地址为您域名下的 /admin/login，并清除浏览器 Cookie 后重试。

第 08 节

## 需要帮助

仍未解决？提交支持工单，我们的团队会尽快回复您。

您的姓名
邮箱
主题
内容

或发送邮件至 support@unlockthemes.com · unlockthemess.com@gmail.com