doveadm-sync - 云端在线

程序：

您的姓名

doveadm-sync - Dovecot 的双向邮箱同步实用程序
doveadm-backup - Dovecot 的单向邮箱同步实用程序

概要

鸽子 [-DV] 同步 [-u 用户|-A|-F 文件[-S 套接字路径[-1fPRU[-l 秒[-r
原始日志路径[-m 邮箱[-g 邮箱向导[-n 命名空间|-N[-x 排除[-s 州[-T
秒] -d|目的地

鸽子 [-DV] 备份 [-u 用户|-A|-F 文件[-S 套接字路径[-fPRU[-l 秒[-r
原始日志路径[-m 邮箱[-g 邮箱向导[-n 命名空间|-N[-x 排除[-s 州[-T
秒] -d|目的地

商品描述

dsync 是 Dovecot 的邮箱同步实用程序。 它可以用于几种不同的
用例：邮箱的双向同步、创建邮件备份和转换
邮箱从/到不同的邮箱格式。 所有这些都可以在同一个
服务器或不同服务器之间（通过 SSH(1) 或 tcp 连接）。 远程邮箱可以
也可以通过 IMAP 协议访问，该协议允许使用 dsync 进行邮箱迁移
的目的。

您可以以三种模式之一运行 dsync：

· 鸽子 备份 执行单向同步。 如果有任何变化
在目的地中，它们将被删除，因此目的地将看起来
完全一样的来源。

· 鸽子 同步 执行双向同步。 它合并所有更改
不会失去任何东西。 两个邮箱最终看起来都一样
同步完成后。

· 鸽子 同步 -1 执行单向同步，但它合并了更改
在目的地而不删除任何东西。 这目前不起作用
完美，所以它的使用应该受到限制。 它的主要目的是在
您可以运行的邮箱迁移 鸽子 备份 多次，然后切换
要发送到新邮箱并运行的邮件 鸽子 同步 -1 再一次
从旧邮箱传输任何最新的新邮件。

还有三种不同的同步算法：

· 全同步（-f 参数）扫描所有消息中的所有
邮箱。 这保证了一切都会同步，但是
增量同步的速度太慢了。

· 快速同步（默认）首先尝试查找具有
改变了，并且只同步那些。 这是通过检查
邮箱的元数据（NEXTUID 和 HIGHESTMODSEQ）。 通常这工作正常，
尤其是单向同步，但如果双方都做到了
相同数量的更改，元数据最终可能包含相同的值
即使变化不同。

· 有状态同步（-s 参数）是最有效的方式
同步邮箱。 它依赖于较早的 dsync 运行状态
保存在某处并被传递到下一次 dsync 运行。 基于这个状态
dsync 只能发送上次 dsync 运行后发生的更改。
只要状态或邮箱没有损坏，这个算法就应该
完美地工作。 复制器进程在内部使用它来执行大多数
的同步。

同步尽可能完美：IMAP 或 POP3 客户端不应该
注意两个邮箱之间的任何差异。 双向同步意味着它是安全的
在双方进行任何类型的修改，dsync 将合并更改而不
丢失任何一方所做的任何更改。 这是可能的，因为 dsync 可以访问
Dovecot 的索引日志，用于跟踪更改。 当然有可能
合并期间的冲突，这些都以安全的方式解决。 见 同步 设计 文件
获取更多信息.

dsync 使用与 Dovecot 其余部分相同的配置文件（通过 鸽会(1) 二进制)。
可以通过将 -c 参数赋予另一个配置来更改整个配置
文件，或使用 -o 参数覆盖特定设置。 执行远程 dsync 时
程序它的工作方式相同：它使用自己的本地配置。

dsync 可以完全独立运行。 它不需要任何 Dovecot 服务器进程
正在运行，除非使用 -u 参数执行 用户数据库 从身份验证过程中查找。

dsync 可以使用 -u 或 -A 参数同步一个或多个用户。 对于连续
复制，您可以使用 Dovecot 复制器进程，它会自动运行 dsync
每当消息发生变化时。

配置

全球 鸽子(1) 选项:

-D 启用详细信息和调试消息。

-o 设置=折扣值
覆盖配置 设置 止 /etc/dovecot/dovecot.conf 并从
具有给定的 userdb 折扣值. 为了覆盖多个设置， -o 选项
可以多次指定。

-v 启用详细信息，包括进度计数器。

命令特定 选项:

-1 做单向同步而不是双向同步。

-A 如果 -A 选项存在， 命令 将为所有用户执行。 使用
此选项与系统用户结合使用 用户数据库 { 司机 = passwd文件 } 是不是
推荐，因为它还包含 UID 比用户低的用户
配置了 第一个有效用户ID 设置。

使用 SQL userdb 模块时，请确保 迭代查询 设置
/etc/dovecot/dovecot-sql.conf.ext 匹配您的数据库布局。 当使用
LDAP userdb 模块，请确保 迭代属性 和 迭代过滤器 设置
/etc/dovecot/dovecot-ldap.conf.ext 匹配您的 LDAP 架构。 除此以外 鸽子(1)
将无法遍历所有用户。

-F 文件
执行 命令 为所有用户在 文件. 这类似于 -A
选项，但不是从 userdb 获取用户列表，而是读取它们
从给定的 文件。 该 文件 每行包含一个用户名。

-N 同步所有可用的命名空间。 默认情况下，只有不
有明确的位置设置是同步的。

-P 跑一个 鸽子清除(1) 用于同步后的目的地（远程）存储。

-R 做一个反向同步。 通常，消息会从本地系统推送到
目的地（远程）。 此选项会反转流程，而是会拉取消息
从远程存储到本地存储。

-S 套接字路径
该选项的参数是本地 UNIX 域套接字的绝对路径，或者
主机名和端口（主机:端口)，以便通过 TCP 连接远程主机
插座。

这允许管理员执行 鸽子(1) 通过给定的邮件命令
插座。

-T 秒
以秒为单位指定时间，多长时间 鸽子(1) 应该等待停止的 I/O
操作。 默认超时为 600 秒。

-U 这由复制器在内部使用，以便 dsync 在
同步完成。

-d 使用默认目标，从 邮件副本 用户数据库 额外
领域。

-g 邮箱向导
与 -m 相同，但通过其 GUID 而不是名称查找要同步的邮箱。

-l 秒
锁定此用户的 dsync。 等待最大值 秒 在放弃之前。 这个
如果可能的话，应该使用参数来避免同步中断
dsync 正在为同一用户同时运行。

-m 邮箱
仅同步此邮箱名称。

-n 命名空间
仅同步指定的命名空间。 该参数可以多次使用
倍。

-r 原始日志路径
远程运行dsync，将远程输入/输出流量写入指定日志
文件中。

-s 以前的状态
使用有状态同步。 如果之前的状态未知，则使用空的
细绳。 新状态总是打印到标准输出。

-u 用户/掩码
运行 命令 仅针对给定的 用户. 也可以使用 '*'和'?'
通配符（例如 -u *@example.org）。
当既不 -A 选项，也不是 -F 文件 选项，也不是 -u 用户 被指定，
此 命令 将在当前登录用户的环境下执行。

-x 邮箱掩码
排除指定的邮箱名称/掩码。 面具可能包含“?“和”*"
通配符。 该参数可以多次使用。

争论

目的地
此参数指定同步目标。 它可以是以下之一：

圖書分館的位置
与...一样 邮件位置 设置，例如maildir：〜/邮件目录

偏僻的：登录@主机
使用 dsync_remote_cmd 设置连接到远程主机（通常通过
SSH)

远程前缀：登录@主机
这与远程相同，除了在 dsync 之前发送“user@domain\n”
协议开始。 这允许实现一个受信任的包装脚本
通过读取第一行的用户名来运行 doveadm dsync-server。

TCP：主机[：端口]
通过 TCP 连接到远程 doveadm 服务器。 默认端口由
doveadm_端口 设置。

tcps：主机[：端口]
这与 tcp 相同，但使用 SSL。

退出 状态

同步 将以下列值之一退出：

0 同步完成得很完美。

2 同步完成没有错误，但有些更改无法完成，因此
邮箱没有完全同步。 再次运行 dsync 通常可以解决这个问题。
通常，对于具有新创建的邮箱的消息修改序列会发生这种情况。
如果其中一个邮箱在同步过程中发生变化，也会发生这种情况。

1, >2
同步失败。

例

同步
将邮箱与远程服务器同步。 任何错误都会写入 stderr。

鸽子 同步 -u [电子邮件保护] 远程：server-replica.example.com

如果您需要更复杂的 ssh 参数，您可以使用例如：

鸽子 同步 -u [电子邮件保护] SSH -i id_dsa.dovecot \
[电子邮件保护] 鸽子 同步服务器 -u [电子邮件保护]

转换中
假设那个 邮件位置 设置 /etc/dovecot/conf.d/10-mail.conf 被设定为：
邮件位置 = mdbox：〜/ mdbox, 登录系统用户可以将她/他的邮件从其
Maildir 在她/他的家目录中以 mdbox 邮箱格式。 用户必须执行
命令：

鸽子 同步 邮件目录：〜/邮件目录

如果您想在没有任何停机时间的情况下执行此操作，您可以一次转换一个用户。
最初：

· 配置用途 邮件位置 = 邮件目录：〜/邮件目录

· 设置使用每个用户的邮件位置的可能性 用户数据库 额外的字段。

然后对于每个用户：

1。 运行 鸽子 同步 一次做初始转换。

2。 运行 鸽子 同步 再次，因为初始转换可能需要一段时间
并且在此期间可能会发生新的变化。 第二次只适用
变化，所以它应该很快。

3. 将 userdb 中的邮件额外字段更新为 mdbox：〜/ mdbox. 如果您使用身份验证缓存，
你需要冲洗它，例如 鸽子 AUTH 缓存 红晕.

4.等待几秒然后kill（doveadm kick）用户所有存在的imap
和 pop3 会话（仍在使用 maildir）。

5。 运行 鸽子 同步 再次应用可能完成的最终更改。 后
这不应该对 Maildir 进行更改，因为用户的邮件位置已
已更改，并且所有使用它的现有进程都已终止。

转换所有用户后，您可以设置默认值 邮件位置 到 mdbox 和
删除每个用户的邮件位置 用户数据库.

REPORTING BUGS

报告错误，包括 鸽会 -n 输出到 Dovecot 邮件列表
<[电子邮件保护]>. 有关报告错误的信息可在以下位置获得：
http://dovecot.org/bugreport.html

使用 onworks.net 服务在线使用 doveadm-sync