什么是玉龙发卡网分销站

玉龙发卡网分销站是一套多商户聚合 + 商品池分销模式的虚拟商品自动交易系统（发卡平台），基于 Python Flask 开发，包含以下端口：

端口地址使用者核心功能
平台官网/访客 / 潜在商户商业模式介绍、商户入驻入口、订单查询
商城中心/mall买家商品聚合比价、下单支付、自动收卡密、订单查询、投诉
商户后台/merchant入驻商户商品/卡密/订单/商品池分销/资金提现/店铺设置
授权中心/license授权用户授权购买续费、授权查询、控制台（本页所属系统的销售站点）
管理后台/admin平台管理员商户审核、订单、投诉裁决、提现审核、支付与系统配置

核心商业逻辑：商户入驻上架商品 → 优质商品可加入商品池 → 其他商户可一键对接分销（代理价拿货赚差价）→ 买家下单后系统自动发卡 → 平台按费率（默认2%）扣除手续费后货款自动分账入商户余额 → 商户满门槛申请提现，管理员审核打款。

系统优势

更新日志

v1.1.0（当前版本）

v1.0.0

环境要求

项目要求
操作系统Linux / Windows / macOS 均可（推荐 Linux）
Python3.9 及以上
数据库SQLite（默认，零配置）/ MySQL 5.7+（可选）
服务器配置最低 1核1G 即可流畅运行（轻量应用服务器即可）
网络需公网可访问（支付回调要求）；建议绑定域名并配置 HTTPS

安装流程

# 1. 解压程序
unzip yulongfaka.zip -d /www/yulongfaka
cd /www/yulongfaka

# 2. 安装依赖（建议 Python 虚拟环境）
pip3 install -r requirements.txt

# 3. 启动（开发/体验）
python3 run.py
🛠️ 系统内置网页安装向导：首次启动后访问站点会自动进入 /install，浏览器中完成 环境检测 → 数据库配置（MySQL/SQLite 二选一，可实时测试连接）→ 设置自己的管理员账号密码 → 自动建表并锁定安装器（生成 install.lock）。安装后管理员密码即你所设，无默认密码。

购买授权

  1. 访问 授权中心，选择套餐（月付 / 季付 / 年付）
  2. 注册授权中心账号，下单时填写需要授权的域名
  3. 支付成功后授权自动开通，可随时在授权查询验证
  4. 到期前在控制台续费，天数在原到期日上累加，不损失剩余时长

部署系统（生产环境）

# 使用 gunicorn 生产级启动
pip3 install gunicorn
gunicorn -w 4 -b 127.0.0.1:5000 run:app

Nginx 反向代理示例（含 HTTPS 建议配合 certbot）：

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

数据库切换 MySQL（适用于安装后迁移；首次安装直接在安装向导中选 MySQL 即可，无需手动配置）：编辑项目根目录 .env 文件中的 DATABASE_URL=mysql+pymysql://user:pass@127.0.0.1:3306/yulongfaka?charset=utf8mb4，重启服务后自动建表。

宝塔面板部署（推荐）

生产环境推荐使用宝塔面板部署，完整图文教程见安装包内 deploy/宝塔部署教程.md，核心流程：

第一步：准备

第二步：启动 Python 服务（二选一）

第三步：网页安装向导（数据库+管理员）

服务启动后访问站点自动进入 /install 安装向导：环境检测 → 填写宝塔创建的 MySQL 信息（可点"测试连接"实时验证，也可选 SQLite 快速体验）→ 自行设置管理员账号密码 → 完成后自动锁定安装器。

第四步：域名 + HTTPS

  1. 宝塔 → 网站 → 添加站点（你的域名，纯静态）
  2. 站点设置 → 反向代理 → 目标URL http://127.0.0.1:5000
  3. 站点设置 → SSL → Let's Encrypt 一键申请，开启强制 HTTPS
  4. 宝塔安全 + 云安全组放行 80 / 443
⚠️ 真实支付（易支付/支付宝/微信）的异步回调必须通过 https://你的域名 送达，请务必完成本步后再配置支付通道。

日常管理

# 方案B（systemd）
systemctl restart|stop|status yulong-faka   # 重启/停止/状态
journalctl -u yulong-faka -n 50             # 查看日志
# 方案A 在宝塔 Python项目管理器界面操作即可

系统配置

  1. 登录管理后台 /admin（账号密码为安装向导中你自行设置的）
  2. 系统设置：站点名称、备案号、版权信息、平台费率、提现规则、注册审核开关
  3. 支付配置：选择支付通道并填写参数（见下方支付对接章节）
  4. 商户注册审核：可在系统设置中开启"注册需审核"，保障入驻商户质量

商户管理

商品与分销

订单与投诉

资金与提现

授权后台（平台方专用）

授权体系使用独立后台，地址 /license/admin，默认账号 authadmin（首次登录后请立即改密）。与站点管理后台 /admin 完全分离、互不可见 —— 站点管理员（部署方）管理自己的发卡业务，授权后台仅平台方管理授权：

配置支付总览

路径：管理后台 → 支付配置 → 支付通道设置。全站统一（商城订单与授权订单共用一个通道），四个通道随时可切换：

通道适用人群买家体验所需资质
模拟支付演示 / 内测点击按钮即成功无
易支付个人站长（推荐）跳转网关，支付宝/微信/QQ钱包均可易支付站点商户账号（个人可申请）
支付宝当面付企业/个体户页面展示支付宝二维码支付宝开放平台应用 + 当面付签约
微信Native企业/个体户页面展示微信二维码微信支付商户号 + Native产品
⚠️ 无论哪种真实通道，都要求：① 站点已绑定域名且公网可访问（回调才能送达）；② 建议配置 HTTPS；③ 服务器防火墙/安全组放行 80/443。

易支付（推荐，个人可用）

易支付是聚合支付协议，兼容市面绝大多数易支付站点（彩虹易支付等）。3 个参数即可完成对接：

第一步：申请商户

  1. 选择一个易支付服务商站点（自行甄别信誉，建议先小额测试）
  2. 注册商户账号，完成实名/签约（各站要求不同）
  3. 在商户后台获取 商户ID（PID） 与 商户密钥（KEY），记录网关地址（即该站点首页地址，如 https://pay.xxx.com）

第二步：填写配置

管理后台 → 支付配置 → 支付通道选择"易支付"，填入：

字段说明示例
网关地址易支付站点根地址，不带 /submit.phphttps://pay.xxx.com
商户ID商户后台的 PID1001
商户密钥商户后台的 KEYxxxxxxxxxxxxxxxx

第三步：验证

  1. 保存后前台下一笔小额测试单，完成支付
  2. 回到订单页看到"已支付/卡密已发放"即回调正常（本系统下单时自动携带回调地址，无需在易支付后台单独设置）
💡 本系统按易支付标准协议对接（MD5签名、TRADE_SUCCESS 状态、金额二次校验），如你的服务商使用非标准协议，请联系开发者适配。

支付宝当面付（官方）

第一步：开通资质

  1. 登录 支付宝开放平台，创建"网页/移动应用"
  2. 在产品中心签约当面付（需营业执照或个体户资质）
  3. 记录 APPID

第二步：配置密钥

  1. 下载支付宝官方"密钥生成器"（开放平台助手），生成 RSA2（2048位）密钥对
  2. 在开放平台"应用信息"中上传/填写应用公钥，平台会给出支付宝公钥
  3. 本系统需要填的是：应用私钥（你自己生成的）和支付宝公钥（平台给你的）——注意不要填成应用公钥

第三步：填写配置

管理后台 → 支付配置 → 选"支付宝当面付"：APPID、应用私钥、支付宝公钥（网关地址留空即正式环境）。

微信Native支付（官方）

第一步：开通资质

  1. 申请 微信支付商户号（需营业执照）
  2. 在商户平台开通 Native支付 产品；关联一个 AppID（公众号/小程序/开放平台应用均可）

第二步：获取四项参数

参数获取位置
商户号 mchid商户平台首页（1900 开头）
AppID已关联的公众号/小程序 AppID
APIv3密钥商户平台 → 账户中心 → API安全 → 设置APIv3密钥（32位）
证书序列号 + API私钥账户中心 → API安全 → 申请API证书，下载证书文件：apiclient_cert.pem 内含序列号（或商户平台查看），apiclient_key.pem 即私钥

第三步：填写配置

管理后台 → 支付配置 → 选"微信Native支付"，填入商户号、AppID、APIv3密钥、证书序列号、API私钥（粘贴 apiclient_key.pem 完整内容）。

支付常见问题

商户API

为商户提供开放接口，用于对接自有站点或查询数据。API 密钥获取方式：商户后台 → 店铺设置 → API密钥（可重新生成）。

接口列表

1. 订单查询

GET /api/order/{订单号}

返回订单状态、商品、金额、卡密列表（已支付订单）。无需鉴权，知道订单号即可查询，请妥善保管订单号。

2. 商品库存查询

GET /api/goods/{商品ID}/stock

返回指定商品的实时库存，适合对接前置页面。

3. 商户商品列表

GET /api/merchant/{你的API密钥}/goods

返回该商户全部商品（含价格、库存、状态），用于对接自有销售页。注意保密 API 密钥，泄露后请立即在商户后台重新生成。

FAQ

关于与联系

📖 本文档随系统更新持续维护，页面内容与程序版本对应：v1.1.0