如何用debian搭建laravel服务

下面给你一份在 Debian 上从零搭建 Laravel 服务的实用流程（以 Debian 12 + Nginx + PHP-FPM + MySQL 为例，适合生产/测试环境）。

一、系统准备

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget git unzip

二、安装 Nginx

sudo apt install -y nginx
sudo systemctl enable --now nginx

测试：

curl http://localhost

三、安装 PHP（Laravel 所需）

以 PHP 8.2 为例（Laravel 10/11 推荐）

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

检查：

php -v

四、安装 Composer

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

五、安装 MySQL（或 MariaDB）

sudo apt install -y mysql-server
sudo systemctl enable --now mysql

初始化安全设置：

sudo mysql_secure_installation

创建数据库：

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

六、部署 Laravel 项目

1️⃣ 新建项目（或拉取代码）

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

或修改目录权限：

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

2️⃣ 配置 .env

cd /var/www/example-app
cp .env.example .env
php artisan key:generate

修改数据库配置：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=laravel
DB_PASSWORD=password

3️⃣ 数据库迁移（可选）

php artisan migrate

七、配置 Nginx 虚拟主机

创建配置文件：

sudo nano /etc/nginx/sites-available/example-app

内容示例：

server {
    listen 80;
    server_name example.com;

    root /var/www/example-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/example-app /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

八、设置权限（重要）

sudo chown -R www-data:www-data /var/www/example-app/storage
sudo chown -R www-data:www-data /var/www/example-app/bootstrap/cache

九、配置队列 / 定时（可选）

队列

php artisan queue:work

生产建议用 supervisor 守护。

定时任务

crontab -e

* * * * * cd /var/www/example-app && php artisan schedule:run >> /dev/null 2>&1

十、HTTPS（强烈推荐）

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

常见问题

✅ 500 错误 → 查看 storage/logs/laravel.log
✅ 权限问题 → www-data 用户
✅ 白屏 → php artisan config:clear

如果你愿意，我可以：

• 给你 Docker 版 Laravel
• 讲 Laravel + Octane / Swoole
• 或针对 Debian 11 / ARM 服务器 调整方案

你打算用于 开发还是生产环境？