下载并解压 Client Portal API Gateway
Java 准备好以后,需要下载 Client Portal API Gateway ZIP 包并解压。官方通常提供 Standard Release 和 Beta Release。
官方下载入口:
| 文件 | 地址 |
|---|---|
| Standard Release | clientportal.gw.zip |
| Beta Release | clientportal.beta.gw.zip |
Standard 与 Beta
Section titled “Standard 与 Beta”| 版本 | 中文理解 |
|---|---|
| Standard Release | 标准版本,优先用于稳定开发。 |
| Beta Release | 测试版本,可能包含问题修复或新能力;标准版本遇到问题时可用于对比。 |
开发时建议先使用 Standard Release。只有标准版本出现明确问题,或官方支持建议使用 Beta 时,再切换 Beta。
解压后通常会得到类似 clientportal.gw 的目录。目录里常见内容包括:
| 路径 | 作用 |
|---|---|
bin/run.bat | Windows 启动脚本。 |
bin/run.sh | macOS / Linux 启动脚本。 |
root/conf.yaml | Gateway 配置文件,包含监听端口、SSL、远端地址等配置。 |
root/ | Gateway 运行配置目录。 |
放在哪里合适
Section titled “放在哪里合适”| 系统 | 示例位置 |
|---|---|
| Windows | C:\Users\你的用户名\Downloads\clientportal.gw 或固定工具目录 |
| macOS | ~/Downloads/clientportal.gw 或 ~/tools/clientportal.gw |
| Linux | ~/clientportal.gw 或服务用户可读写的固定目录 |
目录路径不要包含很复杂的特殊字符。排查问题时,先确认自己进入的是解压后的 Gateway 根目录,而不是 ZIP 文件所在目录。
- 不要直接在文件管理器里双击 ZIP 里的脚本运行,先完整解压。
- 不要把 Gateway 放进会被自动清理的临时目录。
- 升级 Gateway 前,如果改过端口、证书或其他配置,先备份
root/conf.yaml。