运行 API Gateway

Client Portal Gateway 需要从终端启动，不能只靠文件管理器双击完成。启动后终端窗口要保持打开；关闭终端通常会停止 Gateway。

进入 Gateway 目录

先进入解压后的 clientportal.gw 根目录。下面路径只是示例，实际使用时替换成自己的解压位置：

cd /d C:\Users\Example\Downloads\clientportal.gw

macOS / Linux 示例：

cd ~/Downloads/clientportal.gw

实际路径以自己的解压位置为准。

进入目录后，应该能看到 bin、root 等子目录。启动命令必须在这个根目录下执行，否则脚本可能找不到 root\conf.yaml 或运行依赖。

Windows 启动命令

bin\run.bat root\conf.yaml

macOS / Linux 启动命令

bin/run.sh root/conf.yaml

启动成功后，Gateway 默认监听：

https://localhost:5000

浏览器打开该地址，接受 localhost 证书提示，然后使用 IBKR 用户名登录并完成 2FA。登录成功后，页面会显示类似 Client login succeeds 的提示。

Windows 终端如果先打印 '#set' 不是内部或外部命令，不要只凭这一行判断失败。继续看后面的日志；只要出现 Java 版本、This is the Client Portal Gateway 和登录地址，通常说明 Gateway 已经启动。

运行时检查

检查项	正常表现
终端窗口	Gateway 进程持续运行，没有立即退出。
浏览器	能打开 https://localhost:5000。
证书提示	默认自签名证书可能触发浏览器警告。
登录结果	完成账号密码和 2FA 后显示登录成功。

常见问题

问题	处理
java 找不到	先安装 Java，并确认 java -version 正常。
端口被占用	修改 root/conf.yaml 中的 listenPort。
浏览器证书警告	默认 localhost 自签名证书会触发警告；确认访问的是自己的 localhost 地址。
登录后又回到登录页	重新登录一次，并检查同一用户名是否已在其他 IBKR 平台占用 brokerage session。
程序请求失败	先确认浏览器登录成功，再检查 session 状态和 endpoint 路径。