下面给你一份在 Debian 上部署 Laravel 项目的常见、实用方案,适合生产环境,步骤清晰,适合新手到中等水平。
以 Debian 11 / 12 为例。
sudo apt update
sudo apt upgrade -y
sudo apt install nginx -y
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
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;
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version
推荐目录:
/var/www/laravel
cd /var/www
git clone your_repo laravel
# 或 scp / rsync 上传
cd /var/www/laravel
composer install --optimize-autoloader --no-dev
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
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
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan migrate --force
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
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
如果你愿意,我可以:
你现在是 学习 / 生产 / 服务器配置到哪一步了?