属于大家的
VPS知识分享站

Laravel 部署:新加坡/美国节点与队列配置

Laravel 本地跑得好好的,上线 500;队列不消费、定时任务不跑、上传文件 403。部署不是把代码传上去,是把 PHP、权限、队列和缓存都配对。

部署栈

  • Nginx:静态文件和反代 PHP-FPM
  • PHP-FPM:跑 Laravel
  • Composer:装依赖
  • Redis:缓存和队列
  • Supervisor:守护队列进程
  • MySQL/Postgres:数据库

上线步骤

composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache

生产环境别用 php artisan serve;它只适合本地开发。

Nginx 配置

root /var/www/app/public;
index index.php;
location / {
    try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
    fastcgi_pass unix:/run/php/app.sock;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    include fastcgi_params;
}

root 必须指向 public,别把 .env 暴露出去。

权限

storage 和 bootstrap/cache 要可写,但别给 777;用 www-data 用户和组,权限 775。

队列任务流入 worker
队列进程挂了要自动重启。

队列

[program:laravel-worker]
command=php /var/www/app/artisan queue:work redis --sleep=3 --tries=3
numprocs=2
autostart=true
autorestart=true
user=www-data

队列进程挂了要自动重启;失败任务进 failed_jobs,定期重试或清理。

定时任务

* * * * * cd /var/www/app && php artisan schedule:run >> /dev/null 2>&1

Laravel 的调度器靠这一条 cron 驱动,别为每个任务单独写 cron。

新加坡与美国节点和部署流水线
应用、数据库、Redis 同区域。

新加坡还是美国

  • 新加坡:东南亚用户近,适合面向 SEA 的业务
  • 美国:北美市场、成本和机型选择多
  • 香港:大陆和亚洲用户近

应用、数据库和 Redis 同区域,别跨洲查库;队列 worker 跟应用同机或同区。

OPcache 层与数据库
配置、路由、视图都要缓存。

性能

开 OPcache、配置缓存、路由缓存;队列和 web 分开进程,别让重任务拖慢页面。

安全

  • APP_DEBUG=false,别把堆栈暴露给用户
  • .env 不进 Git,权限 600
  • 数据库账号最小权限
  • HTTPS 和 HSTS
  • 定期更新依赖,看安全公告

Composer

生产用 --no-dev,锁文件进 Git;别在服务器上跑 composer update。

环境变量

.env 不进代码库,权限 600;多环境用不同文件,别把生产密钥带到测试。

日志

日志按天切,权限可写;500 先看 storage/logs 和 Nginx 错误日志。

备份

数据库每天、代码和上传文件每周;备份放另一处,恢复演练每季度一次。

OPcache

生产开 OPcache,改代码后重置;配置缓存后别再改 .env,否则不生效。

队列失败

failed_jobs 要监控,失败任务重试或清理;别让队列表无限涨。

节点

应用和 Redis 同区,队列延迟低;数据库跨区会拖慢所有任务。

日志权限

storage 和 bootstrap/cache 可写,其他目录只读;权限错是 500 的常见原因。

部署脚本

拉代码、装依赖、迁移、缓存、重启队列,写成脚本;别手工一步步敲。

回滚

代码和数据库迁移都要能回滚;迁移前备份,别只回代码不回库。

监控

看 5xx、队列长度、失败任务和 TTFB;队列堆积通常比页面慢更早出现。

安全清单

APP_DEBUG 关、.env 600、数据库最小权限、HTTPS;依赖定期更新。

队列监控

队列长度、失败数和处理时间设告警;堆积通常比页面慢更早出现。

上线检查

依赖、迁移、缓存、队列、定时、权限六项逐项确认,别漏 .env 和 key。

性能调优

开 OPcache、配置/路由缓存,队列异步化;数据库慢查询先加索引。

回滚演练

代码回滚和数据库回滚分开练;只回代码不回库,数据可能对不上。

长期

依赖、PHP 和 Laravel 版本定期升级;别等 EOL 才动。

文档

部署步骤写成一页,新同事照着能上线。

合规

日志和用户数据按当地法规保留,别无限存。

总结建议

部署是工程,不是传文件。

最后

上线前把 checklist 走完。

最后补充

先把流程跑通。

常见问题 FAQ

Q1:Laravel 要多大配置?

2 核 4G 起步,队列和并发多就 4 核 8G;内存比 CPU 更先到顶。

Q2:队列不消费怎么办?

看 Supervisor 状态、Redis 连接和 failed_jobs;先重启 worker,再查日志。

Q3:新加坡还是美国节点?

用户在哪放哪;应用和数据库同区域,别跨洲。

Q4:部署要停机吗?

小版本可以热更,大版本用维护模式或蓝绿;迁移前备份。

Q5:500 错误先看哪?

看 Laravel 日志、Nginx 错误日志和 PHP-FPM 日志;权限和 .env 是常见原因。

总结

Laravel 部署的核心是 Nginx root、PHP-FPM、storage 权限、队列 Supervisor 和 schedule cron。节点跟用户走,应用和数据库同区;生产关 debug,依赖定期更新。

需要一台 Laravel 机器,可以按小时开一台萤光云新加坡 VPS,先把队列和定时任务跑通。

队列和定时任务先跑通,再谈扩容和多机部署,别急着上集群。

相关推荐

赞(0)
未经允许不得转载:VPS知识分享站 » Laravel 部署:新加坡/美国节点与队列配置