Fresns 管理面板的默认登录入口是 /fresns/admin。如果忘记了具体地址，也可以在终端中执行命令来查看。🔑 默认登录入口你的后台管理面板地址通常是：https://你的域名/fresns/admin💻 终端查看方法如果默认路径被修改过，可以进入 Fresns 根目录执行以下指令来获取准确信息：⚠️ 无法访问的排查如果访问后台返回 404，或者页面报错，可以按以下顺序排查：检查伪静态：

RoadRunner 是 Octane 支持的三个服务器之一，它的定位是“最稳定、进程隔离最好”的选择。它用 Go 编写，以二进制形式运行，不需要安装任何 PHP 扩展，天然适合容器化部署。📦 安装与激活在 Fresns 根目录的终端中执行：1. 安装 Octane 包2. 安装 RoadRunner 服务首次启动时，Octane 会自动下载对应平台的 RoadRunner 二进制文件。如果下载失

Fresns 配合 Octane 和 Swoole，同样能让应用常驻内存，性能提升十倍以上。它的优势在于 Swoole 生态成熟，有丰富的并发任务、定时器和高性能缓存等特性，适合需要利用这些底层能力的场景。📦 安装与激活以下操作需要在 Fresns 根目录的终端中执行。1. 安装 Octane 包2. 安装 Swoole 扩展Swoole 是 PHP 扩展，需要先通过 PECL 安装：安装完成后，

Fresns 配合 Octane 和 FrankenPHP，是目前社区公认提升访问速度最核心的手段，性能提升可达十倍以上。它的原理是让 PHP 应用常驻内存，避免每个请求都重新加载框架，而 FrankenPHP 则是一个用 Go 编写的现代 PHP 应用服务器，原生支持 HTTP/2、HTTP/3 和自动 HTTPS，无需额外配置 Nginx 反代就能直接对外提供服务。📦 安装与激活以下操作需要在

Fresns 的软链接，核心是解决“本地存储的文件无法被公网访问”的问题。📂 为什么需要软链接Fresns 上传的本地文件存放在 storage/app/public 目录，但这个目录不在网站可访问的范围内，外部无法直接通过 URL 访问。软链接的作用就是在网站根目录 /public 下创建一个指向真实存储目录的“快捷方式”，让浏览器可以通过 /storage/xxx 这样的路径访问到文件。⚙️

Fresns 提供两种自动升级方式，升级前务必先备份数据库。🖱️ 可视化升级（后台操作）当有新版本发布时，Fresns 后台仪表盘会显示更新提示。进入升级页面，直接点击「升级」按钮即可，系统会自动完成下载、解压、迁移等步骤。⌨️ 命令行升级（终端操作）如果后台无法访问，或你更习惯终端操作，在主程序根目录执行：执行过程中会提示确认，输入 yes 后继续。⚙️ 自动升级背后的机制自动升级命令会依次执行

Fresns 的代理环境配置，核心是让系统在 CDN 或反向代理（如 Cloudflare、Nginx 反代）之后，能正确识别访客的真实 IP 地址。如果不配置，系统会把代理服务器的 IP 误认为访客 IP，导致日志、限流等功能失效。📂 配置项说明Fresns 从 2.7.0 版本开始适配代理环境，新增了 TRUSTED_PROXIES 环境变量。配置项说明TRUSTED_PROXIES可信任的代

Fresns 的时区配置核心是在 .env 文件中设置 APP_TIMEZONE 参数。为了确保跨时区数据一致性，Fresns 底层采用 UTC 标准，并自动处理时间录入与输出的转换。📂 配置项说明配置项默认值说明APP_TIMEZONEAsia/Shanghai数据库时区，必须使用 PHP 时区函数（地区命名格式）⚙️ 配置示例在 Fresns 根目录的 .env 文件中，找到并修改该配置项：其

Fresns 的队列进程启动命令，核心就是 php artisan queue:work。下面结合宝塔面板的进程守护功能，说明具体参数和示例。📂 基础启动命令这条命令启动一个常驻进程，持续从队列中取出任务并执行。它适合生产环境，因为 queue:work 是常驻进程，性能比 queue:listen 更好。⚙️ 常用参数说明在宝塔的进程守护管理器中，启动命令通常需要写成完整的一行，并带上必要参数：

关于 Fresns 的队列，它的核心是按需配置，并非安装必选项。如果安装的插件明确要求了“队列”功能，才需要为主程序进行配置；如果没有特别说明，通常可以忽略，系统默认的同步执行模式（sync）足够应付。📂 队列配置方式如果需要启用，先在 .env 文件中配置连接方式，推荐 redis 或 database。方式一：Redis（推荐）方式二：Database（无需额外服务）配置完成后，必须配置进程守