mbsync - 云端在线

程序：

您的姓名

mbsync - 同步 IMAP4 和 Maildir 邮箱

概要

同步 [选项 ...] {{渠道[:框[{,|\n}...]]|组} ...|-a}

商品描述

同步 是一个同步邮箱的命令行应用程序； 目前 Maildir 和
支持 IMAP4 邮箱。 新消息、消息删除和标志更改可以
双向传播； 可以细粒度地选择操作集。
同步基于唯一的消息标识符 (UID)，因此没有标识
可能会发生冲突（与某些其他邮件同步器相反）。 奥托， 同步 is
易受 UID 有效性更改的影响（即 应该 永远不会发生，但请参阅“兼容性”
自述文件）。 同步状态保存在每个邮箱对的一个本地文本文件中；
可以维护一个邮箱的多个副本。

配置

-c, --配置 文件
从中读取配置 文件. 默认情况下，配置从
~/.mbsyncrc。

-a, - 全部
选择所有配置的通道。 命令上的任何通道/组规范
行被忽略。

-l, - 列表
不同步任何内容，但列出所选频道中的所有邮箱并
退出。

-C[m][s], - 创建[-主|-奴隶]
覆盖任何 创建 配置文件中的选项。 见下文。

-X[m][s], --清除[-主|-奴隶]
覆盖任何 清除 配置文件中的选项。 见下文。

{-n|-N|-d|-f|-0|-F}，{- 新的|- 更新|- 删除|--标志|--noop|- 满的}
{-L|-H}[n][N][d][f]，{- 拉|- 推}[-新的|-更新|-删除|-标志]

覆盖任何 Sync 配置文件中的选项。 见下文。

-h, - 帮帮我
显示命令行选项的摘要。

-v, - 版
显示版本信息。

-V, --详细
启用 详细 模式，显示 IMAP4 网络流量。

-D, -调试
启用列印 调试 信息。

-q, - 安静的
抑制信息性消息。 如果指定两次，则禁止警告消息为
井。

配置

配置文件是强制性的； 同步 没有它就不会运行。 以开头的行
一个井号（#) 是注释并且完全被忽略。 配置项为关键字
后跟一个或多个参数； 包含空格的参数必须用 double 括起来
引号 （")，以及文字双引号和反斜杠 (\) 必须是反斜杠转义的。 全部
关键字（包括用作参数的关键字）不区分大小写。 类似 Bash 的家
使用波浪号 (~) 支持所有代表本地的选项
路径。 有几个全局选项，其余的适用于特定部分。 部分
由段关键字开始，以空行或文件结尾终止。
每个部分都定义了一个对象，该对象在该对象类中具有唯一的标识符。

有两个基本的对象类：Stores 和 Channels。 一个 Store 定义了一个集合
邮箱； 基本上是一个文件夹，本地或远程。 一个 Channel 连接两个 Store，
描述两者同步的方式。
有两个辅助对象类：帐户和组。 帐户描述了
远程商店的连接部分，因此可以在多个服务器之间共享一个服务器连接
商店。 一个 Group 聚合多个 Channels 以节省在命令行上的输入。

文件系统位置（特别是 途径 和 收件箱) 使用 Store 的内部路径
分隔符，可以是斜杠、句点等，甚至是它们的组合。
邮箱名称，OTOH，总是使用规范的路径分隔符，这是类 Unix 向前的
斜线。

全部 商店
这些选项可用于所有受支持的 Store 类型。
在这种情况下，术语“远程”描述了频道内的第二个商店，而不是
必须是远程服务器。
专用邮箱 INBOX 存在于每家商店； 它在文件系统中的物理位置
是特定于商店类型的。

途径 径
Store 在（服务器的）文件系统中的位置。 如果这不是绝对的
路径，参考点是特定于商店类型的。 该字符串被添加到
在此存储中寻址的邮箱名称，但不被视为其中的一部分； 这是
重要的 模式 在频道部分。 请注意，您 必须 附加斜线
如果要指定整个目录。 （默认：无）

最大尺寸 尺寸[k|m][b]
大于此值的消息将不会传播到此 Store。 这很有用
用于清除带有大附件的邮件。 K 和 M 可以附加到
大小指定 KiBytes resp。 MeBytes 而不是字节。 B 被接受但是
多余。 如果 尺寸 为 0，最大消息大小为 无限. （默认： 0)

地图收件箱 邮箱
创建虚拟邮箱（相对于 途径) 别名 INBOX. 有道理
与 模式 在 Channels 部分，尽管使用 Maildir slave，您
可能想要放置 收件箱 下 途径 反而。 这个虚拟邮箱没有
支持子文件夹。

展平 DELIM
通过替换规范层次结构来展平此 Store 中的层次结构
定界符 / - DELIM. 这在 MUA 用于访问 Store 时很有用
提供对分层邮箱的次优处理，就像 傻子.
分隔符的常见选择是 ..
请注意，扁平化的子文件夹 INBOX 总是在 途径，包括
“收件箱”DELIM“ 字首。

垃圾桶 邮箱
指定邮箱（相对于 途径) 将删除的邮件复制到之前
清除。 看 建议 和 固有 问题 以下。 （默认：无）

仅限垃圾箱 含|没有
删除时，仅复制尚未传播的消息。 这是有道理的，如果
远程商店有一个 垃圾桶 以及（与 仅限垃圾箱 没有）。 （默认： 没有)

垃圾远程新 含|没有
删除远程 Store 时，将尚未传播的消息复制到此 Store 的
垃圾桶. 使用这个时，远程Store不需要自己的 垃圾桶 总而言之
消息已存档。 （默认： 没有)

邮件目录 商店
相对参考点 途径s 是当前工作目录。

As 同步 需要 UID，但 Maildir 没有标准化的 UID 存储方案， 同步
支持两种方案，各有利弊。
这个 本地人 方案是从最新的 Maildir 补丁中窃取的 客户端 因此
与...兼容 松树. UID 有效性存储在名为 .uidvalidity 的文件中； UID
被编码在消息的文件名中。
这个 替代 方案基于使用的 UID 映射 同步 版本 0.8 和 0.9.x。
消息文件名的不变部分用作进入 Berkeley
名为 .isyncuidmap.db 的数据库，它也保存 UID 有效性。
这个 本地人 方案更快，更节省空间，独立于字节序和“人性化”
可读”，但如果从另一个邮箱复制邮件而没有
获取新文件名； 这迟早会导致重复的 UID，这在
turn 会导致 UID 有效性更改，从而导致同步失败。 这 替代
如果 MUA 在某个部分更改了消息的文件名，则方案将失败 同步 考虑
不变的； 这将被解释为消息删除和新消息，导致
不必要的流量。
傻子 众所周知，这两种方案都能很好地工作。
使用 VHDL 语言编写 转换 将邮箱从一种方案转换为另一种方案。

邮箱存储 姓名
定义 Maildir 存储 姓名，为其参数打开一个部分。

地图 含|没有
使用 替代 此商店中邮箱的 UID 存储方案。 这不
影响已经有 UID 存储方案的邮箱； 用 转换 改变
它。 （默认： 没有)

收件箱 径
的位置 INBOX。 这是 而不去 关系到 途径，但允许放置
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 INBOX 里面的 途径. （默认： 〜/邮件目录)

IMAP4 账户
IMAP账户 姓名
定义 IMAP4 帐户 姓名，为其参数打开一个部分。

主办方 主持人
指定 IMAP 服务器的 DNS 名称或 IP 地址。
If 隧道 使用，此设置仅用于 SSL 主机证书验证，
如果提供。

港口 端口
指定 IMAP 服务器的 TCP 端口号。 （默认：IMAP 为 143，IMAP 为 993
地图）
If 隧道 使用时，此设置将被忽略。

用户 用户名
指定 IMAP 服务器上的登录名。

通过 密码
指定密码 用户名 在 IMAP 服务器上。 注意这个选项是 不是
必需的。 如果密码和密码命令都没有在
配置文件， 同步 将提示您输入密码。

密码命令 命令
指定shell命令获取密码而不是指定密码
直接地。 这允许您使用密码文件和代理。 命令必须
在标准输出上只产生一行； 尾随换行符是可选的。

隧道 命令
指定要运行的命令以建立连接而不是打开 TCP
插座。 例如，这允许您通过 SSH 隧道运行 IMAP 会话。
If 使用 IMAPS 被禁用并且隧道打开一个预先验证的连接，
需要SSL 也需要禁用。 如果未预先验证连接，
但隧道是安全的，禁用 需要SSL 和 使用TLSv1 被推荐。

需要CRAM 含|没有
如果设置为 含, 同步 如果没有 CRAM-MD5 身份验证，将中止连接
可能的。 （默认： 没有)

使用 IMAPS 含|没有
如果设置为 含, 默认为 港口 改为 993 和 同步 将启动 SSL
与服务器建立连接后立即协商。
请注意，现代服务器通过 STARTTLS 在常规 IMAP 端口 143 上支持 SSL
扩展名，默认情况下会自动使用。

需要SSL 含|没有
同步 如果无法建立 TLS/SSL 会话，将中止连接
IMAP 服务器。 （默认： 含)

证书文件 径
包含用于验证服务器身份的附加 X.509 证书的文件。
无论有效性如何，直接匹配的对等证书始终是可信的。
请注意，系统的默认证书存储始终被使用，不应被使用
此处指定。

使用 SSLv2 含|没有
使用 SSLv2 通过 SSL 与 IMAP 服务器进行通信？
请注意，出于安全原因，不推荐使用此选项。 （默认： 没有)

使用 SSLv3 含|没有
使用 SSLv3 通过 SSL 与 IMAP 服务器进行通信？ （默认： 没有)

使用TLSv1 含|没有
使用 TLSv1 通过 SSL 与 IMAP 服务器进行通信？ （默认： 含)

使用TLSv1.1 含|没有
使用 TLSv1.1 通过 SSL 与 IMAP 服务器进行通信？ （默认： 没有)

使用TLSv1.2 含|没有
使用 TLSv1.2 通过 SSL 与 IMAP 服务器进行通信？ （默认： 没有)

管道深度 深度
可以同时进行的 IMAP 命令的最大数量。 环境
这个到 1 禁用流水线。 这主要是仅用于调试的选项。 （默认：
无限)

IMAP 商店
相对参考点 途径s 是服务器喜欢的任何东西； 可能是
用户在该服务器上的 $HOME 或 $HOME/Mail。 的位置 INBOX 由服务器决定
好吧，通常是无关紧要的。

商店 姓名
定义 IMAP4 存储 姓名，为其参数打开一个部分。

账户 帐户
指定要使用的 IMAP4 帐户。 而不是定义一个帐户并引用
在这里，也可以直接在
商店的部分 - 如果一个帐户仅用于一个商店，这是有意义的。

使用命名空间 含|没有
选择服务器的第一个“个人”NAMESPACE 是否应该作为前缀
邮箱名称。 对于某些损坏的 IMAP 服务器，禁用它是有意义的。 这个
如果一个选项是没有意义的 途径 被指定。 （默认： 含)

路径分隔符 DELIM
指定服务器的层次结构定界符。 （默认：取自服务器的第一个
“个人”命名空间）
Do 不是 滥用它来重新解释层次结构。 用 展平 代替。

频道
频道 姓名
定义通道 姓名，为其参数打开一个部分。

{总音量|奴隶} :商店:[邮箱]
指定主响应。 Slave Store 将通过此 Channel 连接。 如果 模式
被指定， 邮箱 被解释为不匹配的前缀
模式，并且不受邮箱列表覆盖的影响。 否则，如果
邮箱 省略， INBOX 假设。

模式[s[!]模式 ...
不是只同步一对邮箱，而是同步所有邮箱
匹配 模式(s). Master 和 Slave 上的邮箱名称相同。
模式是 IMAP4 模式，即， * 匹配任何东西并且 % 匹配任何高达
下一个层次分隔符。 前置 ! 到一个模式使它成为一个排除。
可以指定多个模式（通过提供多个参数或通过
运用 模式 多次）; 后面的比赛优先。
需要注意的是 INBOX 不与通配符匹配，除非它位于 途径.
选择的邮箱列表 模式 可以被一个邮箱列表覆盖
通道参考（一个 团队 规范或命令行）。
例如：模式 % ！垃圾"

最大尺寸 尺寸[k|m][b]
类似于 Stores 部分中的同名选项，但同样适用于
主人与奴隶。 请注意，这实际上会修改 Stores，因此请注意不要
如果您在多个频道中使用商店，请提供冲突的设置。

最大消息数 数
设置每个从属邮箱中保留的最大消息数。 这很有用
对于在服务器上保留完整存档但想要镜像的邮箱
仅最后的消息（例如，对于邮件列表）。 那些消息
最先到达邮箱的（与实际收件日期无关）
消息）将首先被删除。 被标记的消息（标记为重要的）
并且（默认情况下）不会自动删除未读消息。 如果 数 是0，
最大消息数是 无限 （默认： 0).

过期未读 含|没有
选择未读邮件是否应受 最大消息数。 一般，
未读消息被认为是重要的，因此永远不会过期。 这确保了
即使长时间不在，您也不会错过新消息。 但是，如果您的
存档包含大量未读消息，将它们视为
重要的实际上会失败 最大消息数. 在这种情况下，您需要启用
这个选项。 （默认： 没有).

Sync {没有|[拉[推[新建[更新[删除[旗]|全部}
选择要执行的同步操作：
拉 - 将更改从 Master 传播到 Slave。
推 - 将更改从 Slave 传播到 Master。
新建 - 传播新出现的消息。
更新 - 重新评估先前拒绝的消息以进行传播。 之后有用
在源存储中标记受影响的消息或在源存储中扩大 MaxSize
目的地商店。
删除 - 传播消息删除。 这仅适用于
实际上消失了，即被删除了。 远程 Store 中受影响的消息是
标记为仅删除，即，在该 Store 被删除之前，它们不会被真正删除
删除。
旗 - 传播标志更改。 请注意，Deleted/Trashed 也是一个标志； 这个
如果您使用，则特别有趣 傻子 使用 maildir_trash 选项。
全部 (- 满的 在命令行上） - 以上所有。 这是全局默认值。
没有 (--noop 在命令行上） - 不要传播任何东西。 如果你愿意的话很有用
仅清除。

拉 和 推 是方向标志，而 新建, 更新, 删除 和 旗 是类型
旗帜。 这两个标志类构成了一个二维矩阵（一个表格）。 它的细胞
是要执行的单个操作。 有两种断言单元格的方式：
在第一种样式中，标志选择矩阵中的整行/列。 只有
水平和垂直选择的单元格被断言。 指定
没有来自一个类的标志就像指定来自这个类的所有标志。 例如，
"Sync 拉 新建 旗" 将传播新消息并标记来自 Master 的更改
对奴隶，“Sync 新建 删除" 将同时传播消息到达和删除
方式，以及“Sync 推" 会将所有更改从 Slave 传播到 Master。
在第二种风格中，方向标志与类型标志连接； 每一个
复合标志立即断言矩阵中的一个单元格。 除了至少一个
复合标志，也可以使用单个标志，但与
第一种样式，它们立即断言各自行/列中的所有单元格。 为了
例子， ”Sync 拉新 拉动删除 推" 将传播消息到达和
从 Master 到 Slave 的删除以及从 Slave 到 Slave 的任何更改
掌握。 请注意，不允许以两种方式断言单元格，例如
"Sync 拉新 拉“和”Sync 拉新 删除 推" 诱发错误信息。

创建 {没有|总音量|奴隶|以上皆是}
自动创建丢失的邮箱[在主/从上]。 否则打印一个
如果邮箱不存在，则跳过该邮箱对。 （全球的
默认情况下： 没有)

清除 {没有|总音量|奴隶|以上皆是}
永久删除所有标记为删除的消息[在主/从上]。 看
建议 以下。 （全局默认： 没有)

复制到货日期 {含|没有}
选择它们的到达时间是否应与消息一起传播。
启用它是有意义的，以保持基于时间戳的消息排序
完整。 请注意，IMAP 不保证时间戳（称为 内部
日期)其实是到达时间，但通常已经足够接近了。 （默认： 没有)

Sync, 创建, 清除, 最大消息数和 复制到货日期 可以在任何部分之前使用
全球效应。 全局设置被特定于通道的选项覆盖，其中
turn 被命令行开关覆盖。

同步状态 {*|径}
设置此 Channel 的同步状态文件的位置。 * 表示
状态应该保存在 Slave 邮箱本身中名为 .mbsyncstate 的文件中；
这样做的好处是，如果删除，则无需关心状态文件
邮箱，但它显然只适用于 Maildir 邮箱。 否则这是
解释为一个字符串，附加到 Slave 邮箱名称以组成一个完整的
路径。
此选项可用于任何部分之外以获得全局效果。 在这种情况下
附加字符串是根据模式组成的 :主:掌握-
框_:奴隶:从箱.
（全局默认： 〜/.mbsync/).

群
团队 姓名 [渠道[:框[,...]]] ...
定义组 姓名，为其参数打开一个部分。 请注意，即使
组有自己的命名空间，它们会“隐藏”同名的频道
命令行。
可以在同一行上指定一个或多个通道。
如果您提供一个或多个 框es 到 渠道，它们将被使用而不是什么
在通道的模式中指定。 同样可以在命令行上完成，
除了换行符也可以用作邮箱名称分隔符。

频道[s] 渠道[:框[,...]] ...
将指定的频道添加到组中。 这个选项可以指定多个
组内的次数。

全球覆盖 可选项
同步 含|没有
选择是否 同步 执行强制刷新，这决定了数据的级别
系统崩溃和断电后的安全。 禁用它是相当安全的
以 data=ordered 模式挂载的文件系统。 启用它是明智的
选择使用 data=writeback 挂载的文件系统，尤其是现代系统
像 ext4、btrfs 和 xfs。 对旧文件系统的性能影响可能是
不成比例。 （默认： 含)

建议

确保您的 IMAP 服务器不会自动删除已删除的邮件 - 它很慢，并且
语义上有些问题。 具体需要配置Gmail不做
它。

默认情况下， 同步 不会删除任何消息 - 删除是通过标记
在远程存储中删除的消息。 一旦您确认您的设置有效，
您通常需要设置 清除 至 以上皆是，使删除生效。

同步的内置垃圾功能依赖于 同步 做删除删除
消息。 当它传播先前传播的消息的删除时就是这种情况，
并且垃圾在目标商店（通常是您的 IMAP 服务器）上。
然而，当你打算 同步 垃圾邮件尚未传播，MUA
必须将消息标记为已删除而不删除它们（例如， 傻子's 邮件目录_垃圾箱
选项）。 请注意，大多数消息在被删除之前会传播很长时间，因此
这是您可能不想优化的极端情况。 这也意味着，
仅限垃圾箱 和 垃圾远程新 选项通常不是很有用。

如果您的服务器支持自动删除（就像 Gmail 一样），那么依赖于
在那而不是 同步的垃圾功能。 如果你这样做，并打算
像其他邮箱一样同步垃圾箱，你不应该使用 同步's 垃圾桶 在选项
所有。

固有 问题

之后所做的更改 同步 已检索到的消息列表将不会被同步，直到
下一次 同步 被调用。

运用 垃圾桶 在没有 UIDPLUS 扩展的 IMAP 商店上（特别是 M$ Exchange 高达
至少 2010 年）存在竞争条件：如果消息被标记为已删除，则会丢失
在检索邮件列表之后但在删除邮箱之前。 没有风险
只要 IMAP 邮箱只被一个客户端访问（包括 同步) 一次。

使用 onworks.net 服务在线使用 mbsync