温馨提示×

laravel在debian怎部署

小樊
36
2026-09-08 07:00:36
栏目: 智能运维

下面给你一份在 Debian 上部署 Laravel 项目的常见、实用方案,适合生产环境,步骤清晰,适合新手到中等水平。


一、环境准备(Debian)

Debian 11 / 12 为例。

1. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装运行环境

方案选择

  • Nginx + PHP-FPM + MySQL(最常用)
  • Apache 也可,但 Nginx 更推荐

2. 安装 Nginx

sudo apt install nginx -y

3. 安装 PHP(以 PHP 8.2 为例)

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

添加 Sury PHP 源:

sudo apt install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

安装 PHP:

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

4. 安装 MySQL(可选)

sudo apt install mysql-server -y
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;

5. 安装 Composer

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

三、部署 Laravel 项目

6. 上传代码

推荐目录:

/var/www/laravel
cd /var/www
git clone your_repo laravel
# 或 scp / rsync 上传

7. 安装依赖

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

8. 配置环境

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

编辑 .env

APP_ENV=production
APP_DEBUG=false
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=laravel_db
DB_USERNAME=laravel
DB_PASSWORD=password

9. 权限设置(重要)

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

10. 优化 Laravel

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

四、配置 Nginx

11. 创建站点配置

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

示例:

server {
    listen 80;
    server_name example.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/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

五、配置 HTTPS(强烈推荐)

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

六、队列 / 定时任务(可选)

队列

php artisan queue:work

生产建议用 supervisor:

sudo apt install supervisor

定时任务

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

七、常见坑提醒

APP_DEBUG=false
✅ storage 可写
✅ PHP 版本匹配 Laravel
✅ Nginx root 指向 public


如果你愿意,我可以:

  • 给你 Docker 部署方案
  • 给你 Laravel + PM2 / Octane
  • 给你 一键部署脚本

你现在是 学习 / 生产 / 服务器配置到哪一步了?

0