Laravel项目可在云服务器上快速部署:Serverless模板一键创建(5分钟获URL,禁用APP_DEBUG、SERVERLESS=1)、宝塔面板图形化部署(站点+Composer或Docker直启),并须校验storage/bootstrap/cache权限为755、运行目录设为/public、MySQL字符集为utf8mb4。

要在云服务器上快速让Laravel项目跑起来,不折腾环境、不手动编译、不反复调试Nginx配置,只需三步:选对平台、填对参数、点下部署按钮,5分钟内即可获得可访问的线上URL。
用Serverless控制台模板一键创建
适合无运维经验、只想验证功能或做临时演示的开发者,无需购买ECS、不用装宝塔、不碰SSH命令。
1. 登录 Serverless 控制台,单击左侧导航栏的函数服务。
2. 在主界面顶部选择地域和命名空间,点击新建进入函数创建流程。
3. 选择模板创建 → 搜索框输入WebFunc → 找到并选中Laravel 框架模板 → 点击下一步。
4. 查看模板预置配置(已含PHP 8.3运行时、自动挂载/tmp、内置scf_bootstrap启动逻辑),确认无误后直接点击完成。
注意:该模板默认禁用APP_DEBUG、强制使用SERVERLESS=1环境标识,【不可修改运行时版本】,否则会导致bootstrap失败。
宝塔面板内极速部署(推荐生产轻量级场景)
已有宝塔面板且服务器资源充足(≥2G内存)时,此路径兼顾可控性与速度,全程图形化操作占比超90%。
方法一:站点+Composer双驱动
① 进入网站模块 → 添加站点 → 域名填 test.laravel.local(本地hosts可解析)→ 根目录设为 /www/wwwroot/laravel-test → PHP版本选8.1(必须≥8.0)。
② 站点创建后,立即点击右侧根目录按钮,清空 index.html,再上传已打包的Laravel项目压缩包(不含vendor目录)。
③ 进入终端 → 执行:cd /www/wwwroot/laravel-test && composer install --no-dev --optimize-autoloader。
④ 返回文件管理器 → 编辑 .env 文件 → 将 APP_URL 改为 http://test.laravel.local,DB_DATABASE 改为新创建的数据库名(需提前在数据库模块建库)。
方法二:Docker镜像直启(需宝塔已启用Docker)
在终端中执行:curl -s https://laravel.build/myapp | bash → 等待拉取镜像并启动容器 → 宝塔会自动识别并显示为“Docker容器”服务 → 访问 http://myapp.test 即可(需提前配置本地DNS或Hosts)。
关键权限与路径修正
无论用哪种方式部署,以下两处必须人工校验,否则页面报500且日志无明确提示:
1. 进入文件管理器,定位到项目根目录下的 storage 和 bootstrap/cache 目录 → 右键 → 设置权限为 755 → 勾选“递归设置子目录文件权限”。
2. 进入该站点的网站设置 → 左侧选网站目录 → 将运行目录明确改为 /public → 保存。这一步漏掉,Nginx会尝试加载根目录下的index.php,而它不存在。
3. 若使用MySQL,确保在数据库模块中创建的数据库字符集为 utf8mb4,排序规则为 utf8mb4_unicode_ci,否则迁移时可能卡在 migrations 表创建阶段。


















