aspettl/mailadmin Docker 镜像 - 轩辕镜像

Mailadmin

GitHub地址: [***]

镜像概述和主要用途

Mailadmin是一个简单工具，用于方便地管理邮件域名、账户和别名地址。它面向仅有少量用户需要管理自己域名的系统，不供终端用户（使用***的用户）使用，但提供了Roundcube密码插件的API。该工具最初为运行docker-mailserver的邮件服务器开发，但也可用于为任何邮件服务器（如Postfix与Dovecot）生成配置文件。

核心功能和特性

UI功能

• 管理域名和域名别名
  • 支持域名捕获全部（catchalls）
• 终端用户***账户
  • 基于crypt的密码哈希
  • "Have I Been Pwned"密码检查
  • 可选邮件转发
• 别名地址
• 黑洞地址（*** addresses）

管理员用户管理

• 支持多个"管理员"用户
• 一个用户仅可管理自己的域名

其他功能

• 可导出配置至docker-mailserver
• 提供Roundcube密码插件API

截图

• 管理域名
• 管理账户

Docker镜像

main分支最新提交的预构建镜像可通过DockerHub获取：

• aspettl/mailadmin:edge
• aspettl/docker-mailserver-configreload:edge

发布版本将以版本号作为Docker镜像标签推送。

使用方法和配置说明

本地试用

需求：

• Ruby（参见.ruby-version）和bundler，用于bundle install安装所有依赖
• MariaDB或MySQL数据库服务器（已运行），通过/var/run/mysqld socket连接，预期用户名为mailadmin，密码为空，对mailadmin_前缀的数据库有全部权限

步骤：

1. 创建数据库：rails db:create
2. 应用迁移：rails db:migrate
3. 加载示例数据：rails db:fixtures:load
4. 启动服务：rails server
5. 访问 http://localhost:3000，使用"***"和密码"test"登录

构建Docker镜像

使用docker-compose build构建所有Docker镜像。

本地Docker环境（ staging ）

• 启动：docker-compose up -d
• 停止：docker-compose down

配置详情参见docker-compose.yml和Dockerfile中的环境变量默认值。
注意：容器启动时会自动应用数据库迁移。

生产环境用户设置

没有管理管理员用户的UI，需通过命令行创建：

1. 进入容器：docker exec或kubectl exec
2. 运行控制台：bundle exec rails console
3. 执行以下Ruby代码创建用户：

ruby
User.create! do |u|
  u.email    = '***'  # 替换为管理员***
  u.password = 'passwordwithatleast10chars'  # 替换为至少10个字符的密码
end

注意：每个用户可创建新域名，仅限制新子域名不得属于其他用户的域名。

集成说明

与docker-mailserver集成

参见docker-compose.yml和integrations/docker-mailserver-configreload。

与Roundcube集成

Roundcube通常通过IMAP连接docker-mailserver，无需特殊配置。仅当Roundcube用户需要修改账户密码时，需参见integrations/roundcube-password-plugin。