- реализовать создание portable-экземпляров и настройку счетов
- обновить интерфейс и добавить обновление проекта через Git
- добавить сборку и распространение сервиса
- организовать материалы статей и описать актуальную версию
- запрашивать тестовый пароль интерактивно и расширить проверки
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<metacharset="utf-8">
<h1>Разрабатываем менеджер терминалов (Часть 2): Запуск нескольких экземпляров</h1>
<divclass="inner formatted-content">
<h3>Введение</h3><p>В первой <ahref="https://www.mql5.com/ru/articles/19804"target="_blank">части</a> серии "Менеджер терминалов своими руками" мы поставили перед собой задачу — создать веб-интерфейс для управления запуском и остановкой экземпляров MetaTrader 5 на локальном компьютере. Мы определили архитектуру системы, начав с разработки минимально жизнеспособного продукта (MVP) — веб-сервера, который может принимать HTTP-запросы и управлять одним экземпляром терминала. Заодно мы рассмотрели такие ключевые понятия как API, REST, HTTP-запросы, декораторы.</p><p>Для реализации проекта был выбран язык Python, благодаря его богатой экосистеме библиотек и простоте интеграции с внешними API — в данном случае с библиотекой MetaTrader 5.</p><p>Фреймворк FastAPI позволяет создавать веб-приложения с минимальными затратами кода, предоставляя из коробки поддержку типизации, асинхронности и автоматической документации через Swagger UI.</p><p>В связке с ним используется Uvicorn, лёгкий и быстрый ASGI-сервер, обеспечивающий высокую производительность даже при большом количестве одновременных запросов.</p><p>Для работы с процессами терминалов применяются библиотеки psutil и subprocess, что позволяет удобно получать сведения о запущенных экземплярах и управлять ими.</p><p>В дальнейшем планируется добавить использование SQLite или другой базы данных для хранения состояния экземпляров, а также фронтенд-слой на JavaScript или Vue.js для более интерактивного интерфейса.</p><p>Теперь пришло время расширять функциональность и переходить к следующим этапам — реализации более сложных возможностей, таких как управление несколькими экземплярами, хранение состояния, интеграция с MetaTrader5 API и веб-интерфейс с полной информацией о терминалах.</p><p><br></p><h3>Намечаем путь<br></h3><p>Попробуем очертить примерные границы следующего кусочка реализации. Во-первых, пока у нас нет реального разделения общей функциональности на два разных веб-сервера, придётся в каком-то минимальном виде добавлять интерфейсные части в тот веб-сервер, который мы уже начали делать. Эта работа не пропадёт зря, так как в дальнейшем мы сможем перенести уже имеющийся код на другой веб-сервер с некоторыми правками. Поэтому начнём с того, что создадим дополнительные файлы для размещения разных частей кода проекта, придав им некоторый налёт организованности.</p><p>Во-вторых, сделаем самый напрашивающийся следующий шаг, добавив возможность работать с несколькими экземплярами терминала MetaTrader 5. То есть реализуем создание, запуск, остановку и получение информации о составе запущенных в данный момент экземпляров. Получение детальной информации о торговом счёте оставим на будущее.</p><p>Это потребует предварительного принятия некоторых архитектурных решений, что не так просто, как может показаться на первый взгляд. Сейчас на нас лежит ответственность за будущее развитие проекта. От того, насколько удачными окажутся принятые сейчас решения, зависит легкость дальнейшей реализации и возможные пределы расширения функциональности. Очень не хотелось бы, дойдя до какого-то этапа проекта, выяснить, что для дальнейшего развития нужно вернуться к началу и всё переделать. Так, конечно, тоже бывает, но постараемся этого избежать, за счёт более внимательного отношения к своему выбору.</p><p>С другой стороны, важно не утонуть в море возможностей. Поэтому в каких-то вопросах лучше сделать хоть какой-то выбор прямо сейчас, чем заниматься бесконечным загадыванием, как тот или иной выбор отзовётся в будущем. А ещё в некоторых вопросах бывает более эффективно выбрать сейчас что-то простое. То, что потом точно будет переделано на другом, более сложном уровне реализации. Но зато мы не погрязнем в реализации идеальной архитектуры отдельной части проекта и сможем быстрее продвинуть его в целом.</p><p><br></p><h3>Разделение кода<br></h3><p>Добавим несколько новых файлов в наш проект. В файл <i>mt5_control.py</i> вынесем все функции из файла <i>main.py</i>, отвечающие за логику управления терминалами. Таким образом, сейчас в главном файле приложения останутся только функции-обработчики конечных точек (маршрутов) и создание объекта FastAPI с необходимыми настройками.</p><p>Для хранения шаблонов HTML-кода страниц, которые должны генерироваться при обработке некоторых конечных точек, создадим папку <i>templates</i>. Пока что разместим в ней один файл <i>index.html</i> для формирования HTML-кода главной страницы (маршрут GET /).</p><p>Для хранения статического кода, который будет всегда отправляться браузеру без какой-либо обработки веб-сервером, сделаем папку <i>static</i>. К таким файлам можно отнести, например, файлы таблиц CSS-стилей или JavaScript-кода, на которые есть ссылки из HTML-кода страниц. Добавим сразу парочку таких пустых файлов для главной страницы.</p><p>После этого дерево файлов проекта будет выглядеть так:</p><divclass="code"><p>mt5_manager/<br>│<br>├── main.py# Основной файл FastAPI<br>├── mt5_control.py # Логика управления запуском и остановкой терминалов<br>├── templates/<br>│ └── index.html # Шаблон основной страницы<br>└── static/<br> ├── styles.css # CSS-стили<br> └── script.js# JavaScript-код</p></div><p>Будем в дальнейшем придерживаться принятых соглашений по размещению файлов проекта. При необходимости можно будет создавать новые вложенные папки внутри уже имеющихся, если это будет помогать структурированию кода.</p><p>Чтобы в нашем приложении можно было воспользоваться механизмом шаблонов и статическими файлами, нужно подключить соответствующие библиотеки в файле <i>main.py</i>:</p><preclass="code"><spanclass="keyword">from</span> fastapi.staticfiles <spanclass="keyword">import</span> StaticFiles
<spanclass="keyword">from</span> fastapi.templating <spanclass="keyword">import</span> Jinja2Templates</pre><p>Затем, после создания объекта приложения (<i>app</i>), мы подключаем новую конечную точку <i>GET /static</i>, при обработке которой любые имена, идущие в URL после <i>static/</i>, будут восприниматься как файл из папки <i>static</i> нашего проекта:</p><preclass="code"><spanclass="preprocessor"># </span>Создаём объект приложения
</pre><p>Заметьте, что в данном случае мы не создаём отдельную функцию-обработчик маршрута <i>GET /static</i>, а вызываем метод объекта приложения, который сам создаст необходимую функцию с нужным содержимым.</p><p>Теперь создадим объект, который будет использоваться при необходимости передать в качестве ответа HTML-код, сформированный по определённому шаблону из папки <i>templates</i>:</p><preclass="code"><spanclass="preprocessor"># </span>Создаём объект для работы с шаблонами HTML-кода
templates = Jinja2Templates(directory=<spanclass="string">"templates"</span>)</pre><p>Обработчик маршрута GET / перепишем таким образом:</p><preclass="code">@app.get(<spanclass="string">'/'</span>, response_class=HTMLResponse)
<spanclass="string">'''Обработчик GET / (корневой каталог)'''</span>
instances = load_instances()
<spanclass="keyword">return</span> templates.TemplateResponse(<spanclass="string">"index.html"</span>, {<spanclass="string">"request"</span>: request, <spanclass="string">"instances"</span>: instances})</pre><p>В нём мы получаем словарь <i>instances</i> с информацией о зарегистрированных экземплярах терминалов и их текущем статусе (запущен/остановлен). Далее мы возвращаем шаблонный ответ, получаемый из файла <i>index.html</i> с учётом информации из словаря <i>instances</i>. Какая именно информация будет присутствовать в словаре <i>instances,</i> и как она будет трансформироваться в HTML-код, мы посмотрим чуть позже.</p><p>В два оставшихся обработчика маршрутов мы тоже внесем небольшие изменения. Они будут однотипны, то есть для обработчика запуска экземпляра мы сделаем то же самое, что и для обработчика остановки. Необходимость изменений вызвана тем, что теперь нужно в обработчик передавать информацию о том, какой экземпляр мы хотим сейчас запустить или остановить. Когда экземпляр был единственный, такой проблемы не возникало.</p><p>Добавим в URL этих маршрутов изменяемую часть, обозначенную как <i><spanstyle="background-color:rgb(255, 246, 200);">{name}</span></i>. Это обязывает нас добавить в список аргументов функции-обработчика новый аргумент с именем <i><spanstyle="background-color:rgb(216, 232, 194);">name</span></i> и типом <i><spanstyle="background-color:rgb(216, 232, 194);">str</span></i> (так как имя экземпляра — это строка):</p><preclass="code">@app.post(<spanclass="string">'/start/<spanstyle="background-color:rgb(255, 246, 200);">{name}</span>'</span>)
</pre><p>Это приведёт к тому, что при запуске обработчика ему в качестве аргумента будет передаваться строка, вырезанная из той части URL, которая соответствует положению <i><spanstyle="background-color:rgb(255, 246, 200);">{name}</span></i>. А далее мы уже можем с <spanstyle="background-color:rgb(164, 192, 228);">ней</span> работать внутри функций-обработчиков.</p><p>Обновим нашу таблицу маршрутов в связи со сделанными изменениями:</p><tablecellspacing="0"cellpadding="3"width="100%"class="standart"><thead><tr><th>#</th><th>Метод</th><th>URL</th><th>Описание, параметры</th><th>Формат<br>ответа </th></tr></thead><tbody><tr><td>1</td><td>GET</td><td>/</td><td>Отображает главную страницу с веб-интерфейсом для управления экземплярами MetaTrader 5<br>Пока что пусть отображается только заголовок с названием проекта.</td><td>HTML</td></tr><tr><td>2</td><td>POST</td><tdstyle="background-color:rgb(216, 232, 194);">/start/{name}</td><td>Запускает экземпляр терминала MetaTrader 5 с именем {name}</td><td>JSON</td></tr><tr><td>3</td><td>POST<br></td><tdstyle="background-color:rgb(216, 232, 194);">/stop/{name}</td><td>Останавливает запущенный процессMetaTrader 5с именем {name}</td><td>JSON</td></tr></tbody></table><p>Даже несмотря на то, что проект пока находится на стадии активной разработки, важно уже сейчас формировать устойчивую архитектуру. В идеале код приложения должен быть легко расширяемым — чтобы добавление новых функций, маршрутов или логики управления не требовало переписывания существующих частей.</p><p>Именно поэтому имеет смысл придерживаться принципов разделения ответственности и чистой архитектуры, когда:</p><ul><li>Модуль mt5_control.py отвечает только за работу с процессами терминалов.</li><li>Файл main.py концентрируется на маршрутах и веб-интерфейсе.</li><li>Папки templates и static изолируют визуальную часть приложения.</li></ul><p>Такое разделение делает проект более устойчивым к изменениям и облегчает тестирование. В будущем, при необходимости, эти части можно будет вынести в отдельные микросервисы.</p><p><br></p><p></p><h3>Экземпляры терминалов<br></h3><p>Чтобы можно было запускать несколько экземпляров терминалов MetaTrader 5 на сервере, он там должны физически присутствовать. То есть на сервере должны быть несколько папок, в каждой из располагается запускаемый файл терминала. Существуют разные способы, как можно этого добиться, но сейчас для упрощения предположим, что эту часть работы пользователь будет пока выполнять вручную.</p><p>Проделаем эту операцию. Если на компьютере ещё нет установленного терминала, то необходимо скачать его с сайта брокера или <ahref="https://www.metatrader5.com/"title="https://www.metatrader5.com/"target="_blank">www.metatrader5.com</a> и установить. Создадим папку <i>MT5</i> с тремя вложенными папками с именами вида <i>MetaTrader5.x</i> и скопируем в них запускаемые файлы терминала (<i>terminal64.exe</i>) и редактора (<i>metaeditor64.exe</i>) из любой имеющийся установленной копии терминала MetaTrader 5:</p><pstyle="text-align:center;"><imgwidth="694"height="279"src="../images/bd845337-2895060216714.png"loading="lazy"alt=""style="vertical-align:middle;"></p><p>Выбор конкретных названий для папок терминалов и их корневой папки не играет никакой роли. Мы взяли именно такие, потому что они достаточно короткие и понятные.</p><p>В папке каждого терминала запустим файл <i>terminal64.exe</i> в режиме portableи подключимся к какому-то торговому счёту. Здесь мы будем использовать демо-счета от компании MetaQuotes. При необходимости установки обновлений, дождемся завершения этого процесса. Итак, теперь у нас есть три экземпляра терминала, установленные в папки с такими полными путями:</p><divclass="code"><p>C:/MT5/MetaTrader5.1/terminal64.exe<br>C:/MT5/MetaTrader5.2/terminal64.exe<br>C:/MT5/MetaTrader5.3/terminal64.exe</p></div><p></p><p>Именно их мы будем запускать и останавливать через создаваемый веб-сервер. Также мы пока не будем касаться вопросов смены торговых счетов, к которым подключены терминалы, то есть сфокусируемся только на запуске и остановке.</p><p>В дальнейшем то, что мы сейчас проделали вручную, будет каким-то образом автоматизировано. Но сейчас мы можем не отвлекаться на реализацию: проделав такую подготовительную работу один раз, мы можем теперь долго к ней не возвращаться, сосредоточив усилия на содержательной части проекта.</p><p><br></p><h3>Формирование списка терминалов</h3><p>В прошлый раз мы реализовали запуск и остановку одного единственного экземпляра терминала, находившегося по фиксированному пути на нашем сервере. Теперь приступим к реализации выборочного запуска и остановки каждого экземпляра из фиксированного списка. Как уже было сказано, этот код мы перенесли и продолжим писать в новом файле <i>mt5_control.py</i>.</p><p>Новых библиотек, кроме уже добавленных subprocess иpsutil, нам пока не понадобится. Мы создали три папки с экземплярами терминалов, которые отличаются только названием последней папки в пути к файлу <i>terminal64.exe</i>. Поэтому давайте объявим две константы, содержащие те части пути, которые одинаковы для всех экземпляров:</p><preclass="code"><spanclass="comment"># Путь к папке с экземплярами терминалов</span>
MT5_FOLDER = <spanclass="string">'C:/MT5'</span>
<spanclass="comment"># Имя запускаемого файла терминала</span>
MT5_EXE = <spanclass="string">'terminal64.exe'</span></pre><p>Теперь можно сделать функцию, которая по имени будет формировать полный путь к запускаемому файлу нужного экземпляра терминала. Сейчас мы просто будем соединять вместе три части полного пути: общую папку, имя экземпляра и имя запускаемого файла:</p><preclass="code"><spanclass="keyword">def</span> instance_path(name: <spanclass="built_in">str</span>) -><spanclass="built_in">str</span>:
<spanclass="string">'''
Формирует полный путь по имени экземпляра терминала
Args:
name (str): Имя экземпляра терминала.
Returns:
path (str): Полый путь к запускаемому файлу экземпляра терминала.
'''</span>
<spanclass="keyword">return</span><spanclass="string">f'<spanclass="subst">{MT5_FOLDER}</span>/<spanclass="subst">{name}</span>/<spanclass="subst">{MT5_EXE}</span>'</span></pre><p>Для хранения списка имён экземпляров будем использовать пока обычный список, в котором будут находиться выбранные нами названия папок:</p><preclass="code"># Список имён экземпляров (пока фиксированный)
</pre><p>По готовому списку имён мы можем однозначно получить полные пути к исполняемым файлам каждого экземпляра терминала. Поскольку они пока тоже будут постоянными, то можно заранее сформировать два вспомогательных словаря, которые будут использованы для получения пути по заданному имени и имени по заданному пути:</p><preclass="code"><spanclass="comment"># Словарь соответствия имя -> путь</span>
instances_paths = {name: instance_path(name) <spanclass="keyword">for</span> name <spanclass="keyword">in</span> instances_names}
<spanclass="comment"># Словарь соответствия путь -> имя</span>
paths_instances = {instance_path(name): name <spanclass="keyword">for</span> name <spanclass="keyword">in</span> instances_names}</pre><p>После длительных размышлений мы решили отказаться от повторного использования информации о состоянии экземпляров, которая была получена при запуске сервера. Вместо этого, мы при каждой операции будем актуализировать состав запущенных экземпляров. Для этого напишем функцию <i>load_instances()</i>, которая будет формировать словарь <i>instances.</i> В этом словаре ключом будет имя экземпляра, а значением — ещё один словарь с двумя ключами <i>pid</i> и <i>status</i>. В них мы будем хранить уникальный идентификатор запущенного процесса (PID) и статус экземпляра с заданным именем.</p><p>Возможно, что хранение этих двух видов информации является избыточным, так как в принципе, по значению PID мы можем судить о том, запущен ли данный экземпляр или нет. Если PID > 0, то процесс выполняется. Но сейчас не совсем понятно, как сделать лучше, поэтому пусть будут храниться оба этих поля. Далее мы, скорее всего, будем расширять словарь с информацией об одном экземпляре.</p><p>Вначале мы инициализируем словарь <i>instances</i> для экземпляров одинаковыми значениями:</p><preclass="code">{<spanclass="string">'pid'</span>: <spanclass="number">0</span>, <spanclass="string">'status'</span>: <spanclass="string">'stopped'</span>}</pre><p>что соответствует незапущенному экземпляру. Затем, используя библиотеку psutil, организуем перебор всех запущенных на компьютере процессов. Для каждого из них мы будем смотреть, не является ли данный процесс одним из экземпляров нашего терминала. Если да, то определяем его имя, PID, и сохраняем их в соответствующем элементе словаря <i>instances</i>.</p><preclass="code"><spanclass="keyword">def</span> load_instances() -><spanclass="built_in">dict</span>:
<spanclass="string">'''Получение информации о статусе экземпляров
терминала MetaTrader 5 из заданных папок.
Returns:
instances (dict): Информация об экземплярах терминала.
'''</span>
<spanclass="comment"># Формируем словарь для всех экземпляров по списку имён</span>
<spanclass="keyword">return</span> instances</pre><p>Эта функция будет использована в обработчике маршрута GET / для формирования актуального состояния всех зарегистрированных экземпляров. Но также она будет использована и при каждой операции запуска и остановки. С её помощью мы сможем не запускать уже запущенный ранее экземпляр и не останавливать уже остановленный.</p><p><br></p><h3>Запуск терминалов<br></h3><p>Посмотрим теперь на реализацию функции запуска экземпляра терминала с определённым именем, передаваемым в качестве аргумента. Сначала мы получаем актуальную информацию о состоянии всех зарегистрированных терминалов. Если переданное имя нашлось среди существующих имён, то проверим, существует ли запущенный процесс для этого экземпляра.</p><p>Если нет, то тогда запускаем новый процесс, используя функцию <i>Popen()</i> из библиотеки subprocess. В качестве аргумента ей надо передать список аргументов командной строки запуска нужного исполняемого файла. Первым в этом списке идёт полный путь к запускаемому файлу, а дальше — ключ <i>/portable</i> для использования текущей папки терминала в качестве рабочей.</p><p>После успешного запуска, мы получаем значение уникального идентификатора процесса в операционной системе (PID) и вместе со статусом "running" сохраняем его в элементе словаря экземпляров для возврата из функции:</p><preclass="code"><spanclass="keyword">def</span> start_mt5(name: <spanclass="built_in">str</span>) -><spanclass="built_in">dict</span>:
<spanclass="string">'''
Запуск экземпляра терминала
Args:
name (str): Имя экземпляра терминала.
Returns:
instance (dict): Информация о запущенном терминале.
'''</span>
<spanclass="comment"># Получаем информацию об экземплярах терминала</span>
instances = load_instances()
<spanclass="comment"># Если имя экземпляра есть среди имеющихся</span>
<spanclass="keyword">if</span> name <spanclass="keyword">in</span> instances:
<spanclass="comment"># Возвращаем результат - имя не найдено</span>
<spanclass="keyword">return</span> {name: {<spanclass="string">'status'</span>: <spanclass="string">'not found'</span>}}</pre><p>Если же в запросе пришло имя экземпляра, которого нет среди зарегистрированных имён, то ничего не делаем и возвращаем информацию о том, что такой экземпляр не найден.</p><p><br></p><h3>Остановка терминалов</h3>Функция остановки экземпляра терминалов работает похожим образом. Ей также передаётся имя экземпляра, полученное из запроса. Также формируется актуальный состав всех зарегистрированных экземпляров с их текущим статусом. Если имя экземпляра корректное, то берём его PID, и создаём объект, позволяющий управлять процессом с заданным идентификатором. Посылаем процессу команду остановки и ждем не более 10 секунд завершения его работы:<preclass="code"><spanclass="keyword">def</span> stop_mt5(name: <spanclass="built_in">str</span>) -><spanclass="built_in">dict</span>:
<spanclass="string">'''
Остановка терминала
Args:
name (str): Имя экземпляра терминала.
Returns:
instance (dict): Информация о запущенном терминале.
'''</span>
<spanclass="comment"># Получаем информацию об экземплярах терминала</span>
instances = load_instances()
<spanclass="comment"># Если имя экземпляра есть среди имеющихся</span>
<spanclass="keyword">if</span> name <spanclass="keyword">in</span> instances:
<spanclass="comment"># Возвращаем результат - процесс не найден</span>
<spanclass="keyword">return</span> {name: {<spanclass="string">'status'</span>: <spanclass="string">'not found'</span>}}</pre><p>Если процесс благополучно завершился, то возвращаем информацию об этом. Если нет, то всё равно считаем его завершённым. В текущих условиях мы пока не столкнулись с какими-либо проблемами при завершении процессов, поэтому оставим эту функцию именно в таком виде. Когда же проблемы возникнут, тогда и подумаем о дальнейшей доработке.</p><p>Ну и если так оказалось, что мы пытаемся остановить уже завершённый процесс (например, мы могли вручную закрыть окно запущенного терминала), то просто вернётся сообщение о том, что процесс не найден.</p><p><br></p><h3>Главная страница<br></h3><p>Теперь настала очередь заняться HTML-шаблоном формирования главной страницы. В нём нам надо сделать несколько вещей. Во-первых, <spanstyle="background-color:rgb(164, 192, 228);">подключим</span> внешние статические файлы с CSS и JS-кодом. Во-вторых, добавим на страницу ненумерованный список, каждый элемент которого будет представлять собой информацию об одном экземпляре терминала.</p><p>Для его формирования воспользуемся движком шаблоновJinja2. В обработчике маршрута GET / мы передали объекту шаблона наш сформированный словарь с информацией о зарегистрированных экземплярах. Он выглядит примерно так:</p><preclass="code">{
}</pre><p>Используя конструкцию <spanstyle="background-color:rgb(222, 188, 133);">{% for name, data in instances.items() %}</span> ... <spanstyle="background-color:rgb(222, 188, 133);">{% endfor %}</span>, мы можем организовать цикл, который будет генерировать однотипные куски HTML-кода, подставляя в <spanstyle="background-color:rgb(216, 232, 194);">нужные места</span> значения переменных цикла. В данном случае в переменную <i>name</i> будут попадать по очереди названия наших экземпляров терминалов: 'MetaTrader5.1', 'MetaTrader5.2', 'MetaTrader5.3'. А в переменную <i>data</i> будет попадать словарь с ключами <i>pid</i> и <i>status</i> для каждого экземпляра из словаря <i>instances</i>.</p><p>Также при необходимости мы можем использовать конструкцию условного оператора <spanstyle="background-color:rgb(255, 246, 200);">{% if data.pid > 0 %}</span> ...<spanstyle="background-color:rgb(255, 246, 200);">{% else %}</span> ...<spanstyle="background-color:rgb(255, 246, 200);">{% endif %}</span>. Благодаря ей мы отображаем для каждого экземпляра только одну кнопку для выполнения возможного действия: запуска для остановленного экземпляра и остановки для запущенного.</p><preclass="code"><spanclass="doctype"><!DOCTYPE html></span>
<spanclass="tag"><<spanclass="keyword">strong</span>></span><spanstyle="background-color:rgb(216, 232, 194);">{{ name }}</span><spanclass="tag"></<spanclass="keyword">strong</span>></span>
<spanstyle="background-color:rgb(255, 242, 153);">{% if data.pid > 0 %}</span>
<spanclass="tag"></<spanclass="keyword">html</span>></span></pre><p>При нажатии на кнопки на главной странице, будет выполняться JS-код в функциях <i>startInstance()</i> и <i>stopInstance()</i>.</p><p><br></p><h3><h3>Обработка нажатий</h3></h3><p>Функции-обработчики событий нажатия на кнопки Start и Stop будут располагаться в отдельном файле <i>script.js</i>, который мы разместили в папке <i>/static</i>. Их код почти одинаков и отличается только тем, на какую конечную точку функция будет посылать POST-запрос. Переданное в аргументе имя экземпляра терминала подставляется в URL запроса и дальше ожидается получение ответа от нашего же веб-сервера. После получения ответа, он выводится в консоль JavaScript браузера, и текущая страница перезагружается:</p><preclass="code"><spanclass="comment">/**
* Запуск терминала
* @param {string} name - Имя экземпляра
*/</span>
async function startInstance(name) {
<spanclass="comment">// Посылаем запрос по нужному маршруту</span>
<spanclass="keyword">const</span> res = await fetch(`/start/${name}`, { method: <spanclass="string">"POST"</span> });
<spanclass="comment">// Получаем ответ</span>
<spanclass="keyword">const</span> data = await res.json();
<spanclass="comment">// Здесь можно добавить дополнительные действия </span>
}</pre><p>В дальнейшем информацию, получаемую в переменной data, можно использовать для показа каких-либо дополнительных сообщений или обновления кода страницы без её полной перезагрузки. Но пока у нас на главной странице выводится очень мало информации, можно её перезагружать полностью.</p><p>Для улучшения внешнего вида главной страницы, добавим немного стилей в файл <i>styles.css</i>, располагающийся в папке <i>/static</i>. Не будем пока подтягивать мощные фреймворки стилизации HTML вроде Bootstrap, мы всегда сможем ими воспользоваться после того, как проект приобретёт более внятные очертания. Пока же мы только нащупываем, как мог бы выглядеть интерфейс взаимодействия с пользователем, и поэтому не стоит сразу уделять большого внимания внешнему виду. </p><p>Но немного — можно! Например, мы добавили к каждому элементу списка дополнительный CSS-класс, совпадающий со статусом экземпляра. А в файле <i>styles.css</i> добавили правила, задающие разный цвет фона для элемента в зависимости от наличия класса <i>running</i>:</p><preclass="code">.instances li.running {
}</pre><p>Теперь запущенные и незапущенные экземпляры будут хорошо отличимы друг от друга.</p><p><br></p><h3>Тестирование<br></h3><p>Запустим веб-сервер командой из рабочей папки проекта:</p><divclass="code"><p>uvicornmain:app--reload--no-use-colors</p></div><p>и откроем в браузере страницу по адресуhttp://127.0.0.1:8000.</p><p>Пока ни один экземпляр терминала не запущен, мы будем видеть примерно следующее:</p><pstyle="text-align:center;"><imgwidth="745"height="400"src="../images/9955369d-5348011681570.png"loading="lazy"alt=""style="vertical-align:middle;"></p><p>Нажмём на кнопку Start для первого и второго экземпляра. Спустя мгновение мы увидим, что они перешли в состояние выполняющихся, что подтверждается Диспетчером задач Windows, где мы видим два процесса с такими же идентификаторами, как и на главной странице нашего веб-интерфейса:</p><pstyle="text-align:center;"><imgwidth="745"height="400"src="../images/5dd3f466-3582312767553.png"loading="lazy"alt=""style="vertical-align:middle;"></p><p>Также можно проверить, что система автоматической документации подхватила сделанные нами комментарии и уточнения про маршруты и их параметры:</p><pstyle="text-align:center;"><imgwidth="745"height="600"src="../images/2589a28e-3481539276901.png"loading="lazy"alt=""style="vertical-align:middle;"></p><p>Как видно, для маршрута POST /start/{name} есть описание как самого маршрута, так и параметра {name} с примером возможного значения.</p><p><br></p><p></p><h3>Заключение<br></h3><p></p><p>На данном этапе проект MetaTrader 5 Manager превратился из идеи и простого прототипа в полноценное приложение, которое уже способно управлять несколькими экземплярами торговых терминалов MetaTrader 5 через удобный веб-интерфейс. Мы шаг за шагом отделили логику работы с процессами от серверной части, добавили маршруты для управления экземплярами, реализовали простую визуализацию состояния терминалов и сделали первые шаги к структурированию кода проекта.</p><p>Несмотря на то, что текущее решение ещё далеко от окончательного, именно в таком виде оно уже выполняет свою основную задачу — позволяет централизованно запускать и останавливать терминалы, а также получать информацию об их текущем состоянии. Таким образом, у нас появился прочный фундамент, на котором можно строить более сложные уровни функциональности.</p><p>В дальнейшем мы будем развивать проект в нескольких направлениях:</p><ul><li>автоматизация регистрации новых экземпляров терминалов и хранение информации о них в базе данных;</li><li>расширение взаимодействия с PythonMetaTrader 5 API для получения статистики, ордеров и торговых историй;</li><li>улучшение интерфейса — добавление динамических обновлений без перезагрузки страницы и визуальных элементов управления;</li><li>возможное выделение интерфейсной части в отдельный фронтенд-сервис.</li></ul><p>Также необходимо продумать систему ограничения доступа. Для этого можно добавить базовую авторизацию или работу через защищённый канал HTTPS.</p><p>Кроме того, стоит предусмотреть ведение журнала операций: когда и кто запускал или останавливал терминалы. Эти данные могут быть полезны для аудита и анализа использования системы.</p><p>Но главное, что уже сейчас можно видеть: выбранная архитектура и стек технологий (Python + FastAPI + Jinja2 + psutil) позволяют гибко развивать проект, не теряя управляемости и прозрачности. Это отличный пример того, как из простого REST API можно шаг за шагом вырастить полноценную систему управления реальными торговыми процессами.</p><p></p><p>Спасибо за внимание и до следующей встречи!</p><p><br></p><p><b>Содержание архива</b></p><tableclass="standart"width="100%"cellspacing="0"cellpadding="3"><thead><tr><th>#<br></th><th>Имя</th><th>Версия</th><th>Описание</th><th>Последние изменения</th></tr><tr><td></td><td><b>mt5-manager/</b></td><td></td><td>Рабочая папка проекта веб-сервера терминалов</td><td></td></tr><tr><td>1</td><td>├─main.py</td><td>0.1.0<br></td><td>Веб-приложение для веб-сервера терминалов<br></td><td><ahref="https://www.mql5.com/ru/articles/19852"target="_blank">Часть 2</a></td></tr><tr><td>2</td><td>├─mt5_control.py</td><td>0.1.0</td><td>Логика управления запуском и остановкой терминалов </td><td><ahref="https://www.mql5.com/ru/articles/19852"target="_blank">Часть 2</a><br></td></tr><tr><td><br></td><td><b>├─templates/</b></td><td></td><td></td><td></td></tr><tr><td>3</td><td>│ └─ index.html<br></td><td>0.1.0</td><td>Шаблон основной страницы</td><td><ahref="https://www.mql5.com/ru/articles/19852"target="_blank">Часть 2</a><br></td></tr><tr><td></td><td>└─ <b>static/</b></td><td></td><td></td><td></td></tr><tr><td>4</td><td> ├─ styles.css<br></td><td>0.1.0</td><td>CSS-стили<br></td><td><ahref="https://www.mql5.com/ru/articles/19852"target="_blank">Часть 2</a><br></td></tr><tr><td>5</td><td> └─ script.js</td><td>0.1.0</td><td>JavaScript-код<br></td><td><ahref="https://www.mql5.com/ru/articles/19852"target="_blank">Часть 2</a><br></td></tr></thead></table><p>Также исходный код проекта доступен в репозитории <ahref="https://forge.mql5.io/antekov/mt5-manager"rel="noreferrer noopener nofollow"title="https://forge.mql5.io/antekov/mt5-manager"target="_blank">mt5-manager</a>.</p>
Yuriy Bykov
930b46b3c1