Используйте один из следующих подходов:

• Введите следующую команду в командной строке / консоли перед запуском Jira.

  экспорт JIRA_HOME = / путь / к / jira / home  

• Добавьте указанную выше команду в сценарий /bin/start-jira.sh .

Используйте один из следующих подходов:

• Настройте переменную среды JIRA_HOME через пользовательский интерфейс Windows, обычно через «Мой компьютер» или «Компьютер».

• В командной строке введите следующую команду:

  установить JIRA_HOME = C: \ path \ to \ jira \ home  

• Добавьте указанную выше команду в файл \ bin \ start-jira.bat .

Файл свойств

Добавьте путь к домашнему каталогу Jira в файл /atlassian-jira/WEB-INF/classes/jira-application.properties , как в следующем примере:

  джира.home = / Пользователи / charlie / Jira / jira_home  

Примечания для Windows

• Используйте двойные обратные косые черты (\) между подкаталогами, например C: \ path \ to \ Jira \ home .
• Если вы определяете UNC-путь, не забудьте дважды экранировать начальную обратную косую черту, например \\\\ machinename \\ path \\ to \ JIRA \ home .

Инструмент настройки

Вы также можете изменить расположение домашнего каталога с помощью инструмента настройки Jira.

Альтернативный метод

В качестве альтернативы вы можете указать расположение домашнего каталога Jira в качестве свойства на сервере приложений. Этот метод переопределит jira.home , указанный в файле свойств.

• Настройте новое свойство веб-контекста под названием « jira.home » для своего сервера приложений.

  Для этого вам необходимо определить это свойство веб-контекста внутри элемента (как дочерний элемент элемента ) на вашем сервере .xml файл.

    <Контекст ...>
  ...
    
  ...
    

Примечания

• Если вы используете установщик Windows, вам не нужно отдельно настраивать домашний каталог Jira, так как вам будет предложено указать это местоположение в процессе установки.
• Установщик Jira может не создать дом из-за проблем с разрешениями.Если это так, см. Jira не может запуститься из-за «Не удалось создать необходимый подкаталог»

Документация

Настроить

Во-первых, вам нужно настроить rclone. Как объектные системы хранения имеют довольно сложную аутентификацию, они хранятся в файле конфигурации. (См. Запись --config , чтобы узнать, как найти конфигурацию файл и выберите его местоположение.)

Самый простой способ сделать конфиг - запустить rclone с конфигом. вариант:

  конфигурация rclone
  

Подробные инструкции для

Использование

Rclone синхронизирует дерево каталогов от одной системы хранения к другой.

Его синтаксис похож на этот

  Синтаксис: [параметры] подкоманда <параметры> <параметры ...>
  

Исходный и целевой пути указываются именем, которое вы дали система хранения в файле конфигурации, затем дополнительный путь, например «drive: myfolder», чтобы просмотреть «myfolder» на Google диске.

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

Используйте флаг -i / --interactive , пока обучение rclone, чтобы избежать случайной потери данных.

Подкоманды

rclone использует систему подкоманд. Например

  rclone ls remote: path # перечисляет удаленный
rclone copy / local / path remote: path # копирует / local / путь к удаленному
rclone sync -i / local / path remote: path # syncs / local / путь к удаленному
  

Основные команды rclone с наиболее часто используемыми первыми

Полный список см. В указателе команд.

Копирование отдельных файлов

rclone обычно синхронизирует или копирует каталоги.Однако если источник remote указывает на файл, rclone просто скопирует этот файл. В удаленный пункт назначения должен указывать на каталог - rclone предоставит ошибка Не удалось создать файловую систему для «remote: file»: это файл, а не каталог , если это не так.

Например, предположим, что у вас есть пульт с файлом с именем test.jpg , тогда вы можете скопировать только этот файл, например,

  rclone копировать удаленно: test.jpg / tmp / download
  

Файл test.jpg будет помещен в / tmp / download .

Это эквивалентно

  rclone copy --files-from / tmp / files remote: / tmp / download
  

Где / tmp / files содержит единственную строку

  test.jpg
  

При копировании отдельных файлов рекомендуется использовать copy , а не sync . У них почти такой же эффект, но копия будет использовать намного меньше объем памяти.

Синтаксис удаленных путей

Синтаксис путей, переданных команде rclone, следующий.

/ путь / к / каталог

Это относится к локальной файловой системе.

В Windows \ может использоваться вместо / в локальных путях только , нелокальные пути должны использовать /. См. Локальную файловую систему документацию для получения дополнительных сведений о путях, специфичных для Windows.

Эти пути не обязательно должны начинаться с ведущих / - в противном случае они будет относительно текущего каталога.

удаленный: путь / к / каталог

Это относится к каталогу path / to / dir на удаленном компьютере : , как определено в файл конфигурации (настроен с помощью rclone config ).

удаленный: / путь / к / каталог

В большинстве бэкэндов это относится к тому же каталогу, что и удаленный: путь / к / каталогу и этот формат должен быть предпочтительным. На очень небольшое количество пультов (FTP, SFTP, Dropbox для бизнеса) обратитесь к другому каталогу. На этих дорожках без ведущего / будет ссылаться на ваш "домашний" каталог, а пути с начальными / будут относятся к корню.

: бэкэнд: путь / к / каталог

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

Вот несколько примеров:

  rclone lsd --http-url https://pub.rclone.org: http:
  

Чтобы вывести список всех каталогов в корне https: // pub.rclone.org/ .

  rclone lsf --http-url https://example.com: http: путь / к / каталогу
  

Для вывода списка файлов и каталогов в https://example.com/path/to/dir/

  rclone copy --http-url https://example.com: http: path / to / dir / tmp / dir
  

Для копирования файлов и каталогов из https://example.com/path/to/dir в / tmp / dir .

  rclone copy --sftp-host example.com: sftp: path / to / dir / tmp / dir
  

Для копирования файлов и каталогов из примера .com в относительной каталог путь / к / каталогу с по / tmp / dir с использованием sftp.

Струны соединительные

Приведенные выше примеры также можно записать с помощью строки подключения. синтаксис, поэтому вместо предоставления аргументов в виде командной строки параметры --http-url https://pub.rclone.org они предоставляются как часть удаленной спецификации в виде строки подключения.

  rclone lsd ": http, url = 'https: //pub.rclone.org':"
rclone lsf ": http, url = 'https: // example.com ': путь / к / каталогу "
rclone copy ": http, url = 'https: //example.com': path / to / dir" / tmp / dir
rclone copy: sftp, host = example.com: путь / к / каталогу / tmp / каталогу
  

Они могут применяться для изменения существующих пультов дистанционного управления, а также для создания новых пульты с синтаксисом "на лету". Этот пример эквивалентен добавление параметра --drive-shared-with-me к удаленному приводу gdrive: .

  rclone lsf "gdrive, shared_with_me: путь / к / каталогу"
  

Основным преимуществом использования синтаксиса стиля строки подключения является что он применяет только пульт, а не все пульты этого тип командной строки.Распространенная путаница - это попытка скопировать файл, размещенный на диске Google, на обычный диск, который не поддерживает . работать , потому что флаг --drive-shared-with-me применяется как к источник и место назначения.

  rclone copy --drive-shared-with-me gdrive: shared-file.txt gdrive:
  

Однако при использовании синтаксиса строки подключения это работает.

  rclone copy "gdrive, shared_with_me: shared-file.txt" gdrive:
  

Строки подключения имеют следующий синтаксис

  удаленный, параметр = значение, параметр2 = значение2: путь / к / каталог
: backend, параметр = значение, параметр2 = значение2: путь / к / каталог
  

Если параметр имеет значения : или , , то его следует поместить в кавычки " или ', значит

  удаленный, параметр = "двоеточие: значение", параметр2 = "запятая, значение": путь / к / каталогу
: backend, параметр = 'двоеточие: значение', параметр2 = 'запятая, значение': путь / к / каталогу
  

Если указанное значение должно включать эту цитату, оно должно быть вдвое, поэтому

  удаленный, параметр = "с" "цитатой", параметр2 = 'с' 'цитатой': путь / к / каталогу
  

Это приведет к тому, что параметр будет с "цитатой и параметр2 будет с цитатой .

Если вы оставите = параметр , то rclone заменит = true что очень хорошо работает с флагами. Например, чтобы использовать s3, настроенный в среда, которую вы можете использовать:

  rclone lsd: s3, env_auth:
  

Что эквивалентно

  rclone lsd: s3, env_auth = true:
  

Обратите внимание, что в командной строке вам может потребоваться окружить эти соединительные строки с " или ', чтобы оболочка не интерпретировала любые специальные символы внутри них.

Если вы мастер оболочки, вы будете знать, какие строки подходят и которых нет, но если вы не уверены, заключите их в " и используйте ' как внутренняя цитата. Этот синтаксис работает во всех ОС.

  rclone copy ": http, url = 'https: //example.com': path / to / dir" / tmp / dir
  

В Linux / macOS некоторые символы все еще интерпретируются внутри " строки в оболочке (особенно \ и $ и "), поэтому, если ваши строки содержат те, которые вы можете поменять местами " и ' таким образом.(Этот синтаксис не работает в Windows.)

  rclone copy ': http, url = "https://example.com": path / to / dir' / tmp / dir
  

Строки подключения, конфигурация и ведение журнала

Если вы предоставляете дополнительную конфигурацию бэкэнду с помощью флага командной строки, переменная окружения или строка подключения, тогда rclone добавит суффикс на основе хэша конфигурации к имени пульта дистанционного управления, например

  rclone -vv lsf --s3-размер блока 20M s3:
  

Имеет сообщение журнала

  DEBUG: s3: обнаружена переопределенная конфигурация - добавление суффикса "{Srj1p}" к имени
  

Это сделано для того, чтобы rclone мог отличить модифицированный пульт от немодифицированный пульт при кешировании бэкэндов.

Это должно быть заметно только в логах.

Это означает, что на лету бэкенды, такие как

  rclone -vv lsf: s3, env_auth:
  

Получат свои имена

  DEBUG:: s3: обнаружена переопределенная конфигурация - добавление суффикса "{YTu53}" к имени
  

Действительные удаленные имена

• Удаленные имена могут содержать только 0–9, A – Z, a – z, _, - и пробел.
• Удаленные имена не могут начинаться с -.

Цитирование и оболочка

Когда вы вводите команды на свой компьютер, вы используете что-то называется оболочкой командной строки.Это интерпретирует различные символы в специфическим для ОС способом.

Вот несколько ошибок, которые могут помочь пользователям, незнакомым с правилами оболочки.

Linux / OSX

Если в ваших именах есть пробелы или метасимволы оболочки (например, * , ? , $ , ', " и т. Д.), То вы должны заключить их в кавычки. По умолчанию используйте одинарные кавычки ' .

  rclone copy 'Важные файлы?' удаленный: резервное копирование
  

Если вы хотите отправить ', вам нужно будет использовать ", e.грамм.

  rclone copy "O'Reilly Reviews" удаленный: резервное копирование
  

Правила цитирования метасимволов сложны и, если хотите полную информацию вы должны будете проконсультироваться на странице руководства для вашего оболочка.

Окна

Если в ваших именах есть пробелы, введите их в ", например,

  rclone copy "E: \ имя папки \ имя папки \ имя папки" удаленный: резервное копирование
  

Если вы используете корневой каталог отдельно, не цитируйте его (почему см. # 464), e.грамм.

  rclone копия E: \ remote: backup
  

Копирование файлов или каталогов с

rclone использует : для обозначения удаленного имени. Однако это действительный компонент имени файла в операционных системах, отличных от Windows. Парсер удаленного имени будет ищите только : до первых /, поэтому, если вам нужно действовать на файл или каталог, как этот, затем используйте полный путь, начиная с / или используйте ./ в качестве префикса текущего каталога.

Итак, чтобы синхронизировать каталог с именем sync: me с удаленным устройством с именем remote: используйте

  rclone sync -i ./sync:me удаленный: путь
  

или

  rclone sync -i / full / path / to / sync: me remote: path
  

Копирование на стороне сервера

Большинство пультов (но не все - см. обзор) поддерживают серверное копирование.

Это означает, что если вы хотите скопировать одну папку в другую, rclone не будет скачать все файлы и повторно загрузить их; он проинструктирует сервер скопировать их на место.

Например,

  rclone копия s3: oldbucket s3: newbucket
  

Копирует содержимое oldbucket в newbucket без загрузка и повторная загрузка.

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

Копии на стороне сервера используются с синхронизацией и копией и будут определяется в журнале при использовании флага -v . Команда move также могут использовать их, если удаленный сервер не поддерживает перемещение на стороне сервера напрямую.Это делается путем выдачи копии на стороне сервера, а затем удаления, что значительно быстрее, чем загрузка и повторная загрузка.

Копии на стороне сервера будут предприняты только в том случае, если удаленные имена одно и тоже.

Это можно использовать при написании сценариев для эффективного создания устаревших резервных копий, например

  rclone sync -i удаленный: текущее резервное копирование удаленное: предыдущее резервное копирование
rclone sync -i / путь / к / файлам удаленный: текущее резервное копирование
  

Опции

Rclone имеет ряд опций для управления его поведением.

Параметры, принимающие параметры, могут иметь значения, передаваемые двумя способами: --option = значение или --option value . Однако логическое значение (истина / ложь) параметры ведут себя немного иначе, чем другие параметры, в этом --boolean устанавливает для параметра значение true и отсутствие флагов это на ложный . Также можно указать --boolean = false или --boolean = true . Обратите внимание, что --boolean false недопустим - это анализируется как --boolean и false анализируется как дополнительная команда строковый аргумент для rclone.

Опции, использующие ВРЕМЯ, используют синтаксический анализатор времени выхода. Строка продолжительности - это возможно знаковая последовательность десятичных чисел, каждое с необязательным дробь и суффикс единицы, например «300 мс», «-1,5 ч» или «2 ч 55 м». Действительный единицы времени: «нс», «нас» (или «мкс»), «мс», «с», «м», «ч».

Параметры, использующие РАЗМЕР, по умолчанию используют килобайт. Однако суффикс b для байтов, k для kBytes, M для MBytes, G для GBytes, T для Можно использовать TBytes и P для PBytes.Это двоичные единицы, например 1, 2 ** 10, 2 ** 20, 2 ** 30 соответственно.

--backup-dir = DIR

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

Если установлено значение --suffix , то к перемещаемым файлам будет добавлен суффикс им. Если есть файл с таким же путем (после суффикса добавлен) в DIR, то он будет перезаписан.

Используемый пульт дистанционного управления должен поддерживать перемещение или копирование на стороне сервера, и вы должны используйте тот же пульт в качестве места назначения синхронизации. Резервная копия каталог не должен перекрывать целевой каталог.

Например,

  rclone sync -i / путь / к / локальный удаленный: текущий --backup-dir удаленный: старый
  

синхронизирует / path / to / local to remote: current , но для любых файлов которые были бы обновлены или удалены, будут храниться в пульт: старый .

Если вы запускаете rclone из скрипта, вы можете использовать сегодняшнюю дату как имя каталога, переданное в --backup-dir для хранения старых файлов, или вы можете передать - суффикс с сегодняшней датой.

См. --compare-dest и --copy-dest .

- переплет

Локальный адрес для привязки исходящих соединений. Это может быть IPv4-адрес (1.2.3.4), IPv6-адрес (1234 :: 789A) или имя хоста. Если имя хоста не разрешается или разрешается более чем на один IP-адрес выдаст ошибку.

--bwlimit = BANDWIDTH_SPEC

Эта опция контролирует ограничение полосы пропускания. Например

  --bwlimit 10M
  

будет означать ограничение пропускной способности загрузки и выгрузки до 10 МБ / с. NB это байта в секунду, а не бит в секунду. Чтобы использовать single limit, укажите желаемую пропускную способность в кБайт / с или используйте суффикс b | k | M | G. Значение по умолчанию - 0 , что означает отсутствие ограничения пропускной способности.

Пропускная способность загрузки и выгрузки может быть указана отдельно, как --bwlimit UP: DOWN , поэтому

  --bwlimit 10M: 100 КБ
  

будет означать ограничение пропускной способности загрузки до 10 МБ / с, а загрузка пропускная способность до 100 кБайт / с.Любой предел может быть выключен, что означает отсутствие лимита, поэтому чтобы просто ограничить пропускную способность загрузки, вы должны использовать

  --bwlimit 10M: выкл.
  

, это ограничит пропускную способность загрузки до 10 МБ / с, но загрузка пропускная способность будет неограниченной.

Если указано, как указано выше, ограничения полосы пропускания действуют в течение запуск двоичного файла rclone.

Также можно указать «расписание» лимитов, которое будет заставляют применять определенные ограничения в определенное время. Чтобы указать расписание, отформатируйте записи как WEEKDAY-HH: MM, BANDWIDTH WEEKDAY-HH: MM, BANDWIDTH... где: WEEKDAY - необязательный элемент.

• BANDWIDTH может быть одним числом, например 100k или пара цифр для загрузки: скачать, например 10М: 1М .
• WEEKDAY можно записать как целое слово или только с использованием первых трех символы. Это необязательно.
• ЧЧ: ММ - это час с 00:00 до 23:59.

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

--bwlimit "08: 00,512k 12: 00,10M 13: 00,512k 18: 00,30M 23:00, выкл."

В этом примере ширина полосы пропускания будет равна 512 Кбайт / сек. в 8 утра каждый день.В полдень он вырастет до 10 МБ / с, а затем снова упадет. до 512 Кбайт / сек в 13:00. В 18:00 предел пропускной способности будет установлен на 30 МБ / с, а в 23:00 он будет полностью отключен (полная скорость). Все, что находится между 23:00 и 8:00, останется без ограничений.

Пример расписания с WEEKDAY может быть:

--bwlimit "Пн-00: 00,512 Пт-23: 59,10M Сб-10: 00,1M Вс-20: 00, выкл."

Это означает, что пропускная способность будет установлена ​​на 512 Кбайт / сек на Понедельник.К концу пятницы он вырастет до 10 МБ / с. В 10:00 в субботу он будет установлен на 1 Мбайт / с. С 20:00 в воскресенье будет быть неограниченным.

Временные интервалы без WEEKDAY продлены на всю неделю. Так что это пример:

--bwlimit "Пн-00: 00,512 12: 00,1M Вс-20: 00, выкл"

Эквивалентно этому:

--bwlimit "Пн-00: 00,512Пн-12: 00,1M Вт-12: 00,1M Сред-12: 00,1M Чт-12: 00,1M Пт-12: 00,1M Сб-12: 00,1M вс-12: 00,1M вс-20: 00, выкл. »

Ограничение пропускной способности применяется к передаче данных для всех бэкэндов.Для большинства бэкэнды также включена пропускная способность списка каталогов (исключения являются бэкэндами без HTTP, ftp , sftp и tardigrade ).

Обратите внимание, что единицы измерения - Байт / с , а не Бит / с . Обычно соединения измеряются в битах / с - для преобразования разделите на 8. Для Например, допустим, у вас есть соединение со скоростью 10 Мбит / с, и вы хотите, чтобы rclone использовать половину - 5 Мбит / с. Это 5/8 = 0,625 МБ / с, поэтому вы бы используйте --bwlimit 0.625M параметр для rclone.

В системах Unix (Linux, macOS,…) ограничитель пропускной способности можно переключить с помощью отправка сигнала SIGUSR2 на rclone. Это позволяет снять ограничения длительной передачи rclone и восстановить его до указанного значения с --bwlimit быстро при необходимости. Предполагая, что существует только один экземпляр rclone работает, вы можете переключить ограничитель следующим образом:

  kill -SIGUSR2 $ (пидоф rclone)
  

Если вы настраиваете rclone с помощью пульта дистанционного управления, вы можете использовать динамически изменить bwlimit:

  rclone rc core / bwlimit rate = 1M
  

--bwlimit-file = BANDWIDTH_SPEC

Этот параметр контролирует ограничение пропускной способности файла.Чтобы узнать о вариантах, см. - флаг bwlimit .

Например, используйте это, чтобы скорость передачи не превышала 1 МБ / с.

  --bwlimit-file 1M
  

Может использоваться вместе с --bwlimit .

Обратите внимание, что если расписание предоставлено, файл будет использовать расписание в эффект в начале передачи.

- размер буфера = РАЗМЕР

Используйте буфер этого размера для ускорения передачи файлов. Каждые - перевод будет использовать этот объем памяти для буферизации.

При использовании mount или cmount каждый дескриптор открытого файла будет использовать это количество память для буферизации. См. Документацию по монтированию для получения более подробной информации.

Установите значение 0 , чтобы отключить буферизацию для минимального использования памяти.

Обратите внимание, что на распределение памяти буферов влияет Флаг --use-mmap.

- проверка первых

Если этот флаг установлен, то при синхронизации , копировать или перемещать , rclone выполнит все проверки, чтобы увидеть, нужно ли передавать файлы перед делать какие-либо переводы.Обычно rclone запускается переводы в кратчайшие сроки.

Этот флаг может быть полезен в системах с ограниченным вводом-выводом, где передача мешают проверке.

Это также может быть полезно для обеспечения безупречного заказа при использовании - заказать .

Использование этого флага может использовать больше памяти, поскольку он эффективно устанавливает --max-backlog до бесконечности. Это означает, что вся информация на объекты для передачи хранятся в памяти до начала передачи.

--checkers = N

Количество чекеров для параллельного запуска.Шашки делают равенство проверка файлов при синхронизации. Для некоторых систем хранения (например, S3, Swift, Dropbox) это может занять много времени, поэтому они работать параллельно.

По умолчанию 8 чекеров запускаются параллельно.

-c, --checksum

Обычно rclone смотрит на время модификации и размер файлов для посмотрим, равны ли они. Если вы установите этот флаг, rclone проверит хэш файла и размер, чтобы определить, равны ли файлы.

Это полезно, когда пульт не поддерживает время изменения настройки. и желательна более точная синхронизация, чем просто проверка размера файла.

Это очень полезно при переключении между пультами дистанционного управления, которые хранят тот же тип хэша на объекте, например Драйв и Свифт. Подробнее о которых поддержка пультов ДУ, тип хеша см. в таблице в обзоре раздел.

Например, rclone --checksum sync s3: / bucket swift: / bucket будет много работать быстрее, чем без флага - контрольная сумма .

При использовании этого флага rclone не будет обновлять время удаленных файлов, если они неверны, как обычно.

--compare-dest = DIR

При использовании синхронизации , копирование или перемещение DIR проверяется в дополнение к место назначения для файлов. Если обнаружен файл, идентичный источнику, то файл НЕ копируется из источника. Это полезно для копирования только файлов, изменились с момента последней резервной копии.

Вы должны использовать тот же пульт в качестве места назначения синхронизации. В Каталог сравнения не должен перекрывать целевой каталог.

См. --copy-dest и --backup-dir .

--config = CONFIG_FILE

Укажите расположение файла конфигурации rclone.

Обычно файл конфигурации находится в вашем домашнем каталоге в виде файла с именем .config / rclone / rclone.conf (или .rclone.conf , если он создан с более старая версия). Если установлен $ XDG_CONFIG_HOME , он будет в $ XDG_CONFIG_HOME / rclone / rclone.conf .

Если есть файл rclone.conf в том же каталоге, что и rclone исполняемый файл будет предпочтительнее.Этот файл необходимо создать вручную чтобы Rclone мог его использовать, он никогда не будет создан автоматически.

Если вы запустите файл конфигурации rclone , вы увидите, где по умолчанию место для вас.

Используйте этот флаг, чтобы переопределить расположение конфигурации, например rclone --config = ". Myconfig", конфигурация .

Если в качестве местоположения задана пустая строка "" или специальное значение / notfound , или нулевое устройство операционной системы, представленное значением NUL на Windows и / dev / null в системах Unix, тогда rclone сохранит config только в памяти.

Формат файла - базовый INI: Разделы текста, начинающиеся с заголовка [section] , за которым следует ключ = значение записей в отдельных строках. В rclone каждый пульт представлен собственным разделом, где имя раздела определяет имя пульта. Параметры указываются как ключ = значение записей, где ключ - это имя опции без префикса --backend- , в нижнем регистре и с _ вместо - . Например. опция --mega-hard-delete соответствует ключу hard_delete .Можно указать только параметры серверной части. Специальный и обязательный ключ типа идентифицирует систему хранения, где значение - это внутреннее имя в нижнем регистре, возвращаемое командой rclone справочная система . Комментарии обозначены номером ; или # на начало строки.

Пример:

  [мегапиксельная]
тип = мега
user = [email protected]
pass = PDPcQVVjVtzFY-GTdDFozqBhTdsPg3qH
  

Обратите внимание, что пароли скрыты форма.Кроме того, многие системы хранения вместо этого используют аутентификацию на основе токенов. паролей, а это требует дополнительных действий. Так проще и безопаснее, использовать интерактивную команду rclone config вместо ручной редактирование файла конфигурации.

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

При использовании аутентификации на основе токенов файл конфигурации должен быть доступен для записи, потому что rclone должен обновлять токены внутри него.

--contimeout = ВРЕМЯ

Установите время ожидания соединения. Это должно быть в формате времени, который выглядит как 5s в течение 5 секунд, 10m в течение 10 минут или 3h40m .

Тайм-аут соединения - это время, в течение которого rclone будет ждать соединение для перехода к системе хранения удаленных объектов.это 1м по умолчанию.

--copy-dest = DIR

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

Используемый пульт должен поддерживать копирование на стороне сервера, и вы должны используйте тот же пульт в качестве места назначения синхронизации. Сравнение каталог не должен перекрывать целевой каталог.

См. --compare-dest и --backup-dir .

- РЕЖИМ дедупликации

Режим для запуска команды дедупликации. Один из интерактивных , пропустить , первый , самый новый , самый старый , переименовать . По умолчанию - интерактивный . См. Команду dedupe для получения дополнительной информации о том, что означают эти параметры.

- отключить FEATURE, FEATURE, ...

Отключает список дополнительных функций, разделенных запятыми.Например для отключения перемещения на стороне сервера и использования копирования на стороне сервера:

  - отключить ход, копировать
  

Фичи можно поставить в любом случае.

Чтобы просмотреть список функций, которые можно отключить, используйте:

  - помощь по отключению
  

См. Обзор функций и дополнительные функции, чтобы получить представление о какая функция что делает.

Этот флаг может быть полезен для отладки и в исключительных случаях. (например, Google Диск ограничивает общий объем серверных копий до 100 ГБ / день).

--dscp ЗНАЧЕНИЕ

Укажите значение или имя DSCP для использования в соединениях. Это может помочь QoS система определения класса трафика. Разрешены BE, EF, DF, LE, CSx и AFxx.

См. Описание дифференцированных услуг, чтобы получить представление о это поле. Установите для этого параметра значение 1 (LE), чтобы идентифицировать поток к классу SCAVENGER. позволяет избежать использования слишком большой полосы пропускания в сети с поддержкой DiffServ (RFC 8622).

Например, если вы настроили QoS на маршрутизаторе для правильной обработки LE.Бег:

  rclone copy --dscp LE from: / from to: / to
  

сделает приоритет ниже, чем у обычных интернет-потоков.

-n, --dry-run

Сделайте пробный запуск без постоянных изменений. Используйте это, чтобы увидеть, что rclone обошлось бы без этого. Полезно при настройке sync команда, которая удаляет файлы в месте назначения.

--expect-continue-timeout = ВРЕМЯ

Определяет время ожидания первого заголовки ответа после полной записи заголовков запроса, если запрос имеет заголовок «Expect: 100-continue».Не все бэкенды поддерживают используя это.

Ноль означает отсутствие тайм-аута и немедленную отправку тела, не дожидаясь подтверждения сервера. На этот раз не входит время для отправки заголовка запроса.

Значение по умолчанию - 1 с . Установите значение 0 для отключения.

- ошибка при отсутствии передачи

По умолчанию rclone завершит работу с кодом возврата 0, если ошибок не было.

Эта опция позволяет rclone возвращать код выхода 9, если файлы не были переданы. между источником и местом назначения.Это позволяет использовать rclone в скриптах, и запуск последующих действий, если данные были скопированы, или пропуска, если нет.

NB: включение этой опции превращает обычно нефатальную ошибку в потенциально фатальный - проверьте и скорректируйте свои скрипты соответствующим образом!

--fs-cache-expire-duration = ВРЕМЯ

При использовании rclone через API rclone создает кеши удаленных для 5 минут по умолчанию в "кеше фс". Это означает, что если вы это сделаете повторяющиеся действия на одном и том же пульте дистанционного управления, тогда rclone не будет создавать его снова с нуля, что делает его более эффективным.

Этот флаг устанавливает время, в течение которого пульты кэшируются. Если вы установите это на 0 (или отрицательный), тогда rclone вообще не кэширует пульты.

Обратите внимание, что если вы используете некоторые флаги, например --backup-dir и если это установлено до 0 rclone может создавать два пульта дистанционного управления (один для источника или назначения и один для --backup-dir , где он, возможно, построил только один перед.

--fs-cache-expire-interval = ВРЕМЯ

Этот параметр определяет, как часто rclone проверяет, не истек ли срок действия кэшированных пультов ДУ.Подробнее см. Документацию --fs-cache-expire-duration выше. Информация. По умолчанию 60 секунд, значение 0 - отключение истечения срока действия.

Добавьте заголовок HTTP для всех транзакций. Флаг может повторяться до добавить несколько заголовков.

Если вы хотите добавить заголовки только для загрузки, используйте --header-upload и если вы хотите добавить заголовки только для загрузок, используйте --header-download .

Этот флаг поддерживается для всех серверных программ на основе HTTP, даже для тех, которые не поддерживается --header-upload и --header-download , поэтому может использоваться как обходной путь для тех, кто осторожен.

  rclone ls remote: test --header «X-Rclone: ​​Foo» --header «X-LetMeIn: Yes»
  

Добавьте заголовок HTTP для всех транзакций загрузки. Флаг может повторяться до добавить несколько заголовков.

  rclone sync -i s3: test / src ~ / dst --header-download "X-Amz-Meta-Test: Foo" --header-download "X-Amz-Meta-Test2: Bar"
  

См. Проблему GitHub здесь для в настоящее время поддерживаются серверные ВМ.

Добавьте заголовок HTTP для всех транзакций загрузки. Флаг можно повторить, чтобы добавить несколько заголовков.

  rclone sync -i ~ / src s3: test / dst --header-upload "Content-Disposition: attachment; filename = 'cool.html'" --header-upload "X-Amz-Meta-Test: FooBar"
  

См. Проблему GitHub здесь для в настоящее время поддерживаются серверные ВМ.

--ignore-case-sync

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

- игнорировать контрольную сумму

Обычно rclone проверяет, что контрольные суммы переданных файлов совпадают, и выдают ошибку «повреждено при передаче», если они этого не делают.

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

- игнорировать существующий

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

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

- размер игнорирования

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

Это также приведет к тому, что rclone пропустит проверку того, что размеры совпадают. после перевода.

Это может быть полезно для передачи файлов в OneDrive и обратно, которые иногда неверно сообщает размер файлов изображений (см. # 399 для получения дополнительной информации).

-I, --ignore-times

Использование этой опции заставит rclone безоговорочно загрузить все файлы независимо от состояния файлов в месте назначения.

Обычно rclone пропускает все файлы с одинаковым время модификации и имеют одинаковый размер (или имеют одинаковую контрольную сумму, если используя --checksum ).

- неизменяемый

Считать исходный и целевой файлы неизменяемыми и запрещать модификация.

Если этот параметр установлен, файлы будут создаваться и удаляться по запросу, но существующие файлы никогда не будут обновлены.Если существующий файл не совпадает между источником и получателем, rclone выдаст ошибку Источник и место назначения существуют, но не совпадают: неизменяемый файл изменен .

Обратите внимание, что только команды, которые передают файлы (например, синхронизировать , копировать , ход ) затронуты этим поведением, и только модификация запрещено. Файлы по-прежнему могут быть удалены явно (например, удалить , очистка ) или неявно (например, синхронизация , перемещение ).Используйте copy --immutable если желательно избежать удаления или модификации.

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

-i / - интерактивный

Этот флаг можно использовать, чтобы сообщить rclone, что вам нужно руководство. подтверждение перед разрушительными операциями.

рекомендуется использовать этот флаг при изучении rclone особенно с rclone sync .

Например,

  $ rclone удалить -i / tmp / dir
rclone: ​​удалить "important-file.txt"?
y) Да, это нормально (по умолчанию)
п) Нет, пропустить
s) Пропустить все операции удаления без вопросов
!) Выполнять все операции удаления без лишних вопросов
q) Выйдите из rclone сейчас.
г / н / с /! / д> п
  

Варианты означают

• y : Да, , эта операция должна выполняться. Вы также можете нажать Return чтобы это произошло. Вас будут спрашивать каждый раз, если вы не выберете s или ! .
• n : Нет , не выполняйте эту операцию. Вас будут спрашивать каждый раз, если только Вы выбираете s или ! .
• с : Пропустить все следующие операции этого типа, не более вопросов. Это действует до выхода из rclone. Если есть вам будут предложены различные виды операций.
• ! : Выполнить все следующих операций, не более вопросов. Полезно, если вы решили, что не против делать rclone. такая операция.Это действует до выхода из rclone. Если вам будет предложено выполнить какие-либо операции их.
• q : Закройте rclone сейчас, на всякий случай!

- корневой каталог

Во время rmdirs он не удаляет корневой каталог, даже если он пуст.

--log-file = ФАЙЛ

Записывать все выходные данные rclone в ФАЙЛ. По умолчанию он не активен. Это может быть полезно для отслеживания проблем с синхронизацией в комбинация с флагом -v .См. Раздел "Ведение журнала" для получения дополнительной информации.

Если ФАЙЛ существует, то к нему добавится rclone.

Обратите внимание, что если вы используете программу logrotate для управления rclone logs, то вы должны использовать опцию copytruncate , поскольку rclone не есть сигнал повернуть бревна.

- формат журнала СПИСОК

Список параметров формата журнала, разделенных запятыми. дата , время , микросекунд , длинный файл , короткий файл , UTC .По умолчанию: «, дата , , время ».

- уровень журнала УРОВЕНЬ

Устанавливает уровень журнала для rclone. Уровень журнала по умолчанию - УВЕДОМЛЕНИЕ .

DEBUG эквивалентно -vv . Он выводит много отладочной информации - полезно для отчетов об ошибках и реального выяснения того, что делает rclone.

INFO эквивалентно -v . Выводит информацию о каждой передаче и по умолчанию печатает статистику раз в минуту.

УВЕДОМЛЕНИЕ - уровень журнала по умолчанию, если не указаны флаги ведения журнала. Это выводит очень мало, когда все работает нормально. Он выводит предупреждения и важные события.

ОШИБКА эквивалентна -q . Он выводит только сообщения об ошибках.

--use-json-log

Это переключает формат журнала на JSON для rclone. Поля журнала json уровень, сообщение, источник, время.

- повторные попытки на низком уровне НОМЕР

Управляет количеством повторных попыток низкого уровня, которые выполняет rclone.

Повторная попытка на низком уровне используется для повторения неудачной операции - обычно одна. HTTP-запрос. Это может быть загрузка фрагмента большого файла для пример. Вы увидите повторные попытки низкого уровня в журнале с -v флаг.

Не нужно менять значение по умолчанию при нормальной работе. Однако, если вы получаете много повторных попыток на низком уровне, вы можете пожелать чтобы уменьшить значение, чтобы rclone перешел к повторной попытке высокого уровня (см. - повторяет флаг ) быстрее.

Отключить повторы низкого уровня с --low-level-retries 1 .

--max-backlog = N

Это максимально допустимое отставание файлов при синхронизации / копировании / перемещении. в очереди на проверку или передачу.

Может быть установлен произвольно большим. Он будет использовать память только тогда, когда очередь уже используется. Обратите внимание, что он будет использовать порядка N кБ памяти. когда используется невыполненная работа.

Установка этого большого размера позволяет rclone вычислить, сколько файлов ожидание более точно, дайте более точную оценку отделки time и сделать --order-by работать точнее.

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

Установка отрицательного числа приведет к тому, что невыполненная работа будет равна возможный.

--max-delete = N

Это указывает rclone не удалять более N файлов. Если этот предел превышено, то будет сгенерирована фатальная ошибка, и rclone остановит операция в процессе.

--max-depth = N

Это изменяет глубину рекурсии для всех команд, кроме очистки.

Итак, если вы выполните rclone --max-depth 1 ls remote: path , вы увидите только файлы в каталоге верхнего уровня. Использование --max-depth 2 означает, что вы увидит все файлы на первых двух уровнях каталогов и так далее.

По историческим причинам команда lsd по умолчанию использует --max-depth of 1 - вы можете переопределить это с помощью флага командной строки.

Эту команду можно использовать для отключения рекурсии (с --max-depth 1 ).

Обратите внимание, что если вы используете это с sync и --delete-excluded , файлы, не прошедшие рекурсию, считаются исключенными и удаляются по месту назначения. Сначала проверьте --dry-run , если вы не уверены что случится.

--max-duration = ВРЕМЯ

Rclone перестанет планировать новые передачи, когда он будет запущен для указанная продолжительность.

По умолчанию выключено.

При достижении лимита все существующие переводы будут завершены.

Rclone не выйдет с ошибкой, если будет достигнут предел передачи.

--max-transfer = РАЗМЕР

Rclone прекратит передачу, когда достигнет указанного размера. По умолчанию выключено.

При достижении лимита все переводы немедленно прекращаются.

Rclone выйдет с кодом выхода 8, если будет достигнут предел передачи.

--cutoff-mode = hard | soft | осторожный

Это изменяет поведение --max-transfer По умолчанию --cutoff-mode = hard .

Указание --cutoff-mode = hard немедленно остановит передачу когда Rclone достигает предела.

Указание --cutoff-mode = soft остановит запуск новых передач когда Rclone достигает предела.

Указание --cutoff-mode = осторожно попытается предотвратить Rclone от достижения предела.

--modify-window = ВРЕМЯ

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

Значение по умолчанию - 1 нс , если это не отменено удаленным устройством. Для пример OS X хранит только время модификации с точностью до секунды, поэтому если вы читаете и записываете в файловую систему OS X, это будет 1 с по умолчанию.

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

- многониточная обрезка = РАЗМЕР

При загрузке файлов на локальный сервер размером больше этого, rclone будет использовать несколько потоков для загрузки файла (по умолчанию 250M).

Rclone предварительно выделяет файл (используя Fallocate (FALLOC_FL_KEEP_SIZE) в unix или NTSetInformationFile в Windows, оба из которых не требуют время), то каждый поток записывает прямо в файл в нужное место. Это означает, что rclone не будет создавать фрагментированные или разреженные файлы. и в конце передачи не будет времени сборки.

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

Используйте -vv , если вы хотите увидеть информацию о цепочках.

Это будет работать с синхронизацией / копией / перемещением командами и друзьями copyto / moveto . Многопоточная загрузка будет использоваться с rclone mount и rclone serve , если --vfs-cache-mode установлен на пишет или выше.

NB , что этот только работает для местного назначения, но будет работать с любого источника.

NB , что многопоточные копии отключены для локальных копий поскольку они быстрее, если не установлен --multi-thread-streams явно.

NB в Windows при использовании многопоточной загрузки вызовет результирующие файлы должны быть разреженными. Используйте --local-no-sparse , чтобы отключить разреженные файлы (что может задержки в начале загрузки) или отключить многопоточную загрузку с - многопоточными потоками 0

- многопоточные потоки = N

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

Сколько именно потоков rclone использует для загрузки, зависит от размер файла. Для расчета количества потоков загрузки Rclone делит размер файла на - многониточно-отрезной и скругляет вверх, до максимального набора с - multi-thread-streams .

Итак, если - многопоточная обрезка 250MB и - многопоточные потоки 4 являются в силе (по умолчанию):

• Файлы размером 0MB..250MB будут загружены с 1 потоком
• 250 МБ.Файлы .500MB будут загружены двумя потоками
• Файлы размером 500… 750 МБ будут загружены с 3 потоками
• 750MB + файлы будут загружены с 4 потоками

--no-check-dest

--no-check-dest может использоваться с move или copy , и это вызывает rclone, чтобы вообще не проверять место назначения при копировании файлов.

Это означает, что:

• пункт назначения не указан, минимизация вызовов API
• файлов передаются всегда
• это может привести к дублированию на пультах дистанционного управления, которые позволяют это (например,грамм. Google Диск)
• --retries 1 Рекомендуется , иначе вы перенесете все снова при повторной попытке

Этот флаг полезен для минимизации транзакций, если вы знаете, что ни один файлов находятся в месте назначения.

Это специальный флаг, который большинству пользователей следует игнорировать!

--no-gzip-encoding

Не устанавливать Accept-Encoding: gzip . Это означает, что rclone не спросит сервер для сжатых файлов автоматически.Полезно, если вы установили сервер для возврата файлов с кодировкой содержимого : gzip , но вы загруженные сжатые файлы.

Нет необходимости настраивать это при нормальной работе, и это приведет к снизить эффективность сетевой передачи rclone.

- без траверсы

Флаг --no-traverse определяет, будет ли файловая система назначения выполняется при использовании команд копировать или перемещать . --no-traverse несовместим с sync и будет проигнорирован, если вы поставляете его с синхронизацией .

Если вы копируете только небольшое количество файлов (или фильтруете большую часть файлов) и / или иметь большое количество файлов в месте назначения затем --no-traverse остановит rclone перечисление пункта назначения и сохранит время.

Однако, если вы копируете большое количество файлов, особенно если вы делают копию там, где многие рассматриваемые файлы не изменен и не требует копирования, то вам не следует использовать --no-traverse .

См. Rclone copy для примера того, как его использовать.

- нормализация без юникода

Не нормализовать символы Юникода в именах файлов во время процедуры синхронизации.

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

Использование этого флага отключит эту функцию, обрабатывая каждый юникод. характер как уникальный.Например, по умолчанию é и é будут нормализованы. в того же персонажа. С --no-unicode-normalization они будут рассматриваются как уникальные персонажи.

--no-update-modtime

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

Это можно использовать, если пульт также синхронизируется с другим инструментом. (например, клиент Google Диска).

- строка порядка

Флаг --order-by управляет порядком, в котором файлы в очереди. обрабатываются в rclone sync , rclone copy и rclone move .

Порядок по строке строится следующим образом. Первая часть описывает, какой аспект измеряется:

• размер - упорядочить по размеру файлов
• имя - упорядочить по полному пути к файлам
• modtime - упорядочить по дате модификации файлов

Модификатор может быть добавлен с запятой:

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

Если модификатор смешанный , то он может иметь необязательный процент (по умолчанию 50 ), e.грамм. размер, смешанный, 25 , что означает, что 25% нитки должны занимать самые мелкие предметы и 75% самый большой. Нити, которые занимают в первую очередь самые маленькие, всегда будут занимать самая маленькая первая и также самая большая первая нитка. смешанный режим может быть полезен для минимизации времени передачи, когда вы передача смеси больших и маленьких файлов - большие файлы гарантированные потоки загрузки и пропускная способность, а небольшие файлы будут обрабатывается непрерывно.

Если модификатор не указан, то порядок - по возрастанию .

Например,

• - упорядочить по размеру, по убыванию - сначала отправлять самые большие файлы
• - упорядочить по времени модов, по возрастанию - сначала отправлять самые старые файлы
• - упорядочить по имени - отправить файлы в алфавитном порядке по пути сначала

Если флаг --order-by не поставляется или поставляется с пустая строка, тогда будет использоваться порядок по умолчанию, который выглядит как отсканировано. С --checkers 1 это в основном алфавитный, однако со значением по умолчанию --checkers 8 это несколько случайно.

Ограничения

Флаг --order-by не выполняет отдельную передачу данных. Этот означает, что он может передавать некоторые файлы в неправильном порядке, если

• Нет файлов в очереди или источник еще не полностью просканирован
• в очереди больше файлов --max-backlog

Rclone сделает все возможное, чтобы передать лучший файл, который у него есть. на практике это не должно вызывать проблем. Подумайте о --order-by как о быть скорее флагом максимальных усилий, чем идеальным порядком.

Если вам нужен идеальный заказ, вам необходимо указать --check-first, который найдет все нужные файлы передача, прежде чем передавать какие-либо.

- пароль-команда SpaceSepList

Этот флаг предоставляет программу, которая должна предоставить пароль конфигурации. при запуске. Это альтернатива запросу пароля rclone. или установив переменную RCLONE_CONFIG_PASS .

Аргументом здесь должна быть команда со списком, разделенным пробелами. аргументов.Если в одном из аргументов есть пробел, заключите его в ", если вы хотите использовать буквальный " в аргументе, тогда заключите аргумент в " и удвоить " . См. Кодировку CSV для получения дополнительной информации.

Например,

  --password-command echo привет
--password-command echo "привет, пробел"
--password-command echo "привет с" "кавычками" "и пробелом"
  

Дополнительные сведения см. В разделе «Шифрование конфигурации».

См. Пример Windows PowerShell в Wiki.

-P, --progress

Этот флаг заставляет rclone обновлять статистику в статическом блоке в терминал, обеспечивающий обзор перевода в реальном времени.

Любые сообщения журнала будут прокручиваться над статическим блоком. Журнал сообщений подтолкнет статический блок к нижней части терминала, где он остановимся.

Обычно обновляется каждые 500 мс, но этот период можно изменить. с флагом --stats .

Может использоваться с флагом --stats-one-line для упрощения отображать.

Примечание: в Windows до этой ошибки исправлено, все символы, отличные от ASCII, будут заменены на . когда - используется прогресс .

- заголовок-прогресс-терминал

Этот флаг, при использовании с -P / - progress , напечатает строку ETA:% s к заголовку терминала.

-q, --quiet

Этот флаг ограничивает вывод rclone только сообщениями об ошибках.

- время обновления

Флаг --refresh-times может использоваться для обновления времени модификации существующие файлы, когда они не синхронизированы на бэкэндах, которые не поддержка хешей.

Это полезно, если вы загрузили файлы с неправильными отметками времени и теперь вы хотите их исправить.

Этот флаг - , только полезен для пунктов назначения, которые не поддерживают хеши (например, крипта ).

Может использоваться любая из команд синхронизации синхронизация , копировать или перемещать .

Чтобы использовать этот флаг, вам необходимо выполнить синхронизацию времени модификации. (поэтому не используйте --size-only или --checksum ).Флаг не будет иметь эффект при использовании --size-only или --checksum .

Если этот флаг используется, когда rclone приходит для загрузки файла, он проверяет чтобы увидеть, есть ли в месте назначения файл. Если этот файл соответствует источнику по размеру (и контрольной сумме, если имеется), но имеет другую временную метку, то вместо повторной загрузки rclone будет обновить метку времени в конечном файле. Если контрольная сумма не соответствует match rclone загрузит новый файл. Если контрольная сумма отсутствует (например,грамм. на бэкэнде crypt ), то rclone обновит метку времени.

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

Обычно, если вы выполняете синхронизацию времени модификации, rclone будет обновлять время модификации без --refresh-times при условии, что удаленный поддерживает контрольные суммы и , контрольные суммы совпадают в файле. Однако если контрольные суммы отсутствуют, тогда rclone загрузит файл, а не установка отметки времени, поскольку это безопасное поведение.

- retries int

Повторить всю синхронизацию, если она терпит неудачу столько раз, сколько неудач (по умолчанию 3).

Некоторые пульты могут быть ненадежными, и несколько попыток помогут подобрать файлы, которые не были переданы из-за ошибок.

Отключить повторные попытки с --retries 1 .

--retries-sleep = ВРЕМЯ

Устанавливает интервал между каждой повторной попыткой, заданный параметром --retries

По умолчанию 0 . Для отключения используйте 0 .

- только размер

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

Это может быть полезно при передаче файлов из Dropbox, которые были изменен клиентом синхронизации рабочего стола, который не устанавливает контрольные суммы время модификации аналогично rclone.

--stats = ВРЕМЯ

Команды, передающие данные ( синхронизировать , копировать , копировать на , перемещать , moveto ) будет печатать статистику передачи данных через равные промежутки времени, чтобы показать их прогресс.

Устанавливает интервал.

По умолчанию 1 м . Для отключения используйте 0 .

Если вы установите интервал статистики, все команды могут отображать статистику. Этот может быть полезно при запуске других команд, проверьте или mount для пример.

по умолчанию регистрируется на уровне INFO , что означает, что они не будут показывать на уровне журнала по умолчанию УВЕДОМЛЕНИЕ . Используйте --stats-log-level NOTICE или -v , чтобы показать их.Подробнее см. В разделе «Ведение журнала» информация об уровнях журнала.

Обратите внимание, что в macOS вы можете отправить SIGINFO (обычно это ctrl-T в терминал), чтобы статистика распечатывалась немедленно.

--stats-file-name-length целое число

По умолчанию вывод --stats будет сокращать имена файлов и пути длиннее. более 40 знаков. Это эквивалентно предоставлению - длина имени-статс-файла 40 . Используйте --stats-file-name-length 0 , чтобы отключить любое усечение имён файлов, выводимое статистикой.

- строка уровня журнала статистики

Уровень журнала для отображения вывода --stats на. Это может быть DEBUG , INFO , УВЕДОМЛЕНИЕ , или ОШИБКА . По умолчанию ИНФОРМАЦИЯ . Это означает, что на уровень ведения журнала по умолчанию, который составляет УВЕДОМЛЕНИЕ , статистика не будет отображаться - если вы хотите, чтобы они использовали --stats-log-level NOTICE . См. Журнал раздел для получения дополнительной информации об уровнях журнала.

--stats-one-line

Когда это указано, rclone объединяет статистику в одну строку. показывает только самую важную статистику.

--stats-one-line-date

Когда это указано, rclone включает однострочную статистику и добавляет в начало отображение со строкой даты. По умолчанию 2006/01/02 15:04:05 -

--stats-one-line-date-format

Когда это указано, rclone включает однострочную статистику и добавляет в начало отображение с введенной пользователем строкой даты. Строка даты ДОЛЖНА быть заключен в кавычки. Следуйте спецификациям golang для синтаксис форматирования даты.

--stats-unit = биты | байты

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

Эта опция позволяет печатать скорость передачи данных в битах в секунду.

Объем передаваемых данных по-прежнему будет указываться в байтах.

Скорость указывается в двоичной единице, а не в системе СИ. Так 1 Мбит / с равно 1048576 бит / с, а не 1000000 бит / с.

По умолчанию байт .

--суффикс = СУФФИКС

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

Используемый пульт дистанционного управления должен поддерживать перемещение или копирование на стороне сервера, и вы должны используйте тот же пульт в качестве места назначения синхронизации.

Используется с файлами для добавления суффикса в текущий каталог. или с --backup-dir . См. --backup-dir для получения дополнительной информации.

Например,

  rclone copy -i / path / to / local / file remote: current --suffix.бак
  

скопирует / path / to / local на remote: current , но для любых файлов которые были бы обновлены или удалены, если бы был добавлен .bak.

При использовании rclone sync с --suffix и без --backup-dir тогда рекомендуется поставить правило фильтрации, исключая суффикс в противном случае sync удалит файлы резервных копий.

  rclone sync -i / путь / к / локальному / удаленному файлу: текущий --suffix.bak - исключить "* .bak"
  

--suffix-keep-extension

При использовании --suffix установка этого параметра приводит к тому, что rclone помещает SUFFIX перед расширением файлов, для которых выполняется резервное копирование, а не после.

Допустим, у нас есть --suffix -2019-01-01 , без флага file.txt будет сохранена до file.txt-2019-01-01 и с флагом будет можно создать резервную копию файла -2019-01-01.txt . Это может быть полезно сделать убедитесь, что файлы с суффиксами все еще можно открывать.

- системный журнал

В совместимых операционных системах (не Windows или Plan9) отправляйте весь вывод журнала в системный журнал.

Это может быть полезно для запуска rclone в сценарии или rclone mount .

- строка объекта syslog

При использовании --syslog это устанавливает средство системного журнала (например, KERN , USER ). См. Список возможных средств в системном журнале man . По умолчанию объект DAEMON .

- tpslimit поплавок

Ограничьте количество транзакций в секунду до этого числа.По умолчанию 0, что раньше означало неограниченное количество транзакций в секунду.

Транзакция примерно определяется как вызов API; его точное значение будет зависеть от серверной части. Для бэкэндов на основе HTTP это HTTP. PUT / GET / POST / etc и его ответ. Для FTP / SFTP это поездка туда и обратно транзакция по TCP.

Например, чтобы ограничить rclone до 10 транзакций в секунду, используйте --tpslimit 10 , или для 1 транзакции каждые 2 секунды используйте --tpslimit 0,5 .

Используйте это, когда количество транзакций в секунду от rclone вызывая проблему с поставщиком облачного хранилища (например,грамм. получить тебя забанен или ограничен по скорости).

Это может быть очень полезно для rclone mount для управления поведением приложения, использующие его.

Это ограничение применяется ко всем серверным процессам на основе HTTP, а также к FTP и SFTP. бэкэнды. Это не относится к локальному бэкэнду или Tardigrade. бэкэнд.

См. Также --tpslimit-burst .

--tpslimit-burst int

Максимальный пакет транзакций для - tpslimit (по умолчанию 1 ).

Обычно - tpslimit выполняет ровно количество транзакций на второй указан. Однако, если вы поставите --tps-burst , тогда rclone может сохранить некоторые транзакции, когда он был в режиме ожидания, давая всплеск к предоставленному параметру.

Например, если вы предоставите --tpslimit-burst 10 , тогда, если rclone имеет простаивал более 10 * --tpslimit , тогда он может выполнять 10 транзакций очень быстро, прежде чем они снова будут ограничены.

Это может быть использовано для увеличения производительности - tpslimit без изменение долгосрочного среднего количества транзакций в секунду.

- переименование треков

По умолчанию rclone не отслеживает переименованные файлы, поэтому, если вы переименуйте файл локально, затем синхронизируйте его с удаленным, rclone удалит старый файл на пульте и загрузите новую копию.

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

Файлы будут совпадать по размеру и хешу - если оба совпадают, переименовать будут рассмотрены.

Если место назначения не поддерживает копирование или перемещение на стороне сервера, rclone вернется к поведению по умолчанию и запишет сообщение об уровне ошибки к консоли.

Зашифрованные пункты назначения в настоящее время не поддерживаются --track-renames если --track-renames-strategy включает хэш .

Обратите внимание, что --track-renames несовместим с --no-traverse и что он использует дополнительную память для отслеживания всех кандидатов на переименование.

Обратите внимание, что --track-renames несовместим с --delete-before и выберет --delete-after вместо - удалить во время .

--track-renames-strategy (hash, modtime, leaf, size)

Этот параметр изменяет критерии соответствия для --track-renames .

Соответствие контролируется выделением этих токенов, разделенных запятыми:

• modtime - время модификации файла - поддерживается не всеми бэкэндами
• hash - хэш содержимого файла - поддерживается не всеми бэкэндами
• лист - имя файла без имени каталога
• размер - размер файла (всегда включен)

Таким образом, используя модтайм --track-renames-strategy, лист будет соответствовать файлам в зависимости от времени модификации, листа имени файла и размера Только.

Используя --track-renames-strategy, modtime или лист может включить --track-renames поддерживает зашифрованные места назначения.

Если ничего не указано, опция по умолчанию совпадает с хешем es.

Обратите внимание, что стратегия хеширования не поддерживается для зашифрованных пунктов назначения.

--delete- (до, во время, после)

Этот параметр позволяет указать, когда файлы в пункте назначения удаляется при синхронизации папок.

Указание значения --delete-before удалит все имеющиеся файлы в пункте назначения, но не в источнике до , запускающего передача любых новых или обновленных файлов. Это использует два прохода через файловые системы, одна для удаления и одна для копий.

Указание --delete-during приведет к удалению файлов при проверке и загрузка файлов. Это самый быстрый вариант с минимальным использованием памяти.

Указание --delete-after (значение по умолчанию) задержит удаление файлы до тех пор, пока все новые / обновленные файлы не будут успешно перенесены.Файлы, подлежащие удалению, собираются при копировании, а затем удаляются. после успешного завершения копирования. Файлы, которые будут удаленные хранятся в памяти, поэтому этот режим может использовать больше памяти. Это самый безопасный режим, так как он удалит файлы только в том случае, если не было ошибки после этого. Если до Если начнется удаление, вы получите сообщение , что файлы не удаляются из-за ошибок ввода-вывода .

--быстрый список

При выполнении чего-либо, связанного со списком каталогов (например,грамм. синхронизация , copy , ls - фактически почти каждая команда), rclone обычно перечисляет каталог и обрабатывает его перед использованием дополнительных списков каталогов для обрабатывать любые подкаталоги. Это может быть распараллелено и работает очень быстро используя наименьшее количество памяти.

Однако на некоторых пультах есть способ перечислить все файлы под справочник за одну (или небольшое количество) транзакций. Они имеют тенденцию быть пультами на основе ведра (например, S3, B2, GCS, Swift, Hubic).

Если вы используете флаг --fast-list , то rclone будет использовать этот метод для перечисление каталогов.Это будет иметь следующие последствия для листинг:

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

rclone всегда должен давать одинаковые результаты с и без --быстрый список .

Если вы платите за транзакции и можете разместить весь свой список синхронизации в memory, то рекомендуется --fast-list . Если у вас очень большая синхронизация для этого не используйте --fast-list , иначе у вас закончатся объем памяти.

Если вы используете --fast-list на удаленном компьютере, который его не поддерживает, тогда rclone просто проигнорирует это.

--timeout = ВРЕМЯ

Устанавливает тайм-аут простоя ввода-вывода. Если перевод начался, но потом простаивает в течение этого времени, он считается сломанным и отключенным.

По умолчанию 5 м . Установите значение 0 для отключения.

--transfers = N

Число параллельных передач файлов. Иногда это может быть полезно установить меньшее число, если пульт дает много таймаутов или больше, если у вас большая пропускная способность и быстрый пульт.

По умолчанию выполняется параллельная передача 4 файлов.

-u, --update

Это заставляет rclone пропускать любые файлы, которые существуют в месте назначения. и имеют время изменения новее, чем исходный файл.