环境变量参考¶
本文列出 daemon (futu-opend) / CLI (futucli / futu-mcp) 支持的全部
FUTU_* 环境变量, 用途, 默认值, 与配套 CLI flag.
凭据 (Credentials)¶
| Env var | 用途 | 默认 | 配套 CLI flag |
|---|---|---|---|
FUTU_PWD |
登录密码 (明文 / 32-hex MD5 自动判别) | (必填或用 CLI flag) | --login-pwd <PWD> |
FUTU_TRADE_PWD |
交易解锁密码 (futucli unlock / MCP unlock) | (按需) | --trade-pwd <PWD> |
安全提示: 推荐用 systemd EnvironmentFile=/etc/futu-opend.env (mode 0600)
传, 不在 shell history / ps aux 暴露明文.
连接地址 (Connection)¶
| Env var | 用途 | 默认 |
|---|---|---|
FUTU_GATEWAY |
MCP / futucli 连 daemon 的 gRPC 地址 | 127.0.0.1:11111 |
FUTU_REST_URL |
futucli 连 daemon 的 REST URL | http://127.0.0.1:11112 |
FUTU_ADDR |
examples/live_test 用的 daemon 地址 | 127.0.0.1:11111 |
长跑 daemon 加固 (Long-running hardening, v1.4.94+)¶
env opt-in, default OFF. 详细见
长跑 daemon 部署指南.
| Env var | 用途 | 默认 | 风险 |
|---|---|---|---|
FUTU_CLIENT_SIG_PROACTIVE_REFRESH=1 |
在 client_sig 失效前 1h 主动调 refresh |
OFF | 低 — 单次 refresh 行为, backend 接受度真机 verify pending |
FUTU_CLIENT_SIG_REACTIVE_REFRESH=1 |
tcp_login 持续失败 (≥3 次) 时反应式 refresh | OFF | 中 — ret_type=15 含义不止 client_sig 失效 (含反刷限流 / 风控), 多账号 daemon 误 refresh 可能影响其他账号; 单账号场景安全 |
何时切 default ON: tester 真机 verify positive evidence + 跨 2+ release cycle opt-in 用户无问题报告 (pitfall #57 纪律).
客户端 (CLI / SDK / MCP)¶
| Env var | 用途 | 默认 |
|---|---|---|
FUTU_CLI_AUTO_IDEM=1 |
futucli 自动派生 idempotency_key (基于参数 hash) — place-order/modify/cancel | OFF |
测试 / Chaos engineering (内部)¶
| Env var | 用途 | 默认 |
|---|---|---|
FUTU_E2E_SIM_ACC |
E2E 测试用 sim 账号 | (test-only) |
FUTU_E2E_SIM_PWD |
E2E 测试用 sim 密码 | (test-only) |
FUTU_E2E_SIM_PLATFORM |
E2E 测试 platform (futunn / moomoo) |
futunn |
FUTU_CHAOS_ENABLE=1 |
chaos test 故障注入开关 | OFF |
FUTU_MULTI_VERSION_GUARD_STRICT=1 |
multi_version_smoke.sh 严格模式 (binary fingerprint diff 命中 → exit 1) | (ship.sh A9 自动设) |
ship.sh 内部使用¶
| Env var | 用途 |
|---|---|
FUTU_MULTI_VERSION_GUARD_STRICT=1 |
A9 stage 强设, ship-blocker fail 阻塞发版 |
命名约定¶
FUTU_<SUBSYSTEM>_<FEATURE>_<ACTION>=<VALUE>:
FUTU_prefix — 所有 daemon / CLI / SDK 共享 namespace- subsystem:
CLIENT_SIG/TRADE/CLI/E2E/CHAOS等 - feature/action: 描述功能本身, 不暴露内部 audit 编号 (e.g. v1.4.94 G1
protocol gap 的 G1 不写进 env var name; 用
PROACTIVE_REFRESH描述行为) - value: 一律
1= enable, 其他 / unset = disable
与 CLI flag 的关系¶
CLI flag 优先级 > env var > 配置文件 > 内置默认. 同时存在时 CLI flag wins.
例: FUTU_PWD=foo futu-opend --login-pwd bar → 用 bar (CLI flag).