200ms/imapsync_ah2

ImapSync Docker容器

本容器是一款用于两个***之间同步邮件的工具，支持通过命令行或本地Web服务器两种方式进行同步。

您可以直接查看下方的“Docker Compose YAML示例”，获取直观的配置参考。

命令行同步

要通过IMAP协议同步***，需定义以下环境变量（用于源和目标）：

yaml
  S_HOST: 'tls://imap.source-mail:585'
  S_USER: 'user_old@source-mail'
  T_HOST: 'ssl://imap.target-mail:993'
  T_USER: 'user_new@target-mail'
  # 或使用短引用（详见下方）
  # S_HOST: ':yahoo'
  # T_HOST: ':gmail'
  
  # 非必填：
  S_PASS: 'secret6397/for-source_mail'
  T_PASS: 'secret837\for-target--mail'

注意：
S_PASS和T_PASS为非必填项，若未设置，程序会提示用户输入密码（更安全，避免密码存储）。

命令行使用示例：

bash
docker run -it  -e S_HOST=tls://imap.source-mail:585 \
                -e S_USER=user_old@source-mail \
                -e T_HOST=ssl://imap.target-mail:993 \
                -e T_USER=user_new@target-mail \
                --name cmd_imap_sync \
                docker.xuanyuan.run/200ms/imapsync_ah2

# 在另一个终端启动同步：
docker exec -it cmd_imap_sync mailsync
# 此时程序会要求输入密码

mailsync命令用于启动***同步。若未设置S_PASS/T_PASS，程序会提示输入密码。
若要预览同步操作（不实际执行），可使用mailsync -p或mailsync --pretend。

流行***服务的短引用

对于常见服务，可在S_HOST/T_HOST中使用冒号+服务简称（如:service），例如：

... -e S_HOST=:gmail -e T_HOST=:*** ...

（更多短引用见文末“短引用列表”）

本地Web服务器同步

ImapSync附带一个简单的Web服务器，提供可视化界面让用户配置源和目标邮件服务器，无需命令行即可完成同步。

要启用Web服务器，需设置环境变量WEBSERVER为y并开放8080端口：

bash
docker run -it -e WEBSERVER=y -p 8080:8080 \
          docker.xuanyuan.run/200ms/imapsync_ah2

然后访问http://localhost:8080/即可使用。

Docker Compose YAML示例

以下是Docker Compose的使用示例：

命令行同步：

yaml
# 命令行同步配置
services:
  imap_sync:
    image: docker.xuanyuan.run/200ms/imapsync_ah2
    environment:
      S_HOST: 'tls://host1:585'
      S_USER: 'test@example.com'
      T_HOST: 'ssl://host2'
      T_USER: 'test@example.com'

运行同步：

bash
docker exec -it imap_sync mailsync

此命令将通过IMAP协议启动邮件同步。

本地Web服务器同步（端口8080）：

yaml
# 本地Web服务器配置
services:
  imap_sync:
    image: docker.xuanyuan.run/200ms/imapsync_ah2
    ports:
      - 8080:8080
    environment:
      WEBSERVER: 'y'

通过Web应用启动同步：http://localhost:8080/。

URL Schema

S_HOST和T_HOST的URL遵循以下格式：

安全连接：

(ssl|tls)://hostname(:port_no)?
若未指定端口（如ssl://example.com），默认使用993端口。

未加密连接：

hostname(:port_no)?
若未指定端口（如localhost），默认使用143端口。

流行公共服务（如Gmail、ProtonMail）：

:short_reference
详见下方短引用列表。

短引用列表

mailsync预定义了常见***服务的IMAP URL，可直接使用以下简称：

• :fastmail - FastMail
• :gmail - Gmail和Google Workspace IMAP
• :gmx - GMX Mail
• :icloud - iCloud Mail
• :ms365 - Microsoft Office 365***
• :outlook - Microsoft Outlook.com***
• :ovh-europe - OVH欧洲区域IMAP设置
• :ovh-north_america - OVH北美区域IMAP设置
• :ovh-asia_pacific - OVH亚太区域IMAP设置
• :*** - *** Mail
• :yandex - Yandex Mail
• :zoho - Zoho Mail和Zoho Mail Business
• :protonb - Proton Mail Bridge（通过localhost访问）

特殊***说明

Gmail

若ImapSync抛出认证错误，可能是由于Gmail的安全限制。Gmail可能要求两步验证（ImapSync不支持），此时需前往Google账户设置→安全，开启“不太安全的应用访问”。同步完成后建议关闭此设置。

ProtonMail（加密***）

ProtonMail通过Proton Bridge支持与常规邮件客户端的端到端加密。要同步ProtonMail邮件，ImapSync需访问本地的Proton Bridge服务。由于Docker默认网络限制，需将容器网络模式设为host（--network=host或network_mode: host）。Proton Bridge会生成专用密码，需用于ImapSync的认证。

ProtonMail示例：

bash
docker run -it -e S_HOST=:gmail -e T_HOST=:protonb \
        -e S_USER=me@gmail.com -e T_USER=new.me@proton.me \
        --network=host \
        docker.xuanyuan.run/200ms/imapsync_ah2

ImapSync与MailSync

ImapSync是一款命令行工具，用于在IMAP服务器间迁移和同步邮件，保留文件夹结构和元数据。MailSync是ImapSync的包装器，提供本文档所述功能。
使用mailsync -h获取更多帮助信息。

待办事项

• 增加Gmail安全认证支持
• 考虑定期同步功能（如mailsync --every 2h）

故障排除

Web服务器启动失败（