先说一个可能让你意外的事实：用 Docker 部署支付系统，最大的坑从来不是"怎么把容器跑起来"，而是"跑起来之后怎么保证它不丢数据、不崩、出事能回滚"。网上那些"Docker 部署教程"，绝大多数只教你跑到"容器启动成功"就结束了，可新手真正翻车的地方，恰恰在启动成功之后。

这篇文章，我不只给你能跑的命令，更要把"跑起来之后最容易踩的坑"一次讲透。你照着做，是真的能 10 分钟跑起来，而且跑起来之后不会因为一个配置疏忽，把数据搞丢、把服务搞崩。

为什么支付系统用 Docker，比普通网站更讲究

很多人觉得 Docker 就是个"打包工具"，把网站、把系统塞进容器里跑，跟部署个博客、部署个 CMS 没啥区别。这个想法，用在普通网站上没问题，用在支付系统上，会出大事。

区别在哪？两个字：数据。

普通网站，比如博客、官网，数据丢了顶多重发几篇文章；但支付系统跑的是实打实的东西——订单记录、资金流水、通道配置、密钥、商户信息。这些数据一旦丢，不是"重来一遍"能解决的，是实打实的资金风险和客诉。

所以，用 Docker 部署支付系统，有三个和普通网站完全不同的讲究：

  • 数据必须持久化：数据库、配置、日志，必须挂载到宿主机，绝对不能只存在容器里。容器一删，数据全没，这是新手最常见的翻车点。
  • 环境要能复现：支付系统依赖一堆东西——PHP 版本、扩展、数据库、Redis、定时任务。传统方式装一半漏装个扩展，排查到崩溃。Docker 的价值就是把这一整套环境"固化"下来，换台机器也能原样跑。
  • 出事要能回滚：升级、改配置出了错，传统部署想回滚很痛苦；Docker 配合镜像 tag，能做到"一分钟回滚到上一个版本"。

这三条，就是你用 Docker 部署支付系统的真正理由——不是"酷"，是"稳、可复现、可回滚"。

别用零散的 docker run，直接用 docker-compose

新手最容易犯的第一个错，就是照着网上零散的 docker run 命令一行一行敲。敲到第三行，参数就乱了——挂载卷忘了、端口忘了、环境变量忘了，最后容器跑起来也是"缺胳膊少腿"。

正确的做法，从一开始就用 docker-compose：把服务、依赖、挂载、端口、环境变量，全部写进一个 yaml 文件，一条命令整个环境一起起来。

我下面给一个支付系统部署的通用结构，你照着这个思路改，比零散敲命令靠谱得多：

version: '3.8'

services:
  app:                      # 支付系统主程序
    image: your-pay-image:stable   # 用固定 tag，别用 latest
    restart: always
    ports:
      - "8080:80"           # 宿主机端口:容器端口
    volumes:
      - ./app-data:/app/data        # 配置、日志、附件持久化
      - ./app-config:/app/config    # 配置文件持久化
    depends_on:
      - mysql
      - redis
    environment:
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=pay
      - DB_USER=pay
      - DB_PASSWORD=your-strong-password
      - REDIS_HOST=redis

  mysql:
    image: mysql:8.0
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=your-root-password
      - MYSQL_DATABASE=pay
      - MYSQL_USER=pay
      - MYSQL_PASSWORD=your-strong-password
    volumes:
      - ./mysql-data:/var/lib/mysql   # 数据库数据持久化，关键！

  redis:
    image: redis:7-alpine
    restart: always
    volumes:
      - ./redis-data:/data

这个结构里有几个点，是新手最容易忽略、但恰恰最重要的：

  • 数据库目录一定要挂出来（./mysql-data:/var/lib/mysql）。这一行没有，你哪天 docker-compose down 一下，全部订单数据就没了。
  • 镜像 tag 用固定版本，别用 latest。latest 会跟着最新版变，哪天你重新拉镜像，环境悄悄升级了，出问题都不知道是为什么。
  • 配置文件也挂出来。支付系统的通道配置、密钥，如果只存在容器里，容器重建就丢，你要全部重新配一遍。

10 分钟，真实的时间拆解

标题说"10 分钟搞定"，我不给你画饼，给你拆一下这 10 分钟到底花在哪：

  • 第 1-2 分钟：装 Docker。服务器上一条命令装 Docker 和 docker-compose，这个你自己机器大概率已经装好了。
  • 第 3-5 分钟：写 compose 文件。照着上面的结构，把你的镜像、端口、密码填进去。
  • 第 6-7 分钟：起服务。docker-compose up -d，等它拉镜像、起容器。
  • 第 8-10 分钟：验证。访问页面，确认能打开、数据库连上了、能正常跑通一个支付流程。

真正花时间的，其实不是 Docker 本身，而是你第一次搞清楚"哪些目录要挂载、哪些配置要持久化"。这些搞明白了，以后换服务器、重装环境，就是几分钟的事。

新手最容易踩的 5 个坑，提前给你排掉

下面这 5 个坑，是我见过新手用 Docker 部署支付系统时，翻车率最高的。提前知道，能帮你省下大把排错时间。

坑一：数据库没挂载，数据全没。这是最致命的一个。很多人图省事，数据库容器不挂目录，直接用默认的，结果一重建容器，所有订单、流水、商户数据全清零。记住一句话：凡是会变的数据，都要挂载到宿主机。

坑二：端口冲突，服务起不来。宿主机上 80、3306、6379 这些端口经常被别的服务占用。你容器里映射端口时，如果宿主机端口已经被占了，容器就起不来。解决办法很简单：换一个宿主机端口，比如把 8080 映射到容器里的 80。

坑三：容器重启后配置丢失。很多人把通道配置、密钥直接改在容器里，结果容器一重启，配置还原了，支付通道全断。这就是为什么我上面强调"配置文件也要挂出来"——配置要落在宿主机，不能落在容器里。

坑四：环境变量写死密码，还用了弱密码。compose 文件里的数据库密码，很多人随手写个 123456，还把这个文件传到公网仓库。支付系统的数据库密码一旦泄露，等于把商户数据和资金信息全暴露了。密码要用强密码，compose 文件别乱传。

坑五：升级不带版本，出事回不去。升级支付系统，很多人直接拉最新镜像覆盖，结果新版有 bug，想回滚发现旧镜像没留。正确做法是：每次升级前，给旧版本打个 tag 备份，出问题一分钟就能回滚。

这 5 个坑，其实都指向同一件事：Docker 部署的核心不是"跑起来"，而是"数据不丢、能回滚、可复现"。很多人栽跟头，恰恰是只盯着"跑起来"那一瞬间，忽略了后面这些。部署这件事上的坑，我在易支付源码部署实战经验实录：那次生产事故里也讲过，传统部署遇到过的坑，换到 Docker 上一样会踩，值得对照着看。

为什么说 Docker 对新手反而更友好

很多人有个误解，觉得 Docker 是"高手才用的高级工具"，新手应该先学传统部署。其实恰恰相反——对新手来说，Docker 反而是最低门槛的部署方式。

原因很简单：传统部署，你要自己搞定环境——装 PHP、装扩展、配 Nginx、装数据库、装 Redis、配权限、改配置，中间任何一步漏了、错了，系统就起不来，你还不知道错在哪。对新手来说，光是把这一整套环境手动装对，可能就要折腾一下午。

而 Docker 呢？环境已经打包在镜像里了，你不用管 PHP 版本对不对、扩展装没装、Nginx 配没配，一条命令整个环境原样起来。新手不用懂环境，只要懂"我要挂载哪些目录、映射哪些端口"这两件事，就能把支付系统跑起来。这个学习成本，比传统部署低太多了。

那些劝你别用 Docker、让你从手动安装开始学的人，多半是忘了自己当初手动装环境时被坑得有多惨。如果你是完全的新手，想了解传统部署到底要折腾多少步，可以看易支付从零搭建实录：域名+服务器+配置全流程，看完你就明白，Docker 帮你省掉了多少麻烦。

跑起来之后，还有三件收尾的事

容器跑起来、页面能打开，不代表就万事大吉了。支付系统上线前，还有三件收尾的事，新手一定要做：

  • 备份：把挂载出来的数据目录，定期备份到别处。支付数据丢了是大事，不能只依赖本机那一份。
  • 监控：给容器加个简单的健康检查，服务挂了能及时知道，而不是等用户付款失败才后知后觉。
  • 安全：数据库端口别直接暴露到公网，管理后台访问要加限制。支付系统的安全，比普通网站高一个等级。

这三件事，和"跑起来"同样重要。很多人以为"部署成功"就是终点，其实那只是起点。支付系统能不能长期稳定地收钱，靠的不是"跑起来"那一瞬间，而是跑起来之后，你对数据、对安全、对稳定性的持续投入。

说到底，Docker 帮你解决的，是"环境复现"和"部署效率"这两个最磨人的问题。它让你和真正的新手，都能在 10 分钟里把一套支付系统跑起来。但跑起来之后怎么让它"稳、安全、数据不丢"，靠的是你对上面这几个坑和收尾工作的重视。把该挂载的挂载好、把该备份的备份好、把该限制的端口限制好，Docker 就是新手部署支付系统最省心的一条路。