jcabillot/offlineimap

Docker镜像：动态参数的offlineimap启动工具

镜像概述

本Docker镜像提供了一种便捷方式来运行offlineimap（一款IMAP邮件同步工具），支持通过动态参数配置运行行为，无需预先构建镜像即可灵活调整同步参数，简化邮件同步流程的部署与管理。

核心功能与特性

• 动态参数支持：允许在运行时通过命令行直接传递offlineimap参数，无需修改Dockerfile或重新构建镜像
• 轻量级设计：基于精简基础镜像（如Alpine）构建，减少镜像体积，提升运行效率
• 简化部署流程：无需手动安装offlineimap依赖，通过容器化方式快速启动
• 灵活配置兼容：支持offlineimap原生的所有命令行参数，保持工具原有功能完整性

使用场景与适用范围

• 个人或小型团队的邮件本地同步需求
• 需要频繁调整同步参数（如同步频率、日志级别、配置文件路径等）的场景
• 自动化邮件备份脚本或定时任务集成
• 开发/测试环境中快速验证offlineimap不同参数组合的效果
• 临时邮件同步任务（一次性同步后自动退出）

使用方法与配置说明

基本用法

通过docker run命令直接运行，将offlineimap参数作为命令后缀传递：

bash
docker run --rm [镜像名称] [offlineimap参数]

参数说明

支持offlineimap的所有原生命令行参数，常用参数包括：

• -s <配置文件路径>：指定offlineimap配置文件（需配合数据卷挂载宿主机配置文件）
• -o：执行一次同步后退出（非后台持续运行模式）
• -d <调试级别>：启用调试模式，可选级别：imap（IMAP协议调试）、maildir（Maildir调试）、all（全部调试）
• -u <界面类型>：指定用户界面类型，如tty（终端输出）、quiet（静默模式）

配置文件挂载示例

若需使用自定义配置文件，通过-v参数挂载宿主机配置文件到容器内：

bash
# 挂载宿主机./offlineimaprc到容器内/config目录，并指定配置文件路径
docker run --rm -v $(pwd)/offlineimaprc:/config/offlineimaprc [镜像名称] -s /config/offlineimaprc -o

调试模式运行示例

启用IMAP协议调试并执行一次同步：

bash
docker run --rm [镜像名称] -d imap -o

静默模式后台同步示例

bash
docker run -d --name imap-sync [镜像名称] -u quiet

注：[镜像名称]需替换为实际的Docker镜像标签（如构建后的本地镜像名或仓库镜像地址）。