🔖 币安跟单系统
← 返回首页

📝 配置文档

详细的 config.ini 配置说明

快速导航

🌐 服务端配置 🔑 币安API配置 💰 交易参数 ⚙️ 系统参数 📋 完整示例

🌐 服务端配置 [server]

api_url 必填
类型：字符串（URL）

说明：服务端API地址，客户端通过此地址与服务端通信。

格式：http://域名或IP/api_v2.php

api_url = http://hp.13467999.xyz/api_v2.php
⚠️
注意事项：
  • 必须使用 api_v2.php（V2版本）
  • 如果服务端使用HTTPS，请确保证书有效
  • 确保服务端地址可以正常访问
client_id 自动生成
类型：字符串（UUID）

说明：客户端唯一标识符，首次运行时自动生成。

用途：服务端通过此ID识别不同的客户端。

client_id = e7dd7e24-e2bb-4f5d-96ec-c8d4313ce443
🚫
重要警告：此参数由系统自动生成，请勿手动修改！修改后服务端将无法识别该客户端。
client_name 可选
类型：字符串

说明：客户端显示名称，用于在服务端后台识别不同的客户端。

建议：使用有意义的名称，如：交易机器人1、VPS-HK-01、测试机等。

client_name = Trading Client 1

🔑 币安API配置 [binance]

api_key 必填
类型：字符串

说明：币安API访问密钥。

获取方式：

  1. 登录币安官网：https://www.binance.com
  2. 进入「API管理」
  3. 创建新的API Key
  4. 复制API Key并粘贴到此处
api_key = YOUR_BINANCE_API_KEY
🔒
安全建议：
  • 仅授予「合约交易」权限
  • 不要授予「提现」权限
  • 建议设置IP白名单
  • 定期更换API密钥
  • 不要将密钥泄露给他人
api_secret 必填
类型：字符串

说明：币安API私钥，与api_key配对使用。

注意：创建API Key时只显示一次，请妥善保管。

api_secret = YOUR_BINANCE_API_SECRET
base_url 可选
类型：字符串（URL）

说明：币安API地址，默认为主网地址。

默认值：https://fapi.binance.com（主网）

环境 地址 说明
主网 https://fapi.binance.com 真实交易环境（默认）
测试网 https://testnet.binancefuture.com 测试环境，使用虚拟资金
💡
建议：新用户建议先在测试网测试，熟悉后再切换到主网。测试网申请：https://testnet.binancefuture.com

💰 交易参数 [trading]

stop_loss_amount 必填
类型：数字（浮点数）| 单位：USDT

说明：单次开仓的最大止损金额（USDT）。

作用：系统会根据此值和止损价自动计算开仓数量，确保单次最大亏损不超过此金额。

建议值：

  • 总资金的1%-2%（推荐）
  • 例如：总资金10000 USDT，建议设置100-200 USDT
  • 例如：总资金1000 USDT，建议设置10-20 USDT
stop_loss_amount = 100 # 每次最多亏损100 USDT
⚠️
风险控制：
  • 此参数直接决定您的风险敞口
  • 严格建议：设置为总资金的1%-2%
  • 设置过大可能导致单次亏损过多
  • 设置过小可能导致开仓数量不足（少于最小交易量）
leverage 必填
类型：整数 | 范围：1-125

说明：杠杆倍数，决定仓位大小与所需保证金。

默认值：3倍

计算公式：所需保证金 = 开仓金额 ÷ 杠杆倍数

杠杆倍数 风险等级 适用人群
1-5倍 低风险 新手、保守型投资者
5-10倍 中风险 有经验的交易者
10-20倍 高风险 专业交易者
20倍以上 极高风险 不推荐
leverage = 3 # 3倍杠杆（默认，推荐）
⚠️
杠杆风险警告：
  • 杠杆越高，爆仓风险越大
  • 建议新手使用1-5倍杠杆
  • 高杠杆仅适用于小波动套利策略
  • 市场剧烈波动时，高杠杆可能瞬间爆仓

⚙️ 系统参数 [system]

task_check_interval 可选
类型：整数 | 单位：秒 | 默认值：5

说明：客户端检查新任务的频率。

建议值：3-10秒

影响：

  • 值越小：响应越快，但服务器压力越大
  • 值越大：响应越慢，但服务器压力越小
task_check_interval = 5 # 每5秒检查一次新任务
heartbeat_interval 可选
类型：整数 | 单位：秒 | 默认值：30

说明：客户端向服务端上报在线状态和余额的频率。

建议值：20-60秒

作用：服务端通过心跳判断客户端是否在线，并获取实时余额和持仓盈亏。

heartbeat_interval = 30 # 每30秒上报一次心跳
close_check_interval 可选
类型：整数 | 单位：秒 | 默认值：3

说明：客户端检查平仓命令的频率。

建议值：2-5秒

重要性：此值决定平仓命令的响应速度，建议保持较小值以确保及时平仓。

close_check_interval = 3 # 每3秒检查一次平仓命令
log_level 可选
类型：字符串 | 默认值：INFO

说明：日志记录级别，控制日志的详细程度。

级别 说明 适用场景
DEBUG 记录所有详细信息 排查问题、开发调试
INFO 记录重要操作（推荐） 日常运行
WARNING 仅记录警告和错误 减少日志量
ERROR 仅记录错误 生产环境
log_level = INFO # 日常使用推荐

📋 完整配置示例

示例1：保守型配置（推荐新手）

# 服务端配置
[server]
api_url = http://hp.13467999.xyz/api_v2.php
client_id = （自动生成，无需填写）
client_name = 保守型机器人

# 币安API
[binance]
api_key = YOUR_API_KEY_HERE
api_secret = YOUR_API_SECRET_HERE
base_url = https://fapi.binance.com

# 交易参数（保守型）
[trading]
stop_loss_amount = 50     # 每次最多亏损50 USDT（总资金5000的1%）
leverage = 3                # 3倍杠杆（低风险）

# 系统参数
[system]
task_check_interval = 5
heartbeat_interval = 30
close_check_interval = 3
log_level = INFO

示例2：进取型配置（有经验者）

# 服务端配置
[server]
api_url = http://hp.13467999.xyz/api_v2.php
client_name = 进取型机器人

# 币安API
[binance]
api_key = YOUR_API_KEY_HERE
api_secret = YOUR_API_SECRET_HERE

# 交易参数（进取型）
[trading]
stop_loss_amount = 200    # 每次最多亏损200 USDT（总资金10000的2%）
leverage = 10               # 10倍杠杆（中等风险）

# 系统参数
[system]
task_check_interval = 3    # 更快响应
heartbeat_interval = 20
close_check_interval = 2
log_level = INFO

❓ 常见问题

Q: 修改配置后需要重启客户端吗？

A: 是的，修改 config.ini 后必须重启客户端才能生效。
命令：systemctl restart binance-trading-client（Linux）或双击 start.bat 重启（Windows）

Q: stop_loss_amount 和 leverage 如何搭配？

A: 建议搭配：
• 低杠杆（1-5倍）+ 较大止损金额（总资金的2%）
• 高杠杆（10-20倍）+ 较小止损金额（总资金的1%）
原则：杠杆越高，止损金额应越小

Q: 如何计算合适的 stop_loss_amount？

A: 公式：stop_loss_amount = 总资金 × 风险百分比
例如：
• 总资金5000 USDT × 1% = 50 USDT（保守）
• 总资金10000 USDT × 2% = 200 USDT（进取）
建议：1%-2%之间

Q: 币安API Key 如何设置权限？

A: 仅勾选以下权限：
✅ 合约交易（必选）
✅ 读取信息（可选）
❌ 提现（禁止勾选）
❌ 现货交易（禁止勾选）
❌ Margin交易（禁止勾选）

⚠️ 重要风险提示