如何用debian部署laravel

下面给你一个在 Debian（以 Debian 11/12 为例）上部署 Laravel 的完整思路，包含 环境准备 → 安装 → 配置 → 运行 → 生产建议。你可以按需选择 Nginx + PHP-FPM（最常用）。

一、系统准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装必要工具

sudo apt install -y curl git unzip wget ca-certificates lsb-release

二、安装 PHP（Laravel 需要）

1. 添加 Sury PHP 源（推荐）

sudo apt install -y lsb-release apt-transport-https ca-certificates curl
sudo curl -sSL https://packages.sury.org/php/README.txt

（或直接执行）

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 及扩展（以 PHP 8.2 为例）

sudo apt install -y php8.2 php8.2-cli php8.2-fpm \
php8.2-mysql php8.2-pgsql php8.2-sqlite3 \
php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip php8.2-gd php8.2-intl

验证：

php -v

三、安装 Composer

cd /tmp
curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer --version

四、安装数据库（可选）

MySQL

sudo apt install -y mariadb-server
sudo mysql_secure_installation

创建数据库：

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

五、部署 Laravel 项目

方式一：新建项目

cd /var/www
sudo composer create-project laravel/laravel app

方式二：上传已有项目

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

六、配置 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
DB_USERNAME=laravel
DB_PASSWORD=password

权限设置：

sudo chown -R www-data:www-data /var/www/app
sudo chmod -R 755 /var/www/app
sudo chmod -R 775 /var/www/app/storage

七、配置 Nginx

安装 Nginx

sudo apt install -y nginx

配置文件

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

示例：

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

    root /var/www/app/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;
    }

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

启用：

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

八、运行 Laravel

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

访问：

http://your-domain.com

九、生产环境建议（重要）

✅ 使用 HTTPS（Let’s Encrypt）

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx

✅ 设置队列（如用队列）

php artisan queue:work

✅ 使用 Supervisor 管理进程

✅ 关闭调试模式

APP_DEBUG=false

十、常见错误排查

500 错误：检查 storage 权限
502：PHP-FPM 未启动或 sock 路径错误
404：Nginx rewrite 配置错误

如果你愿意，我可以：

给你 Debian + Docker 部署 Laravel
给你 Laravel + Supervisor + Queue 完整方案
或针对 你的 Debian 版本 / Laravel 版本 精确调整

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