Для пользователей Microsoft 365 — полностью интегрированный документ Nirvana

Команды, использующие Microsoft 365 с M-Files, поднимают свою производительность на новый уровень.С помощью M-Files вы можете добавить интуитивно понятные рабочие процессы, расширенные разрешения и контроль документов в MS Teams и SharePoint. Вы можете подключиться к своей CRM, ERP и другим бизнес-инструментам, чтобы делать еще больше — не выходя из приложения Microsoft 365!

Гибкость для вас и вашей команды

Продолжайте использовать знакомые вам инструменты и позвольте M ‑ Files систематизировать, управлять и связывать информацию.

Узнайте больше о том, как M-Files могут вам помочь

Позвольте нам показать вам M-Files в действии

Перебирать список файлов

Оболочка bash Ubuntu / Linux

Запускать команду для каждого файла

делать что-то (эхо) со всеми файлами .txt

для ф дюйм *.текст; до echo $ {f}; выполнено ;

Пример: строка поиска « ABC » во всех файлах .txt

для f в * .txt ; делать эхо — $ {f} -; grep « ABC » $ {f} ; done

тот же цикл по файлам, но с использованием конвейера (чтение из стандартного ввода) и цикла while

ls * .txt | , а — f; до echo $ {f}; выполнено ;

сделайте что-нибудь с небольшим набором файлов

для f в file1.txt file2.txt file3.txt; сделать echo $ {f}; сделано;

file1.txt

file2.txt

file3.txt

то же, но отдельно определенный список файлов

filelist = «file1.txt file2.txt file3.txt»

для f в $ {список файлов}; сделать echo $ {f}; сделано;

чтение списка файлов из файла ‘filelist.txt’ (для большего количества файлов)

ls * .csv> filelist.txt # определите свой список файлов

для f в ` cat filelist.txt `; сделать echo $ {f}; сделано;

, если строка может содержать пробелы, лучше использовать цикл while:

cat filelist.txt | пока читал LINE; сделать эхо «$ {LINE}»; done

цикл по именам файлов, но удаление расширения файла , см. → разделение строки базового имени

для f в Data / *. txt; сделать FILENAME = $ { f %%. * }; echo $ {FILENAME}; сделано;

Data / fileA .txt

Data / fileB .txt

перебирает имена файлов, но удаляет расширение файла и префикс пути

для f в Data / *.текст ; сделать FILENAME = `basename $ { f %%. * }`; echo $ {FILENAME}; done

Data / fileA .txt

Data / fileB .txt

Исключить уже обработанные образцы

обрабатывать входные файлы Data / *. файлы Результат / *. txt не существует

для f в Data / *. fastq ; do \

SAMPLE = `basename $ {f %%. *}`; \

, если [! -f Результаты / $ {SAMPLE}. txt ]; затем \

echo «образец обработки $ {SAMPLE}»; \

# сделать что-нибудь \

fi; \

done

# сделать что-то 10 раз

for N in {1..10}; do \

echo $ {N}; \

done

# двойной цикл по серии цифр и букв

для N в {1..5}; выполнить

для S в {A..C}; сделать

echo $ {N} $ {S};

выполнено;

выполнено;

1 A

1 B

1 C

2 A

2 B

2 C

°°°

общее использование: if-then-else f проверьте, нормальный ли файл)

if [-f / path / to / $ {SAMPLE}];

, затем

# сделайте что-нибудь, если файл существует

else

# сделайте что-нибудь, если файл не существует

fi

Копировать выбранное подмножество файлов

# скопировать все файлы список файлов.txt в newDir /

ls * .csv > filelist.txt # определите свой список файлов (отредактируйте текстовый файл)

mkdir newDir # создайте новый каталог

для f в `cat filelist.txt `; выполнить эхо-копирование $ {f}; cp $ {f} newDir / ; сделано;

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

для f в `cat filelist.txt`; выполнить эхо-копирование $ {f}; cp путь / к / файлам / $ {f} newDir / ; сделано;

см. Команду → найти

подробнее

http: // mywiki.wooledge.org/ BashPitfalls /

Как использовать DFS-N с файлами Azure

• 02.03.2021
• Читать 12 минут

В этой статье

, обычно называемые пространствами имен DFS или DFS-N, представляют собой роль сервера Windows Server, которая широко используется для упрощения развертывания и обслуживания общих файловых ресурсов SMB в производственной среде.Пространства имен DFS — это технология виртуализации пространства имен хранилища, что означает, что она позволяет вам обеспечить уровень косвенного обращения между UNC-путем ваших общих файловых ресурсов и самими фактическими общими файловыми ресурсами. Пространства имен DFS работают с общими файловыми ресурсами SMB, независимо от того, какие общие файловые ресурсы размещены: его можно использовать с общими ресурсами SMB, размещенными на локальном файловом сервере Windows с или без службы синхронизации файлов Azure, напрямую с файловыми ресурсами Azure, с общими файловыми ресурсами SMB, размещенными в Azure. NetApp Files или другие сторонние предложения, и даже с файловыми ресурсами, размещенными в других облаках.

По своей сути, пространства имен DFS обеспечивают сопоставление между удобным для пользователя UNC-путем, например \\ contoso \ share \ ProjectX , и базовым UNC-путем общего ресурса SMB, например \\ Server01-Prod \ ProjectX или \ \ storageaccount.file.core.windows.net \ projectx . Когда конечный пользователь хочет перейти к своему файловому ресурсу, он вводит удобный UNC-путь, но их клиент SMB обращается к базовому SMB-пути сопоставления. Вы также можете расширить эту базовую концепцию, чтобы взять на себя имя существующего файлового сервера, например \\ MyServer \ ProjectX .Вы можете использовать эту возможность для реализации следующих сценариев:

• Укажите защищенное от миграции имя для логического набора данных. В этом примере у вас есть сопоставление типа \\ contoso \ share \ Engineering , которое сопоставляется с \\ OldServer \ Engineering . По завершении миграции в файлы Azure вы можете изменить сопоставление, чтобы удобный для пользователя путь UNC указывал на \\ storageaccount.file.core.windows.net \ engineering . Когда конечный пользователь получает доступ к удобному для пользователя пути UNC, он будет легко перенаправлен на путь к общему файловому ресурсу Azure.

• Задайте общее имя для логического набора данных, который распределяется на несколько серверов на разных физических сайтах, например, через Azure File Sync. В этом примере имя, такое как \\ contoso \ share \ FileSyncExample , сопоставляется с несколькими путями UNC, такими как \\ FileSyncServer1 \ ExampleShare , \\ FileSyncServer2 \ DifferentShareName , \\ FileSyncServer \ Example \\ FileSyncServer. Когда пользователь обращается к удобному UNC-файлу, ему предоставляется список возможных UNC-путей, и он выбирает ближайший к нему на основе определений сайтов Windows Server Active Directory (AD).

• Расширьте логический набор данных по размеру, вводу-выводу или другим пороговым значениям масштабирования. Это обычное явление при работе с пользовательскими каталогами, где каждый пользователь получает свою собственную папку в общей папке, или с пустыми папками, где пользователи получают произвольное пространство для обработки временных потребностей в данных. С помощью пространств имен DFS вы объединяете несколько папок в единое пространство имен. Например, \\ contoso \ share \ UserShares \ user1 сопоставляется с \\ storageaccount.file.core.windows.net \ user1 , \ contoso \ share \ UserShares \ user2 сопоставляется с \\ storageaccount.file.core.windows.net \ user2 и так далее.

В следующем видеообзоре вы можете увидеть пример использования пространств имен DFS с развертыванием файлов Azure.

Примечание

Перейдите к 10:10 в видео, чтобы узнать, как настроить пространства имен DFS.

Если у вас уже есть пространство имен DFS, никаких специальных действий для его использования с файлами Azure и синхронизацией файлов не требуется. Если вы получаете доступ к общему файловому ресурсу Azure из локальной сети, применяются обычные сетевые соображения; Дополнительные сведения см. в разделе «Рекомендации по сети для файлов Azure».

Применимо к

Типы пространств имен

DFS Namespaces предоставляет два основных типа пространств имен:

• Доменное пространство имен : пространство имен, размещенное как часть вашего домена Windows Server AD. Пространства имен, размещенные как часть AD, будут иметь UNC-путь, содержащий имя вашего домена, например, \\ contoso.com \ share \ myshare , если ваш домен — contoso.com . Пространства имен на основе домена поддерживают большие ограничения масштаба и встроенную избыточность через AD.Пространства имен на основе домена не могут быть кластеризованным ресурсом в отказоустойчивом кластере.
• Автономное пространство имен : пространство имен, размещенное на отдельном сервере, а не как часть Windows Server AD. Автономные пространства имен будут иметь имя, основанное на имени автономного сервера, например \\ MyStandaloneServer \ share \ myshare , где ваш автономный сервер называется MyStandaloneServer . Автономные пространства имен поддерживают цели с меньшим масштабом, чем доменные пространства имен, но могут быть размещены как кластерный ресурс в отказоустойчивом кластере.

Требования

Чтобы использовать пространства имен DFS с файлами Azure и синхронизацией файлов, у вас должны быть следующие ресурсы:

• Домен Active Directory. Его можно разместить в любом месте, например локально, на виртуальной машине (ВМ) Azure или даже в другом облаке.
• Сервер Windows, на котором может размещаться пространство имен. Распространенным шаблоном развертывания пространств имен DFS является использование контроллера домена Active Directory для размещения пространств имен, однако пространства имен можно настроить с любого сервера с установленной ролью сервера пространств имен DFS.Пространства имен DFS доступны во всех поддерживаемых версиях Windows Server.
• Общий файловый ресурс SMB, размещенный в среде, присоединенной к домену, такой как файловый ресурс Azure, размещенный в присоединенной к домену учетной записи хранения, или файловый ресурс, размещенный на присоединенном к домену файловом сервере Windows с использованием Azure File Sync. Дополнительные сведения о присоединении к домену вашей учетной записи хранения см. В разделе Проверка подлинности на основе удостоверений. Файловые серверы Windows присоединяются к домену одинаково, независимо от того, используете ли вы службу «Синхронизация файлов».
• Общие файловые ресурсы SMB, которые вы хотите использовать с пространствами имен DFS, должны быть доступны из ваших локальных сетей.Это в первую очередь касается общих файловых ресурсов Azure, однако технически применимо к любому файловому ресурсу, размещенному в Azure или любом другом облаке. Дополнительные сведения о сети см. В разделе Рекомендации по сети для прямого доступа.

Установите роль сервера пространств имен DFS

Если вы уже используете пространства имен DFS или хотите настроить пространства имен DFS на контроллере домена, вы можете пропустить эти шаги.

Чтобы установить роль сервера пространств имен DFS, откройте диспетчер сервера на своем сервере.Выберите Управление , а затем выберите Добавить роли и компоненты . В результате мастер проведет вас через установку необходимых компонентов Windows для запуска и управления пространствами имен DFS.

В разделе Тип установки мастера установки выберите Ролевую или функциональную установку и выберите Далее . В разделе Server Selection выберите желаемые серверы, на которых вы хотите установить роль сервера пространств имен DFS, и выберите Next .

В разделе Server Roles выберите и отметьте роль DFS Namespaces из списка ролей. Вы можете найти это в File and Storage Services > File and ISCSI Services . Когда вы выбираете роль сервера пространств имен DFS, она также может добавлять любые требуемые вспомогательные серверные роли или функции, которые вы еще не установили.

После того, как вы проверили роль DFS Namespaces , вы можете выбрать Next на всех последующих экранах и выбрать Install , как только мастер активирует кнопку.Когда установка будет завершена, вы можете настроить свое пространство имен.

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

  Install-WindowsFeature -Name «FS-DFS-Namespace», «RSAT-DFS-Mgmt-Con»
  

Принять существующие имена серверов с помощью корневой консолидации

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

Несмотря на то, что это полезно для различных сценариев миграции центра обработки данных, консолидация корня особенно полезна для внедрения облачных общих файловых ресурсов Azure, потому что:

• Общие файловые ресурсы Azure не позволяют сохранять существующие имена локальных серверов.
Доступ к файловым ресурсам
• Azure должен осуществляться через полное доменное имя (FQDN) учетной записи хранения. Например, общий файловый ресурс Azure с именем share в учетной записи хранения storageaccount всегда доступен через UNC-путь \\ storageaccount.file.core.windows.net \ share . Это может сбивать с толку конечных пользователей, которые ожидают короткое имя (например, \\ MyServer \ share ) или имя, которое является поддоменом доменного имени организации (например, \\ MyServer.contoso.com \ share ).

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

Включение корневой консолидации

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

  Новый товар `
    -Путь "HKLM: SYSTEM \ CurrentControlSet \ Services \ Dfs" `
    -Type Registry `
    -ErrorAction SilentlyContinue
Новый элемент `
    -Путь "HKLM: SYSTEM \ CurrentControlSet \ Services \ Dfs \ Parameters" `
    -Type Registry `
    -ErrorAction SilentlyContinue
Новый элемент `
    -Path "HKLM: SYSTEM \ CurrentControlSet \ Services \ Dfs \ Parameters \ Replicated" `
    -Type Registry `
    -ErrorAction SilentlyContinue
Set-ItemProperty `
    -Path "HKLM: SYSTEM \ CurrentControlSet \ Services \ Dfs \ Parameters \ Replicated" `
    -Name "ServerConsolidationRetry" `
    -Значение 1
  

Создание записей DNS для существующих имен файловых серверов

Чтобы пространства имен DFS реагировали на существующие имена файловых серверов, создайте записи псевдонимов (CNAME) для существующих файловых серверов, которые указывают на имя сервера пространств имен DFS.Точная процедура обновления записей DNS может зависеть от того, какие серверы использует ваша организация, и от того, использует ли ваша организация специальные инструменты для автоматизации управления DNS. Следующие шаги показаны для DNS-сервера, входящего в состав Windows Server и автоматически используемого Windows AD.

На DNS-сервере Windows откройте консоль управления DNS. Его можно найти, нажав кнопку Start и набрав DNS . Перейдите в зону прямого просмотра для своего домена.Например, если ваш домен — contoso.com , зону прямого просмотра можно найти в разделе Зоны прямого просмотра > contoso.com в консоли управления. Точная иерархия, показанная в этом диалоговом окне, будет зависеть от конфигурации DNS для вашей сети.

Щелкните правой кнопкой мыши зону прямого просмотра и выберите Новый псевдоним (CNAME) . В появившемся диалоговом окне введите короткое имя для заменяемого файлового сервера (полное доменное имя будет автоматически заполнено в текстовом поле Полное доменное имя ).В текстовом поле с надписью Полное доменное имя (FQDN) для целевого хоста введите имя сервера DFS-N, который вы настроили. Вы можете использовать кнопку Browse , чтобы при желании выбрать сервер. Выберите OK , чтобы создать запись CNAME для вашего сервера.

На DNS-сервере Windows откройте сеанс PowerShell (или используйте удаленное взаимодействие PowerShell) для выполнения следующих команд, заполнив $ oldServer и $ dfsnServer соответствующими значениями для вашей среды ( $ domain заполнит автоматически с доменным именем, но вы также можете ввести его вручную).

  # Переменные
$ oldServer = "MyServer"
$ domain = Get-CimInstance -ClassName "Win32_ComputerSystem" | `
    Select-Object -ExpandProperty Domain
$ dfsnServer = "CloudDFSN. $ домен"

# Создать запись CNAME
Импорт-Модуль-Имя DnsServer
Add-DnsServerResourceRecordCName `
    -Название $ oldServer `
    -HostNameAlias ​​$ dfsnServer `
    -ZoneName $ домен
  

Создать пространство имен

Основной единицей управления пространствами имен DFS является пространство имен. Корень или имя пространства имен является начальной точкой пространства имен, например, в UNC-пути \ contoso.com \ Public \ , корень пространства имен — Public .

Если вы используете пространства имен DFS для захвата существующего имени сервера с корневой консолидацией, имя пространства имен должно быть именем сервера, который вы хотите взять на себя, с добавлением символа # в начале. Например, если вы хотите взять на себя управление существующим сервером с именем MyServer , вы должны создать пространство имен DFS-N с именем #MyServer . Раздел PowerShell ниже заботится о добавлении # к началу, но если вы создаете через консоль управления DFS, вам нужно будет добавить соответствующий.

Чтобы создать новое пространство имен, откройте консоль DFS Management . Это можно найти, нажав кнопку Start и набрав DFS Management . Получившаяся консоль управления имеет две секции Namespaces и Replication , которые относятся к пространствам имен DFS и репликации DFS (DFS-R) соответственно. Синхронизация файлов Azure предоставляет современный механизм репликации и синхронизации, который можно использовать вместо DFS-R, если репликация также требуется.

Выберите раздел Namespaces и нажмите кнопку New Namespace (вы также можете щелкнуть правой кнопкой мыши раздел Namespaces ). Получившийся Мастер создания нового пространства имен проведет вас через создание пространства имен.

В первом разделе мастера необходимо выбрать сервер пространства имен DFS для размещения пространства имен. Пространство имен может размещаться на нескольких серверах, но вам нужно будет настроить пространства имен DFS с одним сервером за раз. Введите имя желаемого сервера пространства имен DFS и выберите Next .В разделе Namespace Name and Settings вы можете ввести желаемое имя вашего пространства имен и выбрать Next .

Раздел Namespace Type позволяет вам выбирать между пространством имен на основе домена и автономным пространством имен . Если вы собираетесь использовать пространства имен DFS для сохранения имени существующего файлового сервера / устройства NAS, вам следует выбрать параметр автономного пространства имен. Для любых других сценариев следует выбрать пространство имен на основе домена.Обратитесь к типам пространств имен выше для получения дополнительной информации о выборе между типами пространств имен.

Выберите требуемый тип пространства имен для вашей среды и выберите Next . Затем мастер резюмирует создаваемое пространство имен. Выберите Create , чтобы создать пространство имен, и Close , когда диалоговое окно завершится.

В сеансе PowerShell на сервере пространства имен DFS выполните следующие команды PowerShell, заполнив $ namespace , $ type и $ takeOverName соответствующими значениями для вашей среды.

  # Переменные
$ namespace = "Общедоступный"
$ type = "DomainV2" # "Автономный"
$ takeOverName = $ false # $ true

$ namespace = if ($ takeOverName -and $ type -eq "Standalone" -and $ namespace [0] -ne "#") {
    "# $ пространство имен"
} else {$ namespace}
$ dfsnServer = $ env: имя компьютера
$ namespaceServer = if ($ type -eq "DomainV2") {
    Get-CimInstance -ClassName «Win32_ComputerSystem» | `
    Select-Object -ExpandProperty Domain
} else {$ dfsnServer}

# Создать общий ресурс для пространства имен DFS-N
$ smbShare = "C: \ DFSRoots \ $ namespace"
if (! (Test-Path -Path $ smbShare)) {New-Item -Path $ smbShare -ItemType Directory}
New-SmbShare -Name $ namespace -Path $ smbShare -FullAccess Все

# Создать пространство имен DFS-N
Импорт-Модуль-Имя DFSN
$ namespacePath = "\\ $ namespaceServer \ $ namespace"
$ targetPath = "\\ $ dfsnServer \ $ пространство имен"
New-DfsnRoot -Path $ namespacePath -TargetPath $ targetPath -Type $ type
  

Настроить папки и целевые папки

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

Папки пространств имен DFS можно рассматривать как аналог общих файловых ресурсов.

В консоли управления DFS выберите только что созданное пространство имен и выберите Новая папка .В открывшемся диалоговом окне New Folder вы сможете создать как папку, так и ее цели.

В текстовом поле Имя введите имя папки. Выберите Добавить … , чтобы добавить целевые папки для этой папки. В открывшемся диалоговом окне Add Folder Target появится текстовое поле с надписью Path to folder target , где вы можете указать UNC-путь к желаемой папке. Выберите OK в диалоговом окне Добавить папку .Если вы добавляете UNC-путь к общей папке Azure, вы можете получить сообщение о том, что сервер storageaccount.file.core.windows.net не может быть контактами. Это ожидается; выберите Да , чтобы продолжить. Наконец, выберите OK в диалоговом окне New Folder , чтобы создать целевые папки и папки.

  # Переменные
$ shareName = "MyShare"
$ targetUNC = "\\ storageaccount.file.core.windows.net \ myshare"

# Создание целевых папок и папок
$ sharePath = "$ namespacePath \ $ shareName"
New-DfsnFolder -Path $ sharePath -TargetPath $ targetUNC
  

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

См. Также

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

Настроить

Во-первых, вам нужно настроить 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 содержит единственную строку

  тест.jpg
  

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

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

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

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

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

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

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

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

Это относится к каталогу путь / к / каталогу на удаленном компьютере : , как определено в файл конфигурации (настроен с помощью 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 / путь / к / директории до / tmp / директории .

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

Чтобы скопировать файлы и каталоги с example.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:
  

Обратите внимание, что строка подключения влияет только на параметры непосредственного бэкэнд. Если, например, gdriveCrypt — это крипта, основанная на gdrive, то следующая команда не будет работать должным образом, потому что shared_with_me игнорируется серверной частью крипты:

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

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

  удаленный, параметр = значение, параметр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" удаленный: резервное копирование
  

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

Windows

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

  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 . Команда переместить также могут использовать их, если удаленный сервер не поддерживает перемещение на стороне сервера напрямую.Это делается путем выдачи копии на стороне сервера, а затем удаления, что значительно быстрее, чем загрузка и повторная загрузка.

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

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

  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 м». Действительный единицы времени: «нс», «нас» (или «мкс»), «мс», «с», «м», «ч».

Параметры, которые используют РАЗМЕР, по умолчанию используют KiByte (кратное 1024 байтам). Однако суффикс B для байта, K для KiByte, M для MiByte, Можно использовать G для GiByte, T для TiByte и P для PiByte.Эти двоичные единицы, например 1, 2 ** 10, 2 ** 20, 2 ** 30 соответственно.

—backup-dir = DIR

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

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

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

Например,

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

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

Если вы запускаете 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, укажите желаемую пропускную способность в KiByte / s или используйте суффикс B | K | M | G | T | P. По умолчанию 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, останется без ограничений.

Пример расписания с ДЕНЬ НЕДЕЛИ может быть:

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

Это означает, что пропускная способность будет установлена ​​на 512 KiByte / s на Понедельник. К концу пятницы он вырастет до 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.

— первый чек

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

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

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

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

— чекеры = N

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

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

-c, —checksum

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

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

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

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

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

—compare-dest = DIR

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

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

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

—config = CONFIG_FILE

Укажите расположение файла конфигурации rclone, чтобы переопределить по умолчанию.Например. конфигурация rclone --config = "rclone.conf" .

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

• % APPDATA% / rclone / rclone.conf в Windows
• ~ / .config / rclone / rclone.conf на другом

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

1. rclone.conf (в каталоге программы, где находится исполняемый файл rclone)
2. % APPDATA% / rclone / rclone.conf (только в Windows)
3. $ XDG_CONFIG_HOME / rclone / rclone.conf (во всех системах, включая Windows)
4. ~ / .config / rclone / rclone.conf (объяснение символа ~ см. Ниже)
5. ~ / .rclone.conf

Если существующий файл конфигурации не найден, будет создан новый. по адресу:

• В Windows: Местоположение 2, указанное выше, за исключением маловероятного случая что APPDATA не определен, вместо этого используется местоположение 4.
• В Unix: расположение 3, если определено XDG_CONFIG_HOME , в противном случае расположение 4.
• Возврат к местоположению 5 (во всех ОС), когда каталог rclone не может быть создан, но если домашний каталог не найден, тогда путь .rclone.conf относительно текущего рабочего каталога будет использоваться как последнее средство.

Символы ~ в приведенных выше путях представляют домашний каталог текущего пользователя. на любой ОС, а значение определяется следующим образом:

• В Windows: % HOME% , если определено, иначе % USERPROFILE% , иначе % HOMEDRIVE% \% HOMEPATH% .
• В Unix: $ HOME , если определено, иначе поиск текущего пользователя в пользовательской базе данных ОС (например, файл passwd) или используйте результат команды оболочки cd && pwd .

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

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

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

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

Пример:

  [мегапередатчик]
тип = мега
user = [email protected]
pass = PDPcQVVjVtzFY-GTdDFozqBhTdsPg3qH
  

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

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

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

—contimeout = ВРЕМЯ

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

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

—copy-dest = DIR

При использовании sync , copy или move 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
  

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

Этот параметр не работает в Windows (см. Golang / go # 42728).

-n, —dry-run

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

—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 и если это установлено to 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-раз

Использование этой опции заставит 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 или ! .
• s : Пропустить все следующие операции этого типа, не более вопросов. Это действует до выхода из rclone. Если есть вам будут предложены различные виды операций.
• ! : Выполнить все следующих операций, не более вопросов. Полезно, если вы решили, что не против делать rclone. такая операция. Это действует до выхода из rclone. Если вам будет предложено выполнить какие-либо операции их.
• q : Закройте rclone сейчас, на всякий случай!

— оставить корень

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

—log-file = ФАЙЛ

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

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

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

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

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

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

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

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

ИНФОРМАЦИЯ эквивалентна -v .Выводит информацию о каждой передаче и по умолчанию печатает статистику раз в минуту.

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

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

—use-json-log

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

— повторные попытки низкого уровня НОМЕР

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

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

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

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

—max-backlog = N

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

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

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

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

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

—max-delete = N

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

— макс-глубина = 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, это будет 1s по умолчанию.

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

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

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

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

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

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

Это будет работать с sync / copy / move командами и друзьями 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 .

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

• 0..250 файлов MiB будут загружены с 1 потоком
• 250.Файлы .500 MiB будут загружены с 2 потоками
• 500..750 файлов MiB будут загружены с 3 потоками
• 750+ файлов MiB будут загружены с 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 определяет, будет ли файловая система назначения выполняется при использовании команд copy или move . --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% самый большой. Нити, которые занимают в первую очередь самые маленькие, всегда будут занимать самая маленькая первая и также самая большая первая нитка. смешанный режим может быть полезен для минимизации времени передачи, когда вы передача смеси больших и маленьких файлов — большие файлы гарантированные потоки загрузки и пропускная способность, а небольшие файлы будут обрабатывается непрерывно.

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

Например,

• - упорядочить по размеру, desc — сначала отправлять самые большие файлы
• --order-by modtime, ascending — сначала отправлять самые старые файлы
• - упорядочить по имени — отправить файлы в алфавитном порядке по пути сначала

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

Ограничения

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

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

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

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

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

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

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

Например,

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

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

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

-П, —прогресс

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

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

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

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

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

—progress-terminal-title

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

-q, — тихий

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

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

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

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

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

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

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

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

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

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

— повторяет 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 будет обрезать имена файлов и пути длиннее более 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 -

— статистика-однострочный-формат-даты

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

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

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

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

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

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

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

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

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

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

Используется с файлами для добавления суффикса в текущий каталог. или с --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 установка этого параметра приводит к тому, что 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 syslog для списка возможных средств. По умолчанию объект 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 if --track-renames-strategy включает хэш .

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

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

—track-renames-strategy (хэш, время модификации, лист, размер)

Этот параметр изменяет критерии соответствия для --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 должен загрузить весь листинг в память.
• It может быть быстрее, потому что он использует меньше транзакций
• Это может быть медленнее, потому что не может быть распараллелено

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

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

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

— тайм-аут = ВРЕМЯ

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

По умолчанию 5 м . Установите значение 0 , чтобы отключить.

—transfers = N

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

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

-u, —update

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

Это может быть полезно при передаче на удаленный компьютер, который не поддерживает время модификации напрямую (или при использовании --use-server-modtime , чтобы избежать лишних Вызовы API), поскольку он более точен, чем проверка --size-only и быстрее чем при использовании --checksum .

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

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

На пультах, которые не поддерживают время модификации напрямую (или при использовании --use-server-modtime ) проверенное время будет временем загрузки. Это означает, что при загрузке на один из этих пультов rclone пропустит любые файлы, которые существуют в месте назначения и время загрузки, которое новее, чем время модификации исходного файла.

—use-mmap

Если этот флаг установлен, то rclone будет использовать анонимную память, выделенную mmap на платформах на базе Unix и VirtualAlloc на Windows для своих буферы передачи (размер контролируется параметром --buffer-size ). объем памяти выделенный таким образом, не попадает в кучу Go и может быть возвращен в ОС сразу после завершения работы.

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

Возможно, это не работает на всех платформах, поэтому по умолчанию отключено; в будущем он может быть включен по умолчанию.

—use-server-modtime

Некоторые серверные части хранилища объектов (например, Swift, S3) не сохраняют модификацию файлов. раз (время мод.). На этих серверах rclone сохраняет исходное время мода как дополнительные метаданные об объекте. По умолчанию он будет вызывать API к получать метаданные, когда для операции требуется время модификации.

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

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

-v, -vv, —verbose

С -v rclone расскажет вам о каждом переданном файле и небольшое количество значимых событий.

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

-V, —версия

Печатает номер версии

Опции SSL / TLS

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

— строка CA-Cert

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

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

— строка сертификата клиента

Загружает сертификат на стороне клиента, закодированный в формате PEM.

Используется для взаимной аутентификации TLS.

Флаг --client-key также необходим при его использовании.

— строка ключа клиента

Загружает закрытый ключ на стороне клиента в кодировке PEM, используемый для взаимного TLS. аутентификация. Используется вместе с --client-cert .

—no-check-certificate = истина / ложь

--no-check-certificate контролирует, проверяет ли клиент цепочка сертификатов сервера и имя хоста. Если --no-check-certificate истинно, TLS принимает любой сертификат представлен сервером и любым именем хоста в этом сертификате.В этом режиме TLS уязвим для атак типа «злоумышленник в середине».

По умолчанию для этого параметра установлено значение false .

Следует использовать только для тестирования.

Шифрование конфигурации

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

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

Чтобы добавить пароль к вашей конфигурации rclone, выполните rclone config .

 > Конфигурация rclone
Текущие пульты:

д) Редактировать существующий пульт
n) Новый пульт
г) Удалить удаленный
s) Установить пароль конфигурации
q) Выйти из конфигурации
э / н / д / с / д>
  

Войдите в s , установите пароль конфигурации:

  e / n / d / s / q> s
Ваша конфигурация не зашифрована.
Если вы добавите пароль, вы защитите свои данные для входа в облачные сервисы.а) Добавить пароль
q) Выход в главное меню
а / д> а
Введите НОВЫЙ пароль конфигурации:
пароль:
Подтвердите новый пароль:
пароль:
Пароль установлен
Ваша конфигурация зашифрована.
в) Изменить пароль
u) Незашифрованная конфигурация
q) Выход в главное меню
c / u / q>
  

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

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

rclone использует секретный ящик nacl который, в свою очередь, использует XSalsa20 и Poly1305 для шифрования и аутентификации ваша конфигурация с криптографией с секретным ключом. Пароль — хешированный SHA-256, который дает ключ для секретного ящика. Хешированный пароль не сохраняется.

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

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

Вы можете установить это для сеанса из сценария. Для unix-подобных систем сохраните это в файл с именем set-rclone-password :

  #! / Bin / echo Источник этого файла не запускать

читает -s RCLONE_CONFIG_PASS
экспорт RCLONE_CONFIG_PASS
  

Затем создайте файл, когда хотите его использовать. Из оболочки ты будет делать source set-rclone-password . Затем он попросит вас ввести пароль и установите его в переменной окружения.

Альтернативным способом ввода пароля является предоставление сценария. который получит пароль и распечатает его на стандартный вывод.Этот сценарий должен иметь полностью указанный путь и не полагаться на какие-либо переменные среды. Скрипт поставляется либо через --password-command = "..." аргумент командной строки или через RCLONE_PASSWORD_COMMAND переменная среды.

Одним из полезных примеров этого является использование приложения для хранилища паролей . для получения пароля:

  экспорт RCLONE_PASSWORD_COMMAND = "передать rclone / config"
  

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

Если вы запускаете rclone внутри сценария, если вы не используете --password-command , вы можете отключить запрос пароля. Для этого передайте параметр --ask-password = false для rclone.Вместо этого rclone выйдет из строя запроса пароля, если RCLONE_CONFIG_PASS не содержит действительный пароль, а --password-command не был предоставлен.

При выполнении команд, на которые могут повлиять параметры в файл конфигурации, rclone будет искать существующий файл в соответствии с по правилам, описанным выше, и загрузите любой находит. Если зашифрованный файл найден, это включает его расшифровку, с возможным последствием запроса пароля. При выполнении командная строка, которая, как вы знаете, на самом деле ничего не использует из таких файл конфигурации, вы можете избежать его загрузки, переопределив расположение, д.грамм. с одним из задокументированных специальных значений для конфигурация только с памятью. Поскольку могут быть сохранены только параметры бэкенда в файлах конфигурации это обычно не требуется для команд которые не работают на бэкэндах, например генавтозаполнение . Тем не мение, это будет актуально для команд, которые работают с бэкэндами в общие, но используются без ссылки на сохраненный пульт, например перечисление путей локальной файловой системы, или строки подключения: rclone --config = "" ls.

Параметры разработчика

Эти параметры полезны при разработке или отладке rclone.Там также есть несколько более удаленных конкретных параметров, которые не задокументированы вот которые используются для тестирования. Они начинаются с удаленного имени, например. --drive-test-option — см. Документацию по рассматриваемому пульту.

—cpuprofile = ФАЙЛ

Записать профиль ЦП в файл. Это можно проанализировать с помощью инструмента go pprof .

— сбросить флаг, флаг, флаг

Флаг --dump принимает список флагов, разделенных запятыми, для вывода информации о.

Обратите внимание, что некоторые заголовки, включая Accept-Encoding , как показано, могут не быть правильным в запросе, и ответ может не отображать Content-Encoding если действовало автоматическое кодирование gzip стандартных библиотек go.В этом случае текст запроса будет заархивирован перед его показом.

Доступные флаги:

Дампить заголовки HTTP с авторизацией : строки удалены. Может еще содержат конфиденциальную информацию. Может быть очень многословным. Полезно для отладки Только.

Используйте --dump auth , если вам нужны заголовки Authorization: .

— кузова самосвальные

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

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

— запросы дампа

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

— сбросить ответы

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

— авторизация дампа

Заголовки дампа HTTP — будут содержать конфиденциальную информацию, такую ​​как Авторизация: заголовки — используйте - заголовки дампа для сброса без Авторизация: заголовка.Может быть очень многословным. Полезно для отладки Только.

— сливные фильтры

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

— сбросить горутины

Это выводит список запущенных подпрограмм в конце команды на стандартный вывод.

— дамп открытых файлов

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

—memprofile = ФАЙЛ

Записать профиль памяти в файл. Это можно проанализировать с помощью инструмента go pprof .

Фильтрация

Для опций фильтрации

• - исключить удаление
• - фильтр
• --фильтр-из
• - исключить
• - исключить из
• - включая
• - включить - из
• - файлы - из
• - файлы из сырых
• - минимальный размер
• - макс. Размер
• - возраст
• - максимальный возраст
• - сливные фильтры

См. Раздел фильтрации.

Пульт дистанционного управления

Для опций дистанционного управления и инструкций по удаленному управлению rclone

• -RC
• и все, что начинается с --rc-

См. Раздел о дистанционном управлении.

Лесозаготовки

rclone имеет 4 уровня ведения журнала, ОШИБКА , УВЕДОМЛЕНИЕ , ИНФОРМАЦИЯ и ОТЛАДКА .

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

По умолчанию rclone будет выдавать сообщения уровня Error и Notice .

Если вы используете флаг -q , rclone будет выдавать только сообщения об ошибке .

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

Если вы используете флаг -vv , rclone выдаст ошибку Error , Notice , Информация и Сообщения отладки .

Вы также можете управлять уровнями журнала с помощью флага --log-level .

Если вы используете параметр --log-file = FILE , rclone перенаправит ошибку , Информация и Отладка сообщений вместе со стандартной ошибкой в ​​ФАЙЛ.

Если вы используете флаг --syslog , то rclone войдет в системный журнал, а --syslog-feature контролирует, какое средство оно использует.

Rclone ставит перед всеми сообщениями журнала их уровень заглавными буквами, например.грамм. ИНФОРМАЦИЯ что упрощает поиск в файле журнала различных типов Информация.

Код выхода

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

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

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

Список кодов выхода

• 0 — успех
• 1 — Синтаксическая ошибка или ошибка использования
• 2 — Ошибка без другой категории
• 3 — Справочник не найден
• 4 — Файл не найден
• 5 — Временная ошибка (которую можно исправить несколькими повторными попытками) (ошибки повторных попыток)
• 6 — Менее серьезные ошибки (например, 461 ошибка из Dropbox) (ошибки NoRetry)
• 7 — Неустранимая ошибка (ошибка, которую нельзя исправить несколькими повторными попытками, например, приостановка учетной записи) (Неустранимые ошибки)
• 8 — Передача превышена — достигнут предел, установленный параметром —max-transfer
• 9 — Операция прошла успешно, но файлы не переданы

Переменные среды

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

Опции

Каждая опция в rclone может иметь значение по умолчанию, установленное средой Переменная.

Чтобы найти имя переменной среды, сначала возьмите длинный имя опции, убрать ведущие - , изменить - на _ , сделать верхний регистр и добавить RCLONE_ .

Например, чтобы всегда устанавливать --stats 5s , установите переменную среды RCLONE_STATS = 5 с .Если вы установите статистику в командной строке, это будет переопределить настройку переменной среды.

Или всегда использовать мусор на диске --drive-use-trash , установите RCLONE_DRIVE_USE_TRASH = истина .

Тот же синтаксический анализатор используется для параметров и переменных среды. поэтому они принимают точно такую ​​же форму.

Параметры, установленные переменными среды, можно увидеть с помощью флага -vv , например версия rclone -vv .

Файл конфигурации

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

Чтобы найти имя переменной окружения, нужно установить, взять RCLONE_CONFIG_ + имя удаленного + _ + имя параметра файла конфигурации и сделайте все прописными.

Например, для настройки удаленного S3 с именем mys3: без конфигурации файл (с использованием unix-способов установки переменных среды):

  $ экспорт RCLONE_CONFIG_MYS3_TYPE = s3
$ экспорт RCLONE_CONFIG_MYS3_ACCESS_KEY_ID = XXX
$ экспорт RCLONE_CONFIG_MYS3_SECRET_ACCESS_KEY = XXX
$ rclone lsd MYS3:
          -1 2016-09-21 12:54:21 -1 my-bucket
$ rclone listremotes | grep mys3
mys3:
  

Обратите внимание, что если вы хотите создать удаленный компьютер с использованием переменных среды вы должны создать ..._ Переменная TYPE , как указано выше.

Обратите внимание, что вы можете установить параметры только для непосредственного бэкэнда, поэтому RCLONE_CONFIG_MYS3CRYPT_ACCESS_KEY_ID не имеет никакого эффекта, если myS3Crypt криптографический пульт на основе пульта S3. Однако RCLONE_S3_ACCESS_KEY_ID будет установить ключ доступа для всех пультов, использующих S3, включая myS3Crypt.

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

  rclone lsd: s3, access_key_id = XXX, secret_access_key = XXX:
  

Приоритет

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

• Параметры в строках подключения, например myRemote, skip_links:
• Значения флагов, указанные в командной строке, например - пропускные ссылки
• Удаленные переменные среды, например RCLONE_CONFIG_MYREMOTE_SKIP_LINKS (см. Выше).
• Переменные среды, специфичные для серверной части, например RCLONE_LOCAL_SKIP_LINKS .
• Вары общей среды бэкэнда, например RCLONE_SKIP_LINKS .
• Файл конфигурации, e.грамм. skip_links = true .
• Значения по умолчанию, например false — изменить нельзя.

Итак, если оба параметра --skip-links указаны в командной строке и переменная окружения RCLONE_LOCAL_SKIP_LINKS установлена, командная строка флаг будет иметь предпочтение.

Конфигурации серверной части, установленные переменными среды, можно увидеть с помощью флага -vv , например rclone о myRemote: -vv .

Для конфигурации без серверной части порядок следующий:

• Значения флагов, указанные в командной строке, e.грамм. - статистика 5s .
• Вары среды, например RCLONE_STATS = 5 с .
• Значения по умолчанию, например 1м — изменить нельзя.

Другие переменные среды

• RCLONE_CONFIG_PASS , в котором содержится пароль вашего файла конфигурации (см. Раздел «Шифрование конфигурации»).
• HTTP_PROXY , HTTPS_PROXY и NO_PROXY (или их версии в нижнем регистре).
  • HTTPS_PROXY имеет приоритет над HTTP_PROXY для запросов https.
  • Значения среды могут быть либо полным URL, либо «host [: port]» для, в этом случае предполагается схема «http».
• USER и LOGNAME Значения используются как резервные для текущего имени пользователя. Основной метод поиска имени пользователя зависит от ОС: Windows API в Windows, реальный идентификатор пользователя в / etc / passwd в системах Unix. В документации текущее имя пользователя просто упоминается как $ USER .
• RCLONE_CONFIG_DIR — rclone устанавливает этой переменной для использования в файлах конфигурации и подпроцессах, чтобы она указывала на каталог, содержащий файл конфигурации.

  No related posts.