Laravel Cloud CLI —— 在终端里操作 Laravel Cloud

什么是 Laravel Cloud CLI

laravel/cloud-cli 是用于在终端里操作 Laravel Cloud 的 CLI。它由 Laravel Zero 构建,你在面板里执行的操作都能通过 cloud 命令完成。你可以用这个 CLI 集中管理应用、环境、数据库、缓存、存储桶、域名、WebSocket 等资源。

在开始之前,请满足以下要求。

首先在本地安装 CLI。

拉取仓库并安装依赖

gh repo clone laravel/cloud-cli
cd cloud-cli
composer install

设置 `cloud` 别名

zsh:

echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
source ~/.zshrc

bash:

echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
source ~/.bashrc

用任意路径手动设置

alias cloud="php /path/to/cloud-cli/cloud"

在使用大多数命令之前,请先完成认证。

cloud auth

cloud auth 会打开浏览器,通过 OAuth 完成认证。如果需要在 CI 等场景管理 token,可以使用 cloud auth:token。

cloud auth:token

如果你不想每次都在项目里选择 application 或 environment,请执行 cloud repo:config。

cloud repo:config

这会在 Git 仓库中保存默认值,让 cloud deploy 等命令可以用更短的方式运行。

把首次部署和后续部署分开使用会更有效率。

# 首次:带引导的应用创建与部署
cloud ship

# 后续:向已有应用部署
cloud deploy

# 打开面板
cloud dashboard

从 README 的命令参考中,整理日常常用的分类。

分类	主要命令示例	用途
Auth / Config	`cloud auth`、`cloud auth:token`、`cloud repo:config`	认证与默认设置
Application	`cloud application:list`、`cloud application:create`	应用管理
Environment	`cloud environment:list`、`cloud environment:get`、`cloud environment:logs`	环境信息与日志查看
Deploy	`cloud ship`、`cloud deploy`、`cloud deploy:monitor`	部署管理
Database	`cloud database-cluster:`、`cloud database:`、`cloud database-snapshot:*`	DB 集群、DB、快照管理
Cache	`cloud cache:list`、`cloud cache:create`、`cloud cache:types`	缓存管理
Bucket	`cloud bucket:`、`cloud bucket-key:`	对象存储管理
Domain	`cloud domain:list`、`cloud domain:create`、`cloud domain:verify`	域名配置与验证
WebSocket	`cloud websocket-cluster:`、`cloud websocket-application:`	Reverb 相关资源管理

通过 cloud environment:variables 管理环境变量。该命令统一涵盖 append / set / replace 等操作。

cloud environment:variables

在 CI 和团队协作中,通过该命令统一环境变量的变更流程。

计费和资源用量可以用 cloud usage 查看。

# 当月用量
cloud usage

# 详细展示
cloud usage --detailed

# 上一周期的用量
cloud usage --period=previous

想按环境筛选时使用 cloud usage --environment=<id>。

最后修改于 2026年7月13日