Debian下Laravel如何部署

在 Debian 系统上部署 Laravel 项目，通常包含以下步骤。下面以 Debian 11/12 + Nginx + PHP + MySQL 为例，给你一套生产环境常用方案。

一、准备环境

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.1 / 8.2）

1. 添加 PHP 源（可选，Debian 12 自带 8.2）

sudo apt install -y lsb-release apt-transport-https ca-certificates
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

2. 安装 PHP 及必备扩展

sudo apt install 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-bcmath -y

检查状态：

sudo systemctl status php8.2-fpm

四、安装数据库（MySQL / MariaDB）

1. 安装 MySQL

sudo apt install mysql-server -y
sudo mysql_secure_installation

2. 创建数据库

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

五、部署 Laravel 项目

1. 安装 Composer

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

2. 上传或拉取 Laravel 项目

方式一：Git 拉取（推荐）

cd /var/www
sudo git clone https://github.com/yourname/laravel-project.git
sudo chown -R www-data:www-data laravel-project

方式二：上传 zip

cd /var/www
unzip laravel-project.zip

3. 安装依赖

cd /var/www/laravel-project
composer install --no-dev --optimize-autoloader

六、配置 Laravel 环境

1. 配置 .env

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

编辑数据库配置：

DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=password

2. 设置权限（非常重要）

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

3. 数据库迁移

php artisan migrate --force

（如有 seed）

php artisan db:seed --force

七、配置 Nginx

示例 Nginx 配置

server {
    listen 80;
    server_name yourdomain.com;

    root /var/www/laravel-project/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/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

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

启用配置：

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

八、设置 HTTPS（可选但强烈推荐）

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com

九、优化 Laravel（生产环境）

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

十、常见问题排查

1. 500 错误

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

2. 权限问题

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

3. PHP 版本不匹配

php -v
composer show laravel/framework

十一、可选增强

• ✅ 使用 Supervisor 管理队列
• ✅ 使用 Redis 做缓存
• ✅ 使用 Docker 部署
• ✅ 使用 GitHub Actions 自动部署

如果你愿意，我可以：

• ✅ 给你 Debian + Docker 部署方案
• ✅ 帮你写 完整部署脚本
• ✅ 针对 Laravel 10 / 11 单独说明

只要告诉我你的 Laravel 版本和 Debian 版本 即可。