参考资料

  1. Fresns 的定时任务基于 Laravel 的 Task Scheduler 机制
  2. Fresns 的队列与 Redis 配置，本质上就是让主程序知道“异步任务交给谁处理
  3. Composer 换国内源是提升依赖下载速度最直接的方法
  4. Fresns 伪静态设置
  5. Fresns 对 PHP 超时限制有明确要求，主要是为了避免插件依赖下载超时
  6. Fresns 在宝塔面板下的目录所有权，通常需要设为 www 用户和 www 用户组
  7. Fresns 的 PHP 扩展要求分为 必选 和 按需安装 两类
  8. Fresns 的时区配置核心是在 .env 文件中设置 APP_TIMEZONE 参数

Fresns 终端平台编号

终端平台编号（X-Fresns-Client-Platform-Id）是 Fresns API 请求头中的必填参数，用于声明客户端所在的设备类型。它的核心作用是与你在后台创建的“应用密钥”所绑定的平台类型进行匹配校验。

📋 平台编号对照表

Fresns 系统预置了 11 种平台类型，具体编号如下：

编号平台类型编号平台类型
1Other7Mac App
2Desktop Web（桌面网页）8Windows App
3Mobile Web（移动网页）9Linux App
4Responsive Web（响应式网页）10Vision App
5iOS App11Mini Program（小程序）
6Android App

💻 配置与使用示例

假设你在 Fresns 后台创建了一个密钥，并将其“平台”设置为 “Responsive Web”，那么该密钥对应的平台编号就是 4。

在发起 API 请求时，请求头中必须包含该编号：

X-Fresns-Client-Platform-Id: 4

如果编号与密钥绑定的平台不一致，请求会因签名校验失败而被拒绝。

💡 如何查看你需要的编号

具体使用哪个编号，取决于你在 Fresns 控制面板创建密钥时选择的“平台”。
查看路径：控制面板 → 应用中心 → 应用密钥 → 查看对应 Key 的“平台”字段，该平台名称对应的数字就是你需要填写的编号。

作者：王壹杰
时间：2026-10-01 17:12:13
来源：https://fresns.ciilii.com/