PositionRelay logoPositionRelay

Docs / MT5 最適化:セットアップと使い方

Optimizations

MT5 最適化:セットアップと使い方

自分でホストする MT5 worker を設定し、パラメータ、操作、状態、結果を理解しましょう。Pro または Ultimate で利用できます。

MT5 最適化とは?

お使いのコンピューターの Docker worker が MT5 最適化を実行し、ダッシュボードのコマンドを定期的に確認します。

EA(.ex5)、パラメータグリッド(.set)、MT5 ブローカー口座(デモまたはリアル)はご自身で用意します。結果はコンピューターの reports フォルダーに保存され、ダッシュボードに Passed と Favorites として表示されます。会社ポートフォリオには、対応するポートフォリオ EA のソースコードが必要です。

この機能はセルフホストです。PositionRelay が代わりに MetaTrader を動かすことはありません。現時点でホスト型オプティマイザーはありません。

仕組み

公開されている Wine + MetaTrader 5 Docker イメージがマシン上で動作します。ハートビートは PositionRelay User ID で認証し、Pro または Ultimate 権限を確認したうえでダッシュボードのコマンドを待ちます。

検証済みの結果は Passed と Favorites に表示されます。会社ポートフォリオには、対応するポートフォリオ EA のソースコードも必要です。

  1. Pro または Ultimate に加入し、Dashboard → Setup → MT5 Optimizations を開く。
  2. Docker をインストールし、お使いの OS に合ったセットアップウィザードに従ってください。
  3. Experts と SetFiles をマウントし、optimizer.env を書いてコンテナを起動する。
  4. 起動ログでブローカー認証を確認してから、Dashboard → Optimizations で worker がオンラインであることを確認します。
  5. 日付・銘柄・時間足を設定し、Start を押す。

要件

  • 有効な PositionRelay Pro または Ultimate サブスクリプション。
  • Docker が動作する Windows、Linux、または Intel macOS の x64 コンピューター。Apple Silicon / ARM は非対応です。
  • リアルティック履歴に十分な RAM とディスク容量。Docker Desktop を使う場合は設定でリソースを調整できます。
  • MT5 ブローカー口座(デモまたはリアル)のログイン、パスワード、サーバー。
  • 自作のコンパイル済み EA(.ex5)。MQL5 Market の EA はアクティベーションロックのため動作しません。
  • ウィザードの説明どおり、SetFiles/Classic/<timeframe> 配下に .set ファイルを置きます。

Docker セットアップ

標準口座では、MT5 がその口座について報告する正式な会社名を optimizer.env の MT5_COMPANY に入力します。HTML 最適化レポートの Company 欄と同じ表記・大文字小文字です。ブランドの略称は不可です。MT5 が FTMO Global Markets Ltd と報告する場合、FTMO では失敗します。追加口座はコンピューター上の Broker/accounts.json に保存します。accounts 配列の各口座には一意の id と company、server、login、password が必要です。会社ごとに口座を一つだけ登録し、company と server は MT5 から正確に写してください。設定ウィザードにコピーできる例があります。accounts.json を編集したらコンテナーを再起動します。optimizer.env の口座が再び有効になります。

手順ごとのインストール方法は Dashboard → Setup → MT5 Optimizations にあります。ウィザードが OS に合ったフォルダー、ファイル、コマンドを示し、User ID を入力します。

ファイルの置き場所: オプション 1 はお使いのコンピューター上のフォルダー(Windows は C:\PositionRelay\optimizer、Linux と macOS は $HOME/PositionRelay/optimizer)で、EA、.set ファイル、Broker/servers.dat、optimizer.env を置きます。現在利用できるのはこの方法だけで、ウィザードもこれを使います。オプション 2(EA、.set ファイル、環境変数を PositionRelay にアップロード)は近日提供予定で、ご自身の責任での利用となります。

Experts、SetFiles、Broker、reports の各 -v 行では、左側がコンピューター上のフォルダー、/data/... がコンテナー内のパスです。ファイルが別の場所にある場合は、Windows のドライブ文字を含め、ホスト側のパス全体をそれぞれ変更してください。--env-file のパスだけを変更しても、これらのマウントは変わりません。

接続できている MT5 で File → Open Data Folder を開き、config/servers.dat だけを最適化用の Broker フォルダーにコピーしてください。Docker 内の MT5 がブローカーを見つけるために必要です。accounts.dat はコピーしないでください。保存先はセットアップウィザードに表示されます。

ウィザードに従い、MT5 ブローカー口座を使用してください。MT5_LOGIN、MT5_PASSWORD、MT5_SERVER は optimizer.env に残してください。entrypoint はそれらを /dev/shm にコピーし、パスワードは worker プロセスからのみ解除します。

初回起動では、heartbeat の前にブローカーログインを行うため、数分かかる場合があります。コンテナのログを確認してください。"Starting optimizer heartbeat" の表示後、数回のポーリングを経て Optimizations ページに worker がオンラインと表示されます。

  • optimizer.env をコミットしないでください。
  • Experts と SetFiles は読み取り専用でマウントされ、reports は書き込み可能です。
  • MT5 ツリーとティックキャッシュは名前付きボリューム positionrelay-mt5 にあります。

ダッシュボードから実行

Optimizations のセレクターで設定済みブローカーを選び、切り替え完了を待ちます。そのブローカーの MT5 カタログから銘柄を選んで Start を押します。最初も切り替え後も銘柄は未選択です。worker の処理中はブローカーを変更できません。履歴のみのブローカーでは過去の結果を閲覧できますが、処理は開始できません。Docker がオフラインのときは最後のカタログが古いと表示され、操作できません。

Dashboard → Optimizations を開きます。日付範囲、銘柄、時間足、最適化モード、残高、最大エクイティドローダウンを選びます。必要に応じて検証後のロバストネスを有効にします。

Start は新しいバッチを開始します。Resume は中断した最適化実行を続行します。worker がオンラインのとき、Stop は現在の worker ジョブ(最適化、ロバストネス、ポートフォリオ構築、お気に入り同期、ブローカー切替)を取り消します。worker はオンラインのままです。Clean はホスト上のテスターキャッシュを削除し、アイドルな worker 向けです。

ページを開いている間、ライブ状態は数秒ごとに更新されます。ジョブ中はコンテナを起動したままにしてください。

最適化ダッシュボードを使う

  1. 設定済みブローカーを選び、有効化を待って heartbeat が正常か確認します。
  2. 日付、銘柄、時間足、通貨、テスト残高、ドローダウン目標を選びます。最初は少ない組み合わせにします。
  3. 開始を一度押し、動作、キュー、進捗を確認します。10 秒ごとに更新されます。Docker は動かしたままにします。
  4. 最近の結果と合格した戦略を確認し、レポートを開き、必要なら堅牢性テストを依頼します。バッチ終了後にお気に入りを追加します。
最適化ダッシュボードを使う
デモデータの例です。画像を開くと拡大できます。ブローカー、設定、結果は環境によって異なります。

worker と実行状態

Heartbeat:alive / stale
alive は最近の ping を示し、ブローカー認証やテスト成功を保証しません。stale は最近の ping がない状態です。Docker と接続を確認してください。
最適化処理:待機 / オフライン
待機はオンラインで動作報告がない状態です。オフラインには最後の動作が表示されることがあり、現在も実行中とは限りません。
動作の種類
最適化中はバッチ実行、お気に入り移動はファイル更新、同期は保存内容の照合、ポートフォリオ構築は会社別生成、ブローカー切替は口座有効化、堅牢性チェックはストレステスト、停止中は中断、クリーン中は生成物削除です。Worker 使用中は旧版の一般的な状態です。
開始中… / キュー待ち…
開始中は具体的な動作が報告される前の処理中です。黄色い行は待機コマンドで、複数なら件数を表示します。Stop が先に表示されます。待機は完了ではありません。
最終 ping
最後の heartbeat 時刻。結果を含むダッシュボードの日時は言語に合った形式で UTC 表示です。ダッシュは日時不明を示します。
最適化実行 / 前回の最適化実行
前者は現在のバッチ、後者は履歴です。古い pending や failed が別の現在動作と同時に表示される場合があります。現在の仕事は動作欄で確認します。
実行ステータス
pending:作成済み、running:実行中、completed:バッチ完了(全戦略合格の意味ではない)、stopped:中断、failed:エラー終了。下のエラーを確認します。
進捗とジョブ詳細
割合と完了数/総数は進捗で、残り時間ではありません。進捗不明は未報告であり 0% ではありません。詳細には銘柄、時間足、パラメータファイル、フェーズがあれば表示されます。
スマートフォン:展開 / 閉じる
固定バーは動作と Stop を表示します。展開で詳細と四つのコマンドを開き、閉じるまたは Escape で戻ります。

操作を選ぶ

開始(Start)
表示設定で新しいバッチを作成します。空いている worker、準備済みの設定済みブローカー、銘柄、利用枠が必要です。スピナー中は待ちます。コマンド完了通知はバッチ全体の終了ではありません。
再開(Resume)
現在のブローカーの再開可能な停止・失敗実行を、固定済み設定で続行します。フォーム変更は無視されます。ヒントで対象を確認でき、対象がなければ無効です。
停止(Stop)
最適化、堅牢性、お気に入り、ポートフォリオ、ブローカー切替など現在の仕事を中断します。使用中で heartbeat が正常な worker が必要です。コンテナーはオンラインを維持します。旧版は更新して再作成すると最適化以外もキャンセルできます。
クリーン(Clean)
リセットです。仕事を止め、ホストのテスターキャッシュ、生成レポートと最適化生成物を削除します。全ブローカーについてユーザーのお気に入り以外の結果と、お気に入りに不要な実行を削除します。すべてのポートフォリオと保存 Start 設定も削除します。お気に入りと関連結果・実行記録はダッシュボードに残りますが、ローカルレポートは削除される場合があります。必要なレポートを先に保存してください。待機中のみ可能で、消費枠は戻りません。
月間利用枠
Pro は請求月ごとに新規 Start 1 回、Ultimate は無制限です。キュー入りで予約し、受理された実行で消費します。Resume は追加消費しません。使い切ったらリセットを待つかプランを変更します。Clean では戻りません。

ブローカーと設定

ブローカー
会社で結果を絞り、新しい仕事の口座を選びます。有効化を待ち、使用中は切り替えられません。履歴のみでは閲覧だけで、Start、Resume、再構築はできません。古い・欠けた銘柄一覧にはオンライン worker と正常な有効化が必要です。
開始日 / 終了日
MT5 形式 YYYY.MM.DD、例:2020.01.01〜2026.10.31。開始は終了より前にします。過去データの期間で、実行予約ではありません。初期値は過去 12 年です。
銘柄
ブローカー一覧から選びます。長い一覧には検索、All は全一覧選択、Clear は解除です。N selected は選択数でジョブ数ではありません。最低一つ必要です。口座切替時は保存設定復元前に選択を解除し、利用できない銘柄は除外します。
時間足
M5/M15 は 5/15 分、H1/H4 は 1/4 時間、D1/W1 は日/週です。一つ以上選択し、All/Clear はこの一覧に適用されます。初期選択 M5/M15/H1/H4。対応する Classic グリッドが必要で、戦略セレクターはありません。
最適化モード
Slow complete は全組み合わせ、Fast genetic は MT5 遺伝的アルゴリズムによる一部探索で、初期値です。時間はグリッド、履歴、コンピューターに依存します。
通貨 / 口座残高
テスターの模擬口座で実際の資金ではありません。USD/EUR/GBP/CHF/JPY/AUD/CAD/NZD と正の残高を指定します。初期値 USD、100000。
最大エクイティドローダウン %
検証時のリスク調整目標で初期値 15%。実口座の損失制限ではありません。調整後の不合格閾値には 12% の余裕があり、目標 15% なら上限 16.8% です。
検証後の堅牢性チェック
初期は有効です。追加テストには時間がかかります。無効でも合格結果に後から依頼できます。黄色い行は堅牢性未確認です。
保存設定 / 無効な項目
現在または再開可能な実行の設定を優先し、なければ口座の前回受理 Start を復元します。待機時の編集は更新で失われません。使用中は項目をロックします。変更は新規 Start 用で Resume には適用されません。

結果とテーブル

最近の合否
選択会社のイベントです。緑は合格、黄色は低リターンによる軽度の却下、赤は失敗・却下。理由欄で確認します。ジョブ完了は個別戦略レポートではなく、指標が空の場合があります。空表は該当結果なしです。
戦略 / 銘柄 / TF / プロファイル / Pass
戦略は銘柄・時間足・試行を識別します。TF は時間足、プロファイルはパラメータ構成、Pass はテスター試行番号で合否ではありません。時刻は結果記録時刻です。
Return on risk / Sharpe / Trades / Net profit
Return on risk = 純利益 % ÷ エクイティドローダウン %。Sharpe はリスク調整後収益、Trades は取引数、Net profit は報告の金額・割合です。ダッシュは欠損でゼロではありません。過去のテスト結果です。
合格 / 開く
会社の検証を通過した戦略です。開く、または最近の戦略リンクでレポート、指標、パラメータ、曲線を表示します。黄色は堅牢性待ちです。
堅牢性チェック / 堅牢
チェックでストレステストをキューへ送ります。キュー登録中は依頼処理中です。堅牢は合格済みで、完了のためボタンは無効です。キュー登録成功はテスト合格ではありません。
お気に入り / 削除
会社の選択を保存し同期を依頼します。バッチ中や会社のないレポートは追加できません。保存中・削除中は依頼中です。削除はお気に入りだけで元結果は残ります。
ポートフォリオ / 再構築 / 表示
お気に入りから会社別構成を作れます。構築中は待ち、オフラインは worker を起動、失敗はブローカー準備後に再試行します。再構築は生成依頼、表示は既存ビルドを開きます。対応 EA のソースが必要で公開イメージにはなく、任意のコンパイル済み EA では作れません。
パラメータ使用状況
全ては合格行、堅牢は堅牢性合格、未チェックは待機行です。パラメータ・値は入力、件数は出現数、銘柄/TF は対象、% は選択グループ内の割合です。タブはこの表だけを変更します。スマートフォンでは横スクロールします。

止まって見えるとき

開始が無効
依頼中、動作、ブローカー準備、銘柄、枠を確認します。現在の仕事を終了・停止し、選択欄のエラーを読みます。
再開・停止が無効
Resume は対象実行と準備済みブローカー、Stop は使用中かつ正常な heartbeat が必要です。古い pending だけでは Stop は有効になりません。Docker 接続を復旧します。
コマンド失敗 / オフライン
再試行前に通知とログを確認します。Docker とネットワークを維持し、数回更新を待ち、ブローカー有効化を確認します。heartbeat はログイン成功を保証しません。
結果なし / 進捗不明
ブローカーを確認し、ジョブ報告を待ち、フェーズとエラーを確認します。履歴の状態と現在の動作は別です。下のインストールとトラブルシューティングも参照してください。

結果・お気に入り・ポートフォリオ

Passed 行はバッチで検証を通過した候補です。ダッシュボードでお気に入りを付け、worker がホストの Favorites フォルダに同期できます。

会社ポートフォリオは現在 PositionRelay のポートフォリオ EA 1 種類のみに対応し、公開イメージに含まれないソースコードが必要です。自作のコンパイル済み .ex5 では最適化、検証、お気に入り登録はできますが、ポートフォリオは作成できません。

レポートはホスト上に作成した reports フォルダーに保存されます。

イメージの更新

新しいイメージがあるか確認するには、docker pull ghcr.io/razvantomegea/position-relay-portfolio-optimizer:latest(セットアップウィザードのダウンロード用コマンド)を実行してください。pull の表示はローカルイメージのみを示し、実行中のコンテナーが既にそのイメージを使っているかは分かりません。docker inspect --format '{{.Image}}' positionrelay-optimizer と docker inspect --format '{{.Id}}' ghcr.io/razvantomegea/position-relay-portfolio-optimizer:latest を比較してください。一致していればコンテナーはそのままで構いません。異なる場合、または以前にダウンロードして再作成を後回しにしていた場合は、実行中のジョブが終わるのを待ち、セットアップウィザードの最後の手順にあるコマンドでコンテナーを作り直してください。イメージ更新で置き換わるのは worker のみで、ボリュームには MT5 とティックキャッシュが残ります。新しい MT5 は別途更新してください。

トラブルシューティング

  • Worker がオフラインのまま — Pro または Ultimate が有効か、POSITIONRELAY_USER_ID が Setup と一致するか、docker logs にハートビートが出ているかを確認。
  • ブローカーログインが未確認 — 接続できている MT5 の Broker/servers.dat と、MT5_LOGIN、MT5_PASSWORD、MT5_SERVER を確認してください。3つとも optimizer.env に残してください。entrypoint はそれらを /dev/shm にコピーし、パスワードは worker プロセスからのみ解除します。
  • MT5 company … does not match configured … — MT5_COMPANY または accounts.json の company を、MT5 がその口座について報告する正式な会社名(最適化レポートの Company 欄と同じ)に設定してください。optimizer.env の MT5_COMPANY を変更したあとは、検証の前にコンテナーを作り直して新しい環境変数を適用してください。ブランド略称は失敗します(例: MT5 が FTMO Global Markets Ltd と報告するのに FTMO と書いた場合)。
  • 初回ログイン中に Wine の fixme メッセージ、ALSA の "cannot find card"、グラフィックライブラリのエラーが出る場合があります。それだけでは成功・失敗は判断できません。"Broker login authorized" または "broker login not confirmed"、続いて "Starting optimizer heartbeat" を確認してください。ログインに失敗しても worker はオンラインと表示される場合があります。
  • EA が動かない — Market 購入 EA はアクティベーションロックです。自作のコンパイル済み .ex5 を使用。
  • ディスク不足 / ティックが遅い — Docker Desktop のリソースを増やし、リアルティック履歴用の空き容量を確保。
  • Apple Silicon / ARM — 非対応です。x64 コンピューターを使用してください。
  • ダッシュボードでコマンド失敗 — docker logs -f positionrelay-optimizer で worker エラーを確認。

Docs