mbsync - Интернет в облаке

ПРОГРАММА:

ИМЯ

mbsync - синхронизировать почтовые ящики IMAP4 и Maildir

СИНТАКСИС

мбсинк [кредита ...] {{канал[:ящик[{,|\n} ...]] |группы} ... |-a}

ОПИСАНИЕ

мбсинк это приложение командной строки, которое синхронизирует почтовые ящики; в настоящее время Maildir и
Поддерживаются почтовые ящики IMAP4. Новые сообщения, удаления сообщений и изменение флагов могут быть
размножается в обе стороны; набор операций можно выбрать детально.
Синхронизация основана на уникальных идентификаторах сообщений (UID), поэтому идентификация отсутствует.
могут возникать конфликты (в отличие от некоторых других синхронизаторов почты). OTOH, мбсинк is
подвержены изменениям достоверности UID (что должен никогда не бывает, но см. «Совместимость» в
README). Состояние синхронизации хранится в одном локальном текстовом файле для каждой пары почтовых ящиков;
можно поддерживать несколько реплик почтового ящика.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-c, --config файл
Прочитать конфигурацию из файл. По умолчанию конфигурация считывается из
~ / .mbsyncrc.

-a, --все
Выберите все настроенные каналы. Любые характеристики канала / группы в команде
строки игнорируются.

-l, --список
Ничего не синхронизировать, а перечислить все почтовые ящики в выбранных каналах и
Выход.

-C[m][s], --Создайте[-мастер|-раб]
Отменить любой Создавай параметры из файла конфигурации. См. ниже.

-X[m][s], --выпустить[-мастер|-раб]
Отменить любой Удалить параметры из файла конфигурации. См. ниже.

{-n|-N|-d|-f|-0|-F}, {--новый|- возобновить|--удалять|--флаги|--нуп|--полный}
{-L|-H}[n][N][d][f], {--тянуть|--толкать}[-новый|-обновление|-удалять|-флаги]

Отменить любой Синхронизация параметры из файла конфигурации. См. ниже.

-h, --Помогите
Отобразите сводку параметров командной строки.

-v, --версия
Показать информацию о версии.

-V, --подробный
Включите подробный режим, в котором отображается сетевой трафик IMAP4.

-D, --отлаживать
Разрешить печать отлаживать Информация.

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

КОНФИГУРАЦИЯ

Файл конфигурации является обязательным; мбсинк без него не работать. Строки, начинающиеся с
знак решетки (#) являются комментариями и полностью игнорируются. Элементы конфигурации - это ключевые слова
за которым следует один или несколько аргументов; аргументы, содержащие пробелы, должны быть заключены в двойные
цитаты ("), а также буквальные двойные кавычки и обратные косые черты (\) должен быть экранирован обратной косой чертой. Все
ключевые слова (включая те, которые используются в качестве аргументов) нечувствительны к регистру. Баш-подобный дом
расширение каталога с помощью тильды (~) поддерживается во всех опциях, которые представляют локальный
пути. Есть несколько глобальных опций, остальные относятся к конкретным разделам. Разделы
начинаются ключевым словом section и заканчиваются пустой строкой или концом файла.
Каждый раздел определяет объект с идентификатором, уникальным в пределах этого класса объектов.

Существует два основных класса объектов: магазины и каналы. Магазин определяет коллекцию
почтовые ящики; в основном это папка, локальная или удаленная. Канал соединяет два магазина,
описывая способ их синхронизации.
Есть два вспомогательных класса объектов: Учетные записи и Группы. Учетная запись описывает
часть подключения к удаленным магазинам, поэтому подключение к серверу может быть разделено между несколькими
Магазины. Группа объединяет несколько каналов, чтобы не вводить текст в командной строке.

Расположение файловой системы (в частности, Path и Входящие) используйте внутренний путь Магазина
разделители, которые могут быть косой чертой, точкой и т. д. или даже их комбинациями.
Имена почтовых ящиков, OTOH, всегда используют канонические разделители путей, которые являются Unix-подобными пересылками.
косые черты.

Все Магазины
Эти параметры можно использовать во всех поддерживаемых типах Магазина.
В этом контексте термин «удаленный» описывает второе хранилище в канале, а не
обязательно удаленный сервер.
Специальный почтовый ящик INBOX есть в каждом магазине; его физическое расположение в файловой системе
зависит от типа магазина.

Path путь
Расположение Магазина в файловой системе (сервера). Если это не абсолют
путь, точка отсчета зависит от типа магазина. Эта строка добавляется к
имена почтовых ящиков, адресованные в этом Магазине, но не считающиеся их частью; это
важно для Шаблоны в разделе "Каналы". Обратите внимание, что вы должен добавить косую черту
если вы хотите указать весь каталог. (По умолчанию: нет)

Максимальный размер размер[k|m][b]
Сообщения большего размера не будут переданы в этот Магазин. Это полезно
для отсеивания сообщений с большими вложениями. K и M можно добавить к
размер, чтобы указать KiBytes соотв. MeBytes вместо байтов. B принято, но
лишнее. Если размер 0, максимальный размер сообщения Неограниченный. (Дефолт: 0)

КартаВходящие почтовый ящик
Создайте виртуальный почтовый ящик (относительно Path), который является псевдонимом INBOX. Имеет смысл в
в сочетании с Шаблоны в разделе "Каналы", хотя с подчиненным Maildir вы
наверное хочу разместить Входящие под Path вместо. Этот виртуальный почтовый ящик не
поддержка подпапок.

расплющить DELIM
Сгладьте иерархию в этом Магазине, заменив каноническую иерархию
ограничитель / DELIM. Это может быть полезно, когда MUA используется для доступа к Магазину
обеспечивает неоптимальную обработку иерархических почтовых ящиков, как в случае с собачонка.
Обычно в качестве разделителя выбирают ..
Обратите внимание, что сглаженные подпапки INBOX всегда в конечном итоге под Pathв том числе
"ВХОДЯЩИЕ"DELIM" приставка.

Корзину почтовый ящик
Определяет почтовый ящик (относительно Path), чтобы скопировать удаленные сообщения в до
удаление. Видеть РЕКОМЕНДАЦИИ и ВНУТРЕННИЙ ПРОБЛЕМЫ ниже. (По умолчанию: нет)

TrashNewOnly Да|нет
При удалении копируйте только еще не распространенные сообщения. Это имеет смысл, если
удаленный магазин имеет Корзину а также (с TrashNewOnly нет). (Дефолт: нет)

TrashRemoteНовый Да|нет
При удалении удаленного Магазина копируйте еще не распространенные сообщения в этот Магазин.
Корзину. При использовании этого удаленного магазина не требуется собственный Корзину вообще, но все
сообщения архивируются. (Дефолт: нет)

Maildir Магазины
Ориентир для относительной Paths - текущий рабочий каталог.

As мбсинк требуются UID, но для Maildir не существует стандартизированной схемы хранения UID, мбсинк
поддерживает две схемы, каждая со своими плюсами и минусами.
Ассоциация родной Схема украдена из последних патчей Maildir в c-клиент и поэтому
совместим с сосновый. Срок действия UID хранится в файле с именем .uidvalidity; UID
закодированы в именах файлов сообщений.
Ассоциация альтернатива Схема основана на отображении UID, используемом исинхронный версии 0.8 и 0.9.x.
Инвариантные части имен файлов сообщений используются как ключи в Беркли.
база данных с именем .isyncuidmap.db, в которой также хранится действительность UID.
Ассоциация родной схема более быстрая, более экономичная, независимая от порядка байтов и "человеческая"
читается ", но будет прервано, если сообщение будет скопировано из другого почтового ящика без
получение нового имени файла; это рано или поздно приведет к дублированию UID, что в
Turn приводит к изменению достоверности UID, что приводит к сбою синхронизации. В альтернатива
схема потерпит неудачу, если MUA изменит имя файла сообщения в части мбсинк считает
инвариантный; это будет интерпретироваться как удаление сообщения и новое сообщение, что приведет к
лишний трафик.
собачонка как известно, отлично работает с обеими схемами.
Используйте mdconvert конвертировать почтовые ящики из одной схемы в другую.

MaildirStore имя
Определите хранилище Maildir имя, открыв раздел для его параметров.

Альтернативная карта Да|нет
Использовать альтернатива Схема хранения UID для почтовых ящиков в этом Магазине. Это не
влияют на почтовые ящики, у которых уже есть схема хранения UID; использовать mdconvert изменить
Это. (Дефолт: нет)

Входящие путь
Расположение INBOX. Это не относительно Path, но можно разместить
домен INBOX внутри Path. (Дефолт: ~ / Maildir)

IMAP4 Учетные записи
IMAPаккаунт имя
Определите учетную запись IMAP4 имя, открыв раздел для его параметров.

Хозяин кашель
Укажите DNS-имя или IP-адрес сервера IMAP.
If Тоннель используется, этот параметр используется только для проверки сертификата хоста SSL,
если предусмотрено.

порт порт
Укажите номер TCP-порта сервера IMAP. (По умолчанию: 143 для IMAP, 993 для
ИМАП)
If Тоннель используется, этот параметр игнорируется.

Информация о пользователе username
Укажите имя для входа на IMAP-сервер.

Проходить password
Укажите пароль для username на сервере IMAP. Обратите внимание, что эта опция НЕ
требуется. Если ни пароль, ни команда пароля не указаны в
конфигурационный файл, мбсинк запросит пароль.

PassCmd команду
Укажите команду оболочки для получения пароля вместо того, чтобы указывать пароль
напрямую. Это позволяет использовать файлы паролей и агентов. Команда должна
выводит ровно одну строку на стандартный вывод; завершающий символ новой строки не является обязательным.

Тоннель команду
Укажите команду для запуска, чтобы установить соединение, а не открывать TCP
разъем. Это позволяет, например, запускать сеанс IMAP через туннель SSH.
If ИспользоватьIMAPS отключен, и туннель открывает соединение с предварительной аутентификацией,
Требовать SSL тоже нужно отключать. Если соединение не проходит предварительную аутентификацию,
но туннель безопасен, отключение Требовать SSL и ИспользоватьTLSv1 Рекомендовано.

Требовать CRAM Да|нет
Если установлено на Да, мбсинк прервет соединение, если аутентификация CRAM-MD5 не
возможный. (Дефолт: нет)

ИспользоватьIMAPS Да|нет
Если установлено на Да, значение по умолчанию для порт изменяется на 993 и мбсинк запустит SSL
согласование сразу после установления соединения с сервером.
Обратите внимание, что современные серверы поддерживают SSL на обычном IMAP-порту 143 через STARTTLS.
extension, которое по умолчанию будет использоваться автоматически.

Требовать SSL Да|нет
мбсинк прервет соединение, если сеанс TLS / SSL не может быть установлен с
сервер IMAP. (Дефолт: Да)

СертификатФайл путь
Файл, содержащий дополнительные сертификаты X.509, используемые для проверки идентичности сервера.
Сертификаты с прямым сопоставлением одноранговых узлов всегда являются доверенными, независимо от их действительности.
Обратите внимание, что системное хранилище сертификатов по умолчанию всегда используется и не должно
указано здесь.

Использовать SSLv2 Да|нет
Использовать SSLv2 для связи с сервером IMAP через SSL?
Обратите внимание, что эта опция устарела по соображениям безопасности. (Дефолт: нет)

Использовать SSLv3 Да|нет
Использовать SSLv3 для связи с сервером IMAP через SSL? (Дефолт: нет)

ИспользоватьTLSv1 Да|нет
Использовать TLSv1 для связи с сервером IMAP через SSL? (Дефолт: Да)

ИспользоватьTLSv1.1 Да|нет
Использовать TLSv1.1 для связи с сервером IMAP через SSL? (Дефолт: нет)

ИспользоватьTLSv1.2 Да|нет
Использовать TLSv1.2 для связи с сервером IMAP через SSL? (Дефолт: нет)

ТрубопроводГлубина глубина
Максимальное количество команд IMAP, которые могут одновременно находиться в полете. Параметр
это для 1 отключает конвейерную обработку. Это в основном вариант только для отладки. (Дефолт:
Неограниченный)

IMAP Магазины
Ориентир для относительной Paths - это то, что хочет сервер; вероятно
$ HOME пользователя или $ HOME / Mail на этом сервере. Расположение INBOX зависит от сервера как
ну и обычно не имеет значения.

IMAPStore имя
Определите хранилище IMAP4 имя, открыв раздел для его параметров.

Учетная запись аккаунт
Укажите, какую учетную запись IMAP4 использовать. Вместо определения Учетной записи и ссылки
здесь, также можно указать все параметры учетной записи прямо в
Раздел Магазина - это имеет смысл, если Аккаунт в любом случае используется только для одного Магазина.

Использовать пространство имен Да|нет
Выбирает, следует ли к первому "личному" NAMESPACE сервера начинать с префикса
имена почтовых ящиков. Отключение этого имеет смысл для некоторых сломанных серверов IMAP. Этот
вариант не имеет смысла, если Path было указано. (Дефолт: Да)

Разделитель пути DELIM
Укажите разделитель иерархии сервера. (По умолчанию: берется с первого
"личный" NAMESPACE)
Do НЕ злоупотребляйте этим, чтобы переосмыслить иерархию. Использовать расплющить .

каналы
Канал имя
Определите канал имя, открыв раздел для его параметров.

{Master|Раб} :магазин:[почтовый ящик]
Укажите Мастера соотв. Подчиненное хранилище, которое будет подключено к этому каналу. Если Шаблоны
указаны, почтовый ящик интерпретируется как префикс, который не сопоставляется с
шаблоны, и на который не влияют переопределения списка почтовых ящиков. В противном случае, если
почтовый ящик опущен, INBOX предполагается.

шаблон[s] [!]описания ...
Вместо синхронизации только одной пары почтовых ящиков синхронизируйте все почтовые ящики, которые
соответствовать описания(s). Имена почтовых ящиков одинаковы как на главном, так и на подчиненном устройстве.
Шаблоны - это шаблоны IMAP4, т. Е. * соответствует чему угодно и % совпадает с чем угодно до
следующий разделитель иерархии. Подготовка ! к шаблону делает его исключением.
Можно указать несколько шаблонов (либо путем предоставления нескольких аргументов, либо с помощью
через шаблон многократно); более поздние матчи имеют приоритет.
Обратите внимание, что INBOX не соответствует подстановочным знакам, если он не находится под Path.
Список почтовых ящиков, выбранный Шаблоны может быть переопределено списком почтовых ящиков в
ссылка на канал ( группы спецификацию или командную строку).
Пример: "Шаблоны % !Мусор"

Максимальный размер размер[k|m][b]
Аналогично одноименной опции в разделе «Магазины», но в равной степени применяется к
Хозяин и раб. Обратите внимание, что это фактически изменяет магазины, поэтому будьте осторожны, чтобы
предоставить конфликтующие настройки, если вы используете магазины на нескольких каналах.

Макс. сообщений считать
Устанавливает максимальное количество сообщений для хранения в каждом почтовом ящике Slave. Это полезно
для почтовых ящиков, где вы храните полный архив на сервере, но хотите зеркалировать
только последние сообщения (например, для списков рассылки). Сообщения, которые были
первым поступившим в почтовый ящик (независимо от фактической даты
сообщение) будет удалено первым. Сообщения, помеченные (помеченные как важные)
и (по умолчанию) непрочитанные сообщения не удаляются автоматически. Если считать это 0,
максимальное количество сообщений Неограниченный (Дефолт: 0).

Срок действия непрочитан Да|нет
Выбирает, будут ли на непрочитанные сообщения влиять Макс. сообщений. Как обычно,
непрочитанные сообщения считаются важными, и поэтому срок их действия не истекает. Это гарантирует, что
вы никогда не пропустите новые сообщения даже после длительного отсутствия. Однако если ваш
архив содержит большое количество непрочитанных сообщений, поэтому они рассматриваются как
важно было бы практически победить Макс. сообщений. В этом случае вам нужно включить
этот вариант. (Дефолт: нет).

Синхронизация {Ничто|[Потянуть] [Push] [Новые] [Обновить] [Удалить] [Флаги]|Все}
Выберите операции синхронизации, которые необходимо выполнить:
Потянуть - распространять изменения от Master к Slave.
Push - распространять изменения от Slave к Master.
Новые - распространять вновь появившиеся сообщения.
Обновить - ранее отклоненные сообщения повторно оцениваются для распространения. Полезно после
отметка затронутых сообщений в исходном хранилище или увеличение MaxSize в
Магазин назначения.
Удалить - распространять удаления сообщений. Это относится только к сообщениям, которые
фактически исчезли, т. е. были удалены. Затронутые сообщения в удаленном магазине:
помечены только как удаленные, т. е. они не будут удалены до тех пор, пока Магазин не будет
удалено.
Флаги - распространять изменения флага. Обратите внимание, что «Удалено / Удалено» также является флагом; это
особенно интересно, если вы используете остолоп с опцией maildir_trash.
Все (--полный в командной строке) - все вышеперечисленное. Это глобальное значение по умолчанию.
Ничто (--нуп в командной строке) - ничего не распространять. Полезно, если хочешь
только удалить.

Потянуть и Push флаги направления, а Новые, Обновить, Удалить и Флаги тип
флаги. Два класса флагов составляют двумерную матрицу (таблицу). Его клетки
индивидуальные действия, которые необходимо выполнить. Есть два стиля утверждения ячеек:
В первом стиле флаги выделяют целые строки / столбцы в матрице. Только
ячейки, выбранные как по горизонтали, так и по вертикали, утверждаются. Указание
отсутствие флагов из класса похоже на указание всех флагов из этого класса. Например,
"Синхронизация Потянуть Новые Флаги"будет распространять новые сообщения и отмечать изменения от Мастера
Рабу "Синхронизация Новые Удалить"будет распространять как поступления, так и удаления сообщений
способы, и "Синхронизация Push"распространит все изменения с ведомого на ведущее.
Во втором стиле флаги направления объединяются с флагами типа; каждый
составной флаг немедленно утверждает ячейку в матрице. Помимо как минимум одного
составной флаг, отдельные флаги также могут использоваться, но в отличие от
первый стиль, они немедленно утверждают все ячейки в соответствующей строке / столбце. Для
пример, "Синхронизация PullНовый ВытащитьУдалить Push"будет распространять поступающие сообщения и
удаления от Мастера к Подчиненному и любые изменения от Подчиненного к Подчиненному
Мастер. Обратите внимание, что нельзя утверждать ячейку двумя способами, например
"Синхронизация PullНовый Потянуть, а такжеСинхронизация PullНовый Удалить Push"вызывают сообщения об ошибках.

Создавай {Ничто|Master|Раб|Оба формата}
Автоматически создавать отсутствующие почтовые ящики [на главном / подчиненном]. В противном случае выведите
сообщение об ошибке и пропустите эту пару почтовых ящиков, если почтовый ящик не существует. (Глобальный
по умолчанию: Ничто)

Удалить {Ничто|Master|Раб|Оба формата}
Безвозвратно удалить все сообщения [на ведущем / ведомом], помеченные для удаления. Видеть
РЕКОМЕНДАЦИИ ниже. (Глобальное значение по умолчанию: Ничто)

КопироватьПрибытиеДата {Да|нет}
Выбирает, следует ли распространять время их прибытия вместе с сообщениями.
Включение этого имеет смысл, чтобы сохранить сортировку сообщений на основе отметок времени.
нетронутый. Обратите внимание, что IMAP не гарантирует, что отметка времени (называемая в нашей внутренней среде,
даты) - на самом деле время прибытия, но обычно оно достаточно близко. (Дефолт: нет)

Синхронизация, Создавай, Удалить, Макс. сообщенийи КопироватьПрибытиеДата может использоваться перед любым разделом для
глобальный эффект. Глобальные настройки переопределяются параметрами для конкретного канала, которые в
Turn отменяются переключателями командной строки.

состояние синхронизации {*|путь}
Задайте расположение файлов состояния синхронизации этого канала. * означает, что
состояние должно быть сохранено в файле с именем .mbsyncstate в самом почтовом ящике Slave;
это имеет то преимущество, что вам не нужно заботиться о файле состояния, если вы удалите
почтовый ящик, но он, очевидно, работает только с почтовыми ящиками Maildir. В противном случае это
интерпретируется как строка, добавляемая к имени подчиненного почтового ящика, чтобы составить полное
дорожка.
Эта опция может использоваться вне любого раздела для глобального эффекта. В этом случае
добавляемая строка составляется по шаблону :мастер:мастер-
ящик_:раб:рабский ящик.
(Глобальное значение по умолчанию: ~ / .mbsync /).

Группы
группы имя [канал[:ящик[,...]]] ...
Определить группу имя, открыв раздел для его параметров. Обратите внимание, что хотя
У групп есть собственное пространство имен, они будут «скрывать» каналы с тем же именем на
командная строка.
В одной строке можно указать один или несколько каналов.
Если вы поставите один или несколько ящикes к канал, они будут использоваться вместо того, что
указанные в паттернах канала. То же самое можно сделать в командной строке,
за исключением того, что новые строки также могут использоваться как разделители имен почтовых ящиков.

Канал[s] канал[:ящик[,...]] ...
Добавьте указанные каналы в группу. Этот параметр можно указать несколько
раз в группе.

Глобальный Опции
FСинхронизация Да|нет
Выбирает, будет ли мбсинк выполняет принудительную очистку, которая определяет уровень данных
безопасность после сбоев системы и отключения электроэнергии. Отключение этого достаточно безопасно для
файловые системы, которые смонтированы с данными = упорядоченный режим. Включение - мудрый
выбор для файловых систем, смонтированных с данными = обратная запись, в частности современных систем
например ext4, btrfs и xfs. Влияние на производительность старых файловых систем может быть
непропорционально. (Дефолт: Да)

РЕКОМЕНДАЦИИ

Убедитесь, что ваш IMAP-сервер не удаляет удаленные сообщения автоматически - он работает медленно и
семантически несколько сомнительно. В частности, необходимо настроить Gmail, чтобы не выполнять
его.

По умолчанию мбсинк не удаляет сообщения - удаления распространяются путем отметки
сообщения как удаленные в удаленном хранилище. Убедившись, что ваша установка работает,
вы обычно хотите установить Удалить в Оба формата, чтобы удаления вступили в силу.

мбсинквстроенная функция корзины зависит от мбсинк удаление удаленных
Сообщения. Это тот случай, когда он распространяет удаления ранее распространенных сообщений,
и корзина находится в целевом хранилище (обычно на вашем сервере IMAP).
Однако, когда вы намереваетесь мбсинк для удаления сообщений, которые еще не были распространены, MUA
должен помечать сообщения как удаленные, не стирая их (например, собачонка's maildir_trash
вариант). Обратите внимание, что большинство сообщений распространяются задолго до их удаления, поэтому
это угловой случай, для которого вы, вероятно, не хотите оптимизировать. Это также означает, что
TrashNewOnly и TrashRemoteНовый параметры обычно не очень полезны.

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

ВНУТРЕННИЙ ПРОБЛЕМЫ

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

. Корзину в магазинах IMAP без расширения UIDPLUS (в частности, M $ Exchange до at
минимум 2010) имеет состояние гонки: сообщения будут потеряны, если они помечены как удаленные
после получения списка сообщений, но до удаления почтового ящика. Нет никакого риска
пока к почтовому ящику IMAP обращается только один клиент (включая мбсинк) вовремя.

Используйте mbsync онлайн с помощью сервисов onworks.net