搜索结果

×

搜索结果将在这里显示。

聚合实名认证搭建教程

聚合实名认证系统安装教程

本系统为 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. 如修改端口，记得同步修改防火墙、安全组和反向代理配置。
发布时间：