Mac 上搭建 Docker Compose 并部署应用实战

启动前确保当前用户身份正确，防止生成 root 文件：

cd ~/apps/n8n
export UID && export GID
docker compose up -d
docker compose logs -f

访问地址：http://localhost:5678

示例二：Web + Postgres 典型组合

在 ~/apps/webstack/ 下新建 .env 和 docker-compose.yml。

.env 配置：

POSTGRES_PASSWORD=secret123
POSTGRES_DB=appdb
POSTGRES_USER=appuser
TZ=Asia/Shanghai

docker-compose.yml：

services:
  db:
    image: postgres:16
    container_name: webstack-db
    environment:
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_DB=${POSTGRES_DB}
      - TZ=${TZ}
    volumes:
      - ./pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER"]
      interval: 5s
      timeout: 3s
      retries: 10
    restart: unless-stopped

  web:
    image: nginx:alpine
    container_name: webstack-web
    ports:
      - "8080:80"
    volumes:
      - ./site:/usr/share/nginx/html:ro
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

初始化并启动：

mkdir -p ~/apps/webstack/site ~/apps/webstack/pgdata
echo "<h1>Hello from Nginx</h1>" > ~/apps/webstack/site/index.html
cd ~/apps/webstack
docker compose --env-file .env up -d

访问：http://localhost:8080

常用操作速查

# 查看运行中容器
docker ps

# 查看项目服务状态
docker compose ps

# 实时查看日志
docker compose logs -f

# 指定服务日志
docker compose logs -f web

# 构建镜像
docker compose build

# 停止并删除容器（保留数据卷）
docker compose down

# 连带数据卷一起删除（慎用）
docker compose down -v

Apple Silicon 特别提示

• 优先选择支持多架构的镜像（带 linux/arm64）。
• 遇到仅支持 x86_64 的镜像：
  • Docker Desktop：设置里开启 Use Rosetta for x86/amd64 emulation。
• 自建镜像建议用 buildx 输出多架构包：

docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t your/repo:tag --push

或者手动拉取指定平台：

docker pull --platform=linux/amd64 someimage:tag
docker run --platform=linux/amd64 ...

生产化建议

• 反向代理：使用 Traefik 或 Nginx 作为网关，按域名路由并自动管理 HTTPS 证书。
• 数据持久化：数据库和应用数据务必映射到宿主机目录，纳入备份计划。
• 环境变量：敏感信息放入 .env，切勿提交到代码仓库。

常见问题排查

• 卷权限问题：挂载到用户目录；必要时在服务中指定 user: "${UID}:${GID}"。
• 端口占用：修改映射端口，如 "8081:80"。
• 架构不匹配：显式指定 --platform 或启用 Rosetta。
• 文件共享失败：在 Docker Desktop 设置 → Resources → File Sharing 中添加工程目录。