个人技术博客

标签： Docker

  • 用 Docker Compose 管理一组长期运行的服务

    整理说明：本文属于“2025-2026 技术笔记整理”系列，于 2026 年 8 月集中整理并公开发布。

    用 Docker Compose 管理 WordPress 服务栈

    当站点同时依赖 WordPress、数据库和反向代理时，逐个启动容器容易遗漏网络、存储或参数。Docker Compose 把这些约束写进 compose.yaml，让部署和维护使用同一套声明。

    先读懂编排文件

    services 定义组件；同一 Compose 网络中的容器可用服务名通信，例如 WordPress 通过 database:3306 访问数据库。volumes 保存持久数据，secrets 以文件形式挂载敏感值，profiles 可放置仅在维护时启动的工具。

    • restart: unless-stopped 可在异常退出或主机重启后恢复服务，但不能替代监控。
    • depends_on 只表达依赖关系；需要等待数据库真正可用时，应配合健康检查和 service_healthy 条件。
    • 数据库可只加入内部网络，减少不必要的端口暴露。
    services:
  wordpress:
    depends_on:
      database:
        condition: service_healthy
    volumes:
      - wordpress_data:/var/www/html

    启动前检查，启动后观察

    修改 YAML 后先运行配置渲染命令，它会合并环境变量和覆盖文件，并及早发现缩进、字段或变量问题。确认结果无误后再后台启动：

    docker compose config
docker compose up -d
docker compose ps
docker compose logs -f --tail=100

    ps 检查运行和健康状态，logs 用于追踪故障。在运行中的容器执行诊断可用 docker compose exec wordpress php -v；带 profile 的工具服务可用 docker compose --profile tools run --rm wpcli ... 临时启动。

    更新、暂停与清理

    更新时先运行 docker compose pull，再执行 docker compose up -d。Compose 会重建需要变化的容器，命名卷不会因此消失。操作前仍应备份，完成后检查日志和站点；镜像标签应按维护策略固定。

    • stop 停止服务但保留容器，start 可原样恢复。
    • restart 只重启现有容器，不会把新 YAML 配置应用进去。
    • down 删除容器和项目网络，默认保留命名卷。
    • down -v 会删除命名卷，可能清空站点与数据库，不能作为普通重启命令。

    应把 config、备份、启动、健康检查和日志复核固化为操作顺序。Compose 让环境可重复，数据保护和上线验证仍需明确流程。

  • WordPress 容器化部署中的数据持久化与备份

    整理说明：本文属于“2025-2026 技术笔记整理”系列，于 2026 年 8 月集中整理并公开发布。

    WordPress 容器的数据持久化与可恢复备份

    容器可以重建，但数据不能随可写层消失。WordPress 状态包括数据库中的文章、用户和配置，以及文件系统中的上传、主题、插件与运行配置。只备份一类无法恢复完整站点。

    把数据放到容器之外

    WordPress 站点目录通常是 /var/www/html，MariaDB 数据目录是 /var/lib/mysql。为它们挂载命名卷，容器替换后仍可挂载原数据：

    services:
  database:
    volumes:
      - database_data:/var/lib/mysql
  wordpress:
    volumes:
      - wordpress_data:/var/www/html

volumes:
  database_data:
  wordpress_data:

    命名卷由 Docker 管理。docker compose down 默认保留它们，docker compose down -v 则会删除项目命名卷。卷并非备份：磁盘损坏、误删和错误写入仍会影响数据。

    分别导出数据库和站点文件

    数据库应使用自身的逻辑导出工具备份，不能在运行中直接复制 /var/lib/mysql。以下命令从挂载的密码文件读取凭据，并把 SQL 输出到主机；备份目录应提前创建并限制权限：

    docker compose exec -T database sh -c \
  'mariadb-dump --single-transaction --quick \
  -u"$MARIADB_USER" -p"$(cat "$MARIADB_PASSWORD_FILE")" \
  "$MARIADB_DATABASE"' > backup/wordpress.sql

docker compose exec -T wordpress \
  tar -C /var/www/html -czf - . \
  > backup/wordpress-files.tar.gz

    -T 关闭伪终端，避免混入控制内容。--single-transaction 为事务表提供一致性快照；存在非事务表或结构变更时应安排维护窗口。文件与数据库应同期备份，减少附件不匹配。

    备份完成不等于可以恢复

    • 为文件名加入时间标识，记录对应的 Compose 配置、镜像标签和恢复说明。
    • 将备份复制到另一台主机或对象存储，不要只放在原服务器磁盘。
    • 对归档和 SQL 计算校验值，备份任务失败时应产生告警。
    • 密码和密钥应单独加密保管，避免明文秘密混进普通归档。

    恢复时先阻止写入，在干净卷还原文件并导入数据库，再核对域名、媒体、登录和插件。演练应在隔离环境执行；只有完成关键操作，才能证明备份有效。生产站点还应明确恢复时间和可接受的数据丢失范围。

  • Ubuntu UFW 与 Docker 端口暴露的安全边界

    整理说明：本文属于“2025-2026 技术笔记整理”系列，于 2026 年 8 月集中整理并公开发布。

    先分清主机入站与容器转发

    在 Ubuntu 上把 UFW 设为默认拒绝入站，并不等于 Docker 发布的端口也会自动被拒绝。执行 docker run -p 8080:80 或在 Compose 中写入 ports 后，Docker 会为目标端口建立地址转换和转发规则。典型的 iptables 后端中，外部数据包经过 DNAT 后进入转发路径，而 UFW 常见的入站规则主要作用于主机的 INPUT 链。因此，ufw status 没有放行 8080，外部仍可能访问容器。

    把暴露范围写进部署配置

    最可靠的第一步不是补一条拦截规则，而是避免发布不需要的端口。应用与数据库可加入同一个 Docker 网络，通过服务名通信；Compose 的 expose 只声明容器网络中的端口，不会把端口发布到主机。只需要由本机反向代理访问的服务，应绑定回环地址：

    services:
  app:
    ports:
      - "127.0.0.1:8080:80"
  db:
    expose:
      - "3306"

    对公网服务只发布反向代理的 80 和 443；SSH、数据库、管理面板等端口按来源地址限制。未指定主机地址的 8080:80 通常会绑定所有主机地址，不能把“容器里只监听一个端口”理解为“只有本机能访问”。IPv4 与 IPv6 也要分别核对。

    用三组视角核对实际边界

    sudo ufw status numbered
docker ps --format 'table {{.Names}}\t{{.Ports}}'
sudo ss -lntup
sudo iptables -S DOCKER-USER

    ufw status 展示主机策略，docker ps 展示发布映射，ss 展示主机监听；三者必须结合外部机器的连接测试。不要只在服务器本机执行 curl localhost，因为它无法证明公网边界是否正确。

    确需过滤已发布端口时

    使用 Docker iptables 后端时，可在 DOCKER-USER 链加入转发前置策略，或把等价规则纳入经过验证的 UFW 扩展配置。该链看到的目标通常已经完成 DNAT，匹配的是容器地址和容器端口；若要匹配发布前的原始目标，需要 conntrack 条件。规则还应明确公网接口、允许来源、已建立连接和 IPv6 行为，并配置持久化，不能只临时执行一次命令。

    • 优先取消发布，或绑定 127.0.0.1。
    • 只让反向代理进入应用网络，不发布数据库端口。
    • 变更后从允许与不允许的外部来源各测试一次。
    • 升级 Docker、防火墙后重新检查规则顺序与实际端口。

    安全边界应由“监听地址、Docker 网络、转发规则、UFW 主机规则”共同定义。只依赖其中一层，最容易在重建容器或新增端口时产生意外暴露。

  • 轻量服务器上的 Docker 资源监控与故障排查

    整理说明：本文属于“2025-2026 技术笔记整理”系列，于 2026 年 8 月集中整理并公开发布。

    轻量监控先回答三个问题

    小型服务器不一定需要完整的指标平台，但必须持续知道容器是否存活、资源是否接近边界、服务是否真的可用。Docker 的运行状态只能回答进程有没有退出；CPU、内存和磁盘反映压力；HTTP、数据库连接等探测才反映业务可用性。把三类信号混在一个“运行中”状态里，会漏掉卡死、只读文件系统或依赖不可达等故障。

    建立低成本基线

    docker stats --no-stream
docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
docker system df
free -h
df -h
df -i

    docker stats 提供瞬时 CPU、内存、网络、块 I/O 和进程数，适合快速巡检，但不是历史记录。应在服务正常时保存一份基线，并用定时任务采样关键值；需要趋势和告警时，再增加 cAdvisor、Prometheus 或主机监控代理。对资源紧张的机器，先明确保留周期和采样间隔，避免监控本身占满磁盘。

    限制失控范围

    为核心服务设置合理的内存、CPU 和日志上限。限制值应依据基线留出峰值空间，过低会把短时波动变成重启循环。Docker 的 HEALTHCHECK 会标记健康状态，但普通 Docker 重启策略不会仅因 unhealthy 自动重启容器；探测结果需要由告警或编排逻辑处理。

    services:
  app:
    mem_limit: 512m
    cpus: 1.0
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

    故障时先留证再恢复

    docker inspect -f '{{.State.Status}} {{.State.OOMKilled}} {{.State.ExitCode}}' app
docker logs --since 30m --tail 200 app
docker events --since 30m
journalctl -k --since '-30 min' | grep -Ei 'oom|killed process'

    先记录时间、状态、退出码、重启次数和近期日志，再检查主机内存、负载、磁盘容量与 inode。OOMKilled=true 或内核 OOM 记录指向内存压力；退出码只能提供线索，仍需结合应用日志。磁盘满时还要检查 Docker 数据目录、容器可写层和日志，不能直接执行 docker system prune，因为未使用的镜像、网络或构建缓存可能仍有恢复价值。

    • CPU 高：用 docker top 定位进程，并核对主机整体负载。
    • 网络异常：检查容器网络、DNS 解析、监听地址和已发布端口。
    • 频繁重启：比较首次失败日志与后续连锁错误。
    • 确认已保留证据后，再做单容器重启或回滚。

    轻量运维的关键不是命令数量，而是固定顺序：先确认影响范围，保存现场，判断资源还是依赖问题，再采取最小恢复动作，并把本次阈值和症状补进下一轮监控。