如何下载并运行 Gateway
本页把 Client Portal Gateway 的安装和启动流程串起来。具体命令在子页面中展开，本页适合先看全局顺序。
| 步骤 | 操作 | 成功标准 |
|---|---|---|
| 1 | 安装 Java Runtime Environment | java -version 正常返回版本。 |
| 2 | 下载 Client Portal API Gateway | 获得 Standard 或 Beta ZIP 包。 |
| 3 | 解压 Gateway | 得到 clientportal.gw 目录。 |
| 4 | 进入 Gateway 目录 | 终端所在目录是解压后的 Gateway 根目录。 |
| 5 | 运行启动脚本 | Windows 用 bin\run.bat root\conf.yaml；Unix 用 bin/run.sh root/conf.yaml。 |
| 6 | 浏览器登录 | 打开 https://localhost:5000，完成 IBKR 登录和 2FA。 |
| 7 | 检查认证状态 | 登录成功后再调用 Client Portal API endpoint。 |
Gateway 默认监听 localhost 的 5000 端口：
https://localhost:5000如果端口被占用，可以修改 root/conf.yaml 中的 listenPort。官方常见替代端口示例是 5001。
Paper 账户登录
Section titled “Paper 账户登录”Client Portal Gateway 没有 TWS 那种 Live / Paper 滑块。Paper 账户登录时要使用 Paper Trading 专用用户名，而不是直接用真实账户用户名加某个开关切换。
Paper 用户名通常可以在 Client Portal 中从 Paper Trading 相关设置里查看。使用错误用户名会导致你以为在模拟环境，实际却没有进入正确的 Paper session。
启动后不要关闭终端
Section titled “启动后不要关闭终端”Gateway 是需要持续运行的进程。终端窗口关闭、进程退出、电脑休眠或网络断开，都可能让 API 请求失败。开发时建议把 Gateway 终端、浏览器登录页和自己的程序日志放在一起观察。