本系统为 Go 后端 + MySQL 数据库 + Vue 前端静态页面结构。

系统默认配置：

1. 默认运行端口：8200，该端口在 resource/config.yaml 文件中的 app.port 配置项里设置
2. 默认数据库：MySQL
3. 默认数据库名：real_human
4. 默认表前缀：anc_
5. 默认用户端目录：/user
6. 默认管理端目录：/admin123
7. 默认安装入口：/install
8. 默认首页入口：/index.html

访问地址示例：

1. 安装页面：http://你的域名/install
2. 对外首页：http://你的域名/index.html
3. 用户后台：http://你的域名/user
4. 管理后台：http://你的域名/admin123
5. OpenAPI 文档：http://你的域名/openapi-doc.html

一、宝塔 Linux 安装教程

1、服务器环境要求

建议环境：

1. 系统：CentOS 7+ / Debian / Ubuntu
2. 宝塔面板：最新版
3. MySQL：5.7 或 8.0
4. Nginx：1.20+
5. 运行端口：8200
6. 服务器内存：建议 1G 以上
7. 域名：建议提前解析到服务器 IP

2、宝塔安装运行环境

进入宝塔面板后，安装以下软件：

1. Nginx
2. MySQL 5.7 或 MySQL 8.0
3. PM2 管理器可选，不是必须
4. 终端工具

说明：

本系统后端是 Go 编译后的可执行程序，正式部署时不一定需要安装 Go 环境。

如果你已经有 Linux 可执行文件 RealAuth，直接运行即可。

3、上传系统文件

在宝塔中进入：

文件

建议创建目录：

/www/wwwroot/realauth

将系统文件上传到该目录。

目录结构大致如下：

realauth/
├── RealAuth
├── resource/
│   ├── config.yaml
│   ├── admin123/
│   ├── user/
│   ├── install/
│   ├── static/
│   └── uploads/
├── runtime/
└── 其他项目文件

注意：

1. Linux 服务器运行文件应为 RealAuth
2. Windows 的 RealAuth.exe 不能直接在 Linux 上运行
3. resource 目录必须和 RealAuth 放在同级目录
4. resource/config.yaml 必须存在
5. resource/install/install.sql 必须存在

4、放行端口

进入宝塔：

安全 -> 放行端口

添加端口：

8200

说明：8200 是系统默认运行端口，该端口在项目的 resource/config.yaml 文件中配置：

app:
  port: 8200

如果你修改了 resource/config.yaml 里的 app.port，宝塔安全组、服务器安全组和反向代理中的端口也要同步修改。

如果服务器安全组也有限制，还需要在云服务器控制台放行对应端口。

5、添加宝塔 GO 项目

宝塔面板支持通过 GO 项目方式运行本系统，操作路径：

宝塔面板 -> 网站 -> GO -> 添加项目

添加项目时可参考以下信息：

项目名称：realauth
项目路径：/www/wwwroot/realauth
启动文件：/www/wwwroot/realauth/RealAuth
运行端口：8200

图文教程参考：

https://www.bt.cn/bbs/thread-93034-1-1.html

注意：运行端口需要和 resource/config.yaml 中的 app.port 保持一致。

6、启动系统

在宝塔 GO 项目中启动项目即可。

如果启动成功，终端或项目日志一般会看到类似：

Listening and serving HTTP on :8200
如果还没有安装-请在浏览器访问进行安装：http://127.0.0.1:8200/install

此时可访问：

http://服务器IP:8200/install

7、使用安装向导

浏览器打开：

http://服务器IP:8200/install

或绑定域名后访问：

http://你的域名/install

安装页面需要填写：

1. 授权码
2. 数据库地址
3. 数据库端口
4. 数据库用户名
5. 数据库密码
6. 数据库名称
7. 管理员账号
8. 管理员密码

数据库信息示例：

数据库地址：127.0.0.1
数据库端口：3306
数据库用户名：real_human
数据库密码：你的数据库密码
数据库名称：real_human

管理员信息示例：

管理员账号：admin
管理员密码：自行设置，至少 6 位

安装成功后，系统会自动：

1. 导入 resource/install/install.sql
2. 写入数据库配置到 resource/config.yaml
3. 生成安装锁文件 resource/install/install.lock
4. 初始化管理员账号密码

8、配置宝塔反向代理

如果想通过域名直接访问，不带 :8200，需要配置 Nginx 反向代理。

宝塔操作：

网站 -> 添加站点

绑定域名，例如：

real.xxx.com

站点根目录可以随便选择，例如：

/www/wwwroot/realauth

然后进入：

网站设置 -> 反向代理 -> 添加反向代理

配置：

代理名称：realauth
目标URL：http://127.0.0.1:8200
发送域名：$host

保存后访问：

http://real.xxx.com/install

如果已经安装完成，可访问：

http://real.xxx.com/index.html
http://real.xxx.com/user
http://real.xxx.com/admin123

9、Nginx 反向代理配置示例

如果不用宝塔图形界面，也可以手动配置：

server {
    listen 80;
    server_name real.xxx.com;

    location / {
        proxy_pass http://127.0.0.1:8200;
        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;
    }
}

10、安装完成后的访问地址

假设域名是：

real.xxx.com

则访问地址为：

首页：http://real.xxx.com/index.html
用户后台：http://real.xxx.com/user
管理后台：http://real.xxx.com/admin123
安装页：http://real.xxx.com/install
OpenAPI文档：http://real.xxx.com/openapi-doc.html

11、常见问题

1. 访问 install 提示无法打开

检查宝塔 GO 项目是否已启动，并查看项目日志是否有报错。

同时检查宝塔和服务器安全组是否放行 resource/config.yaml 中 app.port 配置的端口。

2. 数据库连接失败

检查：

1. 数据库地址是否正确
2. 数据库用户名是否正确
3. 数据库密码是否正确
4. 数据库是否已创建
5. MySQL 是否允许本地连接
6. 数据库名是否包含特殊字符

建议数据库地址填写：

127.0.0.1

3. 提示系统已安装

说明存在安装锁文件：

resource/install/install.lock

如果确实要重新安装，需要删除该文件，并清空或重新创建数据库。

注意：重新安装会影响原有数据，请提前备份。

4. 用户后台或管理后台打不开

检查以下目录是否存在：

resource/user
resource/admin123

检查配置文件：

resource/config.yaml

其中应包含：

busDirName: user
adminDirName: admin123
webStatic: admin123,user

二、本地 Windows 安装教程

1、Windows 环境要求

建议环境：

1. Windows 10 / Windows 11
2. MySQL 5.7 或 MySQL 8.0
3. 浏览器：Chrome / Edge / Firefox
4. 系统运行端口：8200

2、准备系统文件

将系统文件解压到本地目录，例如：

D:\realauth

目录结构大致如下：

D:\realauth
├── RealAuth.exe
├── resource
│   ├── config.yaml
│   ├── admin123
│   ├── user
│   ├── install
│   ├── static
│   └── uploads
├── runtime
└── 其他项目文件

注意：

1. Windows 本地运行文件是 RealAuth.exe
2. resource 目录必须和 RealAuth.exe 在同级目录
3. 不要只复制 exe 文件，否则静态页面和安装文件会缺失

3、安装 MySQL

如果本地没有 MySQL，可选择以下方式之一：

1. 安装 MySQL 5.7
2. 安装 MySQL 8.0
3. 使用 phpStudy
4. 使用小皮面板
5. 使用宝塔 Windows 面板

创建数据库，例如：

数据库名：real_human
用户名：root
密码：123456
编码：utf8mb4

也可以自定义数据库用户名和密码，安装时填写即可。

4、启动系统

打开 CMD 或 PowerShell。

进入项目目录：

cd D:\realauth

启动程序：

.\RealAuth.exe

启动成功后会显示：

Listening and serving HTTP on :8200

然后浏览器访问：

http://127.0.0.1:8200/install

5、使用安装向导

打开：

http://127.0.0.1:8200/install

填写安装信息。

数据库信息示例：

数据库地址：127.0.0.1
数据库端口：3306
数据库用户名：root
数据库密码：123456
数据库名称：real_human

管理员信息示例：

管理员账号：admin
管理员密码：自行设置，至少 6 位

点击安装后，系统会自动导入数据库并写入配置。

安装成功后会生成：

D:\realauth\resource\install\install.lock

6、Windows 本地访问地址

安装完成后访问：

首页：http://127.0.0.1:8200/index.html
用户后台：http://127.0.0.1:8200/user
管理后台：http://127.0.0.1:8200/admin123
安装页面：http://127.0.0.1:8200/install
OpenAPI文档：http://127.0.0.1:8200/openapi-doc.html

7、如果端口被占用

如果 8200 端口被占用，可以修改配置文件：

D:\realauth\resource\config.yaml

找到：

app:
  port: 8200

修改为：

app:
  port: 8300

然后重新启动：

.\RealAuth.exe

访问地址改为：

http://127.0.0.1:8300/install

8、Windows 防火墙放行

如果局域网其他电脑需要访问，需要放行端口。

打开：

Windows Defender 防火墙 -> 高级设置 -> 入站规则 -> 新建规则

选择：

端口 -> TCP -> 8200 -> 允许连接

然后局域网访问：

http://你的电脑局域网IP:8200

例如：

http://192.168.1.100:8200

9、Windows 常见问题

1. 双击 exe 闪退

不要双击运行，建议用 CMD 或 PowerShell 启动：

cd D:\realauth
.\RealAuth.exe

这样可以看到错误信息。

2. 提示数据库连接失败

检查：

1. MySQL 是否启动
2. 数据库是否创建
3. 用户名密码是否正确
4. 数据库端口是否为 3306
5. 本地 MySQL 是否允许连接

3. 提示系统已安装

说明存在：

resource\install\install.lock

如需重新安装，删除该文件，并重新创建或清空数据库。

4. 页面空白或后台打不开

检查目录是否完整：

resource\admin123
resource\user
resource\static

如果这些目录缺失，前端页面无法正常打开。

5. 修改配置后没生效

修改：

resource\config.yaml

后需要重启程序：

Ctrl + C
.\RealAuth.exe

三、重要目录说明

RealAuth / RealAuth.exe

系统后端运行程序。

resource/config.yaml

系统主配置文件，包含数据库、端口、静态目录等配置。

resource/install/install.html

安装向导页面。

resource/install/install.sql

系统初始化数据库文件。

resource/install/install.lock

安装锁文件，存在时表示系统已安装。

resource/admin123

管理后台静态文件目录。

resource/user

用户后台静态文件目录。

resource/static

对外首页、OpenAPI 文档等静态文件目录。

resource/uploads

上传文件目录。

runtime/log

系统运行日志目录。

四、安装后基础配置建议

安装完成后，建议进入管理后台检查以下配置：

1. 服务商管理：配置实名认证服务商
2. 认证产品：配置二要素、三要素、人脸等产品
3. 套餐定义：配置套餐价格、次数、有效期
4. 支付配置：配置充值支付渠道
5. 余额管理：检查用户余额
6. API 文档：确认 OpenAPI 接口说明
7. API 密钥：用户端创建 API Key 和 API Secret

五、正式上线建议

1. 使用域名访问，不建议长期使用 IP + 端口。
2. 宝塔中配置 Nginx 反向代理到 127.0.0.1:8200。
3. 开启 HTTPS 证书。
4. MySQL 不要使用弱密码。
5. 安装完成后不要随意删除 install.lock。
6. 定期备份数据库和 resource/uploads。
7. 第三方认证服务商、支付渠道、短信等账号由使用方自行申请配置。
8. 如修改端口，记得同步修改防火墙、安全组和反向代理配置。

1. 添加收款通道

1. 点击添加
2. 填写通道名称
3. 选择支付方式
4. 选择通道
5. 点击下一步

说明

1. 选择收款码类型为图片
2. 点击图片框上传[个人码/经营码/商家码/赞赏码等]
3. 点击保存

2. 下载并安装监控软件

2.1 安装软件

1. 点击打开靓仔码支付下载网盘，选择需要下载的软件版本，点击下载。
2. 点击下载软件

说明

1. 双击运行软件，弹出提示，点击继续安装。
2. 安装完成后，点击关闭。

3. 软件配置

3.1 运行监控软件

双击运行靓仔码支付三网监控软件。

3.2 配置商户信息

1. 在程序首页 - 商户设置 里，填写商户ID和商户密钥。
2. 点击前往API管理 - 靓仔码支付系统 获取API基础信息。

3. 在商户后台>账号管理>个人中心>基本信息中复制消息同步密钥 填写软件消息同步密钥，勾选启用wss消息同步，点击连接WSS
   
   

3.3 添加账号

1. 点击账号管理
2. 点击添加微信账户，扫码登录。

4. 测试支付正常

测试支付是否回调正常。

1. 添加收款通道

1. 点击添加
2. 填写通道名称
3. 选择支付方式
4. 选择通道
5. 点击下一步

2. 说明

1. 选择收款码类型为图片
2. 点击图片框上传[个人码/经营码/商家码/赞赏码等]
3. 点击保存

3. 添加账号

1. 点击账号管理
2. 点击添加微信账户，扫码登录。

4. 测试支付正常

测试支付是否回调正常。

• 获取 PID 方法（任选其一）：

  1. 扫码获取：支付宝客户端扫码直接获取 PID。

  

  2. 链接查询：

  • 商户号查询 → 查看 商户号（收单账号）。
  • 账号管理 → 查看 账号 ID。
  • 合作伙伴身份 → 查看 合作伙伴身份（PID）。

1. PC监控地址

下载地址：点我下载

2. APP下载地址

下载地址：点我下载

3. 微信/QQ/阿里旺旺下载地址

下载地址：点我下载

1. 账户登录

三网监控软件先登录账户（已有账户才能设置 / 并非强制性可不设置）。

2. 收款二维码及通道 ID 查看

一定要是挂机软件账户收款二维码，在商户中心查看通道 ID (个人码 ID)。

3. 通道 ID 复制与保存

复制通道 ID(145)到你双击打开的界面点击确认，自动保存。

1、新增通道

1.1、配置基本信息

1. 点击添加通道
2. 填写通道名称
3. 选择支付方式
4. 选择通道
5. 点击下一步

1.2、通道配置

1. 选择网关
2. 点击解析二维码上传并自动解析
3. 收款码类型选择二维码
4. 订单检查方式和取消订单递增金额，默认不要动
5. 点击保存

2、下载并安装监控软件

2.1、下载监控软件和相应适配的软件

1. 点击下载监控软件
2. 点击下载适配软件

2.2、安装适配软件

1. 双击运行软件，勾选协议，点击安装。
2. 等待安装完成，点击关闭即可。

提示

输入QQ账号密码登录即可。

2.3、运行监控软件

双击运行监控软件。

2.4、导入配置信息

1. 打开靓仔 - 码支付平台，点击API，然后点击复制信息。
2. 复制完成后，在软件中点击一键导入商户信息。

2.5、添加账号

1. 点击账号管理，点击添加QQ账户。
2. 然后点击刷新登录QQ，再勾选已登录的QQ账户。
3. 最后点击监控选择QQ。

3、完成配置

配置已完成，在平台点击测试查看是否正常回调就可。

1、申请开通当面付

如果没有当面付，可以参考网上的教程申请即可！申请的方法简单来讲，就是百度搜索门店图或者自己出门去找一个门店，拍个照片就好了。 个人开通的率费是0.6%，商家开通的率费是0.38%以及更低。

2、开放平台创建应用

2.1 访问开放平台登录

访问支付宝开放平台，点击右上角登录，等待弹出扫码窗口，然后扫码登录，登录后，点击控制台。

2.2 进入控制台

扫码登录后，点击右上角控制台。

2.3 点击网页/移动应用，然后点击创建网页/移动应用

2.4 创建网页移动应用

1. 填写应用名称
2. 选择商家账号
3. 上传应用图标
4. 应用类型选择网页应用
5. 点击立即创建

2.5 创建应用完成后，点击开发设置，然后再点击设置

2.6 点击设置后，弹出接口加签方式注意事项，点击确认

2.7 接口加签方式默认选择密钥，然后点击下一步

2.8 然后继续点击下一步

3. 下载并生成密钥然后配置

3.1 下载密钥工具

请下载并打开“密钥工具”（建议使用 2.0.0 版本或以上），并根据以下步骤生成应用公钥与应用私钥：

1. 加签方式：选择“密钥”。
2. 加签算法：选择 ”RSA2“。
3. 点击“生成密钥”。
4. 复制“应用公钥”字符串，需要在第3步中上传。

说明：您可以通过其他工具生成密钥文件，具体要求可查看文档。
下载好软件后打开，这里用的是win版本。密钥格式我们选择非java试用的这里根据自己定位选择-然后点击生成密钥（这里要保管好哦）

3.2 复制“应用公钥”字符串，需要在第3步中上传。

3.3 应用公钥上传完成后，添加配置通道

1. 点击添加
2. 填写通道名称
3. 选择支付宝方式
4. 选择通道
5. 点击下一步

说明

1. 复制并粘贴应用ID
2. 复制并粘贴应用私钥
3. 复制并粘贴支付宝公钥
4. 点击保存

3.4 点击应用详情，然后点击提交审核

3.5 点击上方的API管理，然后点击实现官方标准API，找到当面付，并点击绑定应用

3.6 点击选择创建的应用，然后点击确定绑定

3.7 等待审核成功后，即可正常使用收款。

最后更新：2025年1月18日

一、前期准备工作

1. 注册支付宝开放平台

1. 访问 支付宝开放平台 完成注册及实名认证。

2. 登录后进入控制台，选择 网页/移动应用 → 创建网页/移动应用。

3. 填写应用信息并提交审核（审核时间通常为 1 天内）。

二、配置网页应用

1. 开通基础功能

1. 审核通过后，进入应用详情页，点击 产品绑定。

2. 开通所有 免费的基础功能服务（如支付、退款等）。

2. 配置接口加签方式

1. 在 开发设置 中，选择 接口加签方式 → 密钥/证书。

2. 选择 密钥（普遍适用），按以下步骤操作：

• 下载支付宝提供的 密钥生成工具。
  
• 打开工具，选择密钥类型（如 RSA2），点击 生成密钥。
  
• 保存生成的公钥和私钥（私钥需严格保密）。
  

  3. 返回开放平台，上传公钥并确认，提示 密钥保存成功 即完成。

  

  4.如果提示，点击 稍后操作 即可。

  

三、配置 XarrPay 支付宝通道

1. 新增通道

1. 登录 XarrPay 管理后台，进入 通道管理 → 新增通道。

2. 选择 支付宝通道，填写以下参数：

• 应用 AppId：在支付宝开放平台控制台中查询（见下图示例）。
  
• 私钥：填入密钥工具生成的私钥（格式需保留如果有这段的话 -----BEGIN PRIVATE KEY-----）。

2. 使用方式配置

方式一：二维码支付

1. 使用二维码解析工具（推荐 草料二维码解析）解码收款码。

2. 将解码后的链接填入通道配置页面的 二维码地址 字段。

方式二：支付宝 PID

• 获取 PID 方法（任选其一）：

  1. 扫码获取：支付宝客户端扫码直接获取 PID。

  

  2. 链接查询：

  • 商户号查询 → 查看 商户号（收单账号）。
  • 账号管理 → 查看 账号 ID。
  • 合作伙伴身份 → 查看 合作伙伴身份（PID）。

测试与验证

1. 完成配置后，使用通道自带的 支付测试功能 验证是否成功。

2. 检查支付回调日志，确保异步通知正常接收。

注意事项

• ⚠️ 密钥安全：私钥泄露可能导致资金风险，务必离线保存。
• ⚠️ PID 权限：确保 PID 对应账号有收款权限。
• ⚠️ 支付宝审核：新注册用户需完成资质审核才能使用支付功能。

技术支持

• 问题反馈：联系上级或管理员。
• 支付宝官方支持：open.support@alipay.com

版权声明
本文档著作权归 靓仔 - 码支付 所有，未经授权禁止复制或商用。
如需使用，请访问原文链接或联系作者授权。
“基于版权所有，不交钱就想复制啊？打钱！！！”