怎样部署laravel到debian

下面给你一套在 Debian（如 Debian 11 / 12）上部署 Laravel 项目的常见、稳妥方案，从零开始，适合生产环境。

一、服务器基础准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装必要软件

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

如果是 Laravel 10/11，建议 PHP 8.1+

二、安装数据库（可选 MySQL / MariaDB）

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 项目

1. 上传或克隆代码

cd /var/www
git clone your-repo.git laravel
cd laravel

2. 安装依赖

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

3. 配置环境

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

编辑 .env：

APP_ENV=production
APP_DEBUG=false
DB_DATABASE=laravel_db
DB_USERNAME=laravel
DB_PASSWORD=password

4. 权限设置（重要）

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

四、配置 Nginx

新建配置文件：

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

示例配置：

server {
    listen 80;
    server_name yourdomain.com;

    root /var/www/laravel/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    index index.php;

    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 ~ /\.(?!well-known).* {
        deny all;
    }
}

启用站点：

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

五、运行 Laravel 优化命令

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

六、可选但强烈推荐

1. 配置 HTTPS（Let’s Encrypt）

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

2. 队列 / 定时任务

crontab -e

* * * * * php /var/www/laravel/artisan schedule:run >> /dev/null 2>&1

队列：

php artisan queue:work

（建议用 supervisor）

七、常见问题排查

• 500 错误：检查 storage 权限
• 404：Nginx root 是否指向 public
• 502：php-fpm 是否运行
• Composer 内存不足：

COMPOSER_MEMORY_LIMIT=-1 composer install

如果你愿意，我可以：

• 给你 一步一步命令版
• 帮你写 systemd / supervisor 配置
• 或针对 Docker / 宝塔 / 云服务器 给你方案

你现在是 本地 Debian 还是云服务器？Laravel 几版本？