一、速览：Jeepay 是什么

入门

想象一下，你的网站或 App 做成了，用户想下单付款，但微信支付、支付宝、云闪付各有各的接入文档、各有各的结算规则。如果你一个个去对接，光是看文档就要花掉好几个星期。

Jeepay 就是来解决这个问题的。它是一套开源的支付系统，相当于一个「线上收银台」——你只需要把 Jeepay 部署在自己的服务器上，它帮你把微信、支付宝、云闪付这些渠道全部对接好，你的业务代码只需要跟 Jeepay 打交道，不用直接面对各个支付平台。

更实用的地方在于，Jeepay 支持聚合码支付：顾客扫一个二维码，用微信扫就是微信支付，用支付宝扫就是支付宝支付，系统会自动识别。这对线下门店、小微商户特别方便。

这套系统由原 XxPay 团队开发维护，在支付领域有多年实战积累。它用 Java 编写，基于 Spring Boot 框架，代码结构清晰，适合需要长期迭代和二次开发的团队。

二、安装：用 Docker 把整套系统跑起来

入门

Jeepay 包含多个模块：支付网关、运营后台、商户后台、前端页面等。如果手动一个个安装配置，对新手来说是个不小的工程。好在项目提供了 Docker Compose 方式，可以一键启动完整集群。

前置条件：

• 一台能联网的 Linux 服务器（推荐 CentOS、Ubuntu 或 Debian），建议配置 2 核 4G 内存以上
• 服务器上安装好 Docker（一种把软件打包成"集装箱"、随处可运行的工具）和 Docker Compose（用来一键启动多个集装箱的编排工具）
• 一个域名（可选，但建议准备，因为支付回调需要公网能访问到你的服务器）

为什么需要这些？因为支付系统必须能被微信、支付宝的服务器主动访问到（用来发送支付结果通知），所以你的服务器必须有公网 IP，不能只跑在本地电脑上。

安装 Docker 的命令如下（以 Ubuntu 为例）：

## 更新软件源
sudo apt update

## 安装 Docker
sudo apt install -y docker.io docker-compose-v2

## 启动 Docker 并设为开机自启
sudo systemctl enable docker --now

接下来获取 Jeepay 项目代码并启动：

## 下载项目代码
git clone https://github.com/jeequan/jeepay.git

## 进入项目目录
cd jeepay

## 使用 Docker Compose 一键启动全部服务
docker compose up -d

第一次启动需要下载镜像，耗时取决于网络状况。启动完成后，在浏览器访问 http://你的服务器IP 就能看到 Jeepay 的运营后台登录页面了。

注意：以上命令是最简流程，生产环境还需要修改数据库密码、配置 HTTPS 证书等。完整步骤请参考项目文档中的「部署方式」章节。

三、配置：让系统认识你的支付渠道

进阶 · 推荐细读

系统跑起来之后，下一步是配置支付渠道。这一步相当于「把收银台跟银行接通」——不配置渠道，Jeepay 只是一个空壳，无法真正收款。

Jeepay 支持两种商户模式，你需要先理解它们的区别：

• 普通商户模式：你直接对接微信支付、支付宝，把你自己（或你的公司）作为商户。适合单个商户自用。
• 服务商模式：你是平台方，帮下游很多个小商户统一收款。适合做 SaaS 平台、聚合支付服务的团队。

配置渠道的核心步骤是：登录 Jeepay 运营后台 → 找到「支付渠道」菜单 → 添加微信或支付宝 → 填入你在微信支付/支付宝开放平台申请的商户号和API 密钥。

这里有一个新手常见的问题：API 密钥是什么？ 它是支付平台用来验证请求身份的一串随机字符，相当于你收银台的「保险柜密码」。在微信支付商户平台和支付宝开放平台的后台都能找到或设置。

配置完成后，建议先使用系统的「测试模式」跑一笔小额支付，确认从下单到回调的全流程通畅，再切换到正式环境。

四、核心用法：商户、应用与订单流转

进阶 · 推荐细读

Jeepay 的使用逻辑可以概括为：平台 → 商户 → 应用 → 订单 四级结构。

• 平台：就是你的 Jeepay 系统本身，管理所有渠道配置和资金流水
• 商户：入驻你平台的商家（如果是自用，就创建一个商户）
• 应用：商户下的具体业务，比如一个 App、一个小程序、一个网站
• 订单：顾客支付时产生的交易记录

当你的业务系统需要收款时，流程是这样的：

1. 你的后端服务器向 Jeepay 发起支付请求（调用 API，即一组程序间的通信接口）
2. Jeepay 生成支付链接或二维码返回给你的前端
3. 顾客完成支付，微信/支付宝通知 Jeepay
4. Jeepay 再通过回调通知告诉你：这笔订单支付成功了

这里的「回调通知」可以理解为「快递签收回执」——支付平台把货款送到后，会给你一张回执单，告诉你钱到了。你的系统收到回执后，就可以给用户发货或开通会员了。

聚合码的使用也很简单：在商户后台创建一个「聚合码」应用，系统会生成一个二维码。打印出来放在收银台，顾客扫码后自动识别是微信还是支付宝，完成支付。

五、判断建议：你适合自建还是用托管

入门

看到这里，你可能会犹豫：既然 Jeepay 是开源的，那是不是所有人都应该自己部署一套？

不一定。Jeepay 官方也提供了托管服务（计全付），相当于「租用现成的收银台」。你可以根据自己的情况选择：

适合自建部署的人：

• 公司有技术团队，希望完全掌控支付流程和数据
• 需要做深度二次开发，比如定制分账逻辑、对接特殊渠道
• 有合规要求，支付数据不能出域

适合用官方托管的人：

• 没有服务器运维经验，也不想花时间搭建
• 没有支付牌照或支付通道资源，需要官方提供渠道
• 业务刚起步，想快速上线验证

无论选哪条路，理解 Jeepay 的核心概念——商户模式、支付渠道、回调通知、聚合码——都能帮你更快地做出决策。

建议：如果你是独立开发者或小团队，先尝试用 Docker 在本机跑通 Jeepay，再决定是否投入生产。实践一次比读十遍文档更有效。

项目信息

参考链接

• GitHub 仓库
• 项目主页

延伸阅读

想继续探索？这些同领域的教程可能也适合你：

• 「Python」中文使用教程
• 「AI_NovelGenerator」中文使用教程
• 「snipe-it」中文使用教程