Freqtrade WebUI 实操指南：5 步从启动到全面盯盘，附故障自查清单

Freqtrade WebUI 实操指南：5 步从启动到全面盯盘，附故障自查清单

【免费下载链接】freqtradeFree, open source crypto trading bot项目地址: https://gitcode.com/GitHub_Trending/fr/freqtrade

策略上线之后，最折磨人的往往不是写代码，而是"盯盘"——总想随时确认当前持仓、最新成交和余额变化，却不想开着终端刷日志。Freqtrade WebUI（官方前端 FreqUI）就是干这件事的：一个跑在浏览器里的可视化面板，把实时行情、交易记录和机器人控制都摆到页面上。读完这篇指南，你能拿到三样东西：一条命令拉起 WebUI 并判断它是否启动成功、盯盘/图表/设置三大面板的操作路径，以及一份覆盖 CORS 报错、远程访问两类高频率问题的自查清单。

一条命令启动 FreqUI

🚀 最短路径只需要两步：确保前端已安装，然后以任何会拉起 API 服务的模式启动机器人。

freqtrade install-ui # 首次使用执行；日后升级 FreqUI 也用它 freqtrade trade # 启动机器人，WebUI 随 API 服务一并就绪

官方文档：docs/commands/install-ui.md

默认访问地址是http://127.0.0.1:8080。判据只有一条：浏览器打开这个地址出现登录界面（见下图），就算启动成功。看不到登录页，再往下翻到"故障自查"一节。

盯盘监控：实时盯住每一笔单

进入 WebUI 后的默认页就是交易面板，它回答的问题很直接："机器人现在在干什么？"

• 实时行情图表：当前交易对的 K 线与买卖信号一目了然
• 活跃订单与交易历史：正在持仓的单和已平仓的单分开列出，含价格、数量与盈亏
• 机器人启停控制：页面上直接暂停/恢复交易，不用切到终端
• 强制交易：在配置允许的前提下，可手动触发开仓或平仓

图表定制：把 K 线页变成你自己的分析台

右上角的"设置"（齿轮图标）能打开 Plot Configurator，图表怎么画由你决定：

• 选指标：MACD、RSI、布林带等常用技术指标按需叠加
• 换周期：不同时间框架的图表可以并存
• 存多套方案：把常用画法保存为独立配置，随时一键切换
• 从策略加载：策略文件里写好的plot_config可直接导入，保证回测和实盘看到的图一致

个性化设置：把界面调成你的习惯

设置页里改的都是"显示层"的事，不涉及策略逻辑：

• 主题：深色/浅色一键切换，长时间盯盘推荐深色
• 时区：K 线时间轴按你所在时区对齐
• K 线涨跌颜色：习惯"红涨绿跌"还是"绿涨红跌"可以自己定
• 通知与标签页图标：让浏览器标签在有新交易时提醒，不用开着页面等

进阶模式：webserver 独立跑，不交易也能用

freqtrade webserver启动的是一个纯 Web 服务，不加载交易引擎，但把 FreqUI 的"生产力"部分全部开放：

• 数据管理：在页面上完成历史行情数据的下载
• 可视化回测：选策略、定时间范围、跑回测，结果直接在图表里呈现，方便横向比较
• 批量操作：如交易对列表测试等工具类命令也可通过接口触发

freqtrade webserver # 独立 Web 服务器模式，无需启动交易

官方文档：docs/commands/webserver.md

故障自查：三个高频问题按"现象→原因→动作"处理

1. 浏览器打不开页面原因通常是 API 服务没启动，或防火墙拦了 8080 端口。先确认freqtrade trade在跑且配置里api_server为启用状态，再放行端口。

2. 登录后报 CORS 错误、数据加载不出来原因：跨域策略没放行你访问 FreqUI 的实际地址。在配置中加入两处（注意地址末尾不能带斜杠，否则不生效）：

{ "jwt_secret_key": "换成你自己知道的随机字符串", "CORS_origins": ["http://localhost:8080"] }

官方说明：docs/includes/cors.md

3. 远程服务器上访问不到原因：默认只监听本机地址。把监听地址改为全网卡，并尽快上 HTTPS 反向代理：

{ "api_server": { "enabled": true, "listen_ip_address": "0.0.0.0", "listen_port": 8080 } }

下一步

🔧 到这里，Freqtrade WebUI 的核心能力——盯盘、看图、调界面、跑回测——已经全部可以在浏览器里完成。建议接着做三件事：

1. 把策略里的plot_config导入 WebUI，统一实盘与回测的视图
2. 用 webserver 模式对同一策略跑两个不同时间段的回测，直观对比表现
3. 给jwt_secret_key和CORS_origins做一次正式配置，再开放远程访问

完整功能说明可查阅官方文档：docs/freq-ui.md。如果踩到本文没覆盖的坑，欢迎把现象贴到社区讨论，一起补充进这份清单。

【免费下载链接】freqtradeFree, open source crypto trading bot项目地址: https://gitcode.com/GitHub_Trending/fr/freqtrade