Freqtrade WebUI 完整指南：快速上手 FreqUI，实现加密货币交易监控与回测
【免费下载链接】freqtradeFree, open source crypto trading bot项目地址: https://gitcode.com/GitHub_Trending/fr/freqtrade
如果你正在用 Freqtrade 跑自动交易，Freqtrade WebUI（即 FreqUI）就是官方内置的浏览器端面板：不写脚本、不敲命令，也能完成加密货币交易监控、K 线分析、策略回测与历史数据下载。下面按"装好 → 配好 → 用好"的顺序，把启动、配置到排错的流程完整走一遍。
读完这份指南，你可以：
- 一条命令安装并启动 FreqUI，访问默认 8080 端口完成首次登录
- 正确配置登录令牌与 CORS，一次解决跨域报错
- 熟练玩转交易监控面板、图表配置工具与系统设置
- 在独立 webserver 模式下执行 FreqUI 回测、管理历史行情数据
- 遇到"页面打不开""登录后数据不加载"时，按症状快速定位原因
三分钟启动 FreqUI：安装、启动与登录一次配好
安装：多数情况开箱即用
通过官方安装脚本或 Docker 部署 Freqtrade 时，FreqUI 已随主程序一并装好，通常无需任何额外操作。只有手动维护环境、或想把界面升到最新版时，才需要执行：
freqtrade install-ui该命令会拉取最新版前端文件并自动部署到位，细节见 docs/commands/install-ui.md。
启动：两种模式按需选择
freqtrade trade：机器人照常交易，Web 服务随交易进程一起拉起，适合"边跑边看"的日常使用。freqtrade webserver：单独启动 Web 服务、不执行交易，专用于数据下载、策略回测等管理任务。
启动后默认监听http://127.0.0.1:8080，端口、监听地址等完整选项参考 docs/commands/webserver.md。
登录：令牌与 CORS 各配一次
首次访问会停在登录页，系统默认生成一个临时访问令牌；如果打算长期使用，建议在配置中写入固定的jwt_secret_key，省去反复换取令牌的麻烦。
当访问地址与 8080 服务不一致（换过端口或经过反向代理）时，浏览器会拦截跨域请求，这时需要在配置中声明允许的来源：
{ "CORS_origins": ["http://localhost:8080"] }💡 两个细节：来源 URL 结尾多写一个斜杠，整条配置就会失效；填写的必须是你实际打开 FreqUI 的那个地址。跨域配置完整说明见 docs/includes/cors.md，FreqUI 总览见 docs/freq-ui.md。
FreqUI 界面详解：从交易监控到图表定制
交易监控面板：日常看盘主界面
📊 登录后默认进入交易面板，高频操作都集中在这里：
- 实时 K 线行情，随新 K 线滚动刷新
- 活跃交易列表：开仓价、浮动盈亏一目了然
- 交易历史记录，方便事后复盘
- 机器人启停控制
- 强制买卖入口（需额外开启对应权限）
图表配置：指标、周期与方案管理
点击右上角的设置图标，即可打开图表配置面板：
- 勾选 MACD、RSI、布林带等常用技术指标
- 调整展示的时间周期
- 把常用组合保存成多套方案，随时切换
- 直接加载策略里定义的绘图配置，让界面与策略逻辑保持一致
配置生效后，买卖信号会直接标注在 K 线上，回看每一笔交易出现的时机非常直观：
系统设置：主题、时区与提醒
设置页负责个性化显示与通知行为：
- 深色 / 浅色主题切换
- 时区设置，保证时间轴与行情时间对齐
- 交易相关通知开关
- K 线涨跌配色反转，习惯"红跌绿涨"的用户可直接调换
- 浏览器标签页图标的提醒启用 / 禁用
进阶玩法：webserver 独立模式下的回测与数据管理
用freqtrade webserver启动的独立服务不跑交易，却多了一批管理型能力：
- 数据下载与管理：在界面上选交易所、交易对与时间范围，直接拉取历史 K 线，免去手工执行数据命令的步骤
- 策略回测：选定策略与时间范围、调好回测参数后执行，结果以图表加表格的形式可视化呈现，还支持多个策略同屏对比表现
- 交易对列表测试：验证 pairlist 插件在当前市场条件下的筛选结果
- 批量操作入口：一次性处理多组参数与任务
一个实用的节奏是：日常用交易模式盯盘，想验证新策略时再起一个 webserver 实例跑 FreqUI 回测，两条线互不影响。
常见坑位速查：按症状对症修
页面完全打不开。按顺序查三处：Freqtrade 进程是否还在运行；防火墙是否放行 8080 端口；配置中api_server的 enabled、listen_ip_address、listen_port 是否符合预期。
能登录、数据却不加载。大概率是 CORS 问题：CORS_origins必须包含你实际访问 FreqUI 的完整 URL——少配一条、http/https 写反、结尾多一个斜杠，都会让请求被浏览器拦下。改对后刷新页面即可，这是最典型的 FreqUI CORS 修复动作。
远程服务器访问。先放行防火墙的 8080 端口，再把监听地址改为对外：
{ "api_server": { "listen_ip_address": "0.0.0.0", "listen_port": 8080 } }随后用http://服务器IP:8080访问即可。⚠️ 公网直接暴露端口风险不小，强烈建议前置一层 HTTPS 反向代理，并把jwt_secret_key换成高强度随机值，完成 FreqUI 远程访问的安全收尾。
FreqUI 的价值在于把 Freqtrade 的终端能力搬进了浏览器：装好、配好令牌与 CORS 之后，日常监控、回测、数据管理就都能在页面上完成。
下一步建议：
- 用图表配置工具固化一套自己的指标组合，并对照策略的 plot 配置检查一致性
- 在 webserver 模式下挑 2~3 个候选策略各跑一轮 FreqUI 回测，横向对比胜率与回撤
- 远程部署尽快补上 HTTPS 反向代理与高强度登录令牌，再启用移动端访问
【免费下载链接】freqtradeFree, open source crypto trading bot项目地址: https://gitcode.com/GitHub_Trending/fr/freqtrade
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
