Skip to content

Commit

Permalink
Merge pull request #2580 from spnethw/netrocks_hlf
Browse files Browse the repository at this point in the history
NetRocks: add Russian hlf + minor fixes in English hlf
elfmz authored Dec 22, 2024
2 parents 2d6ae9f + a246d8c commit 0b36cef
Showing 2 changed files with 325 additions and 26 deletions.
69 changes: 43 additions & 26 deletions NetRocks/configs/plug/helpe.hlf
Original file line number Diff line number Diff line change
@@ -6,11 +6,11 @@ $^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
This plugin adds SFTP/SCP/SHELL/NFS/SMB/WebDAV connectivity to far2l with possibility to add other protocols.
This plugin adds SFTP/SCP/SHELL/NFS/SMB/WebDAV/FTP(S) connectivity to far2l with possibility to add other protocols.

To access this module open plugins menu (F11) or use disks (Alt+F1/Alt+F2) menu. Then choose the "NetRocks". See further topics for more detail.
To access this module open plugins menu (F11) or use Location (Alt+F1/Alt+F2) menu. Then choose the "NetRocks". See further topics for more detail.

~Disks/Plugin menu and sites list~@DisksMenu@
~Location/Plugin menu and sites list~@LocationMenu@

~Background tasks menu~@BackgroundTasksMenu@

@@ -29,14 +29,13 @@ you can switch it to background;
(available only during background action via Plugin commands list by #F11# or via #F9#/Options/Plugins configuration).


@DisksMenu
@LocationMenu
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#Disks/Plugin menu#
$^#Location/Plugin menu#

After choosing the plugin from disks menu (#Alt+F1#/#Alt+F2#) or from Plugin menu (#F11#) you will see connection sites list.
After choosing the plugin from Location menu (#Alt+F1#/#Alt+F2#) or from Plugin menu (#F11#) you will see connection sites list.
Initially there're no sites defined, but you can add site using #<Create site connection># entry or pressing #Shift+F4#.
After being added any site connection can be edited by pressing #F4# or removed by pressing #F8#.
You can #export# selected sites settings to filesystem by opening disk directory in another panel and using #F5#/#F6# keys.
@@ -49,7 +48,6 @@ present in that config.
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#Background tasks menu#

This NetRocks-related menu item available in F11 or Plugins configuration but appears only if there're any background tasks spawned. Here you can examine state of each background task and switch to working (usually destination) directory of completed task by selecting them in opened submenu. Note that selection of completed tasks items automatically removes them from this list.
@@ -60,14 +58,18 @@ $^#Background tasks menu#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#Configuration menu#

Here you can change some plugin-wide options:

#Enable desktop notifications# this options controls if NetRocks will use desktop environment notifications on operation completions or errors. Note that behavior of this notifications partially controlled by FAR.

#<ENTER> to execute files remotely when possible# if enabled then pressing <ENTER> on remote executable file will execute it remotely instead of download and run locally. Note that this option only works for protocols that support it (like SFTP/SCP) and doesn't affect non-executable files, like documents, - they will be still downloaded and opened locally.

#Smart symlinks copying# if (by default) enabled then NetRocks will translate symlinks paths to refer file that copied in same copy operation, or, if symlinks refer file that is not being copied - then such symlink will be converted to plain file. If disabled then NetRocks will just copy symlinks as is, without any efforts to ensure their validity in the new location.

#Use of chmod# change this options if want to have copied files modes to be exactly same as on source files, even in target system umask prevents some mode bits from being set. Or if you want to disable using of chmod at all - for example to avoid other inherited ACLs from being overriden by it.

#Connections pool expiration# when exiting from some remote FS navigation NetRocks will keep actual connection active for specified amount of time and if same server connection will be established before expiration - it will use preserved connection instead of establishing new.

~Contents~@Contents@
@@ -76,19 +78,20 @@ $^#Configuration menu#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#Site connection editor#

This dialog allows you to create new connection site or modify existing connection site settings. You should select protocol you want use and the define connection settings, like #hostname and port# to connect to, #login mode# and #username and password# if needed.
Also by clicking on #Extra options# button you can modify some ~extra site settings~@ExtraSiteSettings@.
This dialog allows you to create new connection site or modify existing connection site settings. You should select protocol you want use and the define connection settings, like #hostname and port# to connect to, #login mode# and #username and password# if needed. #Display name# can further be used for quick access from the ~command line~@CommandLine@.

Also by clicking on #Extra options# button you can modify some ~extra site settings~@ExtraSiteSettings@.
Also by clicking on #Protocol options# button you can modify some protocol-specific settings.
Also by clicking on #Proxy options# button you can modify generic ~proxy settings~@ProxySettings@.

~SFTP:// and SCP:// protocols specific options~@ProtocolOptionsSFTPSCP@
~SHELL:// protocols specific options~@ProtocolOptionsSHELL@
~FTP:// and FTPS:// protocols specific options~@ProtocolOptionsFTP@
~SMB:// protocol specific options~@ProtocolOptionsSMB@
~NFS:// protocol specific options~@ProtocolOptionsNFS@
DAV:// and DAVS:// protocol specific options
~DAV:// and DAVS:// protocol specific options~@ProtocolOptionsWebDAV@
~FILE:// protocol specific options~@ProtocolOptionsFILE@

~Contents~@Contents@
@@ -97,11 +100,12 @@ Also by clicking on #Proxy options# button you can modify generic ~proxy setting
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#Command line and remote FAR2L#

When entering commands in command line when panel displays usual files list you can open connection by typing NetRocks-supported protocol URL, like #sftp://192.168.1.15# or alternatively you can open preconfigured site by invoking its name between triangle brackets and prefixed with net: prefix, like: #net:<SITE>#

When entering commands in command line when panel displays active NetRocks connection of SFTP and SCP protocols - NetRocks will execute them directly on remote host, opening full-featured pseudoterminal for controlling remotely-executed commands. This essentially #allows using NetRocks as SSH client# with FAR2L-extended pseudoterminal.

If you're working in GUI-based FAR2L you can run #remote TTY-mode FAR2L# directly in NetRocks SFTP/SCP connected panel and work in that remote FAR2L with user experience of local GUI-based version (full keyboard support, clipboard sharing, desktop notifications) as well as being sure that if connection suddenly drops - remote work will not be killed instantly, since remote terminal-based FAR2L will remain alive and active in background and next time you will reconnect and re-launch far2l - it will prompt to activate that backgrounded FAR2L instance.

~Contents~@Contents@
@@ -110,10 +114,10 @@ $^#Command line and remote FAR2L#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#SMB:// protocol specific options#

This dialog allows you to modify "smb://" protocol specific settings, which is file sharing protocol primarily used in Windows networks.

#Workgroup:# here you can specify workgroup name where to search hosts.
#Enum network with SMB:# check this option to enable using of libsmbclient to scan for hosts when open empty path ("smb://")
#Enum network with NMB:# check this option to enable using of NetRock's builtin NetBios name service scanner to scan for hosts when open empty path ("smb://")
@@ -124,19 +128,27 @@ $^#SMB:// protocol specific options#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#SFTP:// SCP:// protocols specific options#

This dialog allows you to modify "sftp://" and "scp://" protocols specific settings. Here you can enable authentication by key file, change maximum IO block size or enable TCP_NODELAY socket option.

#Private key file:# can be used for SSH server instead of 'usual' username:password authentication. Note that in such case password field in the main connection settings is actually 'passphrase' used to access private key file.

#IO block size:# increasing this value usually gives performance improvement, especially on uploading files. However not all servers support block size more than 32768 bytes, so use higher values only if you sure it will work with your server.

#TCP_NODELAY socket option:# also can improve network performance by eliminating delay used by TCP stack to buffer outgoing data. However in some cases it may also increase network packets rate, so use it when you know that its better.

#TCP_QUICKACK socket option:# if enabled, TCP ack packets are sent immediately, rather than delayed that may improve receive performance.
#Custom subsystem request/exec# here you can replace default SFTP subsystem handler with specific command, usually its used to get superuser access from sudo'er account by using command line like [sudo /usr/lib/openssh/sftp-server]

#Allowed host keys# if non-empty then forces using only specified host key algorithms. Beside of restricting other algorithms this option can be used to allow using some deprecated algorithm e.g. ssh-rsa if server doesn't support modern ones.

#Allowed KEX algorithms# if non-empty then forces using only specified key-exchange algorithms. Beside of restricting other algorithms this option can be used to allow using some deprecated algorithm e.g. diffie-hellman-group1-sha1 if server doesn't support modern ones.

#Allowed HMAC client->server# if non-empty then forces using only specified HMAC client->server algorithms. Beside of restricting other algorithms this option can be used to allow using some deprecated algorithm e.g. hmac-sha1 if server doesn't support modern ones.

#Allowed HMAC server->client# if non-empty then forces using only specified HMAC server->client algorithms. Beside of restricting other algorithms this option can be used to allow using some deprecated algorithm e.g. hmac-sha1 if server doesn't support modern ones.

#OpenSSH config files# allows to specify which OpenSSH config files to use for this connection. By default ~~/.ssh/config and /etc/ssh/ssh_config are used. Note that libssh version prior 0.9.0 always parses default config files regardless of this option (so you can only add extra configs), but since version 0.9.0 it's possible to disable/override default config files parsing. To specify more than one file - use colon to separate their paths.

~Contents~@Contents@
@@ -145,12 +157,13 @@ $^#SFTP:// SCP:// protocols specific options#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#SHELL:// protocols specific options#

This dialog allows you to modify "shell://" protocols specific settings.

Note that this protocol is specific in a way it communicates with server - instead of using dedicated file access protocol it runs on server special helper script that handles required text commands, allowing to browse and transfer files.
Due to this, SHELL protocol in general picky about server's shell and which standard UNIX tools are accessible there.

Currently you may choose from two predefines ways to access server's shell - either using installed on #client SSH client# (ssh) either using #serial port interface#.
Note that #serial port way# is very sensitive to losses on communication line and sensitive to printouts noise that may arrive from server's kernel or whatever else. So don't use serial port way unless your surely knows what you need and be careful with file transfers afterwards. You may reduce printouts from kernel by following command: #echo 0 > /proc/sys/kernel/printk# before using serial port for this. And make sure serial port is not used by any other process that otherwise can interfere with NetRocks SHELL protocol.

@@ -160,18 +173,26 @@ $^#SHELL:// protocols specific options#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#FTP:// FTPS:// protocols specific options#

This dialog allows you to modify "ftp://" and "ftps://" protocols specific settings. Here you can setup encryption and adjust various options of protocol and networking.

#Explicit encryption:# can be used to enable encryption through AUTH command if FTP server supports it. Note that this option not enabled for FTPS cuz it always uses encryption.

#Minimal encryption protocol:# here you can adjust which protocols can be used for encryption. Note that currently SSL and TLSv1.0 not considered as secure so its not recommended to use them.

#Directory list command:# specify exact command to be used to list files in directory. Most FTP server accepts LIST -la, where -la specifies full list format that includes also .dotfiles, however some servers don't understand -la argument and may require this to be changed to LIST to properly list files.

#Use MLSD/MLST if possible:# use MLSD and MLST commands to retrieve directory listing or information about particular file. If unchecked only LIST command can be used, that is potentially less reliable and slower.

#Passive mode:# selecting this makes NetRocks to use PASV command for data transmission that is most compatible setting. Unchecking it will make NetRocks to use PORT command instead, that uses reversed connection schema and may be incompatible with some firewalls and NAT'ed networks.

#Enable commands pipelining:# allow sending multiple FTP commands as once before receiving response for each command. Reduces delays, but some FTP servers may be incompatible with it.

#Ensure data connection peer matches server:# if checked NetRocks will check that data connection peer IP address of accepted PORT connection matches to actual IP server address. Also if encryption used this will require data connection's certificate to match with command connection's.

#TCP_NODELAY socket option:# can improve network performance by eliminating delay used by TCP stack to buffer outgoing data. However in some cases it may also increase network packets rate, so use it when you know that its better.

#TCP_QUICKACK socket option:# if enabled, TCP ack packets are sent immediately, rather than delayed that may improve receive performance.

~Contents~@Contents@
@@ -180,7 +201,6 @@ $^#FTP:// FTPS:// protocols specific options#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#NFS:// protocol specific options#

This dialog allows you to modify "nfs://" protocol specific settings. Here you can override default user credentials: host, UID, GID and comma-separated list of additional group IDs. Note that some old libnfs may not support this options - in such case they will have no effect.
@@ -191,7 +211,6 @@ $^#NFS:// protocol specific options#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#FILE:// protocol specific options#

Pseudo-protocol "file:" has not additional options.
@@ -210,23 +229,23 @@ you can switch it to background;
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#Extra site settings#

This dialog allows you to modify some extra (not frequently used) site settings:

To prevent connection from disconnect-due-to-idle - set non-zero #keepalive# period.
Apply remote files timestamps adjustement.
Change #codepage# being used by server.
It's possible to #execute specific command# when opening or closing site connection, and that command can, for example, do mounting of some resource that is to be accessed using this connection site. This command will have defined as environment fields of host (#$HOST#), port (#$PORT#), username (#$USER#), password (#$PASSWORD#) and additional extra string configured in this dialog (#$EXTRA#). In this dialog its also possible to define amount of time NetRocks will wait for completion of this command (if command will not complete during that time - timeout error will be raised). Special environment variable #$SINGULAR# equals to 1 in case command being executed on a connection that is singular to specified protocol/user/host/port across all NetRocks instances, so you may use this to initialize/cleanup shared things. In case your init/cleanup have to exchange some data - save it into file indicated by $STORAGE environment variable, and then don't forget to delete this file from cleanup script running in singular context.

It's possible to #execute specific command# when opening or closing site connection, and that command can, for example, do mounting of some resource that is to be accessed using this connection site. This command will have defined as environment fields of host (#$HOST#), port (#$PORT#), username (#$USER#), password (#$PASSWORD#) and additional extra string configured in this dialog (#$EXTRA#). In this dialog its also possible to define amount of time NetRocks will wait for completion of this command (if command will not complete during that time - timeout error will be raised). Special environment variable #$SINGULAR# equals to 1 in case command being executed on a connection that is singular to specified protocol/user/host/port across all NetRocks instances, so you may use this to initialize/cleanup shared things. In case your init/cleanup have to exchange some data - save it into file indicated by $STORAGE environment variable, and then don't forget to delete this file from cleanup script running in singular context.

~Contents~@Contents@

@ProtocolOptionsWebDAV
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#DAV:// and DAVS:// protocol specific options#
$^#DAV:// and DAVS:// protocol specific options#

This dialog allows you to modify "dav://" and "davs://" protocol specific settings: enable connect via HTTP/HTTPS proxy with optional proxy authentication.

@@ -236,7 +255,6 @@ $^#DAV:// and DAVS:// protocol specific options#
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#Proxy settings dialog#

This dialog allows you to specify generic proxy settings for connection. Currently such generic support is implemented by using of external 'proxifier' tool. Two such tools are supported: #proxychains# and #tsocks#. So in order to use this option
@@ -250,7 +268,6 @@ you have to install any of them (however proxychains is recommended) and edit it
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Contents
$^#Contact information#

elfmz
282 changes: 282 additions & 0 deletions NetRocks/configs/plug/helpr.hlf
Original file line number Diff line number Diff line change
@@ -0,0 +1,282 @@
.Language=Russian,Russian (Русский)
.PluginContents=NetRocks

@Contents
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Содержание
Плагин расширяет функциональность far2l, добавляя поддержку протоколов SFTP/SCP/SHELL/NFS/SMB/WebDAV/FTP(S).

Чтобы получить доступ к этому модулю, откройте меню плагинов (#F11#) или используйте меню перехода (#Alt+F1#/#Alt+F2#). Затем выберите "NetRocks". Подробнее см. в следующих темах.

~Меню перехода, меню плагинов и список подключений~@LocationMenu@

~Фоновые задачи NetRocks~@BackgroundTasksMenu@

~Настройки NetRocks~@PluginOptions@

~Настройки подключения~@SiteConnectionEditor@

~Командная строка и удаленный FAR2L~@CommandLine@

~Контакты~@Contact@

Советы и хитрости:
- во время любой операции копирования NetRocks (на одной панели должен быть NetRocks, другая может быть стандартной файловой панелью far2l) вы можете переключить её в фоновый режим;
- для управления/отмены любого фонового действия вы можете использовать меню ~Фоновые задачи NetRocks~@BackgroundTasksMenu@ (доступно через меню плагинов (#F11#) или конфигурации плагинов (#Alt+Shift+F9#), если запущена хотя бы одна фоновая задача).


@LocationMenu
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Меню перехода и меню плагинов#

После выбора NetRocks из меню перехода (#Alt+F1#/#Alt+F2#) или из меню плагинов (#F11#) вы увидите список подключений (сайтов).
Изначально список пуст, но вы можете добавить сайт, выбрав пункт #<Создать новое подключение># или нажав #Shift+F4#.
После добавления любое подключение можно отредактировать нажатием #F4# или удалить нажатием #F8#.

Вы можете #экспортировать# настройки выбранных подключений в файловую систему посредством #F5#/#F6#, открыв нужный каталог в другой панели.
После экспорта сайта вы можете #импортировать# его обратно в список подключений NetRocks, либо войти в него как в архив, чтобы просмотреть сайт(ы), которые присутствуют в этом конфиге.

~Содержание~@Contents@

@BackgroundTasksMenu
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Фоновые задачи NetRocks#

Этот пункт, относящийся к NetRocks, доступен из меню плагинов (#F11#) или конфигурации плагинов (#Alt+Shift+F9#), но появляется только в том случае, если запущены какие-либо фоновые задачи. Здесь вы можете просмотреть состояние каждой фоновой задачи и перейти в рабочий (обычно конечный) каталог завершенной задачи, выбрав их в открывшемся подменю. Обратите внимание, что выбор завершенных задач автоматически удаляет их из этого списка.

~Содержание~@Contents@

@PluginOptions
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки NetRocks#

Здесь вы можете изменить некоторые общие для плагина параметры:

#Включить уведомления рабочего стола#. Этот параметр управляет тем, будет ли NetRocks использовать уведомления рабочего стола при завершении операций или ошибках. Обратите внимание, что поведение этих уведомлений частично контролируется FAR2L.

#<ENTER> исполняет файлы на сервере если возможно#. Если опция включена, то нажатие <ENTER> на удаленном исполняемом файле приведет к его удаленному выполнению вместо загрузки и запуска локально. Обратите внимание, что эта опция работает только для протоколов, которые это поддерживают (например, SFTP/SCP), и не влияет на неисполняемые файлы, такие как документы, - они все равно будут загружены и открыты локально.

#Умное копирование символических ссылок#. При включённой опции (по умолчанию) во время копирования NetRocks изменяет символические ссылки так, чтобы они указывали на скопированные в рамках той же операции файлы. Если же ссылка ведёт на файл, который не копируется, NetRocks преобразует её в обычный файл. При отключённой опции NetRocks копирует символические ссылки в неизменном виде, не предпринимая попыток адаптировать их к новому расположению.

#Использовать chmod#. Измените эту опцию, если хотите, чтобы права скопированных файлов были бы точно такими же, как у исходных файлов, даже если в целевой системе umask не позволяет установить некоторые биты режима. Или чтобы отключить использование chmod вообще для предотвращения перезаписи унаследованных прав доступа (ACL).

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

~Содержание~@Contents@

@SiteConnectionEditor
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки подключения#

Этот диалог позволяет создать новое или изменить настройки существующего подключения. Вы должны выбрать протокол, который хотите использовать, и определить параметры подключения, такие как #имя сервера и порт# для подключения, #режим входа# и #имя пользователя и пароль#, если необходимо. #Имя подключения# может в дальнейшем использоваться для быстрого доступа из ~командной строки~@CommandLine@.

Также, кнопка #Доп. настройки# позволяет изменить ~Дополнительные настройки соединения~@ExtraSiteSettings@.
Кнопка #Настр. протокола# позволяет изменить специфичные для конкретного протокола настройки.
Кнопка #Настр. прокси# позволяет изменить общие ~Настройки прокси~@ProxySettings@.

Подробнее о протокол-специфичных настройках:
~Настройки SFTP:// и SCP://~@ProtocolOptionsSFTPSCP@
~Настройки SHELL://~@ProtocolOptionsSHELL@
~Настройки FTP:// и FTPS://~@ProtocolOptionsFTP@
~Настройки SMB://~@ProtocolOptionsSMB@
~Настройки NFS://~@ProtocolOptionsNFS@
~Настройки DAV:// и DAVS://~@ProtocolOptionsWebDAV@
~Настройки FILE://~@ProtocolOptionsFILE@

~Содержание~@Contents@

@CommandLine
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Командная строка и удаленный FAR2L#

Вы можете установить соединение, находясь в обычной файловой панели, прямо из командной строки: либо введя URL протокола, поддерживаемого NetRocks (например #sftp://192.168.1.15#), либо указав имя подключения ~предварительно сконфигурированного~@SiteConnectionEditor@ сайта в треугольных скобках и префиксом net (например: #net:<SITE>#).

При вводе команд в командной строке, когда на панели NetRocks отображается активное соединение по протоколам SFTP и SCP, NetRocks выполнит их непосредственно на удаленном хосте, открыв полнофункциональный псевдотерминал для управления удаленно выполняемыми командами. По сути, это позволяет использовать #NetRocks как SSH-клиент# с FAR2L-расширенным псевдотерминалом.

Если вы работаете в FAR2L с графическим интерфейсом, вы можете запустить #удаленный FAR2L в TTY-режиме# непосредственно из панели NetRocks с SFTP/SCP-подключением и работать в этом удаленном FAR2L с пользовательскими возможностями локальной GUI-версии (полная поддержка клавиатуры, совместное использование буфера обмена, уведомления на рабочем столе), а также быть уверенным, что в случае внезапного разрыва соединения удаленная работа не будет мгновенно прервана, так как удаленный терминальный FAR2L останется активным в фоновом режиме, и в следующий раз, когда вы снова подключитесь и перезапустите FAR2L - он предложит активировать этот фоновый экземпляр FAR2L.

~Содержание~@Contents@

@ProtocolOptionsSMB
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки SMB://#

Этот диалог позволяет изменять настройки протокола "smb://", который является протоколом совместного доступа к файлам и используется в основном в сетях Windows.

#Рабочая группа:# здесь вы можете указать имя рабочей группы, в которой следует искать хосты.
#Использовать SMB для обзора сети:# установите этот флажок, чтобы включить использование libsmbclient для сканирования хостов при открытии пустого пути ("smb://").
#Использовать NMB для обзора сети:# установите этот флажок, чтобы включить встроенный в NetRocks сканер службы имен NetBIOS для сканирования хостов при открытии пустого пути ("smb://").

~Содержание~@Contents@

@ProtocolOptionsSFTPSCP
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки SFTP:// и SCP://#

Этот диалог позволяет изменять специфичные для "sftp://" и "scp://" настройки протоколов. Здесь вы можете включить аутентификацию по ключу, изменить максимальный размер блока чтения/записи или включить опцию TCP_NODELAY.

#Файл приватного ключа:# может быть использован для сервера SSH вместо "обычной" аутентификации по имени пользователя и паролю. Обратите внимание, что в этом случае поле пароля в основных ~настройках подключения~@SiteConnectionEditor@ фактически является "парольной фразой", используемой для доступа к файлу приватного ключа.

#Размер блока ввода-вывода:# увеличение этого значения обычно улучшает производительность, особенно при загрузке файлов. Однако не все серверы поддерживают размер блока больше 32768 байт, поэтому используйте более высокие значения только в том случае, если вы уверены, что они будут работать с вашим сервером.

#Опция сокета TCP_NODELAY:# также может улучшить производительность сети, устраняя задержки, используемые стеком TCP для буферизации исходящих данных. Однако в некоторых случаях это может также увеличить скорость передачи сетевых пакетов, поэтому используйте её, только если уверены, что это улучшит работу.

#Опция сокета TCP_QUICKACK:# при включении пакеты TCP-подтверждения (ACK) отправляются немедленно, а не с задержкой, что может улучшить производительность приема.

#Запрос особой подсистемы:# здесь вы можете заменить стандартный обработчик подсистемы SFTP на определенную команду, обычно используется для получения доступа суперпользователя от sudoers учетной записи с помощью командной строки, например [sudo /usr/lib/openssh/sftp-server].

#Разрешенные ключи:# если поле не пустое, то принудительно используются только указанные алгоритмы ключей хоста. Помимо ограничения других алгоритмов, эта опция может использоваться для разрешения использования некоторых устаревших алгоритмов, например, ssh-rsa, если сервер не поддерживает современные.

#Разрешенные KEX:# если поле не пустое, то принудительно используются только указанные алгоритмы обмена ключами. Помимо ограничения других алгоритмов, эта опция может использоваться для разрешения использования некоторых устаревших алгоритмов, например, diffie-hellman-group1-sha1, если сервер не поддерживает современные.

#Разрешенные HMAC клиента:# если поле не пустое, то принудительно используются только указанные алгоритмы HMAC клиент->сервер. Помимо ограничения других алгоритмов, эта опция может использоваться для разрешения использования некоторых устаревших алгоритмов, например, hmac-sha1, если сервер не поддерживает современные.

#Разрешенные HMAC сервера:# если поле не пустое, то принудительно используются только указанные алгоритмы HMAC сервер->клиент. Помимо ограничения других алгоритмов, эта опция может использоваться для разрешения использования некоторых устаревших алгоритмов, например, hmac-sha1, если сервер не поддерживает современные.

#OpenSSH конфиги:# позволяет указать, какие конфигурационные файлы OpenSSH использовать для этого подключения. По умолчанию используются ~~/.ssh/config и /etc/ssh/ssh_config. Обратите внимание, что версии libssh до 0.9.0 всегда анализируют файлы конфигурации по умолчанию независимо от этой опции (поэтому вы можете только добавлять дополнительные конфигурации), но начиная с версии 0.9.0 можно отключить/переопределить анализ файлов конфигурации по умолчанию. Для указания нескольких файлов используйте двоеточие для разделения путей.

~Содержание~@Contents@

@ProtocolOptionsSHELL
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки SHELL://#

Этот диалог позволяет изменять настройки протокола "shell://".

Обратите внимание на особенность протокола при взаимодействии с сервером - вместо использования специального протокола доступа к файлам он запускает на сервере вспомогательный скрипт, который обрабатывает посылаемые ему текстовые команды, позволяя просматривать и передавать файлы.
В связи с этим протокол SHELL в целом требователен к оболочке сервера и к тому, какие стандартные инструменты UNIX в ней доступны.

В настоящее время вы можете выбрать один из двух предопределенных способов доступа к оболочке сервера - либо используя установленный #на клиенте SSH-клиент# (ssh), либо используя #интерфейс последовательного порта#.

Обратите внимание, что способ с последовательным портом очень чувствителен к потерям в линии связи и шуму вывода, который может поступать от ядра сервера или от других источников. Поэтому не используйте способ с последовательным портом, если вы не уверены в необходимости, и будьте осторожны с передачей файлов впоследствии. Вы можете снизить количество выводов ядра, выполнив команду: #echo 0 > /proc/sys/kernel/printk# перед использованием последовательного порта для этого. И убедитесь, что последовательный порт не используется другим процессом, который может помешать работе протокола NetRocks SHELL.

~Содержание~@Contents@

@ProtocolOptionsFTP
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки FTP:// и FTPS://#

Этот диалог позволяет изменять специфичные для "ftp://" и "ftps://" настройки протоколов. Здесь вы можете настроить шифрование и различные параметры протокола и сети.

#Включить шифрование:# можно использовать для включения шифрования через команду AUTH, если сервер FTP его поддерживает. Обратите внимание, что эта опция недоступна для протокола FTPS, так как он всегда использует шифрование.

#Минимальный протокол шифрования:# здесь можно настроить, какие протоколы могут использоваться для шифрования. Обратите внимание, что в настоящее время SSL и TLSv1.0 не считаются безопасными, поэтому их использование не рекомендуется.

#Команда листинга директории:# укажите точную команду, которая будет использоваться для перечисления файлов в каталоге. Большинство серверов FTP принимают LIST -la, где -la задает полный формат списка, включающий также скрытые файлы (.dotfiles), однако некоторые серверы не понимают аргумент -la и могут потребовать изменить его на LIST для правильного перечисления файлов.

#Использовать MLSD/MLST если возможно:# при возможности используйте команды MLSD и MLST для получения списка каталога или информации о конкретном файле. Если этот параметр не выбран, будет использоваться только команда LIST, что медленнее и потенциально менее надежно.

#Пассивный режим:# выбор этой опции заставит NetRocks использовать команду PASV для передачи данных, что является наиболее совместимым режимом. При отключенной опции NetRocks пошлёт команду PORT, что использует схему обратного подключения и может быть несовместимо с некоторыми брандмауэрами и сетями с NAT.

#Использовать конвейеризацию команд:# позволяет отправлять несколько команд FTP одновременно, прежде чем получать ответ на каждую из них. Уменьшает задержки, но некоторые серверы FTP могут быть с этим несовместимы.

#Разрешить данные только с того же сервера:# при включенной опции NetRocks удостоверится, что IP адрес пира принятого им PORT-подключения соответствует IP адресу настоящего сервера, с которым соединение изначально инициировалось. Также, если используется шифрование, он потребует соответствия сертификатов канала данных и управляющего канала.

#Опция сокета TCP_NODELAY:# может улучшить производительность сети, устраняя задержки, используемые стеком TCP для буферизации исходящих данных. Однако в некоторых случаях это может также увеличить скорость передачи сетевых пакетов, поэтому используйте её, только если уверены, что это улучшит работу.

#Опция сокета TCP_QUICKACK:# при включении пакеты TCP-подтверждения (ACK) отправляются немедленно, а не с задержкой, что может улучшить производительность приема.

~Содержание~@Contents@

@ProtocolOptionsNFS
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки NFS://#

Этот диалог позволяет изменять настройки протокола "nfs://". Здесь вы можете переопределить стандартные учетные данные пользователя: хост, UID, GID и список дополнительных идентификаторов групп, разделенный запятыми. Обратите внимание, что некоторые старые libnfs могут не поддерживать эти параметры - в этом случае они не будут иметь никакого эффекта.

~Содержание~@Contents@

@ProtocolOptionsFILE
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки FILE://#

Псевдопротокол «file:» не имеет дополнительных опций.

Вы можете использовать "file:" для доступа к локальной файловой системе, осуществляя фоновые операции копирования:

- в отличие от копирования через базовый far2l, NetRocks может выполнять фоновое копирование;
- введите в командной строке far2l команду "file:" для открытия локальной файловой системы в NetRocks;
- во время любой операции копирования NetRocks (на одной панели должен быть NetRocks, другая может быть стандартной файловой панелью far2l) вы можете переключить её в фоновый режим;
- для управления/отмены любого фонового действия вы можете использовать меню ~Фоновые задачи NetRocks~@BackgroundTasksMenu@ (доступно через меню плагинов (#F11#) или конфигурации плагинов (#Alt+Shift+F9#), если запущена хотя бы одна фоновая задача).

~Содержание~@Contents@

@ExtraSiteSettings
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Дополнительные настройки соединения#

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

Настройка #Держать живым# (keep-alive) предназначена для поддержания активного соединения, даже если нет обмена данными. Это полезно в ситуациях, когда соединение может прерваться из-за длительного бездействия. Чтобы предотвратить преждевременный разрыв, установите ненулевое значение, задающее периодичность отправки пакетов в секундах.

#Поправка времени# может использоваться для корректировки временных меток файлов с удалённого хоста.

Доступно изменение #Кодировки#, используемой сервером.

Можно #выполнить определенную команду# при открытии или закрытии соединения с сайтом, и эта команда может, например, смонтировать какой-либо ресурс, к которому должен быть получен доступ с использованием этого соединения. В этой команде будут доступны переменные среды: #$HOST#, #$PORT#, #$USER#, #$PASSWORD# и дополнительная строка #$EXTRA#, настроенная в этом диалоге.

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

Специальная переменная среды #$SINGULAR# равна 1 в том случае, если команда выполняется для единственного соединения, уникального для указанного протокола, пользователя, хоста и порта по всем экземплярам NetRocks, что позволяет инициализировать/очищать общие ресурсы. Если ваша инициализация/очистка должна обмениваться какими-то данными, сохраните их в файл, указанный переменной среды #$STORAGE#, а затем не забудьте удалить этот файл из скрипта очистки, выполняемого в уникальном контексте.

~Содержание~@Contents@

@ProtocolOptionsWebDAV
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки DAV:// и DAVS://#

Этот диалог позволяет изменять специфичные для "dav://" и "davs://" настройки протоколов: задать строку user agent, и разрешить подключение через HTTP/HTTPS-прокси с опциональной авторизацией на прокси-сервере.

~Содержание~@Contents@

@ProxySettings
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Настройки прокси#

Этот диалог позволяет задать общие настройки прокси для подключения. В настоящее время такая поддержка реализована с помощью внешнего инструмента 'проксирования' (proxifier). Поддерживаются два таких инструмента: #proxychains# и #tsocks#. Поэтому для использования этой опции вам нужно установить любой из них (рекомендуется proxychains) и отредактировать его конфигурацию в этом диалоге. Эта конфигурация будет использоваться только с выбранным подключением и сохранена в настройках подключения к сайту.

~Содержание~@Contents@



@Contact
$^#NetRocks plugin#
$^#Version 1.0#
$^#Copyright (C) 2019 elfmz#
$^#Контактная информация#

elfmz

#http://github.com/elfmz

~Содержание~@Contents@

0 comments on commit 0b36cef

Please sign in to comment.