第 7 篇：如何搭建 Freqtrade Web UI？安装与使用指南
- Promise
- 发布于 3天前
- 阅读 322
📘第7篇：如何搭建FreqtradeWebUI？安装与使用指南在使用Freqtrade进行实盘或回测时，你可能希望实时查看当前策略运行状态、持仓、收益等信息。这时，WebUI（FreqUI）就派上用场了。本文介绍如何安装和运行WebUI，包括命令行与Docker两种方
📘 第 7 篇：如何搭建 Freqtrade Web UI？安装与使用指南
在使用 Freqtrade 进行实盘或回测时，你可能希望实时查看当前策略运行状态、持仓、收益等信息。这时，Web UI（FreqUI）就派上用场了。
本文介绍如何安装和运行 Web UI，包括命令行与 Docker 两种方式，并介绍常见的使用场景。
🚀 想学量化交易？
👉 点击访问：https://www.itrade.icu 这里有 Freqtrade 基础教程、策略实战、指标解析 等丰富内容，助你轻松掌握量化交易技巧！
🧩 1. 安装 Web UI 支持组件
在首次使用 Web UI 前，需要执行以下命令安装依赖：
freqtrade install-ui该命令会自动安装运行 Web 界面所需的依赖模块。
🚀 2. 启动 Webserver 服务
Webserver 是 UI 的后端入口，启动后会监听一个端口（默认是 8080）。
freqtrade webserver \
--config user_data/config.json默认情况下，你可以通过浏览器访问：
http://localhost:8080⚙️ 3. 常用参数说明
| 参数 | 说明 |
|---|---|
--config |
指定配置文件路径 |
--port |
指定监听端口，默认是 8080 |
--username / --password |
设置登录用户与密码 |
--api-server |
启用 REST API 服务 |
--webserver |
启动 UI Web 服务（默认即启用） |
🧱 示例：使用指定端口与登录账号
freqtrade webserver \
--config user_data/config.json
🐳 4. Docker 启动 Web UI 示例
如果你用的是 Docker，可以使用如下配置（docker-compose.yml）：
⚠️⚠️⚠️：如果使用docker启动那么config.json中的api_server.listen_port字段需要和docker-compose.yaml中ports端口一致，否则无法正常访问.
"api_server": {
"enabled": true,
"listen_ip_address": "127.0.0.1",
"listen_port": 7777,
"verbosity": "error",
"enable_openapi": false,
"jwt_secret_key": "",
"ws_token": "",
"CORS_origins": [],
"username": "1",
"password": "1"
},services:
freqtrade:
image: freqtradeorg/freqtrade:stable
volumes:
- ./user_data:/quants/freqtrade/user_data
ports:
- "8888:7777" # 外部访问使用 http://localhost:8888
command: >
webserver
--config /quants/freqtrade/user_data/config.json
--username admin
--password 123456启动方式：
docker compose up -d 你说得对，Freqtrade 的 Web UI 实际上包括两种不同用途的界面，分别服务于实盘交易与策略开发测试场景。以下是更准确的说明，可以直接替换你上面的内容：
📊 6. Web UI 模块说明
Freqtrade 提供两套 Web UI，用于不同场景：
✅ 1. 实盘 Web UI（freqtrade trade 时启用）
用于实时监控机器人运行状态：
- 查看当前策略、持仓币种、盈亏情况
- 管理挂单 / 平仓 / 创建手动交易（需启用 API）
- 浏览历史交易记录与盈亏图表
启动方式：
freqtrade trade --config user_data/config.json🧪 2. 回测 Web UI（Backtesting UI）
用于策略回测结果可视化：
- 图形化展示回测盈亏曲线、指标线、买卖点
- 策略性能概览、交易统计分析
- 需先使用
freqtrade backtesting生成结果
启动方式：
freqtrade webserver --config user_data/config.json 🔧 7. 注意事项与常见问题
| 问题 | 解决方法 |
|---|---|
| 无法访问 UI | 确保已启动对应 webserver 模式，端口是否对外开放 |
| 页面空白 / 样式错乱 | 运行：freqtrade install-ui 安装前端依赖 |
| Docker 中访问不到 UI | 检查 docker-compose.yml 是否有 ports: 8888:8080 映射 |
| UI 无法识别策略 | 策略文件名需正确，config.json 中 "strategy" 字段必须一致 |
| 回测 UI 无数据展示 | 确保已运行 backtesting 并生成结果，再启动 webserver --backtesting |
📌 总结
Freqtrade Web UI 是一个轻量、实用的可视化界面，可用于：
- 实时监控交易状态
- 查看回测或实盘表现
- 手动干预交易行为 如果你已熟悉 CLI，但希望更直观地管理策略和资产，强烈推荐开启 Web UI！
