kizaing/kavitaemail

Kavita Email 镜像文档

镜像概述

Kavita Email是一个轻量级邮件中继服务器，专门用于处理Kavita应用的邮件发送请求。默认情况下，Kavita应用使用其托管的邮件服务，而本镜像提供了一种替代方案，允许用户部署自己的SMTP服务实例来管理邮件发送。

注意：当前仓库仅用于归档，不再更新。最新镜像请访问 https://hub.docker.com/r/jvmilazz0/kavitaemail%E3%80%82

核心功能与特性

• 处理Kavita应用生成的邮件发送请求
• 支持用户自定义SMTP服务配置
• 轻量级微服务架构，资源占用低
• 通过配置文件灵活调整邮件发送参数

使用场景与适用范围

适用于需要自行管理邮件发送流程，不希望依赖Kavita默认托管邮件服务的Kavita用户。典型使用场景包括：

• 企业或组织内部部署，需符合特定邮件安全策略
• 对邮件发送有自定义需求（如特定SMTP服务器、发件人信息等）
• 需要提高邮件送达率或跟踪邮件发送状态

使用方法与配置说明

Docker Run 部署

通过以下命令快速启动容器：

bash
docker run --name kavita-email -p 5003:5003 -v ${PWD}/config:/app/config -d kizaing/kavitaemail:latest

参数说明：

• --name kavita-email：指定容器名称
• -p 5003:5003：映射容器端口到主机（容器内固定使用5003端口）
• -v ${PWD}/config:/app/config：挂载本地目录到容器内配置目录，用于持久化配置
• -d：后台运行容器
• kizaing/kavitaemail:latest：使用最新版本镜像

Docker Compose 部署

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  email:
    image: kizaing/kavitaemail:latest
    container_name: kavita-email
    volumes:
      - ./config:/app/config
    ports:
      - "5003:5003"
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置步骤

1. 首次运行容器：按照上述方法启动容器，此时会在挂载的config目录下生成默认配置文件
2. 停止容器：修改配置前需停止容器

   bash
   docker stop kavita-email
   # 或使用docker-compose: docker-compose down
   

3. 编辑配置文件：打开config目录下的appsettings.json文件，根据需求配置SMTP参数（如SMTP服务器地址、端口、认证信息等）
4. 重启容器：应用配置变更

   bash
   docker start kavita-email
   # 或使用docker-compose: docker-compose up -d
   

配置文件修改完成并重启后，Kavita Email服务将使用自定义的SMTP设置处理邮件发送。