- 自 2022 年 10 月起,每家经纪商都拥有与其自身平台和域名绑定的专属 MT5 网页终端;旧的共享终端已不再为任意服务器提供服务。
- 将其放到您的网站上有三种方式:“立即交易”链接、iframe 嵌入,或在您自有子域名上全屏运行的品牌化终端。
- iframe 设置快捷,但在手机上显得局促,可能被禁止嵌入的响应头拦截,并且在浏览器限制第三方存储时可能丢失已保存的登录信息。
- 大多数“无法使用”的反馈都可归结为少数几个原因:服务器未启用网页终端、使用了通用演示终端、禁止嵌入的响应头、混合内容,或 DNS 与证书设置问题。
- 部署在您自有子域名(例如 trade.yourbrand.com)上的终端,可将您的品牌、法律信息和访问规则集中在一处,并在所有设备上全屏运行。
- FXPTrader 通过您自己 Cloudflare 账户中的 Cloudflare Worker 提供这一品牌化终端;它不是 MT5 许可证,因此您仍需拥有自己的 MT5 接入权限。
如何将 MT5 网页版添加到您的网站?
将 MetaTrader 5 网页终端(MT5 网页版)添加到网站有三种方式:通过“立即交易”按钮链接到您的经纪商网页终端,在某个页面中通过 iframe 嵌入,或在您自有的子域名(例如 trade.yourbrand.com)上全屏提供。无论哪种方式,都必须先为您的交易服务器启用网页终端,因为自 2022 年 10 月起,MetaQuotes 为每家经纪商提供独立的网页终端,而不再是所有人共用的一个页面。
链接是最快的途径;iframe 能让访客留在您的页面上,但会带来技术限制;自有域名终端则能提供最一致的品牌和移动端体验。本指南其余部分将介绍每种方式的设置方法、确切的 iframe 参数、上线检查清单,以及如何修复经纪商实际遇到的错误。
2022 年 MT5 网页终端发生了哪些变化?
多年来,MetaQuotes 提供一个任何经纪商都可放到自己网站上的共享网页终端。其 2017 年关于嵌入的 MQL5 文章介绍了带有 servers、trade_server、lang、startup_mode、save_password、demo_all_servers 和 utm_campaign 等参数的 iframe,并声明:“我们不对在您的网站上使用 WebTerminal 收取任何费用。”许多较早的教程和论坛回答仍在描述这一模式。
2022 年 10 月 12 日,MetaQuotes 宣布推出新的网页终端,它“作为独立的网页终端运行,仅适用于特定经纪商的平台”。它运行在经纪商的接入服务器上,与经纪商自己的域名关联,用 MetaQuotes 的话说,可为“经纪商提供最高的安全性和完全的控制权”。根据公告,已持有网页终端许可证的经纪商可免额外费用部署,其他经纪商则通过 MetaQuotes 支持团队订购。
2023 年 9 月,MetaQuotes 发布了面向经纪商的视频指南,涵盖安装过程“从选择域名到将网页终端集成到您的网站,全部在 30 分钟内完成”,包括自定义首页、分析和界面。对于 2026 年搜索“如何把 MT5 网页版放到我的网站上”的人来说,实际影响是:
- 起点是您自己的经纪商网页终端,并为您的交易服务器启用,而不是旧的共享页面。
- 复制指向共享终端的旧 iframe 代码,通常会导致报错,或得到一个只显示演示服务器的终端(参见故障排除部分)。
- 域名、品牌和访问方面的决定如今都由经纪商自行掌握,这也是自有域名部署变得普遍的原因。
客户可以在 MetaTrader 5 网页终端中做什么?
在决定把它放在多显眼的位置之前,最好先了解网页终端与桌面版和移动应用相比能提供什么。根据 MetaTrader 5 官方网页交易页面,该终端基于 HTML5 构建,无需安装。它可在 Windows、macOS 和 Linux 上的 Chrome、Safari、Edge、Opera 和 Firefox 中运行,并针对 iOS 和 Android 的移动浏览器进行了优化。
| 方面 | MT5 网页终端(据 MetaQuotes) | 对您网站的意义 |
|---|---|---|
| 安装 | 无需安装,在浏览器中运行 | 一个链接或一个页面就足以让客户开始交易 |
| 订单 | 所有 MT5 订单类型,一键交易 | 可作为主要交易平台,而不只是查看工具 |
| 持仓核算 | 净额(netting)和对冲(hedging) | 适用于您服务器上的任一账户模式 |
| 账户 | 模拟账户和真实账户 | 可用于模拟账户注册和真实账户开户流程 |
| 分析 | 30 种指标、24 种分析对象、9 个时间周期、3 种图表类型、夜间主题 | 足以满足大多数主观交易者 |
| 语言 | 产品页面列出 8 种界面语言;MQL5 嵌入文章提到 41 种 | 将语言设置为与客户来源页面一致 |
| 自动化 | EA(Expert Advisors)和自定义指标无法在网页版中运行(经纪商资料) | 引导算法交易者使用桌面终端 |
如需更全面地比较三种客户端平台,请参阅 MT5 网页版、桌面版与移动版对比。
链接、iframe 还是自有域名:应该选择哪种方式?
| 链接 | iframe 嵌入 | 品牌化自有域名 | |
|---|---|---|---|
| 设置工作量 | 几分钟 | 几分钟到几小时 | 通常当天完成 |
| 浏览器中的网址 | 网页终端的网址 | 您的页面,终端嵌在框内 | 您的子域名 |
| 全屏交易 | 是 | 受框架限制 | 是 |
| 移动端体验 | 良好 | 常显局促 | 良好 |
| 已保存的登录 | 浏览器正常行为 | 第三方存储被阻止时可能失效 | 浏览器正常行为 |
| 公司信息与法律链接 | 有限 | 仅在框架周围 | 全程展示 |
| 按账户号段控制访问 | 否 | 否 | 是(使用 FXPTrader) |
| 需维护的服务器 | 无 | 无 | 无(边缘分发) |
可借助以下问题做出决定:
- 网页终端是主要平台还是辅助选项?如果许多客户只在浏览器中交易,那么在自有域名上提供全屏终端值得多走这一步。
- 您的流量中有多少来自移动端?页面内的框架在手机上留下的空间很小;链接或自有域名终端则可使用整个屏幕。
- 是否需要在终端中显示您的法律实体、牌照和隐私链接?受监管的经纪商通常需要;请参阅网页终端应显示哪些公司信息。
- 您是否运营多个品牌或合作伙伴网站?为每个品牌单独部署品牌化终端,可避免名称和联系方式混用。
- 是否需要限制谁可以登录?自营交易公司(Prop firm)和 IB 计划通常只希望特定账户号段使用某个网址。
对许多经纪商来说,合理的路径是第一天先上线链接,之后迁移到自有域名终端,并让该链接指向新网址。
如何从您的网站链接到 MT5 网页终端
链接是最简单、最可靠的方式;即使您之后打算采用更完善的方案,它也是正确的第一步。
- 获取您的经纪商网页终端地址。如果您的 MT5 由平台服务商提供,请向其索取为您的交易服务器启用的网页终端 URL。如果您运营自己的 MT5 平台,请按照 MetaQuotes 经纪商指南中的说明部署网页终端。
- 使用模拟账户和真实账户进行测试,分别在桌面和手机上测试,并记下客户必须选择的确切交易服务器名称。
- 添加醒目的按钮,例如在主导航和客户后台中添加“网页交易”或“立即交易”。在新标签页中打开,以便客户仍可在客户后台办理入金和查看文件。
- 为链接添加营销活动追踪(如果您的分析设置支持),以便了解哪些页面带来了登录。
- 在开户引导邮件中重复该链接,并与登录名和服务器名称放在一起,让新客户无需四处寻找。
缺点是网址和大部分呈现方式可能并不属于您。客户从您的品牌网站跳转到一个他们可能不认识的页面,这往往是新交易者犹豫的环节。
如何通过 iframe 嵌入 MT5 网页终端
iframe 将终端放在您自己的某个页面中。最简单的嵌入代码如下,请将地址替换为您的经纪商网页终端地址,并将服务器名称替换为您的服务器名称:
<iframe src="https://YOUR-WEB-TERMINAL-ADDRESS/?servers=YourBroker-Live&trade_server=YourBroker-Live&lang=en" width="100%" height="700" allow="fullscreen" title="Web trading terminal"></iframe>
以下参数名称来自 MetaQuotes 2017 年关于共享终端的 MQL5 文章。请向您的平台服务商确认,您自己的网页终端仍支持其中哪些参数。
| 参数 | 用途 | 实用建议 |
|---|---|---|
servers | 登录对话框中提供的交易服务器 | 只列出您自己的服务器,避免客户选错 |
trade_server | 默认选中的服务器 | 在客户后台页面使用真实服务器,在注册页面使用模拟服务器 |
lang | 界面语言 | 与承载框架的页面语言保持一致 |
startup_mode | 终端打开时的初始操作,例如开立模拟账户 | 适用于“试用模拟账户”落地页 |
save_password | 是否可以记住登录信息 | 在框架内的表现取决于浏览器存储规则 |
demo_all_servers | 跨服务器开立模拟账户 | 通常保持关闭,让模拟账户开在您的服务器上 |
utm_campaign | 用于追踪的营销活动标签 | 使用与其他营销活动相同的命名方式 |
使用 iframe 时需要处理好以下几点:
- 高度。在笔记本电脑上看起来合适的固定高度,在手机上往往过短或过长。请使用自适应高度(例如基于视口单位),并在真实设备上测试。
- 嵌入权限。终端所在服务器必须允许被您的域名嵌入。如果它发送
X-Frame-Options: DENY,或发送排除了您网站的 Content-Security-Policyframe-ancestors规则,浏览器将显示一个空白框。 - 您自己页面的策略。如果您的网站使用带有
frame-src或child-src的 Content-Security-Policy,请将终端地址加入其中。 - 两端都使用 HTTPS。在
https://页面中嵌入http://框架会因混合内容而被阻止。 - 存储与 Cookie。多款主流浏览器默认阻止或分区第三方框架的存储,因此“记住我”可能无法在两次访问之间保留。
- Cookie 同意。如果您的同意横幅在用户接受之前阻止第三方内容,那么对于尚未做出选择的访客,框架可能一直为空。
对于模拟账户落地页或“立即试用”小组件,iframe 是合理的选择。对于日常交易,大多数经纪商更倾向于全屏终端。
如何在自有域名上提供 MT5 网页版
使用自有域名终端时,客户打开 trade.yourbrand.com,即可看到显示您的公司名称、联系方式和法律链接的全屏终端。这是客户在您的网站和邮件中已经熟悉的网址,也可以像其他页面一样加入书签。
FXPTrader 通过部署在您自己 Cloudflare 账户中的 Cloudflare Worker 实现这一点。该 Worker 在您的子域名上提供终端并将其连接到您的交易服务器;无需租用或修补任何服务器。据 Cloudflare 介绍,其网络覆盖 100 多个国家的 348 个城市,其 Workers 运行时支持实时交易终端所依赖的 WebSocket。交易服务器本身仍由您的 MT5 平台承载,因此订单执行仍在原来的地方进行。
典型步骤:
- 确认您的 MT5 接入权限。您需要拥有自己的 MT5 平台或通过服务商接入,并且您的服务器已提供网页终端。FXPTrader 不是 MT5 许可证或白标;请参阅白标、灰标与自有许可证对比。
- 将您的域名添加到 Cloudflare(如尚未添加),并选择子域名,例如
trade、webtrader或terminal。 - 将 Worker 部署到您的 Cloudflare 账户中。
- 以 Cloudflare 环境变量的形式填写设置(见下表)。
- 绑定自定义域名。Cloudflare Custom Domains 会自动创建 DNS 记录和证书;请注意不支持通配符自定义域名,因此需要逐个添加子域名。
- 测试模拟和真实账户登录、允许号段之外的账户、移动版 Safari 和 Chrome,以及法律链接。
- 在网站中添加链接,包括导航、客户后台和开户引导邮件,并将所有旧的 iframe 或链接更新为新网址。
| 设置项 | 控制内容 | 示例 |
|---|---|---|
| 公司名称、地址、电子邮件、电话、网站 | 终端中显示的品牌和联系信息 | 您的法律实体和客服联系方式 |
| 交易服务器名称 | 客户登录的服务器 | YourBroker-Live |
| 上游地址(Upstream) | Worker 所连接的网页终端后端 | 随您的 MT5 接入权限一同提供的地址 |
| 牌照 URL 和隐私 URL | 向客户显示的法律链接 | 您的监管信息和隐私政策页面 |
| 终端用户文本 | 风险警示等提示信息 | 您的标准风险披露 |
| 允许登录的号段 | 哪些账户号码可以在此网址登录 | 仅限某一品牌的真实账户 |
由于一切都通过配置完成,典型部署可在当天上线;多个品牌也可以并行运行,每个品牌使用一个 Worker 和一套配置;请参阅多品牌 WebTrader。DNS 方面的详细说明请阅读 WebTrader 子域名与 DNS 设置,产品概览请参阅白标 WebTrader。
MT5 网页终端无法使用?常见错误与解决方法
以下是经纪商及其客户在网站上添加网页终端时最常报告的问题,以及常见原因和解决方法。
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| “WebTerminal is not supported by this MetaTrader 5 Server”(此 MetaTrader 5 服务器不支持 WebTerminal) | 该交易服务器未启用网页终端;如今每家经纪商都自行托管网页终端 | 通过 MetaQuotes 或您的平台服务商为您的服务器启用或订购网页终端,然后让页面指向该终端 |
| 只显示 MetaQuotes-Demo 或其他演示服务器 | 页面使用的是通用终端,或缺少 servers 参数 | 使用您的经纪商网页终端,并列出您自己的服务器名称 |
| 框架内空白或显示“拒绝连接” | X-Frame-Options 或 frame-ancestors 禁止嵌入,或您自己的 CSP 阻止了该来源 | 检查浏览器控制台;允许您的域名嵌入终端,或改用链接或自有域名终端 |
| 框架因混合内容被阻止 | 在 https:// 页面中通过 http:// 加载终端 | 终端地址使用 HTTPS |
| 客户每次访问都被登出 | 浏览器阻止或分区了框架内的第三方存储 | 在自有域名上全屏提供终端 |
| 终端能加载但没有报价,或不断重连 | 代理、防火墙或配置错误的上游中断了实时连接,或服务器名称错误 | 在网络面板中检查失败的 WebSocket 连接,并核对服务器名称和上游地址 |
trade.yourbrand.com 出现证书警告 | DNS 或证书仍在签发中,或存在冲突的 DNS 记录 | 删除该子域名的旧记录,让 Cloudflare 为自定义域名签发证书 |
| 有效账户无法在品牌化网址登录 | 账户号码不在允许登录的号段内 | 扩大号段,或引导客户前往对应品牌的网址 |
| 界面语言错误 | 未设置 lang,或使用了浏览器默认语言 | 按页面或按品牌设置语言 |
向平台服务商提交工单时,请附上您使用的完整地址、交易服务器名称、浏览器和设备,以及浏览器控制台截图。这能大大减少来回沟通。
网页终端应该放在网站的哪些位置?
只有当客户在想交易时能找到终端,它才能发挥作用。适合放置链接或按钮的位置:
- 主导航:“网页交易”或“立即交易”菜单项,在桌面端和移动端菜单中都可见。
- 客户后台:放在账户详情、入金和平台下载旁边,并在旁边显示服务器名称。
- 开户审核通过邮件和欢迎邮件:将登录名、服务器名称和终端链接放在同一区块中。
- 平台页面:与桌面版和移动版下载并列,并说明网页版无需安装。
- 模拟账户落地页:直接进入模拟账户的入口,这也是 iframe 仍然适用的场景。
- 自营交易公司仪表盘和 IB 合作伙伴页面:放在挑战账户登录信息或合作伙伴注册链接旁边,最好使用仅限相应账户号段的网址;请参阅如何限制 MT5 网页版的登录号段。
保持一个规范网址。如果链接发生变化,请同时更新上述所有位置,并尽可能将旧网址重定向,以便书签和邮件继续有效。
上线前检查清单与常见误区
在向客户发布终端之前,请逐项核对以下清单:
- 已为您的真实和模拟服务器启用网页终端,且两个服务器名称的拼写与客户看到的完全一致。
- 真实账户和模拟账户都能登录,并能下单、修改和平仓。
- 终端在手机竖屏模式下可在 Safari 和 Chrome 中正常使用。
- 公司名称、地址、联系方式、牌照链接、隐私链接和风险提示文本对该品牌均准确无误。
- 网址使用 HTTPS 且无警告,旧链接或 iframe 已指向新网址。
- 不应使用此网址的账户号段会被拒绝,且客服了解客户在这种情况下看到的内容。
- 分析工具和 Cookie 同意的行为符合您的政策要求。
- 客服人员针对故障排除表中的错误准备了简短的应答话术。
反复出现的误区:
- 照搬 2022 年之前的教程,将嵌入代码指向共享终端,而该终端已不再为任意服务器提供服务。
- 只在桌面端测试,之后才发现框架在手机上无法使用。
- 品牌混用:同一个终端带着某一家公司的法律信息,却被多个品牌或合作伙伴使用。
- 以为网页终端可以运行 EA;它并不支持,因此请告知算法交易者使用桌面终端。
- 把品牌化终端当作许可证。品牌化前端背后需要 MT5 接入权限;它不能取代您的平台协议。
资料来源
- MQL5:如何在您的网站上嵌入 MetaTrader WebTerminal(2017)
- MetaTrader 5:面向经纪商的全新独立网页终端(2022 年 10 月)
- MetaTrader 5:面向经纪商的网页终端视频指南(2023 年 9 月)
- MQL5 论坛:“WebTerminal is not supported by this MetaTrader 5 Server”(2024)
- MetaTrader 5 网页交易平台功能
- Cloudflare Workers:Custom Domains(自定义域名)
- Cloudflare Workers:WebSockets
- Cloudflare 全球网络
常见问题
可以用 iframe 将 MT5 网页版嵌入我的网站吗?
可以,前提是您的交易服务器已启用网页终端,且其地址允许被您的域名嵌入。MetaQuotes 2017 年的文章介绍了 servers、trade_server 和 lang 等 iframe 参数。由于浏览器会限制第三方框架内的存储,在移动端和已保存登录方面会有一定限制。
嵌入 MT5 网页终端是免费的吗?
对于旧的共享终端,MetaQuotes 曾表示不对在您网站上使用 WebTerminal 收费。对于 2022 年推出的经纪商独立终端,MetaQuotes 表示持有网页终端许可证的经纪商可免额外费用部署,其他经纪商则通过支持团队订购。在自有域名上提供品牌化终端是另一项服务。
为什么会提示“WebTerminal is not supported by this MetaTrader 5 Server”?
您所指向的交易服务器未启用网页终端。自 2022 年起,每家经纪商都自行托管网页终端,共享终端已不再连接任意服务器。需要由经纪商或其平台服务商为该服务器启用网页终端。
为什么我嵌入的终端只显示 MetaQuotes-Demo?
页面加载的是通用终端而不是您的经纪商网页终端,或缺少 servers 参数。请将嵌入代码或链接指向您自己的网页终端地址,并只列出您自己的服务器名称。
为什么我的 MT5 iframe 是空白的?
通常是终端所在服务器通过 X-Frame-Options 或 Content-Security-Policy 的 frame-ancestors 规则禁止被嵌入,或您自己网站的策略阻止了该来源。混合内容(在 https 页面中嵌入 http 框架)也会造成同样的结果。浏览器控制台会指出确切原因。
可以使用 trade.mybroker.com 这样的子域名吗?
可以,这也是最常见的自有域名部署方式。使用 FXPTrader 时,子域名以 Cloudflare Custom Domain 的形式绑定,会自动创建 DNS 记录和证书。由于不支持通配符自定义域名,每个子域名需单独添加。
品牌化网页终端是否等于获得了 MT5 许可证?
不是。品牌化终端是面向客户的前端;交易服务器、账户和订单执行仍在您的 MT5 平台上。您仍需要自己的 MT5 接入权限,无论是自有许可证还是通过服务商接入。
客户可以在 MT5 网页终端中运行 EA 吗?
不可以。经纪商资料一致指出,EA(Expert Advisors)和自定义指标无法在 MT4 或 MT5 网页版中运行。使用自动化策略交易的客户应使用桌面终端。
哪种方式最有利于转化?
部署在自有品牌域名上的全屏终端通常能带来最流畅、最受信任的体验,在手机上尤其如此,因为网址、品牌和法律信息都与您的网站一致。链接是不错的过渡方案,而 iframe 更适合模拟账户落地页,而非日常交易。
能否限制哪些账户可以登录我的网页终端?
普通链接或 iframe 无法做到。FXPTrader 允许您为每个部署设置允许登录的号段,因此用于某一品牌、某个自营交易计划或某个合作伙伴的网址只接受相应的账户号码。
能否追踪客户是通过哪个营销活动进入终端的?
MetaQuotes 的嵌入参数包括 utm_campaign。在自有域名上,您还可以使用常规的分析工具,但需遵循您的 Cookie 同意设置和隐私政策。
在自有域名上部署网页终端需要多长时间?
MetaQuotes 表示,其经纪商指南可在约 30 分钟内完成从选择域名到集成到网站的安装过程。使用 FXPTrader 时,Worker 和设置部署在您的 Cloudflare 账户中,一旦您的 MT5 接入权限和域名准备就绪,典型部署可在当天上线。