1. 项目概述为什么选择Docker来搭建LNMP如果你是一名后端开发者、运维工程师或者正在学习Web开发那么“LNMP”这个组合对你来说一定不陌生。它代表了Linux、Nginx、MySQL和PHP是构建动态网站最经典、最稳定的技术栈之一。传统的LNMP环境搭建通常意味着我们需要在服务器上手动安装和配置这四大组件处理各种依赖、版本冲突和权限问题过程繁琐且容易出错一旦系统环境变化迁移和复现更是头疼。这正是Docker大显身手的地方。Docker通过容器化技术将应用及其所有依赖打包在一个独立的、可移植的“容器”中。对于LNMP环境搭建来说这意味着我们可以将Nginx、MySQL、PHP分别封装在独立的容器里它们彼此隔离互不干扰。你需要哪个版本的PHP7.4还是8.2直接拉取对应的镜像即可。想在同一台服务器上运行多个不同配置的项目容器间的网络和存储可以轻松隔离和管理。所以今天我要分享的就是如何在Linux系统下使用Docker从零开始搭建一个完整的LNMP环境并部署一个实际的PHP项目。整个过程我会拆解得非常细致从Docker的基本操作讲起到每个服务的容器化配置、容器间的网络通信、数据持久化最后完成项目的部署和访问。无论你是Docker新手还是有一定经验想寻求更佳实践这篇内容都能给你提供一条清晰的路径和许多实操中积累下来的细节技巧。2. 环境准备与Docker基础在开始搭建之前我们需要一个干净的Linux环境。我使用的是Ubuntu 22.04 LTS但CentOS、Debian等主流发行版的步骤也大同小异。核心是确保Docker能够正确安装和运行。2.1 Docker安装与验证首先我们需要安装Docker Engine。这里我推荐使用官方提供的安装脚本它比通过系统包管理器安装通常能获得更新的版本。打开终端执行以下命令来安装Docker# 1. 卸载旧版本如果存在 sudo apt-get remove docker docker-engine docker.io containerd runc # 2. 更新apt包索引并安装依赖 sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg lsb-release # 3. 添加Docker官方GPG密钥 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 4. 设置稳定版仓库 echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 5. 安装Docker Engine sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin安装完成后运行下面的命令来验证Docker是否安装成功并启动Docker服务# 启动Docker服务并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 验证安装运行hello-world镜像 sudo docker run hello-world如果看到“Hello from Docker!”等欢迎信息说明Docker已经安装并运行正常。为了后续操作方便避免每次都使用sudo可以将当前用户加入docker用户组sudo usermod -aG docker $USER执行此命令后你需要完全退出当前终端会话并重新登录或者新开一个终端窗口用户组变更才会生效。注意在生产环境中将用户加入docker组意味着该用户拥有了等同于root的权限因为容器可以挂载主机目录、操作网络等。在个人开发或测试环境这样做很方便但在多用户或生产服务器上需要仔细评估权限管理的策略。2.2 Docker核心概念与本次搭建的架构设计在动手之前快速理解几个核心概念这对理解我们后续的每一步操作至关重要镜像Image一个只读的模板包含了运行应用所需的代码、运行时、库、环境变量和配置文件。例如nginx:latest、mysql:8.0都是镜像。我们后续的操作就是基于这些镜像来创建容器。容器Container镜像的运行实例。你可以把它理解为一个轻量级的、隔离的虚拟机进程。我们将会运行Nginx容器、MySQL容器和PHP-FPM容器。Dockerfile一个文本文件包含了一系列指令用于构建一个自定义的镜像。虽然本次我们主要使用官方镜像但理解它有助于后续定制。Docker Compose一个用于定义和运行多容器Docker应用的工具。通过一个docker-compose.yml文件我们可以配置整个LNMP服务栈Nginx, MySQL, PHP以及它们之间的关系然后用一条命令启动所有服务。这是管理多容器项目的最佳实践我们将在核心环节使用它。本次LNMP Docker架构设计我们将采用“每个服务一个容器”的最佳实践MySQL容器运行MySQL数据库服务并创建一个数据卷Volume用于持久化存储数据库文件这样即使容器删除数据也不会丢失。PHP-FPM容器运行PHP-FPMFastCGI进程管理器服务负责处理PHP脚本。我们的项目代码将通过一个绑定挂载Bind Mount的方式放入此容器实现代码实时同步。Nginx容器运行Nginx Web服务器。它通过Docker网络与PHP-FPM容器通信将.php请求转发给PHP-FPM处理并通过绑定挂载共享项目代码目录用于读取静态文件和Nginx配置文件。三个容器通过Docker Compose定义的网络连接在一起形成一个内部私有的网络它们可以通过容器名称相互访问。项目代码和配置文件存放在宿主机上便于我们直接编辑。3. 核心环节使用Docker Compose编排LNMP手动用docker run命令一个个启动容器并配置网络和数据卷是可行的但非常繁琐且不易管理。Docker Compose是解决这个问题的标准答案。我们将创建一个docker-compose.yml文件来定义整个服务栈。首先为我们的项目创建一个工作目录并进入该目录mkdir -p ~/projects/docker-lnmp cd ~/projects/docker-lnmp然后创建并编辑docker-compose.yml文件vim docker-compose.yml将以下内容写入文件。我会逐段解释关键配置version: 3.8 services: # MySQL 数据库服务 mysql: image: mysql:8.0 container_name: lnmp-mysql restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: your_strong_root_password # 务必修改为强密码 MYSQL_DATABASE: myapp_db # 容器启动时自动创建的数据库 MYSQL_USER: myapp_user # 自动创建的用户 MYSQL_PASSWORD: your_user_password # 对应用户的密码 volumes: - mysql_data:/var/lib/mysql # 使用命名卷持久化数据库数据 - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql # 可选初始SQL脚本 networks: - lnmp-network ports: - 3306:3306 # 将宿主机的3306端口映射到容器的3306端口方便宿主机工具连接 # PHP-FPM 应用服务 php-fpm: image: php:8.2-fpm # 使用PHP 8.2的FPM版本 container_name: lnmp-php-fpm restart: unless-stopped working_dir: /var/www/html # 容器内的工作目录 volumes: - ./src:/var/www/html # 关键将宿主机项目代码目录挂载到容器内 - ./php/php.ini:/usr/local/etc/php/conf.d/custom.ini # 自定义PHP配置 depends_on: - mysql # 确保mysql服务先启动 networks: - lnmp-network # Nginx Web服务器 nginx: image: nginx:alpine # 使用轻量级的Alpine版本 container_name: lnmp-nginx restart: unless-stopped ports: - 80:80 # 将宿主机80端口映射到容器80端口 - 443:443 # 如果需要HTTPS映射443端口 volumes: - ./src:/var/www/html # 与php-fpm容器挂载相同的代码目录 - ./nginx/conf.d:/etc/nginx/conf.d # 挂载自定义的Nginx站点配置 - ./nginx/logs:/var/log/nginx # 挂载日志目录方便查看 depends_on: - php-fpm networks: - lnmp-network # 定义数据卷用于持久化MySQL数据 volumes: mysql_data: driver: local # 定义自定义网络让三个服务在同一个网络内互通 networks: lnmp-network: driver: bridge关键配置解析与注意事项版本与环境变量version: 3.8指定了Compose文件的语法版本。在mysql服务中我们通过environment设置了root密码、初始数据库和用户。这是安全的重灾区your_strong_root_password和your_user_password必须替换为你自己的、足够复杂的密码。切勿使用简单密码或提交到代码仓库。数据持久化Volumesmysql_data:/var/lib/mysql这是一个命名卷Named Volume。Docker会管理这个卷的存储位置即使lnmp-mysql容器被删除这个卷及其中的数据依然存在。下次启动新容器时挂载它数据就恢复了。这是持久化数据库数据的标准做法。./src:/var/www/html这是一个绑定挂载Bind Mount。它将宿主机的./src目录相对路径直接挂载到容器内的/var/www/html。这样我们在宿主机上编辑PHP代码容器内立即生效无需重建镜像极大方便了开发。./nginx/conf.d:/etc/nginx/conf.d同样使用绑定挂载让我们可以自定义Nginx的站点配置文件而无需进入容器内部修改。网络Networks我们创建了一个名为lnmp-network的自定义桥接网络。三个服务都加入了这个网络。在这个网络内部容器之间可以使用服务名service name作为主机名进行通信。例如在php-fpm容器中你可以直接使用mysql这个主机名连接到MySQL数据库连接地址就是mysql:3306这比使用动态分配的IP地址稳定得多。依赖与启动顺序depends_on指令确保了服务的启动顺序。php-fpm依赖于mysqlnginx依赖于php-fpm。这意味着Docker Compose会先启动mysql然后是php-fpm最后是nginx。但这仅代表容器启动顺序并不保证容器内的服务如MySQL已经完全初始化并准备好接受连接。对于需要等待数据库就绪的应用需要在应用层如PHP脚本或使用更高级的工具如wait-for-it脚本处理。4. 配置详解与项目部署实战配置文件是灵魂。现在我们来创建docker-compose.yml中引用的各个目录和配置文件。4.1 创建项目目录结构在docker-lnmp目录下执行以下命令创建所需的目录mkdir -p src nginx/conf.d nginx/logs php mysql创建后的目录树如下docker-lnmp/ ├── docker-compose.yml ├── src/ # 项目PHP代码存放处 ├── nginx/ │ ├── conf.d/ # Nginx站点配置文件 │ └── logs/ # Nginx日志目录 ├── php/ # PHP自定义配置 └── mysql/ # MySQL初始化脚本可选4.2 配置Nginx连接PHP-FPMNginx需要知道如何将PHP请求转发给PHP-FPM容器。我们在nginx/conf.d/目录下创建一个名为default.conf的配置文件vim nginx/conf.d/default.conf写入以下配置server { listen 80; server_name localhost; # 或你的域名 root /var/www/html; index index.php index.html index.htm; access_log /var/log/nginx/access.log; error_log /var/log/nginx/error.log; location / { try_files $uri $uri/ /index.php?$query_string; } # 关键配置将所有.php请求转发给php-fpm容器处理 location ~ \.php$ { fastcgi_pass php-fpm:9000; # 使用服务名“php-fpm”端口9000 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } # 禁止访问.htaccess等隐藏文件 location ~ /\.ht { deny all; } }配置核心解析fastcgi_pass php-fpm:9000;这是整个配置的灵魂。它告诉Nginx对于PHP请求应该转发到名为php-fpm的主机的9000端口。注意这里用的是我们在docker-compose.yml中定义的服务名php-fpm而不是IP地址。Docker的网络DNS解析会自动将服务名映射到对应容器的IP。fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;这个参数至关重要它告诉PHP-FPM要执行的文件路径。$document_root对应Nginx的root目录/var/www/html$fastcgi_script_name是请求的PHP文件名。两者拼接起来就是PHP文件在容器内的绝对路径。try_files $uri $uri/ /index.php?$query_string;这是一个常见的重写规则用于实现“前端控制器”模式如Laravel等框架将非静态文件请求都引导到index.php处理。4.3 配置PHP连接MySQL我们可能需要调整一些PHP设置比如时区、上传文件大小等。在php/目录下创建自定义配置文件vim php/php.ini写入一些常用配置; 设置时区 date.timezone Asia/Shanghai ; 调整内存限制和上传文件大小根据项目需要 memory_limit 256M upload_max_filesize 64M post_max_size 64M ; 开启错误日志开发环境建议开启生产环境关闭 display_errors On log_errors On error_log /var/log/php_errors.log这个文件会被挂载到PHP容器的/usr/local/etc/php/conf.d/custom.ini覆盖或追加默认的PHP配置。4.4 编写测试项目并连接数据库现在我们在src/目录下创建一个最简单的PHP项目来测试整个环境。首先创建信息探针文件src/info.php?php phpinfo();然后创建一个连接数据库的测试文件src/db_test.php?php header(Content-Type: text/html; charsetutf-8); // 使用Docker Compose中定义的服务名和端口连接MySQL $host mysql; // 对应 docker-compose.yml 中的服务名 $dbname myapp_db; // 对应我们环境变量中创建的数据库 $username myapp_user; $password your_user_password; // 替换为你在docker-compose.yml中设置的密码 try { $pdo new PDO(mysql:host$host;dbname$dbname;charsetutf8mb4, $username, $password); $pdo-setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); echo h2数据库连接成功/h2; // 尝试执行一个简单查询 $stmt $pdo-query(SELECT VERSION() as version); $result $stmt-fetch(PDO::FETCH_ASSOC); echo MySQL服务器版本: . $result[version] . br; // 创建一个测试表并插入数据 $pdo-exec(CREATE TABLE IF NOT EXISTS test_users ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100) NOT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP )); $pdo-exec(INSERT INTO test_users (name) VALUES (Docker LNMP Test User)); echo 测试数据插入成功br; // 查询并显示数据 $stmt $pdo-query(SELECT * FROM test_users); echo h3测试用户列表/h3; echo ul; while ($row $stmt-fetch(PDO::FETCH_ASSOC)) { echo liID: {$row[id]}, Name: {$row[name]}, Created: {$row[created_at]}/li; } echo /ul; } catch (PDOException $e) { die(h2数据库连接失败/h2 . $e-getMessage()); } ?关键点说明连接主机名$host mysql;这正是我们在docker-compose.yml中定义的MySQL服务名。Docker网络使得容器间可以通过服务名直接通信。数据库名、用户名和密码需要与docker-compose.yml中environment部分设置的环境变量一致。4.5 启动LNMP服务栈所有配置和代码准备就绪现在可以启动我们的Docker LNMP环境了。在docker-lnmp目录下运行docker-compose up -d-d参数代表“detached”模式让服务在后台运行。你会看到Docker开始拉取镜像如果本地没有然后创建网络、卷并依次启动三个容器。使用以下命令查看容器状态docker-compose ps如果一切正常你应该看到三个服务的状态都是“Up”。你也可以用docker logs lnmp-nginx等命令查看特定容器的日志。4.6 测试与访问打开你的浏览器访问以下地址测试Nginx与PHP访问http://你的服务器IP或localhost/info.php。你应该能看到标准的PHP信息页面其中“Server API”一项应该显示为“FPM/FastCGI”。这证明Nginx和PHP-FPM协同工作正常。测试数据库连接访问http://你的服务器IP或localhost/db_test.php。如果配置正确页面会显示“数据库连接成功”、MySQL版本号以及插入的测试数据。这证明PHP容器能够通过Docker网络成功连接到MySQL容器。至此一个基于Docker的完整LNMP开发/测试环境就已经搭建并运行成功了。你的项目PHP代码只需放在宿主机的src/目录下就能立即生效。5. 进阶配置、管理与问题排查基础环境跑起来只是第一步要让这个环境更健壮、更适合生产或团队协作还需要考虑更多细节。5.1 使用自定义Dockerfile构建PHP镜像官方php:8.2-fpm镜像很纯净但我们的项目通常需要安装额外的PHP扩展如pdo_mysql,gd,redis等。我们可以通过自定义Dockerfile来构建一个包含所需扩展的PHP镜像。在项目根目录创建Dockerfile# 使用官方PHP-FPM镜像作为基础 FROM php:8.2-fpm # 安装系统依赖和PHP扩展 RUN apt-get update apt-get install -y \ libpng-dev \ libjpeg-dev \ libfreetype6-dev \ libzip-dev \ zip \ unzip \ git \ curl \ docker-php-ext-configure gd --with-freetype --with-jpeg \ docker-php-ext-install -j$(nproc) \ pdo_mysql \ mysqli \ gd \ zip \ opcache \ apt-get clean rm -rf /var/lib/apt/lists/* # 安装ComposerPHP包管理工具 COPY --fromcomposer:latest /usr/bin/composer /usr/bin/composer # 设置工作目录 WORKDIR /var/www/html然后修改docker-compose.yml中的php-fpm服务不再使用image而是使用build上下文来构建镜像php-fpm: build: . # 使用当前目录下的Dockerfile构建 container_name: lnmp-php-fpm restart: unless-stopped # ... 其余配置保持不变之后运行docker-compose up -d --buildCompose会重新构建PHP镜像并启动服务。5.2 数据备份与迁移由于数据库数据持久化在名为mysql_data的Docker卷中备份和迁移变得非常清晰。备份你可以使用docker run命令启动一个临时MySQL容器连接到这个数据卷并执行mysqldump。docker run --rm -v mysql_data:/volume -v $(pwd):/backup alpine \ sh -c apk add --no-cache mysql-client mysqldump -h mysql -u myapp_user -pyour_user_password myapp_db /backup/backup_$(date %Y%m%d_%H%M%S).sql更简单的方式是直接进入MySQL容器执行备份docker exec lnmp-mysql mysqldump -u myapp_user -pyour_user_password myapp_db backup.sql迁移将整个项目迁移到新服务器只需要三步将项目目录docker-compose.yml,src/,nginx/,php/等拷贝到新服务器。在新服务器安装Docker和Docker Compose。在新服务器项目目录下运行docker-compose up -d。MySQL容器会自动创建新的空数据卷。如果需要恢复数据可以将备份的SQL文件放到mysql/目录下并在docker-compose.yml中配置挂载如我们之前注释掉的init.sql挂载或者启动后手动导入。5.3 常见问题与排查技巧实录在实际操作中你可能会遇到一些问题。这里记录一些常见坑点和排查思路。问题1访问info.php显示“File not found.” 或 空白页。排查思路检查文件路径首先进入Nginx容器确认文件是否存在。docker exec -it lnmp-nginx sh ls -la /var/www/html/info.php如果不存在说明宿主机src/目录到容器的挂载可能失败了。检查docker-compose.yml中Nginx和PHP-FPM服务的volumes配置路径是否正确。检查Nginx配置确认fastcgi_param SCRIPT_FILENAME设置正确。确保$document_root指向了正确的目录/var/www/html。检查PHP-FPM容器进入PHP-FPM容器查看PHP错误日志。docker exec -it lnmp-php-fpm bash tail -f /var/log/php_errors.log # 如果配置了的话或者查看Docker容器日志docker logs lnmp-php-fpm检查网络连通性在Nginx容器内尝试ping PHP-FPM服务。docker exec lnmp-nginx ping php-fpm如果ping不通检查docker-compose.yml中的networks配置确保所有服务都在同一个自定义网络下。问题2访问db_test.php显示数据库连接失败如“SQLSTATE[HY000] [2002] Connection refused”。排查思路确认MySQL容器是否运行正常docker-compose ps查看状态docker logs lnmp-mysql查看启动日志确认没有初始化错误。检查连接参数确认db_test.php中使用的host是服务名mysql端口是3306默认数据库名、用户名、密码与docker-compose.yml中的environment完全一致。特别注意密码中的特殊字符可能需要转义。从PHP容器内部测试连接进入PHP-FPM容器安装MySQL客户端并尝试连接。docker exec -it lnmp-php-fpm bash apt update apt install -y mysql-client # 如果镜像内没有的话 mysql -h mysql -u myapp_user -p输入密码看是否能连接成功。这能直接判断网络和认证是否有问题。检查MySQL用户权限有时需要确认创建的用户是否有从任意主机%连接的权限。可以在MySQL容器内登录root账户进行授权生产环境需谨慎docker exec -it lnmp-mysql mysql -uroot -p # 输入root密码后 GRANT ALL PRIVILEGES ON myapp_db.* TO myapp_user%; FLUSH PRIVILEGES;问题3修改了Nginx或PHP配置后不生效。排查思路重启服务修改宿主机上的配置文件后需要让容器内的服务重新加载配置。对于Nginxdocker exec lnmp-nginx nginx -s reload对于PHP-FPMdocker exec lnmp-php-fpm kill -USR2 1(发送信号给主进程) 或直接重启容器docker-compose restart php-fpm检查配置文件语法Nginx:docker exec lnmp-nginx nginx -tPHP: 重启时查看容器日志docker logs lnmp-php-fpm看是否有配置解析错误。确认挂载成功进入容器查看配置文件内容是否与宿主机一致。问题4Docker Compose up 时提示端口被占用。排查思路docker-compose.yml中ports映射将宿主机端口如803306映射到容器。如果宿主机上已有服务如本机ApacheMySQL占用了这些端口就会冲突。解决方案1停止宿主机上的冲突服务。解决方案2修改docker-compose.yml中的端口映射例如将80:80改为8080:80这样通过宿主机的8080端口访问容器内的80服务。一个实用的调试技巧使用docker-compose logs当服务出现问题时第一时间的日志是最重要的线索。使用以下命令可以查看所有服务的实时日志或者查看特定服务的日志# 查看所有服务的日志尾部 docker-compose logs # 查看特定服务如nginx的日志并实时刷新 docker-compose logs -f nginx # 查看从启动开始的所有日志 docker-compose logs --tailall6. 生产环境考量与优化建议上面搭建的环境非常适合本地开发和测试。但如果要用于生产环境还需要在安全、性能和监控方面做更多工作。6.1 安全加固使用非root用户运行容器默认情况下容器内的进程以root运行。可以在Dockerfile中使用USER指令或者在docker-compose.yml中使用user选项指定一个非root用户来运行进程。services: php-fpm: image: php:8.2-fpm user: 1000:1000 # 使用宿主机某个普通用户的UID和GID # ...限制容器资源在docker-compose.yml中为每个服务设置CPU和内存限制防止单个容器耗尽主机资源。services: mysql: # ... deploy: resources: limits: cpus: 1.0 memory: 1G reservations: cpus: 0.5 memory: 512M使用Secret管理敏感信息将数据库密码等敏感信息直接写在docker-compose.yml中是不安全的。Docker Swarm或Kubernetes提供了Secrets管理对于单机Docker可以考虑使用环境变量文件.env并确保该文件不被提交到版本控制系统。创建.env文件MYSQL_ROOT_PASSWORDyour_very_strong_password_here MYSQL_PASSWORDanother_strong_password在docker-compose.yml中引用environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}仅暴露必要端口生产环境中MySQL的3306端口不应映射到宿主机公网IP。可以移除ports中的3306:3306仅让MySQL在Docker内部网络中被访问。Web服务Nginx的80/443端口需要暴露。6.2 性能与可用性为PHP配置OPcacheOPcache可以极大提升PHP性能。确保在php.ini或自定义配置中启用并优化OPcache设置。Nginx缓存与优化根据项目类型配置Nginx的静态文件缓存、代理缓存等。使用更高效的存储驱动对于Linuxoverlay2是推荐的存储驱动。可以通过docker info查看。考虑使用Docker Swarm或Kubernetes对于需要高可用的生产环境单机Docker Compose不够。应该使用Docker Swarm或Kubernetes来编排容器实现服务发现、负载均衡、滚动更新和自愈。6.3 监控与日志集中式日志将Docker容器的日志收集到ELKElasticsearch, Logstash, Kibana或LokiGrafana等日志系统中便于统一查询和分析。容器监控使用cAdvisor、Prometheus和Grafana监控容器的资源使用情况CPU、内存、网络、磁盘IO。应用性能监控APM集成如New Relic、Datadog或开源的Pinpoint、SkyWalking等工具监控PHP应用内部的性能瓶颈。从手动安装配置到使用Docker Compose一键编排LNMP环境的搭建和维护方式发生了根本性的变化。容器化带来的隔离性、一致性和可移植性使得开发、测试和生产环境的高度统一成为可能也极大地简化了运维复杂度。虽然初始的配置需要一些学习成本但一旦掌握它所带来的效率提升和问题减少是巨大的。希望这篇详细的指南能帮助你顺利踏上Docker化部署之路。 Docker LNMP环境搭建：容器化部署PHP项目的完整实践指南
1. 项目概述为什么选择Docker来搭建LNMP如果你是一名后端开发者、运维工程师或者正在学习Web开发那么“LNMP”这个组合对你来说一定不陌生。它代表了Linux、Nginx、MySQL和PHP是构建动态网站最经典、最稳定的技术栈之一。传统的LNMP环境搭建通常意味着我们需要在服务器上手动安装和配置这四大组件处理各种依赖、版本冲突和权限问题过程繁琐且容易出错一旦系统环境变化迁移和复现更是头疼。这正是Docker大显身手的地方。Docker通过容器化技术将应用及其所有依赖打包在一个独立的、可移植的“容器”中。对于LNMP环境搭建来说这意味着我们可以将Nginx、MySQL、PHP分别封装在独立的容器里它们彼此隔离互不干扰。你需要哪个版本的PHP7.4还是8.2直接拉取对应的镜像即可。想在同一台服务器上运行多个不同配置的项目容器间的网络和存储可以轻松隔离和管理。所以今天我要分享的就是如何在Linux系统下使用Docker从零开始搭建一个完整的LNMP环境并部署一个实际的PHP项目。整个过程我会拆解得非常细致从Docker的基本操作讲起到每个服务的容器化配置、容器间的网络通信、数据持久化最后完成项目的部署和访问。无论你是Docker新手还是有一定经验想寻求更佳实践这篇内容都能给你提供一条清晰的路径和许多实操中积累下来的细节技巧。2. 环境准备与Docker基础在开始搭建之前我们需要一个干净的Linux环境。我使用的是Ubuntu 22.04 LTS但CentOS、Debian等主流发行版的步骤也大同小异。核心是确保Docker能够正确安装和运行。2.1 Docker安装与验证首先我们需要安装Docker Engine。这里我推荐使用官方提供的安装脚本它比通过系统包管理器安装通常能获得更新的版本。打开终端执行以下命令来安装Docker# 1. 卸载旧版本如果存在 sudo apt-get remove docker docker-engine docker.io containerd runc # 2. 更新apt包索引并安装依赖 sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg lsb-release # 3. 添加Docker官方GPG密钥 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 4. 设置稳定版仓库 echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 5. 安装Docker Engine sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin安装完成后运行下面的命令来验证Docker是否安装成功并启动Docker服务# 启动Docker服务并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 验证安装运行hello-world镜像 sudo docker run hello-world如果看到“Hello from Docker!”等欢迎信息说明Docker已经安装并运行正常。为了后续操作方便避免每次都使用sudo可以将当前用户加入docker用户组sudo usermod -aG docker $USER执行此命令后你需要完全退出当前终端会话并重新登录或者新开一个终端窗口用户组变更才会生效。注意在生产环境中将用户加入docker组意味着该用户拥有了等同于root的权限因为容器可以挂载主机目录、操作网络等。在个人开发或测试环境这样做很方便但在多用户或生产服务器上需要仔细评估权限管理的策略。2.2 Docker核心概念与本次搭建的架构设计在动手之前快速理解几个核心概念这对理解我们后续的每一步操作至关重要镜像Image一个只读的模板包含了运行应用所需的代码、运行时、库、环境变量和配置文件。例如nginx:latest、mysql:8.0都是镜像。我们后续的操作就是基于这些镜像来创建容器。容器Container镜像的运行实例。你可以把它理解为一个轻量级的、隔离的虚拟机进程。我们将会运行Nginx容器、MySQL容器和PHP-FPM容器。Dockerfile一个文本文件包含了一系列指令用于构建一个自定义的镜像。虽然本次我们主要使用官方镜像但理解它有助于后续定制。Docker Compose一个用于定义和运行多容器Docker应用的工具。通过一个docker-compose.yml文件我们可以配置整个LNMP服务栈Nginx, MySQL, PHP以及它们之间的关系然后用一条命令启动所有服务。这是管理多容器项目的最佳实践我们将在核心环节使用它。本次LNMP Docker架构设计我们将采用“每个服务一个容器”的最佳实践MySQL容器运行MySQL数据库服务并创建一个数据卷Volume用于持久化存储数据库文件这样即使容器删除数据也不会丢失。PHP-FPM容器运行PHP-FPMFastCGI进程管理器服务负责处理PHP脚本。我们的项目代码将通过一个绑定挂载Bind Mount的方式放入此容器实现代码实时同步。Nginx容器运行Nginx Web服务器。它通过Docker网络与PHP-FPM容器通信将.php请求转发给PHP-FPM处理并通过绑定挂载共享项目代码目录用于读取静态文件和Nginx配置文件。三个容器通过Docker Compose定义的网络连接在一起形成一个内部私有的网络它们可以通过容器名称相互访问。项目代码和配置文件存放在宿主机上便于我们直接编辑。3. 核心环节使用Docker Compose编排LNMP手动用docker run命令一个个启动容器并配置网络和数据卷是可行的但非常繁琐且不易管理。Docker Compose是解决这个问题的标准答案。我们将创建一个docker-compose.yml文件来定义整个服务栈。首先为我们的项目创建一个工作目录并进入该目录mkdir -p ~/projects/docker-lnmp cd ~/projects/docker-lnmp然后创建并编辑docker-compose.yml文件vim docker-compose.yml将以下内容写入文件。我会逐段解释关键配置version: 3.8 services: # MySQL 数据库服务 mysql: image: mysql:8.0 container_name: lnmp-mysql restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: your_strong_root_password # 务必修改为强密码 MYSQL_DATABASE: myapp_db # 容器启动时自动创建的数据库 MYSQL_USER: myapp_user # 自动创建的用户 MYSQL_PASSWORD: your_user_password # 对应用户的密码 volumes: - mysql_data:/var/lib/mysql # 使用命名卷持久化数据库数据 - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql # 可选初始SQL脚本 networks: - lnmp-network ports: - 3306:3306 # 将宿主机的3306端口映射到容器的3306端口方便宿主机工具连接 # PHP-FPM 应用服务 php-fpm: image: php:8.2-fpm # 使用PHP 8.2的FPM版本 container_name: lnmp-php-fpm restart: unless-stopped working_dir: /var/www/html # 容器内的工作目录 volumes: - ./src:/var/www/html # 关键将宿主机项目代码目录挂载到容器内 - ./php/php.ini:/usr/local/etc/php/conf.d/custom.ini # 自定义PHP配置 depends_on: - mysql # 确保mysql服务先启动 networks: - lnmp-network # Nginx Web服务器 nginx: image: nginx:alpine # 使用轻量级的Alpine版本 container_name: lnmp-nginx restart: unless-stopped ports: - 80:80 # 将宿主机80端口映射到容器80端口 - 443:443 # 如果需要HTTPS映射443端口 volumes: - ./src:/var/www/html # 与php-fpm容器挂载相同的代码目录 - ./nginx/conf.d:/etc/nginx/conf.d # 挂载自定义的Nginx站点配置 - ./nginx/logs:/var/log/nginx # 挂载日志目录方便查看 depends_on: - php-fpm networks: - lnmp-network # 定义数据卷用于持久化MySQL数据 volumes: mysql_data: driver: local # 定义自定义网络让三个服务在同一个网络内互通 networks: lnmp-network: driver: bridge关键配置解析与注意事项版本与环境变量version: 3.8指定了Compose文件的语法版本。在mysql服务中我们通过environment设置了root密码、初始数据库和用户。这是安全的重灾区your_strong_root_password和your_user_password必须替换为你自己的、足够复杂的密码。切勿使用简单密码或提交到代码仓库。数据持久化Volumesmysql_data:/var/lib/mysql这是一个命名卷Named Volume。Docker会管理这个卷的存储位置即使lnmp-mysql容器被删除这个卷及其中的数据依然存在。下次启动新容器时挂载它数据就恢复了。这是持久化数据库数据的标准做法。./src:/var/www/html这是一个绑定挂载Bind Mount。它将宿主机的./src目录相对路径直接挂载到容器内的/var/www/html。这样我们在宿主机上编辑PHP代码容器内立即生效无需重建镜像极大方便了开发。./nginx/conf.d:/etc/nginx/conf.d同样使用绑定挂载让我们可以自定义Nginx的站点配置文件而无需进入容器内部修改。网络Networks我们创建了一个名为lnmp-network的自定义桥接网络。三个服务都加入了这个网络。在这个网络内部容器之间可以使用服务名service name作为主机名进行通信。例如在php-fpm容器中你可以直接使用mysql这个主机名连接到MySQL数据库连接地址就是mysql:3306这比使用动态分配的IP地址稳定得多。依赖与启动顺序depends_on指令确保了服务的启动顺序。php-fpm依赖于mysqlnginx依赖于php-fpm。这意味着Docker Compose会先启动mysql然后是php-fpm最后是nginx。但这仅代表容器启动顺序并不保证容器内的服务如MySQL已经完全初始化并准备好接受连接。对于需要等待数据库就绪的应用需要在应用层如PHP脚本或使用更高级的工具如wait-for-it脚本处理。4. 配置详解与项目部署实战配置文件是灵魂。现在我们来创建docker-compose.yml中引用的各个目录和配置文件。4.1 创建项目目录结构在docker-lnmp目录下执行以下命令创建所需的目录mkdir -p src nginx/conf.d nginx/logs php mysql创建后的目录树如下docker-lnmp/ ├── docker-compose.yml ├── src/ # 项目PHP代码存放处 ├── nginx/ │ ├── conf.d/ # Nginx站点配置文件 │ └── logs/ # Nginx日志目录 ├── php/ # PHP自定义配置 └── mysql/ # MySQL初始化脚本可选4.2 配置Nginx连接PHP-FPMNginx需要知道如何将PHP请求转发给PHP-FPM容器。我们在nginx/conf.d/目录下创建一个名为default.conf的配置文件vim nginx/conf.d/default.conf写入以下配置server { listen 80; server_name localhost; # 或你的域名 root /var/www/html; index index.php index.html index.htm; access_log /var/log/nginx/access.log; error_log /var/log/nginx/error.log; location / { try_files $uri $uri/ /index.php?$query_string; } # 关键配置将所有.php请求转发给php-fpm容器处理 location ~ \.php$ { fastcgi_pass php-fpm:9000; # 使用服务名“php-fpm”端口9000 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } # 禁止访问.htaccess等隐藏文件 location ~ /\.ht { deny all; } }配置核心解析fastcgi_pass php-fpm:9000;这是整个配置的灵魂。它告诉Nginx对于PHP请求应该转发到名为php-fpm的主机的9000端口。注意这里用的是我们在docker-compose.yml中定义的服务名php-fpm而不是IP地址。Docker的网络DNS解析会自动将服务名映射到对应容器的IP。fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;这个参数至关重要它告诉PHP-FPM要执行的文件路径。$document_root对应Nginx的root目录/var/www/html$fastcgi_script_name是请求的PHP文件名。两者拼接起来就是PHP文件在容器内的绝对路径。try_files $uri $uri/ /index.php?$query_string;这是一个常见的重写规则用于实现“前端控制器”模式如Laravel等框架将非静态文件请求都引导到index.php处理。4.3 配置PHP连接MySQL我们可能需要调整一些PHP设置比如时区、上传文件大小等。在php/目录下创建自定义配置文件vim php/php.ini写入一些常用配置; 设置时区 date.timezone Asia/Shanghai ; 调整内存限制和上传文件大小根据项目需要 memory_limit 256M upload_max_filesize 64M post_max_size 64M ; 开启错误日志开发环境建议开启生产环境关闭 display_errors On log_errors On error_log /var/log/php_errors.log这个文件会被挂载到PHP容器的/usr/local/etc/php/conf.d/custom.ini覆盖或追加默认的PHP配置。4.4 编写测试项目并连接数据库现在我们在src/目录下创建一个最简单的PHP项目来测试整个环境。首先创建信息探针文件src/info.php?php phpinfo();然后创建一个连接数据库的测试文件src/db_test.php?php header(Content-Type: text/html; charsetutf-8); // 使用Docker Compose中定义的服务名和端口连接MySQL $host mysql; // 对应 docker-compose.yml 中的服务名 $dbname myapp_db; // 对应我们环境变量中创建的数据库 $username myapp_user; $password your_user_password; // 替换为你在docker-compose.yml中设置的密码 try { $pdo new PDO(mysql:host$host;dbname$dbname;charsetutf8mb4, $username, $password); $pdo-setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); echo h2数据库连接成功/h2; // 尝试执行一个简单查询 $stmt $pdo-query(SELECT VERSION() as version); $result $stmt-fetch(PDO::FETCH_ASSOC); echo MySQL服务器版本: . $result[version] . br; // 创建一个测试表并插入数据 $pdo-exec(CREATE TABLE IF NOT EXISTS test_users ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100) NOT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP )); $pdo-exec(INSERT INTO test_users (name) VALUES (Docker LNMP Test User)); echo 测试数据插入成功br; // 查询并显示数据 $stmt $pdo-query(SELECT * FROM test_users); echo h3测试用户列表/h3; echo ul; while ($row $stmt-fetch(PDO::FETCH_ASSOC)) { echo liID: {$row[id]}, Name: {$row[name]}, Created: {$row[created_at]}/li; } echo /ul; } catch (PDOException $e) { die(h2数据库连接失败/h2 . $e-getMessage()); } ?关键点说明连接主机名$host mysql;这正是我们在docker-compose.yml中定义的MySQL服务名。Docker网络使得容器间可以通过服务名直接通信。数据库名、用户名和密码需要与docker-compose.yml中environment部分设置的环境变量一致。4.5 启动LNMP服务栈所有配置和代码准备就绪现在可以启动我们的Docker LNMP环境了。在docker-lnmp目录下运行docker-compose up -d-d参数代表“detached”模式让服务在后台运行。你会看到Docker开始拉取镜像如果本地没有然后创建网络、卷并依次启动三个容器。使用以下命令查看容器状态docker-compose ps如果一切正常你应该看到三个服务的状态都是“Up”。你也可以用docker logs lnmp-nginx等命令查看特定容器的日志。4.6 测试与访问打开你的浏览器访问以下地址测试Nginx与PHP访问http://你的服务器IP或localhost/info.php。你应该能看到标准的PHP信息页面其中“Server API”一项应该显示为“FPM/FastCGI”。这证明Nginx和PHP-FPM协同工作正常。测试数据库连接访问http://你的服务器IP或localhost/db_test.php。如果配置正确页面会显示“数据库连接成功”、MySQL版本号以及插入的测试数据。这证明PHP容器能够通过Docker网络成功连接到MySQL容器。至此一个基于Docker的完整LNMP开发/测试环境就已经搭建并运行成功了。你的项目PHP代码只需放在宿主机的src/目录下就能立即生效。5. 进阶配置、管理与问题排查基础环境跑起来只是第一步要让这个环境更健壮、更适合生产或团队协作还需要考虑更多细节。5.1 使用自定义Dockerfile构建PHP镜像官方php:8.2-fpm镜像很纯净但我们的项目通常需要安装额外的PHP扩展如pdo_mysql,gd,redis等。我们可以通过自定义Dockerfile来构建一个包含所需扩展的PHP镜像。在项目根目录创建Dockerfile# 使用官方PHP-FPM镜像作为基础 FROM php:8.2-fpm # 安装系统依赖和PHP扩展 RUN apt-get update apt-get install -y \ libpng-dev \ libjpeg-dev \ libfreetype6-dev \ libzip-dev \ zip \ unzip \ git \ curl \ docker-php-ext-configure gd --with-freetype --with-jpeg \ docker-php-ext-install -j$(nproc) \ pdo_mysql \ mysqli \ gd \ zip \ opcache \ apt-get clean rm -rf /var/lib/apt/lists/* # 安装ComposerPHP包管理工具 COPY --fromcomposer:latest /usr/bin/composer /usr/bin/composer # 设置工作目录 WORKDIR /var/www/html然后修改docker-compose.yml中的php-fpm服务不再使用image而是使用build上下文来构建镜像php-fpm: build: . # 使用当前目录下的Dockerfile构建 container_name: lnmp-php-fpm restart: unless-stopped # ... 其余配置保持不变之后运行docker-compose up -d --buildCompose会重新构建PHP镜像并启动服务。5.2 数据备份与迁移由于数据库数据持久化在名为mysql_data的Docker卷中备份和迁移变得非常清晰。备份你可以使用docker run命令启动一个临时MySQL容器连接到这个数据卷并执行mysqldump。docker run --rm -v mysql_data:/volume -v $(pwd):/backup alpine \ sh -c apk add --no-cache mysql-client mysqldump -h mysql -u myapp_user -pyour_user_password myapp_db /backup/backup_$(date %Y%m%d_%H%M%S).sql更简单的方式是直接进入MySQL容器执行备份docker exec lnmp-mysql mysqldump -u myapp_user -pyour_user_password myapp_db backup.sql迁移将整个项目迁移到新服务器只需要三步将项目目录docker-compose.yml,src/,nginx/,php/等拷贝到新服务器。在新服务器安装Docker和Docker Compose。在新服务器项目目录下运行docker-compose up -d。MySQL容器会自动创建新的空数据卷。如果需要恢复数据可以将备份的SQL文件放到mysql/目录下并在docker-compose.yml中配置挂载如我们之前注释掉的init.sql挂载或者启动后手动导入。5.3 常见问题与排查技巧实录在实际操作中你可能会遇到一些问题。这里记录一些常见坑点和排查思路。问题1访问info.php显示“File not found.” 或 空白页。排查思路检查文件路径首先进入Nginx容器确认文件是否存在。docker exec -it lnmp-nginx sh ls -la /var/www/html/info.php如果不存在说明宿主机src/目录到容器的挂载可能失败了。检查docker-compose.yml中Nginx和PHP-FPM服务的volumes配置路径是否正确。检查Nginx配置确认fastcgi_param SCRIPT_FILENAME设置正确。确保$document_root指向了正确的目录/var/www/html。检查PHP-FPM容器进入PHP-FPM容器查看PHP错误日志。docker exec -it lnmp-php-fpm bash tail -f /var/log/php_errors.log # 如果配置了的话或者查看Docker容器日志docker logs lnmp-php-fpm检查网络连通性在Nginx容器内尝试ping PHP-FPM服务。docker exec lnmp-nginx ping php-fpm如果ping不通检查docker-compose.yml中的networks配置确保所有服务都在同一个自定义网络下。问题2访问db_test.php显示数据库连接失败如“SQLSTATE[HY000] [2002] Connection refused”。排查思路确认MySQL容器是否运行正常docker-compose ps查看状态docker logs lnmp-mysql查看启动日志确认没有初始化错误。检查连接参数确认db_test.php中使用的host是服务名mysql端口是3306默认数据库名、用户名、密码与docker-compose.yml中的environment完全一致。特别注意密码中的特殊字符可能需要转义。从PHP容器内部测试连接进入PHP-FPM容器安装MySQL客户端并尝试连接。docker exec -it lnmp-php-fpm bash apt update apt install -y mysql-client # 如果镜像内没有的话 mysql -h mysql -u myapp_user -p输入密码看是否能连接成功。这能直接判断网络和认证是否有问题。检查MySQL用户权限有时需要确认创建的用户是否有从任意主机%连接的权限。可以在MySQL容器内登录root账户进行授权生产环境需谨慎docker exec -it lnmp-mysql mysql -uroot -p # 输入root密码后 GRANT ALL PRIVILEGES ON myapp_db.* TO myapp_user%; FLUSH PRIVILEGES;问题3修改了Nginx或PHP配置后不生效。排查思路重启服务修改宿主机上的配置文件后需要让容器内的服务重新加载配置。对于Nginxdocker exec lnmp-nginx nginx -s reload对于PHP-FPMdocker exec lnmp-php-fpm kill -USR2 1(发送信号给主进程) 或直接重启容器docker-compose restart php-fpm检查配置文件语法Nginx:docker exec lnmp-nginx nginx -tPHP: 重启时查看容器日志docker logs lnmp-php-fpm看是否有配置解析错误。确认挂载成功进入容器查看配置文件内容是否与宿主机一致。问题4Docker Compose up 时提示端口被占用。排查思路docker-compose.yml中ports映射将宿主机端口如803306映射到容器。如果宿主机上已有服务如本机ApacheMySQL占用了这些端口就会冲突。解决方案1停止宿主机上的冲突服务。解决方案2修改docker-compose.yml中的端口映射例如将80:80改为8080:80这样通过宿主机的8080端口访问容器内的80服务。一个实用的调试技巧使用docker-compose logs当服务出现问题时第一时间的日志是最重要的线索。使用以下命令可以查看所有服务的实时日志或者查看特定服务的日志# 查看所有服务的日志尾部 docker-compose logs # 查看特定服务如nginx的日志并实时刷新 docker-compose logs -f nginx # 查看从启动开始的所有日志 docker-compose logs --tailall6. 生产环境考量与优化建议上面搭建的环境非常适合本地开发和测试。但如果要用于生产环境还需要在安全、性能和监控方面做更多工作。6.1 安全加固使用非root用户运行容器默认情况下容器内的进程以root运行。可以在Dockerfile中使用USER指令或者在docker-compose.yml中使用user选项指定一个非root用户来运行进程。services: php-fpm: image: php:8.2-fpm user: 1000:1000 # 使用宿主机某个普通用户的UID和GID # ...限制容器资源在docker-compose.yml中为每个服务设置CPU和内存限制防止单个容器耗尽主机资源。services: mysql: # ... deploy: resources: limits: cpus: 1.0 memory: 1G reservations: cpus: 0.5 memory: 512M使用Secret管理敏感信息将数据库密码等敏感信息直接写在docker-compose.yml中是不安全的。Docker Swarm或Kubernetes提供了Secrets管理对于单机Docker可以考虑使用环境变量文件.env并确保该文件不被提交到版本控制系统。创建.env文件MYSQL_ROOT_PASSWORDyour_very_strong_password_here MYSQL_PASSWORDanother_strong_password在docker-compose.yml中引用environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}仅暴露必要端口生产环境中MySQL的3306端口不应映射到宿主机公网IP。可以移除ports中的3306:3306仅让MySQL在Docker内部网络中被访问。Web服务Nginx的80/443端口需要暴露。6.2 性能与可用性为PHP配置OPcacheOPcache可以极大提升PHP性能。确保在php.ini或自定义配置中启用并优化OPcache设置。Nginx缓存与优化根据项目类型配置Nginx的静态文件缓存、代理缓存等。使用更高效的存储驱动对于Linuxoverlay2是推荐的存储驱动。可以通过docker info查看。考虑使用Docker Swarm或Kubernetes对于需要高可用的生产环境单机Docker Compose不够。应该使用Docker Swarm或Kubernetes来编排容器实现服务发现、负载均衡、滚动更新和自愈。6.3 监控与日志集中式日志将Docker容器的日志收集到ELKElasticsearch, Logstash, Kibana或LokiGrafana等日志系统中便于统一查询和分析。容器监控使用cAdvisor、Prometheus和Grafana监控容器的资源使用情况CPU、内存、网络、磁盘IO。应用性能监控APM集成如New Relic、Datadog或开源的Pinpoint、SkyWalking等工具监控PHP应用内部的性能瓶颈。从手动安装配置到使用Docker Compose一键编排LNMP环境的搭建和维护方式发生了根本性的变化。容器化带来的隔离性、一致性和可移植性使得开发、测试和生产环境的高度统一成为可能也极大地简化了运维复杂度。虽然初始的配置需要一些学习成本但一旦掌握它所带来的效率提升和问题减少是巨大的。希望这篇详细的指南能帮助你顺利踏上Docker化部署之路。