> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Cloud — Laravel 专用 PaaS 全貌

> 2025 年登场的 Laravel Cloud。解析它与 Forge 的区别、擅长与不擅长的地方,以及实际使用的收益。

## 什么是 Laravel Cloud

[Laravel Cloud](https://cloud.laravel.com/docs/intro) 是 Laravel 官方的**全托管 PaaS**。
从应用部署、扩缩容、数据库、缓存到 WebSocket 基础设施,都以面向 Laravel 的方式整合在一起。

在 Cloud 的 [Changelog](https://cloud.laravel.com/docs/changelog) 中,记录着 `February 24, 2025` 的 **Launched Laravel Cloud!**。它是 2025 年才开始正式提供服务的相对较新的产品。

***

## 与 Forge 的差异

Laravel Cloud 和 Laravel Forge 都是面向 Laravel 开发者的产品,但处于不同的层次。

| 视角      | Laravel Cloud     | Laravel Forge     |
| ------- | ----------------- | ----------------- |
| 定位      | 全托管 PaaS          | 服务器管理工具           |
| 主要操作    | 选择环境和资源后部署        | 供给并运维 VPS / EC2 等 |
| 基础设施管理  | 最少(由 Cloud 一侧管理)  | OS、中间件的运维由用户负责    |
| root 权限 | 无(不假设可以直接操作 OS 层) | 有(可以细粒度地控制服务器运维)  |

如果你想“不感知基础设施,尽快让 Laravel 应用上线”,选 Cloud;
如果你想“精细控制服务器”,选 Forge。

***

## Laravel Cloud 擅长的事

Laravel Cloud 的优势在于:在 Laravel 生产运行中会用到的功能,可以在面板中直接开启。

### Task Scheduler

在 [Scheduled Tasks](https://cloud.laravel.com/docs/scheduled-tasks) 中,只要给 App cluster 或 Worker cluster 启用 **Scheduler**,`schedule:run` 就会每分钟执行一次。

### Managed Queues(托管队列)

[Queues](https://cloud.laravel.com/docs/queues) 中推荐 **Managed Queues**。Laravel Cloud 会自动完成队列供给、Worker 启动和扩缩容,没有作业时 Worker 数会缩到零,因此只在处理时计费。

| 选项                    | 适合的用途                          | 扩缩容               | 计费思路                 |
| --------------------- | ------------------------------ | ----------------- | -------------------- |
| **Managed Queues**    | 生产 / 预览 / 开发环境的通用选择,优先考虑       | 根据队列积压自动扩缩,空闲时降到零 | Worker 运行秒数 + 队列操作次数 |
| **Worker cluster**    | 想自己管理 `queue:work` 的场景、较重的后台处理 | 基于 CPU / 内存       | Worker cluster 的常规费用 |
| **App cluster 的后台进程** | 小规模开发或低频作业                     | 基于 CPU / 内存       | 计入 App cluster       |

Managed Queues 让 Web 流量与作业处理分离,并附带失败作业面板。
如果你想使用 `database`、`redis` 等其他驱动并自己管理,选 Worker cluster;和应用同一份计算就够用时,选 App cluster 的后台进程。

<Steps>
  <Step title="创建 Managed Queue">
    在环境的基础设施看板上点击 **New Managed Queue**。
  </Step>

  <Step title="确定队列名和 Worker 设置">
    设置队列名、实例规格、轮询间隔、最大 Worker 数等。
  </Step>

  <Step title="保存并部署">
    保存设置后重新部署,Laravel Cloud 会自动准备好队列和 Worker 池。
  </Step>
</Steps>

<Tip>
  没有作业时 Managed Queues 的 Worker 会缩到零,和后面提到的 Scale to Zero 组合非常契合。即便让 App cluster 睡眠,也能在需要处理队列时自动启动。
</Tip>

### Scale to Zero(Flex 计算资源)

[Compute](https://cloud.laravel.com/docs/compute#scale-to-zero) 中的 **Flex** 是低成本且灵活的 compute class。新的 **Scale to Zero** 就是在这个 Flex 上,从旧 Hibernation 演进出来的机制。在新的 **Flex 计算资源** 中,收到 HTTP 请求时的启动时间被缩短到了 **500ms 以内**,不再是过去动辄等 5\~20 秒的前提。

启用只需要在 App cluster 的设置页把 **Scale to Zero** 开关打开,保存后重新部署即可。

此外,在启用 Scale to Zero 的环境下,即便处于休眠状态,也会为了 Scheduled Tasks 和队列处理自动唤醒环境。
在 App cluster 上运行 `schedule:run`、作业处理交给 Managed Queues,这也是当前官方文档中最容易上手的组合。

<Info>
  在 App cluster 上自己跑 `queue:work` 时,一旦跨越 sleep timeout 可能会被中断。如果想让队列处理保持可靠运行,请优先选择官方文档中推荐的 Managed Queues。
</Info>

### Laravel Octane

启用 [Compute](https://cloud.laravel.com/docs/compute#laravel-octane) 中的 **Use Octane as runtime**,Cloud 就会以 Octane + FrankenPHP 的架构运行。不需要手动搭建服务器配置。

### Inertia SSR

启用 [Compute](https://cloud.laravel.com/docs/compute#inertia-ssr) 中的 **Use Inertia SSR** 即可使用。如果使用启动套件,官方推荐 `npm run build:ssr`。

### WebSocket 服务器(Reverb)

在 [Laravel Cloud WebSockets](https://cloud.laravel.com/docs/resources/websockets) 中可以创建基于 Reverb 的 WebSocket 集群。将其挂到环境上后,`REVERB_*` 和 `VITE_REVERB_*` 会被自动注入。

### Laravel Nightwatch 集成

[Environments](https://cloud.laravel.com/docs/environments#nightwatch-integration) 提供一键集成,Cloud 的 [Changelog](https://cloud.laravel.com/docs/changelog) 中也记录了 `July 1, 2025` 的 **One-Click Nightwatch Integration**。
需要手动配置时,可参考 [nightwatch-on-cloud](https://cloud.laravel.com/docs/knowledge-base/nightwatch-on-cloud) 中的步骤。

***

## 计费与免费方案

Laravel Cloud 的计费基本上是**方案费 + 使用量计费**。
详情请随时查看 [Pricing](https://cloud.laravel.com/docs/pricing)。

* **Starter**:月付 `$5`,每月赠送 `$5` 使用额度。新注册首月免费
* **Growth**:`$20/mo + usage`,每月赠送 `$5` 使用额度
* **Business**:`$200/mo + usage`,每月赠送 `$5` 使用额度

比以往更容易用 **Starter** 起步小型项目了。
配合 Scale to Zero 和 Managed Queues,即便是待机时间较长的个人项目或内部工具,也能把成本控制得很清楚。

***

## 实际使用时需要注意的点

### 不能以 root 权限为前提运营

Cloud 是 PaaS,更优先运维简便性而非 OS 层的自由度。
如果你需要修改内核设置或常驻自定义 daemon 等以 root 权限为前提的工作,可以考虑 Forge 等选项。

### Nightwatch 的事件量应一开始就控制好

在免费额度或小规模环境上使用 Nightwatch 时,事件量容易增长,一开始就设置好采样比较安全。

```ini theme={null}
NIGHTWATCH_REQUEST_SAMPLE_RATE=0.1
NIGHTWATCH_IGNORE_QUERIES=true
```

***

## 适合与不适合的项目

### 适合

* 想以最快速度让 Laravel 应用上生产
* 想把 Scheduler / Queue / Octane / Inertia SSR / Reverb 一起用起来
* 想专注在应用开发上,降低服务器运维成本

### 不适合

* 想通过 root 权限对 OS 层进行较强的调优
* 已有特殊的基础设施要求(独特的中间件或严格的网络限制)

***

## 总结

Laravel Cloud 特别适合“想用上 Laravel 的高级功能、同时又要降低基础设施搭建负担”的团队。
特别是把 Scheduler / Queue / Octane / Inertia SSR / Reverb / Nightwatch 组合起来使用的项目,从上线到运维的初速会大幅提升。

而如果你的运维模式必须依赖 root 权限,那 Forge 会更合适。
最保险的做法是:先用免费试用把实际的工作负载跑一遍,确认它是否满足你的运维要求。


## Related topics

- [Laravel Cloud Hibernation(自动休眠)](/zh/blog/laravel-cloud-hibernation.md)
- [Labeler](/zh/packages/laravel-bluesky/labeler.md)
- [部署](/zh/deployment.md)
- [Laravel 10 升级到 11](/zh/blog/upgrade-10-to-11.md)
- [Laravel 11 之后的应用结构](/zh/advanced/app-structure.md)