instrumentisto/haraka

Haraka Docker镜像

https://github.com/instrumentisto/haraka-docker-image/actions/workflows/ci.yml/badge.svg?branch=main "CI"](https://github.com/instrumentisto/haraka-docker-image/actions?query=workflow%3ACI+branch%3Amain)

https://hub.docker.com/r/instrumentisto/haraka | https://github.com/orgs/instrumentisto/packages/container/package/haraka | Quay.io

https://github.com/instrumentisto/haraka-docker-image/blob/main/CHANGELOG.md

支持的标签及对应的Dockerfile链接

• https://github.com/instrumentisto/haraka-docker-image/blob/main/Dockerfile%3C/think%3E===SHORT_DESC===

支持的平台

• linux: amd64, arm64v8

什么是Haraka？

https://haraka.github.io是一个开源SMTP服务器，采用Node.js编写，具备极高的性能，同时拥有灵活的插件系统，允许Javascript程序员全面修改服务器行为。

https://haraka.github.io

https://github.com/haraka/Haraka

!https://haraka.github.io/icon.png "Haraka Logo"

如何使用此镜像

要运行https://haraka.github.io邮件服务器，只需启动容器：

bash
docker run -d -p 25:25 instrumentisto/haraka

配置

默认情况下，镜像使用/etc/haraka/config/目录中的默认配置文件。如需使用自定义配置文件，应挂载该文件：

bash
docker run -d -p 25:25 \
           -v /path/to/my/smtp.ini:/etc/haraka/config/smtp.ini:ro \
       instrumentisto/haraka

插件

注意！ 安装https://haraka.github.io/core/Plugins后，务必在/etc/haraka/config/plugins文件中启用它们。

NPM打包插件

https://haraka.github.io/core/Plugins#plugins-as-modules可通过HARAKA_INSTALL_PLUGINS环境变量轻松安装。将其指定为逗号分隔的NPM包，容器将在启动时运行npm install：

bash
docker run -d -p 25:25 \
           -v /path/to/my/plugins:/etc/haraka/config/plugins:ro \
           -e HARAKA_INSTALL_PLUGINS=haraka-plugin-rcpt-postgresql,haraka-plugin-auth-enc-file@1.0 \
       instrumentisto/haraka

遗留插件

遗留自定义插件文件可直接挂载到/etc/haraka/plugins目录：

bash
docker run -d -p 25:25 \
           -v /path/to/my-awesome-plugin.js:/etc/haraka/plugins/my-awesome-plugin.js:ro \
           -v /path/to/my/plugins:/etc/haraka/config/plugins:ro \
       instrumentisto/haraka

Alpine包

某些插件（如https://haraka.github.io/plugins/tls）可能需要安装额外的系统库。使用APK_INSTALL_PACKAGES环境变量在容器启动时预安装这些库：

bash
docker run -d -p 25:25 \
           -v /path/to/my/plugins:/etc/haraka/config/plugins:ro \
           -e APK_INSTALL_PACKAGES=openssl \
       instrumentisto/haraka

镜像标签

此镜像基于流行的Alpine Linux项目，可在https://hub.docker.com/_/alpine中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

当希望最终镜像大小尽可能小时，强烈推荐此变体。需要注意的是，它使用musl libc而非glibc及类似库，因此某些软件可能因libc需求深度而遇到问题。然而，大多数软件对此没有问题，因此此变体通常是非常安全的选择。有关可能出现的问题以及使用Alpine基镜像的优缺点比较，请参见此Hacker News评论线程。

<X>

最新X主版本的最新标签。

这是一个多平台镜像。

<X.Y>

最新X.Y次版本的最新标签。

这是一个多平台镜像。

<X.Y.Z>

具体X.Y.Z版本的最新标签。

这是一个多平台镜像。

<X.Y.Z>-node<A>-r<N>

使用A主版本Node.js的具体X.Y.Z版本的第N次镜像修订标签。

构建后永不更新。

这是一个多平台镜像。

<X.Y.Z>-node<A>-r<N>-<os>-<arch>

在特定os和arch上使用A主版本Node.js的具体X.Y.Z版本的第N次镜像修订标签。

构建后永不更新。

这是一个单平台镜像。

许可证

https://haraka.github.io采用https://github.com/haraka/Haraka/blob/master/LICENSE。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。

生成instrumentisto/harakaDocker镜像的https://github.com/instrumentisto/haraka-docker-image采用https://github.com/instrumentisto/haraka-docker-image/blob/main/LICENSE.md许可证。

问题反馈

我们无法注意到https://hub.docker.com（或其他容器仓库）中的评论，因此请勿使用它们报告问题或提问。

如对此镜像有任何问题或疑问，请通过https://github.com/instrumentisto/haraka-docker-image/issues与我们联系。

基于Node.js的高性能开源SMTP服务器Haraka的Docker镜像，具备灵活的插件系统，支持自定义配置与多平台部署，适用于构建可扩展的邮件服务器。 ===FULL_DESC===

Haraka Docker镜像

https://github.com/instrumentisto/haraka-docker-image/actions/workflows/ci.yml/badge.svg?branch=main "CI"](https://github.com/instrumentisto/haraka-docker-image/actions?query=workflow%3ACI+branch%3Amain)

https://hub.docker.com/r/instrumentisto/haraka | https://github.com/orgs/instrumentisto/packages/container/package/haraka | Quay.io

https://github.com/instrumentisto/haraka-docker-image/blob/main/CHANGELOG.md

支持的标签及对应的Dockerfile链接

• https://github.com/instrumentisto/haraka-docker-image/blob/main/Dockerfile%3C/think%3E===SHORT_DESC===

支持的平台

• linux: amd64, arm64v8

什么是Haraka？

https://haraka.github.io是一款开源SMTP服务器，采用Node.js开发，具备极高性能与灵活的插件系统，允许Javascript开发者通过编程全面自定义服务器行为。

https://haraka.github.io

https://github.com/haraka/Haraka

!https://haraka.github.io/icon.png "Haraka Logo"

如何使用此镜像

基本运行

启动Haraka邮件服务器容器：

bash
docker run -d -p 25:25 instrumentisto/haraka

配置

默认配置文件位于/etc/haraka/config/目录。如需使用自定义配置，可挂载配置文件：

bash
docker run -d -p 25:25 \
           -v /path/to/custom/smtp.ini:/etc/haraka/config/smtp.ini:ro \
       instrumentisto/haraka

插件管理

注意：安装https://haraka.github.io/core/Plugins后，需在/etc/haraka/config/plugins文件中启用。

NPM打包插件

通过HARAKA_INSTALL_PACKAGES环境变量指定逗号分隔的NPM包，容器启动时将自动安装：

bash
docker run -d -p 25:25 \
           -v /path/to/plugins.conf:/etc/haraka/config/plugins:ro \
           -e HARAKA_INSTALL_PLUGINS=haraka-plugin-rcpt-postgresql,haraka-plugin-auth-enc-file@1.0 \
       instrumentisto/haraka

遗留插件

将自定义插件文件直接挂载至/etc/haraka/plugins目录：

bash
docker run -d -p 25:25 \
           -v /path/to/custom-plugin.js:/etc/haraka/plugins/custom-plugin.js:ro \
           -v /path/to/plugins.conf:/etc/haraka/config/plugins:ro \
       instrumentisto/haraka

系统依赖

部分插件（如https://haraka.github.io/plugins/tls）需系统库支持，通过APK_INSTALL_PACKAGES环境变量预安装Alpine包：

bash
docker run -d -p 25:25 \
           -v /path/to/plugins.conf:/etc/haraka/config/plugins:ro \
           -e APK_INSTALL_PACKAGES=openssl \
       instrumentisto/haraka

镜像标签说明

此镜像基于Alpine Linux构建（约5MB基础镜像），相比其他发行版更精简。其使用musl libc而非glibc，大多数软件可正常运行，适合对镜像体积有严格要求的场景。关于Alpine基镜像的优缺点讨论，参见Hacker News评论线程。

标签格式说明

• <X>: 最新X主版本的最新标签（多平台）
• <X.Y>: 最新X.Y次版本的最新标签（多平台）
• <X.Y.Z>: 具体X.Y.Z版本的最新标签（多平台）
• <X.Y.Z>-node<A>-r<N>: 基于Node.js A版本的第N次修订标签（多平台，构建后不更新）
• <X.Y.Z>-node<A>-r<N>-<os>-<arch>: 特定系统架构的单平台标签（构建后不更新）

许可证

• https://haraka.github.io核心采用https://github.com/haraka/Haraka/blob/master/LICENSE
• 镜像构建源代码https://github.com/instrumentisto/haraka-docker-image/blob/main/LICENSE.md

使用前请确保遵守所有包含软件的许可证要求。

问题反馈

请勿在容器仓库评论区反馈问题。如有疑问或问题，请通过https://github.com/instrumentisto/haraka-docker-image/issues提交。