参考资料

  1. Fresns PHP函数 官方要求
  2. Fresns 的 APP_KEY 是应用加密密钥
  3. RoadRunner 是 Octane 支持的三个服务器之一,它的定位是“最稳定、进程隔离最好”的选择
  4. Fresns 的定时任务基于 Laravel 的 Task Scheduler 机制
  5. Fresns 伪静态设置
  6. Fresns 管理面板的默认登录入口是 /fresns/admin
  7. Fresns 的队列,它的核心是按需配置,并非安装必选项
  8. Fresns 配合 Octane 和 FrankenPHP,是目前社区公认提升访问速度最核心的手段

Fresns 的软链接,核心是解决“本地存储的文件无法被公网访问”的问题

Fresns 的软链接,核心是解决“本地存储的文件无法被公网访问”的问题。

📂 为什么需要软链接

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

⚙️ 生成命令

在 Fresns 根目录执行:

php artisan storage:link

执行后会在 /public 目录下生成一个 storage 软链接,指向 storage/app/public。

💡 涉及到的函数

生成软链接依赖 PHP 的 symlink 函数。在宝塔面板中,如果 symlink 被禁用,命令会执行失败。安装阶段需要开启该函数,安装完成后可以禁用。

🔄 重新生成的情况

如果迁移了服务器、移动了 Fresns 目录,或软链接意外失效,需要重新执行 storage:link 命令。若提示“链接已存在”,可先删除旧的软链接再执行:

rm public/storage
php artisan storage:link
作者:王壹杰
时间:2026-10-01 16:47:08
来源:https://fresns.ciilii.com/