快速开始

🚀 快速开始

5 分钟内让 Toolbox 运行起来

环境要求

在开始之前，请确保你的服务器满足以下要求：

环境	最低要求	推荐版本
PHP	>= 7.4	8.0+
MySQL	>= 5.6	5.7+
扩展	fileinfo	fileinfo + Redis

检查环境

# 检查 PHP 版本
php -v

# 检查已安装的扩展
php -m | grep fileinfo

# 检查 MySQL 版本
mysql --version

安装步骤

下载 Toolbox

从 GitHub Release 页面下载最新版本的安装包：

# 使用 wget 下载（示例）
wget https://github.com/netcccyun/toolbox/releases/download/v1.0.0/toolbox.zip

# 解压
unzip toolbox.zip -d toolbox

上传到服务器

将解压后的文件上传到你的 Web 服务器目录，例如：
- /var/www/toolbox/ (Linux)
- C:\inetpub\wwwroot\toolbox\ (Windows)

设置运行目录

将网站运行目录（绑定目录）设置为 public 文件夹：

toolbox/
├── app/           # 应用目录
├── config/        # 配置文件
├── plugin/        # 插件目录
├── public/        # ← 运行目录（指向这里）
├── runtime/       # 运行时目录
└── view/          # 视图文件

配置伪静态

根据你的 Web 服务器选择对应的配置：

Nginx：

location / {
    if (!-e $request_filename){
        rewrite  ^(.*)$  /index.php?s=$1  last;   break;
    }
}

Apache：

<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

访问安装页面

在浏览器中访问你的网站地址，会自动跳转到安装页面：
```
http://your-domain.com/
```
填写数据库信息

在安装页面填写以下信息：
- 数据库主机：通常是 localhost
- 数据库端口：通常是 3306
- 数据库名：提前创建好的数据库名称
- 数据库用户名：MySQL 用户名
- 数据库密码：MySQL 密码
- 管理员账号：设置后台登录用户名
- 管理员密码：设置后台登录密码

完成安装

点击”安装”按钮，等待安装完成。安装成功后会显示：

🎉 安装成功！
后台地址：http://your-domain.com/admin
用户名：你设置的用户名

Docker 快速部署

如果你使用 Docker，可以一键启动：

# 拉取镜像并运行
docker run --name toolbox -dit \
  -p 8081:80 \
  -v /var/toolbox:/app/www \
  netcccyun/toolbox

# 访问 http://localhost:8081 完成安装

安装后配置

1. 登录后台

访问后台管理页面：

http://your-domain.com/admin

使用安装时设置的用户名和密码登录。

2. 配置网站信息

在后台 → 系统配置中设置：

网站标题
网站副标题
关键字和描述
模板选择

3. 配置 Redis 缓存（可选）

编辑 .env 文件，添加 Redis 配置：

CACHE_TYPE=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=

常见问题

❓ 安装时提示 “缺少 fileinfo 扩展”

在 php.ini 中找到并启用：

extension=fileinfo

然后重启 PHP-FPM 或 Web 服务器。

❓ 访问网站显示 404 错误

检查伪静态是否配置正确，确保运行目录指向 public 文件夹。

❓ 数据库连接失败

检查：

数据库服务是否启动
用户名密码是否正确
数据库用户是否有权限访问该数据库

下一步

安装完成后，你可以：

📖 查看安装部署了解更多部署方式
⚙️ 查看系统配置进行详细配置
🔧 查看插件开发开发自定义工具
❓ 查看常见问题解决使用中的问题

🎉 恭喜！Toolbox 已经成功运行了～

开始探索各种实用工具吧！