给 Composer 换国内源是提升依赖下载速度最直接的方法。目前阿里云和腾讯云的镜像比较稳定，你可以按需选择。🚀 全局配置（推荐）如果你希望所有项目都使用镜像加速，在终端执行一条命令即可。阿里云镜像：腾讯云镜像：📦 仅当前项目配置如果只想给特定项目加速，进入项目根目录（含 composer.json）后，去掉 -g 参数执行：💡 云服务器特别提示如果你正在使用云服务器（如阿里云 ECS） 部署项
终端平台编号（X-Fresns-Client-Platform-Id）是 Fresns API 请求头中的必填参数，用于声明客户端所在的设备类型。它的核心作用是与你在后台创建的“应用密钥”所绑定的平台类型进行匹配校验。📋 平台编号对照表Fresns 系统预置了 11 种平台类型，具体编号如下：编号平台类型编号平台类型1Other7Mac App2Desktop Web（桌面网页）8Windows
OpenResty 本质上是一个集成了 Nginx 与 LuaJIT 的 Web 平台，对于 Fresns 而言，它完全可以替代标准的 Nginx 作为 Web 服务器或反向代理使用。📂 与 Fresns 的兼容性Fresns 官方环境要求中列出的 Web 服务器是 Nginx、Apache、Caddy、IIS，并未直接提及 OpenResty。但由于 OpenResty 的核心就是 Nginx，
配置 Fresns 的队列进程，核心是使用 Supervisor 守护 php artisan queue:work 命令。宝塔面板用户可直接使用自带的“进程守护管理器”插件完成配置。📂 宝塔面板配置步骤进入宝塔面板「软件商店」，安装 Supervisor 进程守护管理器（或名为“进程守护管理器”）。安装完成后，点击「设置」进入管理界面，选择「添加守护进程」。填写以下关键参数：配置项建议填写内容说
Supervisor 是 Fresns 在生产环境中运行队列的标准方案。它本质上是一个进程监控器，负责确保 php artisan queue:work 进程一直存活，如果意外退出会自动拉起。📦 安装 SupervisorFresns 官方文档明确要求：只要修改了队列连接方式（如改为 redis），就必须配置 Supervisor。宝塔面板安装（推荐）登录宝塔面板，进入「软件商店」搜索「Super
Fresns 的定时任务基于 Laravel 的 Task Scheduler 机制。核心逻辑是：在服务器上配置一个每分钟执行一次的 cron，由它触发 Laravel 的调度器，调度器再根据定义好的周期去执行具体任务。📂 宝塔面板配置步骤进入计划任务：宝塔面板 → 计划任务 → 添加任务。任务类型：选择 Shell 脚本。执行周期：选择 N 分钟，并设置为 1 分钟。脚本内容：复制以下命令，注意
Fresns 对 Composer 的版本要求很明确：不低于 2.5。📂 版本要求说明官方文档及宝塔配置教程中均一致标注，软件包管理器需为 Composer 2.5 或更高版本。💡 检查与升级如果版本过低，可以在终端执行以下命令来更新：⚠️ 注意事项如果在宝塔面板环境中操作，建议先进入站点根目录，并在宝塔面板的“Composer”版本管理器中确认版本已切换至 2.5 以上，避免因全局版本与面板设置
Fresns 对 PHP 超时限制有明确要求，主要是为了避免插件依赖下载超时，以及支持前端大文件上传等场景。默认的 30 秒通常不够用，需要适当加大。📂 宝塔面板设置方法（推荐）在宝塔面板中，不要只改全局 php.ini，优先调整站点级别的设置，优先级更高且更稳定。路径：进入【网站】→ 找到 Fresns 站点 →【设置】→【PHP 版本】→ 点击右侧的**“设置”按钮**（不是“配置文件”）→
Fresns 的 PHP 扩展要求分为 必选 和 按需安装 两类。📂 必选扩展以下扩展 Fresns 运行所必需，在宝塔面板的 PHP 设置中需要确保已安装并启用：扩展用途说明fileinfo文件类型检测核心必选，Fresns 官方明确要求mbstring多字节字符串处理Laravel 框架基础依赖，通常默认已安装opcachePHP 字节码缓存提升性能，推荐开启📦 按需安装的扩展根据你启用的功能
在 Fresns 的终端中清理缓存，需要根据具体的缓存类型来执行对应的 Artisan 命令。🧹 常用缓存清理命令你可以根据实际情况，在 Fresns 根目录下运行以下命令：命令作用适用场景php artisan cache:clear清除应用数据缓存修改了后台设置、插件配置后不生效php artisan config:clear清除框架配置缓存修改了 .env 文件后必须执行，否则新配置不生效p
