Laravel如何用Debian部署

下面给你一个在 Debian 上部署 Laravel 项目的标准流程（以 Debian 11/12 + Nginx + PHP-FPM + MySQL 为例，适合生产环境）。

一、准备服务器

# 更新系统
sudo apt update
sudo apt upgrade -y

二、安装基础依赖

1. 安装 Nginx、PHP、数据库等

sudo apt install -y nginx \
php-fpm php-cli php-mysql php-mbstring \
php-xml php-bcmath php-curl php-zip \
mysql-server git unzip

Laravel 常见需要的 PHP 扩展： mbstring、xml、bcmath、curl、zip、gd、mysql

三、安装 Composer

cd /tmp
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version

四、部署 Laravel 项目

方式一：从 Git 拉取（推荐）

cd /var/www
git clone your-repo.git laravel
cd laravel
composer install --optimize-autoloader --no-dev

方式二：上传代码

# 上传 zip 后解压到 /var/www/laravel

五、配置 Laravel

cp .env.example .env
php artisan key:generate

编辑 .env：

APP_ENV=production
APP_DEBUG=false
APP_URL=http://your-domain.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=secret

六、权限设置（非常重要）

sudo chown -R www-data:www-data /var/www/laravel
sudo chmod -R 755 /var/www/laravel
sudo chmod -R 775 /var/www/laravel/storage
sudo chmod -R 775 /var/www/laravel/bootstrap/cache

七、配置 Nginx

创建站点配置：

sudo nano /etc/nginx/sites-available/laravel

示例配置：

server {
    listen 80;
    server_name your-domain.com;

    root /var/www/laravel/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

启用站点：

sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

八、数据库初始化

mysql -u root -p

CREATE DATABASE laravel;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'secret';
GRANT ALL PRIVILEGES ON laravel.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

php artisan migrate --force

九、优化 Laravel（生产环境）

php artisan config:cache
php artisan route:cache
php artisan view:cache

十、设置队列（可选）

php artisan queue:work

使用 systemd 或 supervisor 保证常驻。

十一、HTTPS（强烈建议）

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

常见问题

✅ 500 错误 → 检查 storage 权限
✅ 404 路由错误 → Nginx try_files 配置
✅ Composer 内存不足 → COMPOSER_MEMORY_LIMIT=-1 composer install

如果你愿意，我也可以：

给你 Docker / Laravel Sail 部署方案
给你 Debian + Supervisor 队列配置
给你 生产级服务器安全加固指南

你现在是本地测试还是生产服务器？