laravel 10 迁移到 debian 需完成环境适配、权限控制、服务配置和安全加固四环节：升级系统，安装 php 8.1+ 及扩展、composer、nginx 和数据库；上传代码后执行 composer install --no-dev --optimize-autoloader；设 www-data 权限；配置 .env 并运行 key:generate、migrate、config:cache 等命令；nginx 指向 public 目录并启用安全配置；确保 app_debug=false。
把 Laravel 10 应用迁移到 Debian 服务器不是简单复制文件，而是要完成环境适配、权限控制、服务配置和安全加固四个关键环节。核心在于让应用在生产环境下稳定、安全、可维护地运行。
准备 Debian 系统环境
确保系统基础组件就绪：
- 运行
sudo apt update && sudo apt upgrade -y升级系统 - 安装 PHP 8.1+（Laravel 10 最低要求）及必要扩展：
sudo apt install php8.1-cli php8.1-fpm php8.1-mysql php8.1-curl php8.1-gd php8.1-mbstring php8.1-xml php8.1-zip php8.1-bcmath php8.1-opcache - 安装 Composer：
curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer - 安装 Web 服务器（推荐 Nginx）：
sudo apt install nginx -y - 安装 MySQL 或 PostgreSQL，并创建数据库与用户
部署应用代码与依赖
不要用开发机的 vendor/ 目录直接上传，应在服务器上重装依赖：
- 将你的 Laravel 10 项目（不含
vendor/、.env、node_modules/）上传至目标路径，例如/var/www/myapp - 进入项目目录，执行：
composer install --no-dev --optimize-autoloader
（加--no-dev禁用开发依赖，--optimize-autoloader提升性能） - 设置正确权限：
sudo chown -R www-data:www-data /var/www/myappsudo chmod -R 755 /var/www/myappsudo chmod -R 775 /var/www/myapp/storage /var/www/myapp/bootstrap/cache
配置运行环境
生产环境必须严格管理敏感配置：
- 复制并编辑
.env：cp .env.example .env，然后用nano .env填写数据库、缓存、队列等真实参数 - 生成应用密钥：
php artisan key:generate --force - 运行迁移（如需）：
php artisan migrate --force（生产环境建议先备份再执行） - 预热配置与路由缓存：
php artisan config:cachephp artisan route:cachephp artisan view:cache
Nginx 与安全加固
Web 服务器配置决定能否正确解析 Laravel 路由：
- 新建站点配置：
sudo nano /etc/nginx/sites-available/myapp - 关键配置项必须包含：
–root指向/var/www/myapp/public
–index包含index.php
–location /使用try_files $uri $uri/ /index.php?$query_string;
–location ~ \.php$正确指向 PHP-FPM socket（如unix:/var/run/php/php8.1-fpm.sock） - 启用站点并验证：
sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/sudo nginx -t && sudo systemctl reload nginx - 禁用调试模式：
确保.env中APP_DEBUG=false，防止敏感信息泄露
迁移完成之后，访问域名或 IP 应能正常打开首页；若报错，优先检查 Nginx 错误日志（/var/log/nginx/error.log）和 Laravel 日志（storage/logs/laravel.log）。不复杂但容易忽略。
