在 Ubuntu 上搭建 Docker 沙盒时很多新手都会碰到以下常见痛点：

• 程序缺少必要的依赖导致 Docker 安装失败。
• 使用 docker-compose 时出现语法错误，却找不到明确的报错定位。
• 容器之间的网络、端口冲突让调试变得异常困难。
• 敏感信息不慎提交到代码仓库，导致安全隐患。
• 生产环境与开发环境配置不统一，部署时频繁出错。

下面的操作参考从最基础的 docker-compose.yml 编写开始。帮助你一步步解决这些痛点，高效管理和部署容器。

一、第一个 docker-compose.yml一个经典的 Web 应用栈

我们将用一个 Nginx + PHP + MySQL 的示例来展示 Compose 的强大。创建一个新目录：

mkdir my-webapp && cd my-webapp
touch docker-compose.yml

基础版这方面，单个 Nginx 服务

先写一个最简版本。熟悉语法：

version: "3.9"
services:
说到web，image: nginx:alpine
ports这方面，- "8080:80"
volumes:
- ./html:/usr/share/nginx/html

• version: Compose 文件格式版本。
• services: 定义容器，这里只有一个叫 web 的服务。
• image: 使用的镜像。
• ports: 将宿主机端口 808080 端口，避免与程序已有服务冲突。
• volumes: 把当前目录下的 html 文件夹挂载到 Nginx 默认站点目录，实现本地编辑即时生效。

常见痛点提示：

• 端口被占用？ 先执行 sudo lsof -i:-8080 查看占用进程并调整端口。
• 挂载方法失效？话说回来， 确保宿主机目录已创建且拥有读取权限。

说到运行，

mkdir -p html
echo ""> html/index.html
docker compose up -d

访问  即可看到页面。

至于完整版，Nginx + PHP + MySQL

现在把示例 为完整的 LEMP 环境：

version: "3.9"
services:
# Nginx Web 服务器
再看web，image: nginx:alpine
ports的观点是，- "8080:80"
volumes:
- ./html:/var/www/html
- ./nginx.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php
- db
# PHP-FPM 处理动态请求
说到php，image: php:fpm-alpine
volumes:
- ./html:/var/www/html
# MySQL 数据库
再看db。image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: secret
MYSQL_DATABASE: myapp
MYSQL_USER: user
MYSQL_PASSWORD: pass
volumes:
- db_data:/var/lib/mysql
从ports来看，- "3306:3306"
volumes:
db_data:

关键概念提示：

• #depends_on# : 确保 Nginx 在 PHP 与 MySQL 启动后再启动，但不保证它们已经准备好接受请求。后面会介绍健康检查来解决此问题。
• #environment# : 将敏感信息写入环境变量时请务必使用 .env 文件管理，避免明文写在源码中。话说回来，
• #volumes# : 命名卷 用于持久化数据库数据。 即使容器删除也不会丢失，
• #nginx.conf# : 必须准备一个站点配置文件，放在项目根目录下否则默认站点会返回 404。

Nginx 配置示例 (nginx.conf）:

server {
listen 80;server_name localhost;root /var/www/html;index index.php index.html;location / {
try_files $uri $uri/ =404;}
location ~ \.php$ {
fastcgi_pass php:9000;# 注意这里 php 是服务名，端口是 PHP-FPM 默认端口
fastcgi_index index.php;include fastcgi_params;fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;}
}

说到启动整个栈，

docker compose up -d

二、如何高效管理和部署容器

常用 Compose 命令速查

/tbody> /table>

命令	作用
docker compose up -d	后台启动所有服务。
docker compose down	停止并删除容器、网络，但保留卷。
docker compose down -v	同时删除卷，实现彻底清理。按理说，
docker compose logs -f	实时查看所有日志。快速定位错误，
docker compose ps	查看服务状态及端口映射。
docker compose exec sh	进入某个服务容器内部进行调试。​
docker compose restart	重启所有服务，适用于修改了配置文件后立即生效。
docker compose build	如有自定义 Dockerfile 时重新建立镜像。
* 在实际使用中，把这些命令写进脚本或 Makefile 能进一步提高效率。

说到高效技巧，多环境差异化管理

AWS、阿里云等不同环境往往需要不同配置。推荐使用 多 Compose 文件 +

#="" 开发环境

docker compose –f docker‑compose.yml –f docker‑compose.override.yml up 

• docker‑compose.override.yml  默认会被自动加载；可在该文件中加入源码挂载、调试端口等开发专属设置。
• docker‑compose.prod.yml  用于生产。通常会限制资源、关闭热加载，并指定正式镜像标签。不过，

​​

使用 .env 管理敏感信息 – 痛点：密码硬编码导致安全事故

mysqlROOTPASSWORD=verysecret
MYSQLDATABASE=myapp
MYSQLUSER=user
MYSQL_PASSWORD=pass
/ code>/ pre>

---