mwaeckerlin/roundcube

Roundcube Webmailer Docker镜像

Roundcube是一款基于浏览器的多语言IMAP客户端，拥有类应用程序的用户界面。它提供电子邮件客户端的完整功能，包括MIME支持、地址簿、文件夹操作、邮件搜索和拼写检查。

本镜像继承自https://hub.docker.com/r/mwaeckerlin/nginx和https://hub.docker.com/r/mwaeckerlin/php-fpm，用于处理网络流量和执行PHP代码。因此，这些镜像的所有功能在本镜像中同样可用。

卷（Volumes）

配置存储在/etc/roundcube目录下。请务必将此目录存储在持久卷中，否则会丢失用于存储加密密码的DES密钥，导致数据库无法访问。

同时，需永久存储数据库卷（无论是外部数据库如https://hub.docker.com/_/mysql，还是内部SQLite数据库，默认路径为/usr/share/webapps/roundcube/db/sqlite.db）。

配置

主要需要指定：用户设置数据库、IMAP和SMTP服务器。所有配置均为可选，且有实用的默认值。

配置通过环境变量完成。MySQL数据库可通过Docker --link配置，此时环境变量会自动传递。

数据库

需要数据库存储用户配置。默认使用SQLite数据库，路径为/usr/share/webapps/roundcube/db/sqlite.db。请确保将数据库存储在持久卷中。

MySQL

可通过--link your-db-container:mysql链接到MySQL数据库（冒号后的mysql名称很重要）。链接的https://hub.docker.com/_/mysql容器需预先初始化MYSQL_PASSWORD、MYSQL_USER和MYSQL_DATABASE环境变量，本镜像会继承并使用这些变量。

也可连接到本地MySQL服务器（如Docker Swarm中的服务器），使用以下环境变量：

• MYSQL_PASSWORD: 数据库密码（必填）。
• MYSQL_USER: 数据库用户，默认值为roundcube。
• MYSQL_DATABASE: 数据库名称，默认值为roundcube。

数据库和用户必须已存在。

SQLite

若未配置数据库，本镜像默认使用SQLite。需将数据库存储在卷中并定期备份。可通过以下变量指定数据库路径：

• SQLITE_PATH: SQLite数据库文件路径，默认值为/usr/share/webapps/roundcube/db/sqlite.db。

其他数据库

可通过以下环境变量指定任意数据库：

• DB_DSNW: 数据库连接字符串，格式遵循http://pear.php.net/manual/en/package.database.mdb2.intro-dsn.php规范。

IMAP服务器

IMAP服务器用于存储邮件。默认情况下，用户可在登录时指定任意IMAP服务器。

通过DEFAULT_HOST环境变量定义可访问的IMAP服务器：

• 空值（默认）：登录界面提供文本框，用户需输入要连接的IMAP主机。
• 单个主机名：仅连接该主机，用户无法选择。
• 逗号+空格（, ）分隔的主机列表（无需引号），以下拉框形式呈现（逗号后需有一个空格）。示例：

  bash
  -e 'DEFAULT_HOST=mail.example.com => 默认服务器, ssl://webmail.example.com => Webmail服务器, ssl://mail.example.com:993 => 安全Webmail服务器'
  

使用ssl://或tls://前缀启用SSL/TLS连接（强烈推荐）。可通过=>（前后各一个空格）为主机添加名称（名称不能包含逗号）。

其他相关变量：

• USERNAME_DOMAIN: 自动为登录用户名添加域名（仅适用于需要完整***地址登录的IMAP服务器）。
• LOGIN_LC: 是否将用户名转换为小写，默认值2（转换整个用户名）。

SMTP

SMTP用于发送邮件。默认情况下，SMTP服务器与IMAP服务器相同，且使用相同的用户名和密码登录。

• SMTP_SERVER: 用于发送邮件的SMTP服务器，默认值为%h（用户的IMAP主机名）。使用SSL/TLS连接时，需添加ssl://或tls://前缀。
• SMTP_USER: SMTP用户名，默认值%u（与IMAP登录用户名相同）。
• SMTP_PASS: SMTP密码，默认值%p（与IMAP登录密码相同）。

外观与安全

• 外观: PRODUCT_NAME（服务名称）、SKIN_LOGO（替换Logo的URL）、SUPPORT_URL（支持页面URL）。
• 安全: IP_CHECK（会话授权时检查客户端IP，默认false）。

拼写检查

SPELLCHECK_ENGINE设置拼写检查引擎，可选值：off（禁用）、pspell（默认）、enchant、googie（外部服务）。

用户默认设置

包括LANGUAGE（默认语言）、SKIN（主题，默认larry）、PREFER_HTML（是否优先显示HTML邮件，默认false）、DRAFT_AUTOSAVE（草稿自动保存间隔，默认300秒）等。

插件

默认启用多个插件（如archive、markasjunk、zipdownload等）。可通过PLUGINS环境变量指定插件列表（逗号+空格分隔）。

示例

最简配置

bash
docker run -d -p 8005:8080 --name roundcube mwaeckerlin/roundcube

MySQL配置

bash
# 创建MySQL持久卷容器
docker run -d --restart unless stopped \
           --name roundcube-mysql-volume \
           mysql \
           sleep infinity
# 启动MySQL容器
docker run -d --restart unless stopped \
           --name roundcube-mysql \
           --volumes-from roundcube-mysql-volume \
           -e MYSQL_DATABASE=roundcube \
           -e MYSQL_USER=roundcube \
           -e MYSQL_PASSWORD=$(pwgen -s 20 1) \
           -e MYSQL_ROOT_PASSWORD=$(pwgen -s 20 1) \
           mysql
# 启动Roundcube容器
docker run -d --restart unless stopped \
           --name roundcube \
           -p 8005:8080 \
           --link roundcube-mysql:mysql \
           mwaeckerlin/roundcube