Программа удаленного доступа MyConnector

В руководстве описаны функциональные характеристики программы и описание ее возможностей. MyConnector является новой версией (2.x) программы Connector - Отличия от Connector.

_images/main.png

http://myconnector.ru/

Актуальную версию программы можете скачать со следующих ресурсов:

Описание

MyConnector - инструмент системного администратора для осуществления удаленного доступа к компьютерам с различными операционными системами с использованием распространенных типов подключения - таких как RDP, VNC, NX, XDMCP, X2GO, SSH, SFTP, SPICE и технологий Citrix и VMware. C помощью MyConnector также есть возможность подключения к web-ресурсам и файловым серверам (Доступ к файловым ресурсам).

Преимущества данной программы:

  • все необходимые программы удаленного доступа собраны в одной программе - MyConnector, нет необходимости искать нужную;

  • есть возможность как быстрого подключения, так и с определенными параметрами;

  • GUI-интерфейс для работы с программой FreeRDP (удаленный доступ по протоколу RDP);

  • возможность сохранять кнопку быстрого подключения в любое место компьютера;

  • ведение списка сохраненных подключений с возможностью группировки;

  • ведение логов, как самой программы, так и каждого подключения;

  • Режим КИОСК.

Программа написана на Python (3-ей версии) с использованием GTK+ для графического интерфейса.

MyConnector является программой, реализующей интерфейс для пользователя к предустановленным программам для запуска их с введенными параметрами. Такими программами на данный момент являются:

Copyright © 2014-2023 Evgeniy Korneechev <ek@myconnector.ru>

Установка

Alt Linux

Актуальная версия пакета всегда доступна в репозиториях:

$ su -
# apt-get update
# apt-get install myconnector

Linux Mint & Ubuntu

Для оптимальной работы приложения необходимо установить следующие пакеты:

  • libgtk-3-0 (версия 3.10 и выше);

  • python3 (>=3.2);

  • python3-gi (>=3.2);

  • remmina (>=1.0);

  • freerdp-x11 (>=1.2.0) (для Ubuntu14/Mint17), freerdp2-x11 (Ubuntu18/Mint19);

  • vncviewer;

  • python3-keyring.

Все данные программы можно установить либо в Менеджере пакетов Synaptic, либо через командную строку:

$ sudo apt-get update
$ sudo apt-get install libgtk-3-0 python3 python3-gi remmina vncviewer python3-keyring

Не обязательными, но необходимыми для полного функционала программы являются:

После этого можно устанавливать MyConnector. Готовый бинарный пакет для установки можно скачать здесь. Также можно собственноручно собрать пакет по инструкции или установить напрямую из исходников с помощью утилиты make.

git & make

После установки всех зависимостей (для mint/ubuntu - см. выше, для alt - указаны в spec-файле в секциях requires) выполните (пакет git тоже должен быть установлен):

$ git clone https://github.com/MyConnector/MyConnector
$ cd MyConnector
$ git checkout <release> # по умолчанию 'master', список релизов: `git tag -l`
$ sudo make install

Первый запуск

После установки программы MyConnector Вы можете его найти в главном меню, в категории «Интернет»/»Сеть». Либо запустить из командной строки:

$ myconnector

После запуска перед Вами откроется главное окно приложения:

_images/main.png

Сверху справа Вы можете увидеть выпадающий список с названиями технологий (протоколов) подключения. При выборе того или иного элемента внешний вид приложения изменится, будет написано как будет происходить подключение к указанному Вами адресу сервера.

Имеется поле ввода адреса и кнопка для быстрого подключения с параметрами по умолчанию. После ввода адреса и после нажатия данной кнопки (или клавиши Enter) произойдет запуск той или иной программы для подключения к указанному серверу по выбранному протоколу.

Также имеется кнопка «Дополнительные параметры» для указания параметров подключения отличных от параметров по умолчанию, таких как имя пользователя, домен, пароль и т.п. Подробнее об этом в разделе Дополнительные параметры подключений.

Ниже в располагается область с Список сохраненных подключений.

Параметры программы

Для выбора программ, используемых по умолчанию для подключения по протоколам RDP, VNC и SPICE, необходимо открыть главное меню программы и выбрать «Параметры» (или через Значок в области уведомлений), либо нажать комбинацию клавиш Ctrl + P. После этого откроется окно настройки параметров приложения:

_images/params1.png

Есть возможность сменить программу для RDP-соединения - Remmina или FreeRDP, для подключения по VNC - Remmina и vncviewer (любая программа, предоставляющая данный функционал) и для подключения по SPICE - Remmina и Virt Viewer. По умолчанию подключение по RDP настроено через FreeRDP, VNC - через vncviewer, а SPICE - через Remmina.

Также Вы можете настроить отображение определенного протокола на главном окне приложения по умолчанию и сортировку для Список сохраненных подключений.

На вкладке «Расширенные» настраивается отображение значка в трее, проверка обновлений программы, ведение логов, редактор для файлов подключений и сохранение паролей. Есть возможность очистить базу адресов серверов, к которым было совершено подключение (выпадающий список при вводе адреса на главном окне или в доп. параметрах), Список сохраненных подключений, сохраненные пароли и список недавних подключений. Или произвести сброс всех параметров программы.

_images/params2.png

О вкладке «Администрирование» подробнее в разделе документации Параметры администратора.

Дополнительные параметры подключений

При нажатии кнопки «Дополнительные параметры» в области одного из протоколов, откроется окно для ввода настроек подключения по нему. Также данное окно можно открыть из главного меню программы.

Ниже продемонстрированы дополнительные параметры подключения к удаленному рабочему столу Windows (RDP) с использованием наиболее значимых опций программы FreeRDP:

_images/rdp.png

Как видно из изображения, Вы также можете сохранить введенные значения в Список сохраненных подключений. Для этого Вам необходимо ввести имя подключения и нажать кнопку «Сохранить».

Также можно сохранить введенные параметры как параметры по умолчанию для текущего протокола - они будут применяться при быстром подключении с главного окна или при их отсутсвии в открываемых или импортируемых файлах (Прочие возможности).

Список сохраненных подключений

Расположен в нижней части главного окна программы.

_images/main.png

Сохраненные подключения в списке представляют собой файлы с расширением .myc, сохраняемые в домашней папке текущего пользователя в папке .myconnector. Эти файлы возможно открывать на других компьютерах с установленным MyConnector или редактировать в любом удобном текстовом редакторе.

При двойном щелчке на одном из подключений произойдет запуск требуемой программы для соединения (или нажатие правой кнопкой мыши на нужном соединении и далее выбрать пункт меню «Подключение»).

Также через нажатие правой кнопки мыши на любом из сохраненных соединений, Вы можете выбрать пункт «Изменить» - тогда откроется окно дополнительных настроек данного подключения с заполненными полями. При выборе пункта «Копировать» - откроется такое же окно, однако при сохранении добавится новое подключение с измененными Вами параметрами. При выборе пункта «Переименовать» - откроется диалоговое окно переименования подключения (без открытия свойств самого подключения). При выборе пункта «Удалить» - Вы удалите подключение из списка.

Пункт данного меню «Сохранить ярлык» позволяет создать кнопку запуска приложения MyConnector с быстрым подключением к выбранному соединению в любом месте на Вашем компьютере (по умолчанию на рабочем столе). Также это можно сделать простым перетаскиванием подключения в нужное место. Формат команды:

$ myconnector -c|--connection <имя_подключения>

Пункт «Автозапуск подключения» позволяет настроить запускать ли данное подключение при входе пользователя в сеанс или нет. Если включить - то в папке $HOME/.config/autostart создаться ярлык запуска подключения, если выключить - удалится при наличии.

Пункт «Открыть как текст» позволяет открыть файл подключения в текстовом редакторе, указанном на вкладке «Расширенные» в Параметры программы.

Список поддерживает сортировку и группировку (группа указывается в Дополнительные параметры подключений).

Режим КИОСК

Данная функция находится в режиме тестирования и доступна только на семействе операционных систем Альт. За основу взята статья https://wiki.altlinux.org/kiosk.

Доступ к настройке

Доступ к настройке данного режима открывается через пункт главного меню «Режим КИОСК»:

_images/kiosk_off.png

Как видно на данном изображении, по умолчанию доступ к настройке отключен. Для получения доступа необходимо выполнение следующих условий:

  • ОС принадлежит семейству Альт (Alt Linux);

  • наличие установленного пакета myconnector-kiosk;

  • наличие одного из поддерживаемых дисплейных менеджеров - LightDM или SDDM;

  • программа MyConnector запущена с правами администратора:

    $ su -
    # myconnector
    или
    $ sudo myconnector
    

При выполнении всех условий пункт меню будет активным и после нажатия на него откроется окно настройки режима КИОСК:

_images/kiosk.png

Также пункт меню «Режим КИОСК» может быть недоступен еще по двум причинам:

Режимы работы

1. Отключен. Можно также выключить режим киоска из командной строки (sudo или root):

# myconnector --kiosk disable

2. Запуск программы MyConnector. В окружении пользователя запускается сама программа MyConnector, с возможностью подключения к любым ресурсам.

3. Запуск выбранного подключения. Запускается отдельное подключение (с помощью диалога открытия необходимо указать заранее сохраненный файл поддерживаемого формата: .myc, .rdp или .remmina). Указанный файл будет скопирован в домашнюю папку пользователя.

Подключение к WEB-ресурсу. Так называемый WEB-киоск. Запускается браузер Chromium со следующими параметрами командной строки:

chromium --kiosk --incognito <указанный_в_настройках_URL>

Или же (если Chromium не установлен) запускается Mozilla Firefox cо следующими:

firefox --kiosk --private-window <указанный_в_настройках_URL>

Примечание

Ключ --kiosk появился в Firefox с версии 71, если версия будет ниже - откроется обычное приватное окно браузера.

Дополнительные параметры

По умолчанию пользователь для режима определен как kiosk. Но можно указать любого другого (как существующего, так и нет - пользователь будет создан автоматически (пароль для которого, если необходимо, указывается самостоятельно) во время сохранения параметров).

Также имеется возможность настройки автовхода в систему для указанного пользователя.

Так как ни один из используемых браузеров для режима WEB-киоск не имеет возможность отключения сочетаний горячих клавиш в режиме киоска, в myconnector-kiosk есть возможность отключить клавишу Ctrl, чтобы исключить создание новых окон и вкладок, просмотр истории и прочих возможностей по сочетаниям клавиш c Ctrl. Для администраторов же оставлена возможность ее использования - ее функцию выполняет клавиша CapsLock. То есть для запуска терминала нужно использовать CapsLock + Alt + T, для входа в другие TTY - CapsLock + Alt + F[2-9].

Конфигурационный файл

Все произведенные настройки записываются в файл /etc/myconnector/kiosk.conf (используется только для отображения в окне параметров режима). Подробнее (а также о настройке через командную строку) в разделе Использование в командной строке.

Параметры администратора

С версии приложения MyConnector 2.3 добавилась новая вкладка в параметрах программы - «Администрирование»:

_images/params3.png

Для получения доступа необходимо, чтобы программа MyConnector была запущена с правами администратора:

$ su -
# myconnector
или
$ sudo myconnector

Использовать системные настройки

Все настройки программы запишутся в файл /etc/myconnector/myconnector.conf (именно директория /etc/myconnector является рабочей для пользователя с правами администратора, все настройки и подключения созданные под ним сохраняются здесь) и у всех пользователей на компьютере будут именно они, без возможности внесения изменений:

_images/global_config.png

Использовать системные подключения

У всех пользователей будут только те подключения, которые имеются в директории /etc/myconnector, без возможности внесения в них изменений:

_images/global_folder.png

Режим «Stealth»

Данный режим включает в себя:

  • использование системных настроек и подключений (см. выше), опции обязательны для совместного использования с данным режимом;

  • отключение отображения подробностей о подключении в главном окне программы (скриншот см. ниже) и в трее;

  • отключение ведения журнала работы программы.

_images/stealth.png

Доступ к файловым ресурсам

Имеется возможность подключения к сетевым файловым ресурсам, организованным по распространенным протоколам: FTP, SMB, WebDAV и AFP (поддерживаемые большинством файловых менеджеров).

Программа для открытия ресурсов указывается в параметрах программы. По умолчанию, устанавливается команда xdg-open.

Для подключения к сетевым файловым ресурсам в строке адреса (как на главном окне, так и в дополнительных параметрах) обязательно указание протокола подключения:

  • ftp:// - для подключения к FTP-серверу;

  • sftp:// - для подключения по протоколу SFTP;

  • smb:// - ресурсы Windows, доступные по протоколу SMB;

  • dav:// или davs:// - подключение через WebDAV (расширение протокола HTTP или HTTPS);

  • afp:// - доступ к файлам Mac OS (протокол AFP);

  • file:// - открытие локального каталога (например, file:///home/user).

Для быстрого подключения из главного окна программы можно использовать следующий формат адреса (в квадратных скобках указываются необязательные параметры, их также можно указать в окне дополнительных настроек подключения):

Протокол://[Имя_пользователя@]Сервер[:Порт]/[Папка]

Значок в области уведомлений

Программу можно свернуть в трей:

_images/tray.png

По умолчанию, данный функционал отключен, включить его можно в настройках программы на вкладке «Расширенные» (Параметры программы), которые доступны из этого меню. Также доступно главное окно программы и быстрое подключение к сохраненным подключениям.

Использование в командной строке

Настроен bash completion (автоподстановка параметров по нажатию клавиши Tab).

Ниже приведены страницы документации, входящие в состав пакета.

$ myconnector --help
usage: myconnector [options]

MyConnector - клиент удаленного рабочего стола.

positional arguments:
  FILE                  имя файла подключения (.myc, .remmina, .rdp)

optional arguments:
  -h, --help            показать эту справку и выйти
  -c CONNECTION, --connection CONNECTION
                        имя сохраненного подключения
  -f FILE, --file FILE  имя файла подключения (.myc, .remmina, .rdp)
  -l, --list            список сохраненных подключений
  -e, --edit            редактировать конфигурационный файл (будет использоваться
                        редактор, указанный в VISUAL или EDITOR, по умолчанию vi)
  --kiosk <option>      Управление режимом КИОСКа ('--kiosk help' для подробной информации)
  -v, --version         показать версию приложения
  -d, --debug           отображение журнала работы в режиме реального времени
  -q, --quit            закрыть все копии приложения

Не указывайте опций для запуска графического интерфейса.

Copyright (C) 2014-2023 Evgeniy Korneechev <ek@myconnector.ru>

$ man myconnector
НАИМЕНОВАНИЕ
       MyConnector - remote desktop client.

СИНТАКСИС
       myconnector [options]

ОПИСАНИЕ
       Программа-фронтэнд  для  удаленного  администрирования  компьютеров с различными операционными системами. Поддерживается большинство распространенных типов подключения (RDP, VNC,
       X2GO, Citrix, VMware, etc).

ОПЦИИ
       <без опций>
          Запустить программу в режиме графического интерфейса.

       -c CONNECTION, --connection CONNECTION
          Подключиться к сохраненному подключению по его имени.

       FILE, -f FILE, --file FILE
          Подключиться с помощью файла подключения (.myc, .remmina, .rdp).

       -l, --list
          Вывести список сохраненных подключений.

       -e, --edit
          Редактировать конфигурационный файл.

       --kiosk <option>
          Управление режимом КИОСК (подробнее: '--kiosk help').

       -v, --version
          Вывести информацию о версии программы и завершить работу.

       -d, --debug
          Запуск программы в режиме отображения журналов работы в реальном времени.

       -h, --help
          Вывести краткую справку и завершить работу.

       -q, --quit
          Закрыть все существующие копии программы.

$ myconnector --kiosk help
myconnector --kiosk - Управление режимом КИОСКа

Использование: myconnector --kiosk <option>

Опции:
  enable        включить простой режим (запуск программы MyConnector);
  edit          редактировать конфигурационный файл (будет использоваться
                редактор, указанный в VISUAL или EDITOR, по умолчанию: vi);
  disable       отключить режим;
  status        показать текущий статус режима;
  help          показать эту справку и выйти.

См. также: man myconnector-kiosk

Copyright (C) 2014-2023 Evgeniy Korneechev <ek@myconnector.ru>

$ man myconnector-kiosk
НАИМЕНОВАНИЕ
       myconnector-kiosk - Mode KIOSK for 'MyConnector'

ОПИСАНИЕ
       Конфигурационный файл режима КИОСК программы MyConnector - /etc/myconnector/kiosk.conf

       mode - один из следующих режимов работы:
          "0" - КИОСК отключен
          "1" - запуск программы MyConnector в режиме КИОСК
          "2" - соединение с сохраненным подключением
          "3" - ВЕБ-киоск

       file - файл подключения для mode=2

       url - URL для ВЕБ-киоска

       user - имя пользователя для режима КИОСК

       autologin - управление автовходом пользователя
          True,Yes - включен
          False,No - отключен

       ctrl_disabled - отключение "Ctrl" в ВЕБ-киоске
          True,Yes - отключен
          False,No - включен

Прочие возможности

Поиск по списку подключений (фильтр)

В нижней части главного окна программы есть поле для ввода поискового запроса (можно нажать Ctrl + F для установки фокуса на данное поле). Поддерживается инверсия русской и английской раскладки клавиатуры (например при вводе ыукмук найдется server).

Открытие файлов

В программе есть возможность открытия файлов .myc, .rdp и .remmina. Для этого в пункте меню «Файл» выберите «Открыть», либо дважды щелкните на нем в файловом менеджере. После выбора необходимого файла будет произведена попытка соединения - если файл не содержит параметров или содержит ошибки, то отобразится соответствующее сообщение. В другом случае - произойдет успешное подключение к серверу.

Импорт файлов

Вы также можете импортировать параметры из файлов (.myc, .ctor, .rdp и .remmina) либо для изменения параметров, либо для сохранения в свой список подключений. Для этого в пункте меню «Файл» выберите «Импорт…», после этого откроется диалог открытия файла, а после его выбора откроется окно дополнительных параметров того типа подключения, который записан в данный файл.

Импорт из старого формата файлов .ctor помимо главного меню доступен через утилиту ctor2myc, входящую в состав пакета:

$ ctor2myc
usage: ctor2myc [-v] input.ctor [output.myc]

Также при первом запуске MyConnector и при наличии в рабочей папке .connector в домашней папке пользователя файлов подключения Connector будет выдан запрос на автоматический импорт всех имеющихся там соединений.

Ведение логов

Располагаются в рабочей папке программы: ~/.myconnector/logs. Файл all.log содержит отладочную информацию от запускаемых программ, а myconnector.log - информацию по работе самого MyConnector (три уровня сообщений: info, warning и error) и ошибки в его работе. В «Параметрах программы» есть возможность отключения ведения логов.

Текстовый редактор для подключений

В «Параметрах программы» можно указать редактор, используемый при нажатии кнопки «Открыть как текст» в контекстном меню списка подключений.

Справка по программе MyConnector

Ссылка на данную страницу Wiki всегда доступна из приложения - пункт главного меню «Справка». Там же краткие сведения о программе и об ее разработчике. Также справочную информацию можно просмотреть и на компьютере (данная вики размещена в отдельном пакете myconnector-docs):

$ man myconnector
$ myconnector --help

Отличия от Connector

connector right myconnector

MyConnector является обновленной версией программы Connector. Основные отличия (на 01.05.2022):

  • обновленный графический интерфейс;

  • текстовый формат файлов подключений .myc (с автоимпортом подключений из Connector), что означает возможную правку и создание подключений с помощью любого текстового редактора (плюс возможность открыть через контекстное меню списка подключений);

  • возможность группировки в списке сохраненных подключений;

  • импорт подключений RDP, Remmina (и формата .ctor);

  • интерфейс командной строки для настройки Режим КИОСК;

  • X2GO-подключение (консольный клиент pyhoca-cli);

  • добавлен англоязычный интерфейс (i18n);

  • возможность настройки автозапуска подключения при входе пользователя;

  • режим прослушивания для vncviewer;

  • сохранение паролей - настраиваемая опция;

  • возможность удаления всех сохраненных паролей;

  • системные параметры и список подключений;

  • режим "Stealth".