部署与接入文档

Quick Start

快速部署流程

适用于首次接入新2皇冠平台出租的标准环境。按照以下步骤操作,即可在最短时间内完成系统上线。

01

环境准备

确认服务器操作系统为 CentOS 7.6+ / Ubuntu 20.04+,内存不低于 4GB,磁盘可用空间不低于 50GB。开放 80、443、8088 端口用于管理后台与 API 通信。

02

获取部署包

登录商户中心,在「资源管理」中下载对应产品线(登1/登2/登3)的部署包与授权证书。部署包内含完整安装脚本与依赖清单。

03

执行安装脚本

上传部署包至服务器,解压后运行 ./install.sh --product=deng2。脚本将自动完成数据库初始化、服务注册、防火墙策略配置与守护进程拉起。

04

配置接入参数

编辑 config/access.yaml,填入商户 ID、接入密钥、回调地址与数据同步策略。支持主备双通道配置,保障业务连续性。

05

联调验证

使用内置的 health-check 工具执行全链路探测,验证登录鉴权、资源拉取、心跳上报与异常告警是否正常。全部通过后即可切换生产流量。

API Reference

核心接入能力

新2皇冠平台出租提供标准化的 RESTful API 与 WebSocket 长连接通道,覆盖从账号鉴权到实时数据同步的完整业务链路。

鉴

统一鉴权接口

提供基于 HMAC-SHA256 签名算法的安全鉴权方案,支持多级权限粒度控制。商户可通过 /api/v1/auth/token 获取访问令牌,有效期可配置。

查看接入规范
同

资源同步服务

支持全量/增量两种同步模式,通过 /api/v1/resource/sync 接口实现账号、额度、配置等数据的实时下发与状态回传,延迟低于 200ms。

查看同步策略
监

监控告警通道

内置 WebSocket 心跳通道与异常事件推送,商户可订阅系统负载、服务可用性、资源消耗等指标,异常时自动触发多级告警通知。

查看告警配置
扩

弹性扩容协议

当业务量增长时,可通过 /api/v1/capacity/scale 接口动态申请追加资源实例。扩容过程无需停机,新实例自动加入负载均衡池。

查看扩容指南
Deployment Topology

推荐部署架构

根据业务规模选择适合的部署拓扑。以下为生产环境推荐的主备双活架构示意,确保单点故障不影响业务连续性。

主节点

承载核心业务流量,部署完整的登1/登2/登3服务实例,实时写入主数据库并同步至备节点。

备节点

热备待命,持续接收主节点数据同步。主节点异常时通过 VIP 漂移自动接管,切换时间小于 5 秒。

接入层

部署 Nginx/HAProxy 负载均衡,负责请求分发、SSL 卸载与限流策略,支持横向扩展。

Integration Checklist

接入上线检查清单

正式切换生产流量前,请逐项确认以下关键配置,避免上线后出现兼容性或安全风险。

✓

安全配置

确认接入密钥已轮换、IP 白名单已配置、管理后台默认密码已修改,且强制 HTTPS 已开启。

✓

数据策略

核对同步频率、数据保留周期与备份策略,确保与业务合规要求一致。建议开启每日全量备份。

✓

容灾演练

至少完成一次主备切换演练与数据恢复演练,记录切换耗时与数据一致性校验结果。

✓

监控覆盖

确认关键指标已接入监控看板,告警通知已绑定至值班人员,避免告警遗漏。

Environment

运行环境与兼容性

新2皇冠平台出租全系产品经过多环境严格测试,以下为官方推荐与已验证的部署环境组合。

OS

操作系统

CentOS 7.6-8.5、Ubuntu 20.04/22.04 LTS、Debian 11+,均提供对应的一键安装脚本。

DB

数据库

MySQL 8.0+ / MariaDB 10.6+,支持主从复制与自动故障转移。初始化脚本随部署包提供。

RT

运行时

Node.js 18 LTS / Java 17 LTS,依赖项已离线打包,无需外网访问即可完成安装。

NET

网络要求

出站访问 API 网关域名,入站开放管理端口。支持 HTTP/2 与 WebSocket 长连接。

FAQ

部署接入常见问题

以下为商户在部署与接入过程中高频咨询的问题,更多细节可查阅完整版技术手册。

部署脚本执行失败,提示依赖缺失怎么办?

请确认服务器操作系统版本在推荐范围内,并检查是否以 root 或具有 sudo 权限的用户执行脚本。若为离线环境,请使用完整版部署包(内含全部依赖),而非精简版。

登1、登2、登3的接入方式有差异吗?

核心接入流程一致,差异主要体现在资源配额模型与部分高级接口的参数结构上。建议根据实际订购的产品线选择对应的接入文档章节,避免参数混用。

如何验证系统是否已成功接入?

登录商户中心进入「接入状态」页面,查看节点心跳、数据同步延迟与接口成功率。绿色状态表示接入正常,黄色表示存在延迟,红色表示链路中断需排查。

支持从旧版本平滑升级吗?

支持。官方提供增量升级包与回滚脚本,升级过程不影响在线业务。建议在业务低峰期执行,并提前备份配置目录与数据库。

Docs Updates

部署与接入相关文章

持续更新的技术文档与版本发布说明,帮助您第一时间掌握平台能力变化。