Laravel在Debian如何部署

下面给你一套在 Debian 系统上部署 Laravel 的完整流程，适用于 Laravel 10 / 11，涵盖 Nginx + PHP + MySQL + Composer + 权限配置，适合生产环境。

一、准备环境

1️⃣ 更新系统

sudo apt update
sudo apt upgrade -y

二、安装 Nginx

sudo apt install nginx -y

启动并设置开机自启：

sudo systemctl enable nginx
sudo systemctl start nginx

浏览器访问服务器 IP，看到 Nginx 欢迎页说明成功。

三、安装 PHP（推荐 PHP 8.2）

1️⃣ 添加 PHP 源（Debian 12 可跳过）

sudo apt install -y lsb-release apt-transport-https ca-certificates
sudo curl -sSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/sury-php.list
sudo apt update

2️⃣ 安装 PHP 及扩展

sudo apt install -y php8.2 php8.2-fpm \
php8.2-mysql php8.2-curl php8.2-mbstring \
php8.2-xml php8.2-zip php8.2-gd php8.2-tokenizer

检查：

php -v

四、安装 MySQL（或 MariaDB）

sudo apt install mysql-server -y
sudo mysql_secure_installation

创建数据库：

CREATE DATABASE laravel_db;
CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';
FLUSH PRIVILEGES;

五、安装 Composer

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

六、部署 Laravel 项目

1️⃣ 进入 web 目录

cd /var/www

2️⃣ 拉取代码（推荐）

git clone https://github.com/yourname/laravel.git
cd laravel

或上传压缩包解压。

3️⃣ 安装依赖

composer install --optimize-autoloader --no-dev

七、配置 Laravel 环境

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

编辑 .env：

APP_ENV=production
APP_DEBUG=false
APP_URL=http://your_domain_or_ip

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=password

八、设置目录权限（非常重要）

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

九、配置 Nginx 虚拟主机

创建配置文件：

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

示例配置：

server {
    listen 80;
    server_name your_domain_or_ip;

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

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

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

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

启用配置：

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

十、运行 Laravel 初始化

php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache

十一、配置 HTTPS（可选但强烈推荐）

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your_domain

十二、常见问题排查

✅ 500 错误

tail -f /var/www/laravel/storage/logs/laravel.log

✅ PHP 不解析

sudo systemctl status php8.2-fpm

✅ 权限问题

sudo chown -R www-data:www-data /var/www/laravel

十三、推荐生产优化

php artisan optimize
php artisan config:cache
php artisan route:cache

如果你需要：

✅ Docker 部署
✅ Laravel + Supervisor + 队列
✅ Debian + Apache
✅ CI/CD 自动部署

告诉我你的具体场景，我可以给你定制方案。