ОПИСАНИЕ
Ncdc — это современный и легкий клиент прямого подключения с дружественным интерфейсом ncurses.
НАЧИНАЯ
Это базовое введение для новичков в ncdc. Более подробное описание доступных функций смотрите в главах ниже.
При запуске ncdc вы видите строку ввода, в которую вы можете вводить команды, и окно журнала, в котором отображаются результаты, как в обычном терминале. Команды в ncdc начинаются с косой черты (например, /help) и для удобства имеют завершение табуляции.
Первое, что вам нужно сделать после первого запуска ncdc, — это настроить некоторую базовую информацию и настройки:
/set nick MyNick
/set description ncdc is awesome!
/set connection 10
/share "My Awesome Files" /path/to/files
А если у вас есть прямое подключение к Интернету или если ваш маршрутизатор поддерживает переадресацию портов, вы также можете включить активный режим:
/set active_port 34194
/set active true
Дополнительную информацию см. в тексте справки для каждой команды и настроек. Разумеется, все вышеперечисленные настройки сохраняются в базе данных и будут использованы снова при следующем запуске.
Чтобы подключиться к хабу, используйте /open:
/open ncdc adc://dc.blicky.net:2780/
Здесь ncdc — это личное имя, которое вы даете хабу, а второй аргумент — URL-адрес. Этот URL-адрес будет сохранен в базе данных, поэтому в следующий раз, когда вы захотите подключиться к этому хабу, вы можете просто сделать /open ncdc. Дополнительную информацию /openсм. в тексте справки . /connectЕсли вы хотите автоматически подключаться к хабу при запуске ncdc, используйте autoconnect настройку.
Ncdc использует интерфейс с вкладками: каждый хаб открывается на новой вкладке, а также доступно несколько других типов вкладок. Тип вкладки указывается в списке вкладок в нижней части экрана с помощью префикса символов. Например, хабы имеют префикс #. Если вкладка требует вашего внимания, перед названием вкладки отображается цветной восклицательный знак, для разных видов активности используются разные цвета.
Все остальное должно быть достаточно понятно: для поиска файлов используйте /searchкоманду. Чтобы просмотреть список пользователей хаба, используйте /userlistили нажмите Alt+u. Чтобы просмотреть чей-либо список файлов, используйте /browseили нажмите клавишу «b» в списке пользователей. А чтобы отслеживать соединения для загрузки и скачивания, используйте /connectionsили нажмите Alt+n.
ПАРАМЕТРЫ
-c, --session-dir= каталог
Используйте другой каталог сеанса. По умолчанию используется содержимое переменной окружения `$NCDC_DIR' или, если она не установлена, значение `$HOME/.ncdc'.
-х, --help
Отобразить сводку опций.
-n, --no-автоподключение
Не подключаться автоматически к концентраторам с autoconnect установленной опцией.
--без-вставить-в скобках
Отключить вставку в квадратных скобках.
-v, --version
Отобразить версию ncdc.
ПОДКЛЮЧЕНИЕ
Как и большинство клиентов для обмена файлами, ncdc поддерживает два режима подключения: активный и пассивный . В пассивном режиме (по умолчанию) вы можете подключаться к внешнему миру, но никто не может подключиться (напрямую) к вам. В пассивном режиме вы сможете передавать файлы только тем людям, которые находятся в активном режиме. Однако в активном режиме у вас будет открыт некоторый порт для остальной части сети, к которому могут подключаться другие клиенты. Когда он активен, вы сможете передавать файлы всем и получать больше и быстрее результатов поиска. Поэтому рекомендуется настроить активный режим.
Во многих конфигурациях все, что вам нужно сделать, чтобы переключиться в активный режим, — это установить порт TCP/UDP и включить настройку active:
/set active_port 34194
/set active true
Когда вы подключаетесь к хабу, в строке состояния будет указано, активны вы или пассивны на этом конкретном хабе, а также какой IP-адрес используется, чтобы другие могли подключиться к вам. Для большинства хабов ваш IP-адрес будет определен автоматически, но если это не удастся, вы также можете установить его самостоятельно:
/set active_ip 13.33.33.7
Если вы находитесь за NAT или брандмауэром, вам необходимо убедиться, что настроенный вами порт каким-то образом разрешен и/или перенаправлен. Этот active_portпараметр используется для входящих TCP-соединений и сообщений UDP. С помощью этой настройки вы можете настроить другой порт UDP active_udp_port. В отличие от многих других клиентов Direct Connect, ncdc использует только один порт для входящих соединений TCP и TLS; Для TLS нет отдельного порта.
Команда /listenможет сообщить вам, какие порты будут перенаправлены и для каких концентраторов будут использоваться эти порты. В нем перечислены только хабы, на которых вы в данный момент активны, поэтому выходные данные будут меняться, когда вы открываете или закрываете соединение с хабом.
Если у вас несколько сетевых интерфейсов, вы можете заставить ncdc использовать только один интерфейс, задав local_address для параметра адрес этого интерфейса. Это влияет как на исходящие соединения (они будут вынуждены проходить через настроенный интерфейс), так и на входящие соединения (порты будут привязаны к настроенному интерфейсу).
Все ранее упомянутые настройки можно установить глобально (с помощью /set) или для каждого концентратора (с помощью /hset). Это позволяет вам одновременно работать в интернет-концентраторе и в концентраторе только для локальной сети. Это также позволяет вам быть активным в одном концентраторе и пассивным в другом или использовать разные порты для каждого концентратора.
ИНТЕРАКТИВНЫЕ КОМАНДЫ
Ниже приведен список команд, которые можно использовать в ncdc. Команду /help также можно использовать для получения списка доступных команд и доступа к этой документации.
/принимать
Используйте эту команду, чтобы принять TLS-сертификат концентратора. Эта команда используется только в том случае, если отпечаток ключа TLS-сертификата хаба не совпадает с отпечатком ключа, хранящимся в базе данных.
/browse [[-f] <пользователь>]
Без аргументов откроется новая вкладка, на которой вы сможете просмотреть свой собственный список файлов. Обратите внимание, что изменения в вашем списке не сразу отображаются в браузере. Вам необходимо повторно открыть вкладку, чтобы получить последнюю версию списка.
С аргументами будет загружен список файлов указанного пользователя (если он еще не был загружен), и после его завершения откроется вкладка просмотра. Флаг `-f' может использоваться для принудительной (повторной) загрузки списка файлов.
/прозрачный
Очищает журнал, отображаемый на экране. Никак не влияет на файлы журналов. Ctrl+l — это ярлык для этой команды.
/закрывать
Закройте текущую вкладку. При закрытии вкладки хаба вы будете отключены от хаба, и все связанные вкладки списка пользователей и личных сообщений также будут закрыты. Alt+c — это ярлык для этой команды.
/connect [<адрес>]
Инициализировать соединение с хабом. Если адрес не указан, будет подключено к хабу, который вы последний раз использовали на текущей вкладке. Адрес должен быть в форме «протокол://хост:порт/» или «хост:порт». Часть `:port' в обоих случаях необязательна и по умолчанию равна :411. Распознаются следующие протоколы: dchub, nmdc, nmdcs, adc, adcs. При подключении к концентратору nmdcs или adcs и известном отпечатке ключа SHA256 вы можете прикрепить его к URL-адресу как `?kp=SHA256/<base32-encoded-keyprint>'
Обратите внимание, что эту команду можно использовать только на вкладках концентратора. Если вы хотите открыть новое соединение с хабом, вам нужно сначала использовать /open. Например:
/open testhub
/connect dchub://dc.some-test-hub.com/
Дополнительную информацию смотрите в команде /open.
/соединения
Откройте вкладку «Соединения».
/delhub <имя>
Удаление хаба из конфигурации
/Отключить
Отключитесь от хаба.
/гк
Очищает неиспользуемые данные и реорганизует существующие данные для более эффективного хранения и использования. В настоящее время эта команда удаляет неиспользуемые хеш-данные, выполняет ВАКУУМ в db.sqlite3, удаляет неиспользуемые файлы в inc/ и старые файлы в fl/.
Выполнение этой команды может занять некоторое время и полностью заблокирует ncdc во время его работы. Рекомендуется запускать эту команду время от времени. Каждый месяц — хороший интервал. Обратите внимание: когда ncdc сообщает, что выполнил эту команду, он вам лжет. Ncdc по-прежнему будет выполнять несколько больших запросов в фоновом режиме, выполнение которых может занять до минуты.
/grant [-список|<пользователь>]
Предоставьте кому-нибудь место. Это позволяет пользователю скачивать у вас, даже если у вас нет свободных слотов. Слот останется предоставленным до тех пор, пока не будет использована команда /ungrant, даже если ncdc за это время был перезапущен.
Чтобы получить список пользователей, которым вы предоставили слот, используйте `/grant' без аргументов или с `-list'. Имейте в виду, что использование `/grant' без аргументов на вкладке PM предоставит слот пользователю, с которым вы разговариваете. В этом случае обязательно используйте `-list'.
Обратите внимание, что предоставленный слот предназначен только для одного концентратора. Если тот же пользователь также находится в других концентраторах, ему/ей не будет предоставлено место в этих концентраторах.
/help [<команда>|set <ключ>|ключи [<раздел>]]
Чтобы получить список доступных команд, используйте /help без аргументов. Чтобы получить информацию о конкретной команде, используйте /help <команда>. Чтобы получить информацию о параметре конфигурации, используйте /help set <настройка>. Чтобы получить справку по привязке клавиш, используйте ключи /help.
/hset [<ключ> [<значение>]]
Получите или установите переменные конфигурации для каждого концентратора. Работает эквивалентно команде `/set', но может использоваться только на вкладках концентратора. Используйте `/hunset', чтобы вернуть переменной ее глобальное значение.
/hunset [<ключ>]
Эту команду можно использовать для сброса переменной конфигурации каждого концентратора обратно к ее глобальному значению.
/kick <пользователь>
Удалить пользователя из хаба. Эта команда работает только на концентраторах NMDC, и вам нужно быть оператором, чтобы иметь возможность ее использовать.
/слушать
Список открытых в данный момент портов.
/me <сообщение>
Это позволяет вам говорить от третьего лица. Большинство клиентов отобразят ваше сообщение примерно так:
** Nick is doing something
Обратите внимание, что эта команда корректно работает только на концентраторах ADC. Протокол NMDC не имеет этой функции, и ваше сообщение будет отправлено «как есть», включая /me.
/msg <пользователь> [<сообщение>]
Отправьте личное сообщение пользователю в открытом в данный момент хабе. Если сообщение не указано, вкладка будет открыта, но сообщение отправлено не будет.
/ник [<ник>]
Псевдоним для `/hset nick' на вкладках хаба и `/set nick' в противном случае.
/open [-n] [<имя>] [<адрес>]
Без аргументов выведите список всех концентраторов, известных текущей конфигурации. В противном случае откроется новая вкладка, которую можно использовать для концентратора. Имя — это (короткое) личное имя, которое вы используете для идентификации концентратора и которое будет использоваться для хранения конфигурации, специфичной для концентратора.
Если вы указали адрес или ранее подключались к хабу из одноименной вкладки, /open автоматически подключится к хабу. Используйте флаг `-n', чтобы отключить это поведение.
См. /connect для получения дополнительной информации о подключении к концентратору.
/пароль <пароль>
Эту команду можно использовать для отправки пароля на хаб без сохранения его в базе данных. Если вы хотите автоматически входить в систему без необходимости каждый раз вводить /пароль, используйте «/hset пароль <пароль>». Однако имейте в виду, что в этом случае ваш пароль будет сохранен в незашифрованном виде.
/pm <пользователь> [<сообщение>]
Псевдоним для /msg
/очередь
Откройте очередь загрузки.
/покидать
Выйдите из NCDC.
/восстановить соединение
Повторно подключитесь к хабу. Если ваш ник или кодировка хаба были изменены, новые настройки будут использованы после переподключения.
Эту команду также можно использовать на главной вкладке, и в этом случае все подключенные хабы будут переподключены.
/обновить [<путь>]
Инициирует обновление общего доступа. Если аргумент не указан, будет обновлен полный список. В противном случае будет обновлен только указанный каталог. Аргумент пути может быть либо абсолютным путем к файловой системе, либо виртуальным путем внутри вашего общего ресурса.
/say <сообщение>
Отправляет сообщение чата текущему хабу или пользователю. Обычно вам не нужно явно использовать команду /say: любая команда, не начинающаяся с '/', автоматически подразумевает `/say <команда>'. Например, набрав «привет». в командной строке эквивалентно `/say hello.'. Явное использование команды /say может оказаться полезным для отправки в чат сообщения, начинающегося с «/», например: «/say /help — это то, что вы ищете».
/search [опции] <запрос>
Выполняет поиск файлов, открывая новую вкладку с результатами.
Доступные Варианты:
-hub Search the current hub only. (default)
-all Search all connected hubs, except those with `chat_only' set.
-le <s> Size of the file must be less than <s>.
-ge <s> Size of the file must be larger than <s>.
-t <t> File must be of type <t>. (see below)
-tth <h> TTH root of this file must match <h>.
Размеры файлов (<s> выше) допускают следующие суффиксы: G (ГиБ), M (МиБ) и K (КиБ).
С опцией -t можно использовать следующие типы файлов:
1 any Any file or directory. (default)
2 audio Audio files.
3 archive (Compressed) archives.
4 doc Text documents.
5 exe Windows executables.
6 img Image files.
7 video Video files.
8 dir Directories.
Обратите внимание, что сопоставление типов файлов осуществляется с использованием расширений файлов и не очень надежно.
/set [<ключ> [<значение>]]
Получите или установите глобальные переменные конфигурации. Используйте без аргументов, чтобы получить список всех глобальных настроек и их текущее значение. Также возможно сопоставление шаблонов в стиле Glob в настройках. Используйте, например, `/set color*' для вывода списка всех настроек, связанных с цветом.
См. команду `/unset', чтобы вернуть параметру значение по умолчанию, и команду `/hset', чтобы управлять конфигурацией отдельно для каждого концентратора. Изменения настроек автоматически сохраняются в базе данных и не теряются после перезапуска ncdc.
Чтобы получить информацию о конкретной настройке, используйте `/help set <key>'.
/share [<имя> <путь>]
Используйте /share без аргументов, чтобы получить список общих каталогов. При вызове с именем и путем этот путь будет добавлен в ваш общий ресурс. Обратите внимание, что в имени можно использовать экранирование оболочки. Например, чтобы добавить каталог с именем «Fun Stuff», вы можете сделать следующее:
/share "Fun Stuff" /path/to/fun/stuff
Или:
/share Fun\ Stuff /path/to/fun/stuff
Полный путь к каталогу не будет виден другим пользователям, общедоступным будет только имя, которое вы ему дадите. Начальное `/refresh' выполняется автоматически для добавленного каталога.
/ungrant [<пользователь>]
Отозвать предоставленный слот.
/unset [<ключ>]
Эту команду можно использовать для сброса глобальной переменной конфигурации обратно к значению по умолчанию.
/отменить общий доступ к [<имя>]
Чтобы удалить один каталог из вашего общего ресурса, используйте `/unshare <name>', чтобы удалить все каталоги из вашего общего ресурса, используйте `/unshare/'.
Обратите внимание, что хеш-данные, связанные с удаленными файлами, останутся в базе данных. Это позволяет вам повторно добавлять файлы в общий ресурс без необходимости их повторного хеширования. Обратной стороной является то, что файл базы данных может стать довольно большим из-за ненужной информации. См. команду `/gc', чтобы очистить это.
/список пользователей
Открывает список пользователей выбранного в данный момент хаба. Доступ также возможен с помощью Alt+u.
/версия
Отображение информации о версии.
/whois <пользователь>
Это откроет список пользователей и выберет данного пользователя.
НАСТРОЙКИ
Ниже приведен список параметров конфигурации. Эти настройки можно изменить и запросить с помощью /setкоманды для глобальных настроек и /hsetлокальных настроек концентратора. Все данные конфигурации хранятся в файле db.sqlite3 в каталоге сеанса.
активный <логическое значение>
Включает или отключает активный режим. Возможно, вам придется настроить маршрутизатор и/или брандмауэр, чтобы это работало. Дополнительную информацию см. в настройках «active_ip» и «active_port».
active_ip <строка>
Ваш общедоступный IP-адрес для использования в активном режиме. Если он не установлен или установлен на «0.0.0.0» для IPv4 или «::» для IPv6, то ncdc попытается автоматически получить ваш IP-адрес от концентратора. Если вы установите это вручную, важно, чтобы другие клиенты могли связаться с вами, используя этот IP-адрес. Если вы подключаетесь к концентратору в Интернете, это должен быть IP-адрес вашего Интернета (WAN). Аналогично, если вы подключаетесь к концентратору в локальной сети, это должен быть IP-адрес вашей локальной сети.
Адреса IPv4 и IPv6 задаются путем указания двух IP-адресов, разделенных запятой. Если значение не установлено, предполагается «0.0.0.0,::». Используется только та IP-версия, которая использовалась для подключения к хабу. То есть, если вы подключаетесь к концентратору IPv6, то используется настроенный адрес IPv6, а адрес IPv4 игнорируется.
Если установлено специальное значение «local», ncdc автоматически получит ваш IP-адрес из локального сетевого интерфейса, который используется для подключения к концентратору. Эту опцию следует использовать только в том случае, если между вами и хабом нет NAT, поскольку это приведет к неправильному IP-адресу, если вы находитесь за NAT.
активный_порт <целое число>
Порт прослушивания входящих соединений в активном режиме. Установите значение «0», чтобы автоматически назначить случайный порт. Этот параметр по умолчанию также используется для порта UDP, см. настройки active_tls_port, чтобы изменить это. Если вы находитесь за маршрутизатором или брандмауэром, убедитесь, что вы настроили его для переадресации и разрешения этих портов.
active_udp_port <целое число>
Порт прослушивания входящих UDP-соединений в активном режиме. По умолчанию используется настройка «active_port» или случайное число, если «active_port» не установлен.
adc_blom <логическое значение>
Поддерживать ли расширение BLOM на концентраторах ADC. Это может уменьшить использование полосы пропускания при подключении к концентратору в обмен на небольшие вычислительные затраты. Некоторые концентраторы требуют включения этого параметра. Для активации этого параметра требуется повторное подключение к концентратору.
автоподключение <логическое значение>
Установите значение true, чтобы автоматически подключаться к текущему концентратору при запуске ncdc.
автообновление <интервал>
Время между автоматическими обновлениями файлов. Принято считать, что «s» означает секунды, «m» означает минуты, «h» означает часы и «d» означает дни. Установите значение 0, чтобы отключить автоматическое обновление списка файлов. Этот параметр также определяет, будет ли ncdc выполнять обновление при запуске. См. команду `/refresh', чтобы вручную обновить список файлов.
отставание <целое число>
При открытии вкладки хаба или PM ncdc может загрузить определенное количество строк из файла журнала в окно журнала. Установка положительного значения включает эту функцию и настраивает количество загружаемых строк. Обратите внимание: хотя этот параметр можно установить для каждого концентратора, окна PM будут использовать глобальное значение (global.backlog).
chat_only <логическое значение>
Установите значение true, чтобы указать, что этот центр используется только для общения. То есть вы не будете или не сможете с него скачать. Этот параметр влияет на команду /search, когда ей задана опция -all.
цвет_* <цвет>
Настройки, начинающиеся с префикса «color_», позволяют изменять цвета интерфейса. Ниже приведен список доступных настроек цвета:
list_default - default item in a list
list_header - header of a list
list_select - selected item in a list
log_default - default log color
log_time - the time prefix in log messages
log_nick - default nick color
log_highlight - nick color of a highlighted line
log_ownnick - color of your own nick
log_join - color of join messages
log_quit - color of quit messages
separator - the list separator/footer bar
tab_active - the active tab in the tab list
tabprio_low - low priority tab notification color
tabprio_med - medium priority tab notification color
tabprio_high - high priority tab notification color
title - the title bar
Фактическое значение цвета может быть установлено с помощью списка названий и/или атрибутов цветов, разделенных запятыми. Первый цвет в списке — это цвет переднего плана, второй цвет используется для фона. Если цвет переднего плана или фона не указан, будут использоваться цвета вашего терминала по умолчанию. Могут использоваться следующие названия цветов: черный, синий, голубой, по умолчанию, зеленый, пурпурный, красный, белый и желтый. Можно использовать следующие атрибуты: жирный шрифт, мерцание, реверс и подчеркивание. Фактические значения цвета, отображаемые вашим терминалом, могут отличаться. Добавление атрибута «жирный» обычно делает цвет переднего плана ярче.
соединение <строка>
Установите скорость загрузки. Это всего лишь указание для других пользователей хаба, чтобы они знали, на какую скорость они могут рассчитывать при загрузке у вас. Фактический формат, который вы можете здесь использовать, может отличаться, но рекомендуется установить его либо на простое число для Мбит/с (например, «50» для 50 Мбит), либо на число с индикатором «КиБ/с» (например, «2300 КиБ/с'). В концентраторах ADC необходимо использовать один из ранее упомянутых форматов, иначе скорость загрузки не будет транслироваться. Этот параметр передается в концентраторах NMDC в неизменном виде, что позволяет использовать значения подключения старого стиля (например, «DSL» или «Кабель») на концентраторах, которым это требуется.
Этот параметр игнорируется, если установлена `upload_rate'. Если это так, вместо этого передается это значение.
описание <строка>
Краткое общедоступное описание, которое будет отображаться в списке пользователей хаба.
Disconnect_offline <логическое значение>
Автоматически отключайте любую загрузку или выгрузку, когда пользователь покидает хаб или когда вы покидаете хаб. Установка для этого параметра значения «true» гарантирует, что вы подключаетесь только к людям, которые находятся в сети в тех же концентраторах, что и вы.
каталог_загрузки <путь>
Каталог, в который перемещаются готовые загрузки. Завершенные загрузки по умолчанию сохраняются в <каталог сеанса>/dl/. Можно установить это место в файловой системе, отличной от входящего каталога, но делать это не рекомендуется: ncdc заблокирует перемещение завершенных файлов в конечный пункт назначения.
download_exclude <регулярное выражение>
При рекурсивном добавлении каталога в очередь загрузки — нажатием клавиши «d» на каталоге в браузере списка файлов — любой элемент в выбранном каталоге с именем, соответствующим этому регулярному выражению, не будет добавлен в очередь загрузки.
Это регулярное выражение не проверяется при добавлении отдельных файлов ни из браузера списка файлов, ни из результатов поиска.
скорость загрузки <скорость>
Максимальная совокупная скорость передачи всех загрузок. Общая скорость загрузки будет ограничена этим значением. Суффиксы «G», «M» и «K» могут использоваться для ГиБ/с, МиБ/с и КиБ/с соответственно. Обратите внимание, что, как и в случае с upload_rate, издержки TCP не учитываются в этом пределе, поэтому фактическое использование полосы пропускания может быть немного выше.
download_segment <размер>
Минимальный размер сегмента, который можно использовать при запросе данных файла от другого пользователя. Установите значение 0, чтобы отключить сегментированную загрузку.
download_shared <логическое значение>
Загружать ли файлы, которые уже присутствуют в вашей общей папке. Если для этого параметра установлено значение «false», добавление уже общих файлов приводит к появлению сообщения пользовательского интерфейса вместо добавления файла в очередь загрузки.
download_slots <целое число>
Максимальное количество одновременных загрузок.
электронная почта <строка>
Ваш электронный адрес. Это будет отображаться в списке пользователей хаба, поэтому устанавливайте это значение только в том случае, если вы хотите, чтобы оно было общедоступным.
кодировка <строка>
Набор символов/кодировка, используемая для сообщений Hub и PM. Этот параметр используется только в концентраторах NMDC, ADC всегда использует UTF-8. Некоторые общие ценности:
CP1250 (Central Europe)
CP1251 (Cyrillic)
CP1252 (Western Europe)
ISO-8859-7 (Greek)
KOI8-R (Cyrillic)
UTF-8 (International)
filelist_maxage <интервал>
Максимальный возраст списка загруженных файлов. Если список файлов был загружен раньше настроенного интервала, он будет удален из кэша (каталога fl/), а последующие запросы на открытие списка файлов приведут к повторной загрузке списка у пользователя. Принято считать, что «s» означает секунды, «m» означает минуты, «h» означает часы и «d» означает дни. Установите значение 0, чтобы полностью отключить кеш.
flash_file_cache <нет|загрузка|загрузка|хэш>[,...]
Укажите ОС, чтобы она очистила кэш файла (диска) для содержимого файла, прочитанного во время хеширования и/или загрузки или записи во время загрузки. С одной стороны, это позволит избежать загрязнения дискового кэша большими файлами и, таким образом, улучшить общую скорость реагирования вашей системы. С другой стороны, ncdc может удалить из кэша любые общие файлы, даже если они все еще используются другими приложениями. В общем, рекомендуется включить это, если вы также используете свою систему для других целей, помимо ncdc, вы делитесь большими файлами (> 100 МБ), и люди не загружают у вас постоянно один и тот же файл.
geoip_cc <путь>|отключено
Путь к файлу базы данных страны GeoIP2 (GeoLite2-Country.mmdb) или «отключено», чтобы отключить поиск GeoIP. Базу данных можно загрузить с https://dev.maxmind.com/geoip/geoip2/geolite2/.
hash_rate <скорость>
Максимальная скорость хеширования файлов. См. настройку «download_rate» для разрешенных форматов для этой настройки.
имя_хаба <строка>
Имя открытой в данный момент вкладки хаба. Это имя назначается пользователем и используется только внутри самого ncdc. Это то же имя, что и у команды `/open'.
incoming_dir <путь>
Каталог, в котором хранятся незавершенные загрузки. Этот параметр можно изменить только в том случае, если очередь загрузки пуста. Также см. настройку download_dir.
local_address <строка>
Указывает адрес локального сетевого интерфейса, который будет использоваться для подключения к внешней среде и приема входящих подключений в активном режиме. Адреса IPv4 и IPv6 задаются путем указания двух IP-адресов, разделенных запятой. Если значение не установлено, предполагается «0.0.0.0,::».
Если адрес IPv4 не указан, «0.0.0.0» добавляется автоматически. Аналогично, если адрес IPv6 не указан, «::» добавляется автоматически. Фактически используемый адрес зависит от фактически используемой версии IP. То есть, если вы используете концентратор IPv6, ncdc будет прослушивать указанный адрес IPv6. Обратите внимание: даже если концентратор, на котором вы находитесь, использует IPv6, ncdc все равно может попытаться подключиться к другому клиенту через IPv4, после чего сокет будет привязан к настроенному адресу IPv4.
log_debug <логическое значение>
Записывайте отладочные сообщения в stderr.log в каталоге сеанса. Настоятельно рекомендуется включить этот параметр, если вы хотите отладить или взломать ncdc. Однако имейте в виду, что это может привести к генерации большого количества данных, если вы подключены к большому концентратору.
log_downloads <логическое значение>
Записывайте загруженные файлы в файл Transfers.log.
log_hubchat <логическое значение>
Зарегистрируйте основной чат хаба. Обратите внимание, что для изменения этого параметра необходимо закрыть и снова открыть все затронутые вкладки концентратора, прежде чем изменение вступит в силу.
log_uploads <логическое значение>
Файл журнала загружается в Transfers.log.
max_ul_per_user <целое число>
Максимальное количество одновременных подключений загрузки для одного пользователя.
мини-слоты <целое число>
Установите количество доступных мини-слотов. «Мини-слот» — это специальный слот, который используется, когда все обычные слоты загрузки используются и кто-то запрашивает ваш список файлов или небольшой файл. В этом случае другой клиент автоматически подает заявку на мини-слот и все еще может загружать у вас, пока не все мини-слоты используются. То, что представляет собой «маленький» файл, можно изменить с помощью настройки «minislot_size». Также см. настройку конфигурации slots и команду /grant.
minislot_size <целое число>
Максимальный размер файла, который можно загрузить с использованием «мини-слота», в КиБ. Дополнительную информацию смотрите в настройке «minislots».
ник <строка>
Ваш ник. Изменения ника видны только на вновь подключенных концентраторах. Используйте команду `/reconnect', чтобы немедленно использовать новый ник. Обратите внимание: крайне не рекомендуется менять свой ник на хабах NMDC. Это связано с тем, что клиенты, загружающие у вас, не имеют возможности узнать, что вы изменили свой ник, и, следовательно, не могут немедленно продолжить загрузку у вас.
notify_bell <отключить|низкий|средний|высокий>
Если эта функция включена, ncdc отправит сигнал на ваш терминал, когда на вкладке появится уведомление. Типы уведомлений:
high - Messages directed to you (PM or highlight in hub chat),
medium - Regular hub chat,
low - User joins/quits, new search results, etc.
То, как проявится «звонок» (или «гудок», или «оповещение», как бы вы его ни называли), зависит от вашего терминала. В некоторых конфигурациях при этом генерируется звуковой сигнал системы. В других настройках он может мигать окном вашего терминала или делать другие раздражающие вещи, чтобы привлечь ваше внимание. А в некоторых настройках это вообще игнорируется.
пароль <строка>
Устанавливает пароль для текущего концентратора и включает автоматический вход при подключении. Если вы просто хотите войти в хаб, не сохраняя пароль, используйте вместо этого команду `/password'. Пароли сохраняются в незашифрованном виде в файле конфигурации.
reconnect_timeout <интервал>
Время ожидания перед автоматическим повторным подключением к хабу. Установите значение 0, чтобы отключить автоматическое переподключение.
sendfile <логическое значение>
Следует ли использовать системный вызов sendfile() для загрузки файлов, если он поддерживается. Использование sendfile() позволяет меньше использовать ресурсы при загрузке, но может работать не на всех системах.
Share_emptydirs <логическое значение>
Поделитесь пустыми каталогами. Если этот параметр отключен (по умолчанию), пустые каталоги в вашей общей папке не будут видны другим. Это также влияет на пустые каталоги, содержащие только пустые каталоги, и т. д. Чтобы этот параметр вступил в силу, необходимо обновить список файлов.
Share_exclude <регулярное выражение>
Любой файл или каталог с именем, соответствующим этому регулярному выражению, не будет доступен для общего доступа. Чтобы этот параметр вступил в силу, необходимо обновить список файлов.
Share_hidden <логическое значение>
Предоставлять ли общий доступ к скрытым файлам и каталогам. «Скрытый» файл или каталог — это файл или каталог, имя которого начинается с точки. (например, `.bashrc'). Чтобы этот параметр вступил в силу, необходимо обновить список файлов.
Share_symlinks <логическое значение>
Следует ли переходить по символическим ссылкам в общих каталогах. Если отключено (по умолчанию), ncdc никогда не будет делиться файлами за пределами указанного вами каталога. Если этот параметр включен, все символические ссылки в ваших общих каталогах будут отслеживаться, даже если они указывают на каталог за пределами вашего общего ресурса.
show_free_slots <логическое значение>
Если установлено значение true, к вашему описанию будет добавлено [n sl], где n — количество доступных на данный момент слотов для загрузки.
show_joinquit <логическое значение>
Отображать ли сообщения о присоединении/выходе в хаб-чате.
слоты <целое число>
Количество слотов для загрузки. По большей части это определяет, сколько людей смогут скачивать у вас одновременно. Возможно, что этот предел будет превышен при определенных обстоятельствах, см. настройку minislots и команду /grant.
sudp_policy <отключено|разрешить|предпочитать>
Установите политику отправки или получения зашифрованных результатов поиска UDP. Если установлено значение «отключено», все результаты поиска UDP будут отправляться и приниматься в виде обычного текста. Установите для этого параметра значение «разрешить», чтобы позволить ncdc отвечать зашифрованными результатами поиска, если другой клиент запросил это. `prefer' также заставит сам ncdc запросить шифрование.
Обратите внимание, что независимо от этого параметра зашифрованные результаты поиска UDP используются только в концентраторах ADCS. Они никогда не будут отправляться на концентраторы NMDC или не-TLS ADC. Также обратите внимание, что даже если вы установите для этого параметра значение «предпочитать», шифрование по-прежнему будет использоваться только в том случае, если клиент на другой стороне соединения также поддерживает его.
tls_policy <отключено|разрешить|предпочитать|форсировать>
Установите политику для безопасных соединений между клиентами. Установка значения «отключено» отключает поддержку TLS для клиентских подключений, но по-прежнему позволяет подключаться к концентраторам с поддержкой TLS. «allow» разрешит использование TLS, если другой клиент запросит это, но сам ncdc не будет запрашивать TLS при подключении к другим, «prefer» сообщает ncdc запрашивать TLS при подключении к другим. Установка для этого параметра значения «force» запретит соединения, отличные от TLS, а также потребует, чтобы само соединение концентратора было TLS.
Использование TLS для клиентских подключений обычно приводит к менее оптимальной производительности при загрузке и скачивании, но весьма эффективно позволяет избежать формирования трафика в зависимости от протокола, что могут делать некоторые интернет-провайдеры.
tls_priority <строка>
Установите строку приоритета GnuTLS, используемую для всех соединений с поддержкой TLS. Подробную информацию о том, что это делает и как работает, см. в разделе «Строки приоритета» в руководстве GnuTLS. В настоящее время невозможно установить разные строки приоритета для разных типов подключений (например, концентратора или входящих/исходящих клиентских подключений).
ui_time_format <строка>
Формат времени, отображаемый в левом нижнем углу экрана. Установите `-', чтобы вообще не отображать время. Строка передается в функцию Glib g_date_time_format(), которая принимает примерно те же форматы, что и strftime(). Дополнительную информацию можно найти на странице руководства strftime(3) или в документации Glib. Обратите внимание, что этот параметр не влияет на формат даты и времени, используемый в других местах, например в окне чата или файлах журналов.
upload_rate <скорость>
Максимальная общая скорость передачи всех загрузок. См. настройку «download_rate» для получения дополнительной информации об ограничении скорости. Обратите внимание, что этот параметр также имеет приоритет над любыми параметрами соединения.
ПРИВЯЗКИ КЛЮЧЕЙ
На любой вкладке без строки ввода текста вы можете нажать `?' чтобы получить привязки клавиш для этой вкладки. Список привязок клавиш доступен через /help keysкоманду и воспроизведен ниже.
Глобальные привязки клавиш
Alt+j Open previous tab.
Alt+k Open next tab.
Alt+h Move current tab left.
Alt+l Move current tab right.
Alt+a Move tab with recent activity.
Alt+<num> Open tab with number <num>.
Alt+c Close current tab.
Alt+n Open the connections tab.
Alt+q Open the download queue tab.
Alt+o Open own file list.
Alt+r Refresh file list.
Keys for tabs with a log window:
Ctrl+l Clear current log window.
PgUp Scroll the log backward.
PgDown Scroll the log forward.
Keys for tabs with a text input line:
Left/Right Move cursor one character left or right.
End/Home Move cursor to the end / start of the line.
Up/Down Scroll through the command history.
Tab Auto-complete current command, nick or argument.
Alt+b Move cursor one word backward.
Alt+f Move cursor one word forward.
Backspace Delete character before cursor.
Delete Delete character under cursor.
Ctrl+w Delete to previous space.
Alt+d Delete to next space.
Ctrl+k Delete everything after cursor.
Ctrl+u Delete entire line.
Браузер файлов
Up/Down Select one item up/down.
k/j Select one item up/down.
PgUp/PgDown Select one page of items up/down.
End/Home Select last/first item in the list.
/ Start incremental regex search (press Return to stop editing).
,/. Search next / previous.
Right/l Open selected directory.
Left/h Open parent directory.
t Toggle sorting directories before files.
u Toggle sorting unknown files before files existing locally.
s Order by file size.
n Order by file name.
d Add selected file/directory to the download queue.
m Match selected item with the download queue.
M Match entire file list with the download queue.
a Search for alternative download sources.
Список подключений
Up/Down Select one item up/down.
k/j Select one item up/down.
PgUp/PgDown Select one page of items up/down.
End/Home Select last/first item in the list.
d Disconnect selected connection.
i/Return Toggle information box.
f Find user in user list.
m Send a PM to the selected user.
q Find file in download queue.
b/B Browse the selected user's list, B to force a redownload.
Очередь загрузки
Up/Down Select one item up/down.
k/j Select one item up/down.
PgUp/PgDown Select one page of items up/down.
End/Home Select last/first item in the list.
K/J Select one user up/down.
f Find user in user list.
c Find connection in the connection list.
a Search for alternative download sources.
d Remove selected file from the queue.
+/- Increase/decrease priority.
i/Return Toggle user list.
r Remove selected user for this file.
R Remove selected user from all files in the download queue.
x Clear error state for the selected user for this file.
X Clear error state for the selected user for all files.
Note: when an item in the queue has `ERR' indicated in the
priority column, you have two choices: You can remove the
item from the queue using `d', or attempt to continue the
download by increasing its priority using `+'.
Вкладка результатов поиска
Up/Down Select one item up/down.
k/j Select one item up/down.
PgUp/PgDown Select one page of items up/down.
End/Home Select last/first item in the list.
f Find user in user list.
b/B Browse the selected user's list, B to force a redownload.
d Add selected file to the download queue.
h Toggle hub column visibility.
u Order by username.
s Order by file size.
l Order by free slots.
n Order by file name.
m Match selected item with the download queue.
M Match all search results with the download queue.
q Match selected users' list with the download queue.
Q Match all matched users' lists with the download queue.
a Search for alternative download sources.
Вкладка списка пользователей
Up/Down Select one item up/down.
k/j Select one item up/down.
PgUp/PgDown Select one page of items up/down.
End/Home Select last/first item in the list.
/ Start incremental regex search (press Return to stop editing).
,/. Search next / previous.
o Toggle sorting OPs before others.
s/S Order by share size.
u/U Order by username.
t/T Toggle visibility / order by tag column.
e/E Toggle visibility / order by email column.
c/C Toggle visibility / order by connection column.
p/P Toggle visibility / order by IP column.
i/Return Toggle information box.
m Send a PM to the selected user.
g Grant a slot to the selected user.
b/B Browse the selected users' list, B to force a redownload.
q Match selected users' list with the download queue.
СТРАННЫЕ ФЛАГИ UI
Некоторые объявления имеют флажки, и их значение может быть не сразу очевидным.
Статус файла
Вы можете увидеть однобуквенные флаги слева от имен файлов в результатах поиска и на вкладках списка файлов. Их смысл следующий:
ЧАС
Файл был добавлен в список файлов, но еще не хеширован и поэтому не виден другим. Этот флаг может появиться только при просмотре собственного списка.
С
Файл уже находится в вашей общей папке. Если download_sharedустановлено значение false, попытка загрузки приведет только к информационному сообщению. Этот флаг никогда не появляется при просмотре собственного списка файлов.
вопрос
В настоящее время файл находится в очереди на загрузку. Попытка скачать приведет лишь к информационному сообщению.
Флаги подключения
В окне списка подключений есть два флажка:
С
Состояние соединения может быть следующим: « Подключение», «H andshake», «Idle », «D собственная загрузка», «U загрузка» или «-» для отключения.
т
Это означает, что соединение шифруется с помощью TLS.
Пользовательские флаги
В списке пользователей также есть несколько флагов:
О
Установите, если пользователь является оператором хаба.
п
Когда пользователь пассивен. Если этот флаг не установлен, пользователь активен.
т
Установите, будут ли соединения с этим пользователем шифроваться с помощью TLS.
СРЕДА
$NCDC_DIR используется для определения каталога сеанса, он учитывается только в том случае, если -c не установлен в командной строке.
ФАЙЛЫ
$NCDC_DIR соответствует каталогу сеанса, установленному с помощью -c , переменной среды $NCDC_DIR или $HOME/.ncdc.
$NCDC_DIR/сертификат/
Каталог, в котором хранятся сертификаты клиентов. Должен содержать файл закрытого ключа (client.key) и открытый сертификат (client.crt). Они будут созданы автоматически при первом запуске ncdc.
$NCDC_DIR/db.sqlite3
База данных. Здесь хранятся все переменные конфигурации, хеш-данные общих файлов, информация об очереди загрузки и другая информация о состоянии. Редактирование этого файла вручную с помощью инструмента командной строки sqlite3 возможно, но не рекомендуется. Любые изменения, внесенные в базу данных во время работы ncdc, не будут прочитаны и даже могут быть перезаписаны ncdc.
$NCDC_DIR/дл/
Каталог, в который по умолчанию перемещаются завершенные загрузки. Может быть изменено с помощью download_dirопции конфигурации.
$NCDC_DIR/files.xml.bz2
Список файлов, содержащий список всех общих файлов.
$NCDC_DIR/эт/
Каталог, в котором хранятся списки файлов, загруженных другими пользователями. Имена файлов представляют собой идентификаторы пользователей в шестнадцатеричной кодировке, которые используются внутри ncdc. Старые списки файлов удаляются автоматически через настраиваемый интервал. См. filelist_maxageвариант конфигурации.
$NCDC_DIR/история
История команд.
$NCDC_DIR/вкл/
Местоположение по умолчанию для неполных загрузок. Можно изменить с помощью incoming_dirнастроек. Имена файлов в этом каталоге представляют собой корень TTH завершенного файла в кодировке Base32.
$NCDC_DIR/журналы/
Каталог, в котором хранятся все файлы журналов. Имена файлов, начинающиеся с «#», представляют собой журналы концентратора, а «~» — журналы пользователей (PM). Специальные файлы журналов — Transfers.log и main.log.
ncdc не имеет встроенной функции автоматического ротирования или сжатия файлов журналов. При ротации файлов журналов вручную (например, с помощью задания cron) обязательно после этого отправьте сигнал SIGUSR1, чтобы заставить ncdc очистить старые журналы и создать или открыть новые файлы журналов.
$NCDC_DIR/stderr.log
Журнал ошибок/отладки. Этот файл очищается при каждом запуске ncdc.
$NCDC_DIR/версия
Версия каталога данных. Этот файл блокируется во время работы экземпляра ncdc, гарантируя, что никакие два экземпляра ncdc не будут работать с одним и тем же каталогом сеанса одновременно.
Формат Transfers.log
Загрузки и загрузки регистрируются в файле Transfers.log. Передачи разделяются новой строкой ( 0x0a). Каждая строка журнала имеет следующие поля, разделенные пробелом:
Дата/время завершения передачи в формате [YYYY-MM-DD HH:MM:SS ZONE],
Имя хаба, включая# префикс,
CID другого пользователя в кодировке Base32 для передачи ADC или «-» для NMDC.
Имя пользователя (экранировано),
адрес IPv4 или IPv6,
Направление uдля загрузки илиd для скачивания,
Завершилась ли передача успешно ( c) или была прервана/отключена до того, как были переданы все запрошенные данные файла (i ),
TTH передаваемого файла в кодировке Base32 или «-» для files.xml.bz2 ,
Общее время передачи, в секундах,
Размер файла, в байтах,
Смещение файла, в байтах,
Размер передачи, в байтах,
Путь к файлу (экранированный). Абсолютный виртуальный путь для загрузок, путь назначения для загрузок.
Все поля кодируются в UTF-8. Поля, которые могут содержать пробел или новую строку, экранируются следующим образом: пробел экранируется как \s, новая строка как \nи обратная косая черта как\\ . Временная метка не экранируется.
Многие клиенты загружают файлы отдельными (небольшими) кусками. Ncdc не пытается объединить несколько запросов фрагментов в одной записи журнала, поэтому вы можете увидеть один и тот же загруженный файл несколько раз с разным смещением файла.
ЛИЦЕНЗИЯ
Авторские права (C) Йоран Хелинг <projects@yorhel.nl>
ncdc распространяется под лицензией MIT; дополнительную информацию можно найти в файле COPYING.
ОШИБКИ
Пожалуйста, сообщайте об ошибках или предложениях функций в систему отслеживания ошибок или в список рассылки. Оба можно найти на домашней странице ncdc по адресу https://dev.yorhel.nl/ncdc . Существует также центр ADC, доступный adc://dc.blicky.net:2780/для общей поддержки и обсуждений.
