服务端配置 [server]
api_url
必填
string · URL
服务端API地址，客户端通过此地址与服务端通信。
格式：http://域名或IP/api_v2.php
api_url = http://hp.13467999.xyz/api_v2.php
注意
- 必须使用
api_v2.php（V2版本）
- HTTPS 环境下确保证书有效
- 确保服务端地址可正常访问
client_id
自动生成
string · UUID
客户端唯一标识符，首次运行时自动生成。服务端通过此ID识别不同的客户端。
client_id = e7dd7e24-e2bb-4f5d-96ec-c8d4313ce443
警告
此参数由系统自动生成，请勿手动修改。修改后服务端将无法识别该客户端。
client_name
可选
string
客户端显示名称，用于在服务端后台识别不同客户端。建议使用有意义的名称，如 VPS-HK-01、交易机器人1。
client_name = Trading Client 1
币安API配置 [binance]
api_key
必填
string
币安API访问密钥。
获取方式：
- 登录 binance.com
- 进入「API管理」
- 创建新的API Key
- 复制并粘贴到配置文件
api_key = YOUR_BINANCE_API_KEY
安全
- 仅授予「合约交易」权限
- 禁止授予「提现」权限
- 建议设置 IP 白名单
- 定期更换 API 密钥
api_secret
必填
string
币安API私钥，与 api_key 配对使用。创建时仅显示一次，请妥善保管。
api_secret = YOUR_BINANCE_API_SECRET
base_url
可选
string · URL · 默认：https://fapi.binance.com
| 环境 | 地址 | 说明 |
|---|
| 主网 |
https://fapi.binance.com |
真实交易（默认） |
| 测试网 |
https://testnet.binancefuture.com |
虚拟资金测试 |
提示
新用户建议先在测试网验证，熟悉后再切换主网。
交易参数 [trading]
stop_loss_amount
必填
float · USDT
单次开仓的最大止损金额（USDT）。系统根据此值和止损价自动计算开仓数量，确保单次最大亏损不超限。
建议值：
- 总资金的 1%-2%（推荐）
- 例：总资金 10000 USDT → 设置 100-200 USDT
- 例：总资金 1000 USDT → 设置 10-20 USDT
stop_loss_amount = 100
风险
- 此参数直接决定风险敞口
- 建议设置为总资金的 1%-2%
- 过大 → 单次亏损过多；过小 → 可能低于最小交易量
leverage
必填
int · 范围 1-125 · 默认 3
杠杆倍数，决定仓位大小与所需保证金。
计算公式：保证金 = 开仓金额 ÷ 杠杆
| 倍数 | 风险 | 适用人群 |
|---|
1-5x |
低 |
新手、保守型 |
5-10x |
中 |
有经验者 |
10-20x |
高 |
专业交易者 |
20x+ |
极高 |
不推荐 |
leverage = 3
注意
- 杠杆越高，爆仓风险越大
- 新手建议 1-5 倍
- 剧烈波动时高杠杆可能瞬间爆仓
系统参数 [system]
task_check_interval
可选
int · 秒 · 默认 5
客户端检查新任务的频率。建议 3-10 秒。
- 值越小 → 响应越快，服务器压力越大
- 值越大 → 响应越慢，服务器压力越小
task_check_interval = 5
heartbeat_interval
可选
int · 秒 · 默认 30
客户端向服务端上报在线状态和余额的频率。建议 20-60 秒。服务端通过心跳判断客户端是否在线并获取实时数据。
heartbeat_interval = 30
close_check_interval
可选
int · 秒 · 默认 3
客户端检查平仓命令的频率。建议 2-5 秒。此值决定平仓命令的响应速度，建议保持较小值。
close_check_interval = 3
log_level
可选
string · 默认 INFO
| 级别 | 说明 | 场景 |
|---|
DEBUG |
记录所有详细信息 |
排查问题 |
INFO |
记录重要操作 |
日常运行（推荐） |
WARNING |
仅警告和错误 |
减少日志量 |
ERROR |
仅记录错误 |
生产环境 |
log_level = INFO
完整配置示例
保守型 — 推荐新手
[server]
api_url = http://hp.13467999.xyz/api_v2.php
client_id =
client_name = 保守型机器人
[binance]
api_key = YOUR_API_KEY_HERE
api_secret = YOUR_API_SECRET_HERE
base_url = https://fapi.binance.com
[trading]
stop_loss_amount = 50
leverage = 3
[system]
task_check_interval = 5
heartbeat_interval = 30
close_check_interval = 3
log_level = INFO
进取型 — 有经验者
[server]
api_url = http://hp.13467999.xyz/api_v2.php
client_name = 进取型机器人
[binance]
api_key = YOUR_API_KEY_HERE
api_secret = YOUR_API_SECRET_HERE
[trading]
stop_loss_amount = 200
leverage = 10
[system]
task_check_interval = 3
heartbeat_interval = 20
close_check_interval = 2
log_level = INFO
常见问题
Q
修改配置后需要重启客户端吗？
是的，修改 config.ini 后必须重启客户端才能生效。
Linux: systemctl restart binance-trading-client
Windows: 双击 start.bat 重启
Q
stop_loss_amount 和 leverage 如何搭配？
- 低杠杆（1-5倍）+ 较大止损金额（总资金的2%）
- 高杠杆（10-20倍）+ 较小止损金额（总资金的1%）
原则：
杠杆越高，止损金额应越小
Q
如何计算合适的 stop_loss_amount？
公式：stop_loss_amount = 总资金 x 风险百分比
例：5000 USDT x 1% = 50 USDT（保守）
例：10000 USDT x 2% = 200 USDT（进取）
建议：1%-2%
Q
币安API Key 需要哪些权限？
- 合约交易 — 必选
- 读取信息 — 可选
- 提现 — 禁止
- 现货交易 — 禁止
- Margin交易 — 禁止
重要风险提示
- 配置错误可能导致严重后果 — 请仔细检查每个参数，特别是 stop_loss_amount 和 leverage
- 杠杆风险 — 高杠杆可能短时间内损失全部保证金
- 止损保护 — stop_loss_amount 是最后防线，请合理设置
- API安全 — 不要授予提现权限，不要泄露密钥
- 测试先行 — 建议先在测试网验证后再使用真实资金
- 盈亏自负 — 数字货币交易存在风险，请勿投入超出承受能力的资金