ftrade.icu

Appearance

Freqtrade 代理配置指南（支持 Docker 与源码） ​

为了提高在访问加密货币交易所 API 的稳定性与速度，如 HTX（火币）、Binance（币安）、OKX、KuCoin 等，用户可以通过为 Freqtrade 配置代理（支持 HTTP、HTTPS 和 SOCKS5）方式解决连接超时或请求失败等问题。

本指南将详解如何在 Docker 容器模式 和 源码运行模式（裸机） 中，正确设置 Freqtrade 的 ccxt_config.httpsProxy 参数，从而实现科学上网、加速行情与订单请求，解决频繁连接失败或请求超时等问题。配置后可稳定运行自动交易策略与机器人，适用于策略开发与实盘部署场景。

本文关键词：Freqtrade 代理配置、Freqtrade 设置 HTTP 代理、ccxt httpsProxy、Docker 配置代理、币安火币连接失败、量化交易连接超时、freqtrade 科学上网、交易机器人代理设置

🧪 源码运行模式（裸机） ​

适用于直接在本机运行 Freqtrade 项目（非 Docker 环境）。

✅ 示例配置（源码运行） ​

json
{
  "exchange": {
    "name": "htx",
    "key": "",
    "secret": "",
    "ccxt_config": {
      "enableRateLimit": true,
      "httpsProxy": "http://127.0.0.1:1087"
    },
    "ccxt_async_config": {},
    "pair_whitelist": ["BTC/USDT", "ETH/USDT"],
    "pair_blacklist": []
  }
}

🐳 Docker 模式配置代理 ​

⚠️ 注意：在 Docker 容器中，不能直接访问 127.0.0.1。应使用 host.docker.internal 访问宿主机代理。

✅ 示例配置（Docker 模式） ​

json
{
  "exchange": {
    "name": "htx",
    "key": "",
    "secret": "",
    "ccxt_config": {
      "enableRateLimit": true,
      "httpsProxy": "http://host.docker.internal:1087"
    },
    "ccxt_async_config": {},
    "pair_whitelist": ["BTC/USDT"],
    "pair_blacklist": []
  }
}

📝 配置说明 ​

参数说明
httpsProxy代理服务器地址，支持 HTTP、HTTPS、SOCKS5 协议
127.0.0.1:1087源码模式下的本地代理地址
host.docker.internal:1087Docker 模式下访问宿主机的特殊域名
enableRateLimit启用 API 请求频率限制，避免被交易所封禁

🔧 常见代理协议格式 ​

  • HTTP 代理：http://127.0.0.1:1087
  • HTTPS 代理：https://127.0.0.1:1087
  • SOCKS5 代理：socks5://127.0.0.1:1080
  • 带认证的代理：http://username:password@127.0.0.1:1087

✅ 验证配置 ​

配置完成后，启动 Freqtrade 并观察日志输出，确认是否成功通过代理连接到交易所 API。

bash
# 源码模式启动
freqtrade trade --config config.json

# Docker 模式启动
docker-compose up -d

如果配置正确，应该能看到成功获取市场数据和订单信息的日志。

🚨 故障排查 ​

  1. 连接失败：检查代理服务是否正常运行
  2. Docker 无法访问：确认使用 host.docker.internal 而非 127.0.0.1
  3. 端口错误：确认代理端口号与实际一致（如 1087、7890 等）
  4. 协议不匹配：确认代理类型（HTTP/SOCKS5）与配置一致

📚 相关资源 ​