okooooooo/temp_mail

0 Fork 0

Files

T

Nei-Xin 715c9c83b3 init

2025-10-18 15:32:52 +08:00

26 KiB

Raw Blame History

Temp Mail - 临时邮箱服务# Temp Mail - 临时邮箱服务# Temp Mail - 临时邮箱服务

一个轻量级的临时邮箱服务，使用 Go 语言实现。支持收发邮件，提供简洁的 Web 界面。

✨ 特性一个轻量级的临时邮箱服务，使用 Go 语言实现。支持收发邮件，提供简洁的 Web 界面。一个轻量级的临时邮箱服务，使用 Go 语言实现。

📧 SMTP 邮件接收：监听 25 端口，接收外部邮件
📤 SMTP 邮件发送：使用临时邮箱地址发送邮件，自动查找 MX 记录
🎯 标签页界面：收件箱和发送邮件切换方便## ✨ 特性## ✨ 特性
💾 内存存储：邮件自动过期（默认 1 小时）
🐳 Docker 支持：一键部署，镜像仅 24.5MB
🔧 灵活配置：支持 IP 或自定义域名，无需修改代码
📧 SMTP 邮件接收：监听 25 端口，接收外部邮件- 📧 SMTP 邮件接收（端口 25）

📤 SMTP 邮件发送：使用临时邮箱地址发送邮件，自动查找 MX 记录- 📤 SMTP 邮件发送（支持 Gmail、163、QQ 等）

🚀 快速开始

🎯 标签页界面：收件箱和发送邮件切换方便- 🌐 Web 界面（端口 8080）

Docker Compose 部署（推荐）

💾 内存存储：邮件自动过期（默认 1 小时）- 💾 内存存储，自动过期（默认 30 分钟）


# 1. 克隆项目- 🐳 **Docker 支持**：一键部署，镜像仅 24.5MB- 🐳 Docker 支持，一键部署

git clone <your-repo>

cd temp_mail- 🔧 **灵活配置**：支持 IP 或自定义域名，无需修改代码- 🔧 环境变量配置，无需修改代码



# 2. 修改配置（可选）

nano .env  # 修改 DOMAIN 为你的域名或 IP

------

# 3. 启动服务

docker-compose up -d



# 4. 访问 Web 界面## 🚀 快速开始## 🚀 快速开始

http://your-server:8080

Docker Run 部署### Docker Compose 部署（推荐）### 方式 1: Docker Compose（推荐）


docker pull neixin/temp-mail:v2.0

```bash```bash

docker run -d \

  --name temp-mail \# 1. 克隆项目# 1. 修改配置

  -p 8080:8080 \

  -p 25:25 \git clone <your-repo>nano .env  # 修改 DOMAIN 为你的域名

  -e DOMAIN=101.44.160.108 \

  -e MESSAGE_TTL=3600 \cd temp_mail

  neixin/temp-mail:v2.0

```# 2. 启动服务



### 本地编译运行# 2. 修改配置（可选）docker-compose up -d



```bashnano .env  # 修改 DOMAIN 为你的域名或 IP

# 1. 安装依赖

go mod tidy# 3. 访问 Web 界面



# 2. 编译# 3. 启动服务http://localhost:8080

go build -o temp-mail ./cmd/temp-mail

docker-compose up -d```

# 3. 运行

./temp-mail



# 4. 访问# 4. 访问 Web 界面### 方式 2: Docker Run

http://localhost:8080

```http://your-server:8080



---``````bash



## ⚙️ 配置docker run -d \



通过 `.env` 文件或环境变量配置：### Docker Run 部署  --name temp-mail \



| 变量 | 默认值 | 说明 |  -p 8080:8080 \

|------|--------|------|

| `HTTP_ADDR` | `:8080` | HTTP 服务监听地址 |```bash  -p 25:25 \

| `SMTP_ADDR` | `:25` | SMTP 接收服务监听地址 |

| `DOMAIN` | `localhost` | 邮件域名（支持 IP 地址） |docker pull neixin/temp-mail:v2.0  -e DOMAIN=mail.example.com \

| `MESSAGE_TTL` | `3600` | 邮件保留时间（秒） |

| `TZ` | `Asia/Shanghai` | 时区 |  neixin/temp-mail:latest



**配置文件示例（.env）：**docker run -d \```



```bash  --name temp-mail \

HTTP_ADDR=:8080

SMTP_ADDR=:25  -p 8080:8080 \### 方式 3: 本地编译运行

DOMAIN=mail.example.com

MESSAGE_TTL=3600  -p 25:25 \

TZ=Asia/Shanghai

```  -e DOMAIN=101.44.160.108 \```bash



---  -e MESSAGE_TTL=3600 \# 1. 编译



## 📖 使用说明  neixin/temp-mail:v2.0go mod tidy



### 接收邮件```go build ./cmd/temp-mail



1. 访问 Web 界面（http://your-server:8080）

2. 输入自定义邮箱名称，点击"创建邮箱"

3. 复制生成的邮箱地址（如：test@your-domain.com）### 本地编译运行# 2. 运行

4. 使用该地址接收邮件

5. 邮件会自动显示在"📨 收件箱"标签页中./temp-mail



### 发送邮件```bash



1. 切换到"📤 发送邮件"标签页# 1. 安装依赖# 3. 访问

2. 填写以下信息：

   - **发件人**：输入邮箱本地部分（如：test）go mod tidyhttp://localhost:8080

   - **收件人**：目标邮箱地址（多个用逗号分隔）

   - **主题**：邮件主题```

   - **内容**：邮件正文

3. 点击"📤 发送"按钮# 2. 编译

4. 如果发件人邮箱不存在，系统会自动创建

go build -o temp-mail ./cmd/temp-mail---

**工作原理**：

- 使用您创建的临时邮箱地址作为发件人

- 系统自动查找收件人的 MX 记录

- 直接连接对方邮件服务器发送邮件# 3. 运行## ⚙️ 配置

- 无需配置第三方 SMTP 服务

./temp-mail

**⚠️ 发送限制说明**：

- ✅ **可以发送**：QQ.com、163.com、126.com 等国内邮箱通过环境变量配置，无需修改代码：

- ⚠️ **可能失败**：Gmail、Hotmail、Outlook 等国际邮箱（它们有严格的反垃圾邮件策略，会拒绝未认证 IP 的连接）

- 💡 **提高成功率**：配置 DNS（SPF、PTR 记录）、使用有信誉的服务器 IP# 4. 访问



---http://localhost:8080### 基础配置



## 🌐 生产环境部署```



### 端口要求| 变量 | 默认值 | 说明 |



| 端口 | 用途 | 说明 |---|------|--------|------|

|------|------|------|

| **25** | SMTP 邮件接收 | 接收外部邮件（Gmail、Outlook 等） || `HTTP_ADDR` | `:8080` | HTTP 服务监听地址 |

| **8080** | HTTP Web 界面 | 查看和发送邮件 |

## ⚙️ 配置| `SMTP_ADDR` | `:25` | SMTP 接收服务监听地址 |

### DNS 配置（可选）

| `DOMAIN` | `tmp.local` | 邮件域名 |

如果使用自定义域名，建议配置以下 DNS 记录以提高邮件送达率：

通过 `.env` 文件或环境变量配置：| `MESSAGE_TTL` | `30m` | 邮件保留时间 |

类型名称值优先级| TZ | Asia/Shanghai | 时区 |

A mail.example.com 服务器IP -

MX example.com mail.example.com 10| 变量 | 默认值 | 说明 |

TXT example.com v=spf1 ip4:服务器IP -all -




**说明**：| `HTTP_ADDR` | `:8080` | HTTP 服务监听地址 |

- **A 记录**：域名指向服务器 IP

- **MX 记录**：邮件路由记录| `SMTP_ADDR` | `:25` | SMTP 接收服务监听地址 |```bash

- **SPF 记录**：提高发送邮件的可信度，减少被拒绝的概率

- **PTR 记录**：反向解析，需要联系服务器提供商配置| `DOMAIN` | `localhost` | 邮件域名（支持 IP 地址） |# 基础配置



### 防火墙配置| `MESSAGE_TTL` | `3600` | 邮件保留时间（秒） |HTTP_ADDR=:8080



```bash| `TZ` | `Asia/Shanghai` | 时区 |SMTP_ADDR=:25

# 开放端口

sudo ufw allow 25/tcpDOMAIN=mail.example.com

sudo ufw allow 8080/tcp

sudo ufw enable**配置文件示例（.env）：**MESSAGE_TTL=30m

TZ=Asia/Shanghai

bash

📡 API 接口

HTTP_ADDR=:8080

创建邮箱地址

SMTP_ADDR=:25---


POST /api/address?local=testDOMAIN=mail.example.com

MESSAGE_TTL=3600## 🌐 生产环境部署

响应：


{

  "address": "test@example.com",```### 端口要求

  "local": "test",

  "ttl": 3600

}

```---| 端口 | 用途 | 说明 |



### 获取邮件列表|------|------|------|



```http## 📖 使用说明| **25** | SMTP 邮件接收 | 接收外部邮件（Gmail、Outlook 等） |

GET /api/messages/{local}

```| **8080** | HTTP Web 界面 | 查看邮件 |



**响应**：### 接收邮件

```json

[### DNS 配置

  {

    "id": "abc123",1. 访问 Web 界面（http://your-server:8080）

    "from": "sender@gmail.com",

    "to": ["test@example.com"],2. 输入自定义邮箱名称，点击"创建邮箱"添加以下 DNS 记录：

    "subject": "测试邮件",

    "received": "2025-10-18T10:30:00Z"3. 复制生成的邮箱地址（如：test@your-domain.com）

  }

]4. 使用该地址接收邮件```

邮件会自动显示在"📨 收件箱"标签页中类型名称值优先级

获取邮件详情

A mail.example.com 服务器IP -


GET /api/messages/{local}/{id}### 发送邮件MX      example.com             mail.example.com    10

GET /api/messages/{local}/{id}?format=raw  # 获取原始邮件

发送邮件1. 切换到"📤 发送邮件"标签页


POST /api/send

Content-Type: application/json   - **发件人**：输入邮箱本地部分（如：test）



{   - **收件人**：目标邮箱地址（多个用逗号分隔）```bash

  "from": "test",

  "to": ["recipient@example.com"],   - **主题**：邮件主题# 1. 克隆项目

  "subject": "测试邮件",

  "body": "邮件正文内容",   - **内容**：邮件正文git clone <your-repo>

  "html": "<p>HTML内容</p>"

}3. 点击"📤 发送"按钮cd temp_mail

如果发件人邮箱不存在，系统会自动创建

响应（成功）：


{

  "success": true,**工作原理**：cp .env .env.local

  "message": "邮件已发送",

  "from": "test@example.com"- 使用您创建的临时邮箱地址作为发件人nano .env.local  # 修改 DOMAIN

}

```- 系统自动查找收件人的 MX 记录



---- 直接连接对方邮件服务器发送邮件# 3. 启动服务



## 🐳 Docker 镜像- 无需配置第三方 SMTP 服务docker-compose up -d



### 镜像信息



- **镜像名称**：`neixin/temp-mail`---# 4. 查看日志

- **最新版本**：`v2.0`

- **镜像大小**：24.5MBdocker-compose logs -f

- **基础镜像**：Alpine Linux

## 🌐 生产环境部署

### 拉取镜像

# 5. 测试

```bash

docker pull neixin/temp-mail:v2.0### 端口要求# 发送邮件到 test@example.com

docker pull neixin/temp-mail:latest

```# 访问 http://mail.example.com:8080



### 构建镜像| 端口 | 用途 | 说明 |```



```bash|------|------|------|

# 构建

docker build -t neixin/temp-mail:v2.0 .| **25** | SMTP 邮件接收 | 接收外部邮件（Gmail、Outlook 等） |---



# 运行| **8080** | HTTP Web 界面 | 查看和发送邮件 |

docker run -d -p 8080:8080 -p 25:25 \

  -e DOMAIN=your-domain.com \## � 使用说明

  neixin/temp-mail:v2.0

```### DNS 配置（可选）



---### 接收邮件



## 🔧 开发如果使用自定义域名，建议配置以下 DNS 记录以提高邮件送达率：



### 项目结构1. 访问 Web 界面（http://your-server:8080）



``````2. 输入自定义邮箱名称（可选），点击"创建邮箱"

temp_mail/

├── cmd/temp-mail/      # 主程序入口类型    名称                    值                  优先级3. 复制生成的邮箱地址

│   └── main.go

├── internal/A       mail.example.com        服务器IP            -4. 使用该地址接收邮件

│   ├── httpapi/        # HTTP 服务和 Web 界面

│   ├── smtpserver/     # SMTP 接收服务器MX      example.com             mail.example.com    105. 邮件会自动显示在收件箱中

│   ├── smtpclient/     # SMTP 发送客户端（MX 查询）

│   └── storage/        # 内存存储TXT     example.com             v=spf1 ip4:服务器IP -all

├── Dockerfile          # Docker 镜像构建

├── docker-compose.yml  # Docker Compose 配置```### 发送邮件

├── .env                # 环境变量配置

└── README.md           # 项目文档

说明：1. 首先创建一个临时邮箱（如果还没有）

本地开发

A 记录：域名指向服务器 IP2. 在 Web 界面中，找到"📤 发送邮件"卡片


# 安装依赖- **MX 记录**：邮件路由记录3. 点击"✍️ 写邮件"按钮展开表单

go mod tidy

- **SPF 记录**：提高发送邮件的可信度（可选）4. 填写以下信息：

# 运行

go run ./cmd/temp-mail   - **发件人**：自动使用您创建的邮箱地址（不可修改）



# 测试### 防火墙配置   - **收件人**：目标邮箱地址（必填，多个收件人用逗号分隔）

go test ./...

   - **主题**：邮件主题（必填）

# 编译

go build -o temp-mail ./cmd/temp-mail```bash   - **内容**：邮件正文（必填）

开放端口5. 点击"📤 发送"按钮发送邮件

sudo ufw allow 25/tcp

💡 注意事项

sudo ufw allow 8080/tcp工作原理：

数据存储：所有邮件存储在内存中，重启服务后数据会丢失
端口 25：监听 25 端口需要 root 权限或使用 Dockersudo ufw enable- 使用您创建的临时邮箱地址作为发件人
防火墙：确保开放 25 和 8080 端口
云服务商：部分云服务商（阿里云、腾讯云）封禁 25 端口，无法接收外部邮件```- 系统通过查找收件人的 MX 记录，直接发送邮件到对方邮件服务器
DNS 配置：使用 IP 地址也可以正常工作，DNS 仅用于提高送达率
发送限制：Gmail/Hotmail 等大型邮箱可能拒绝连接，建议先测试国内邮箱- 无需配置第三方 SMTP 服务

🔒 安全建议---

使用 Nginx 反向代理，配置 SSL/TLS## 📡 API 接口
限制访问来源（防火墙规则）
定期更新 Docker 镜像## �📡 API
监控日志，防止滥用
不要用于生产环境敏感数据### 创建邮箱地址

---### 创建邮箱地址

📚 常见问题```http

Q1: 无法接收外部邮件？POST /api/address?local=test```bash

检查：```POST /api/address?local=test

DNS MX 记录是否正确
防火墙是否开放 25 端口
云服务商是否封禁 25 端口（阿里云、腾讯云默认封禁）
SMTP 服务是否正常运行：docker logs temp-mail响应：返回:

Q2: 发送邮件失败？```json{

常见原因及解决方案：{ "address": "test@example.com",

1. Gmail/Hotmail/Outlook 拒绝连接（最常见） "address": "test@example.com", "local": "test",

现象： "local": "test", "ttl": 30


发送失败: 无法连接到 gmail.com 的任何MX服务器  "ttl": 3600}

}```

原因：

Gmail、Hotmail、Outlook 等大型邮件服务商有严格的反垃圾邮件策略```
会直接拒绝来自未认证 IP 的 SMTP 连接
需要 IP 具有良好的发信信誉### 获取邮件列表

解决方案：### 获取邮件列表

✅ 先测试国内邮箱：QQ.com、163.com、126.com（成功率高）
✅ 配置 PTR 记录：联系服务器提供商配置反向 DNS 解析```bash
✅ 配置 SPF 记录：在域名 DNS 中添加 v=spf1 ip4:你的IP -all
✅ 配置 DKIM/DMARC：进一步提高邮件信誉```httpGET /api/messages/{local}
✅ 使用有信誉的服务器：避免使用廉价 VPS 的共享 IP
⏳ 建立 IP 信誉：Gmail 通常需要较长时间（数周到数月）才能接受新 IPGET /api/messages/{local}

2. 其他常见问题```返回:

收件人邮箱地址错误：检查邮箱格式[
MX 记录查询失败：网络或 DNS 问题
IP 被列入黑名单：使用 MXToolbox 检查响应： {
对方服务器临时故障：稍后重试


**测试建议**：

```bash[    "from": "sender@gmail.com",

# 1. 先测试国内邮箱（成功率高）

curl -X POST http://localhost:8080/api/send -H "Content-Type: application/json" -d '{  {    "to": ["test@example.com"],

  "from": "test",

  "to": ["your@qq.com"],    "id": "abc123",    "subject": "测试邮件",

  "subject": "测试邮件",

  "body": "这是一封测试邮件"    "from": "sender@gmail.com",    "received": "2025-10-17T10:30:00Z"

}'

    "to": ["test@example.com"],  }

# 2. 查看详细日志

docker logs -f temp-mail    "subject": "测试邮件",]

"received": "2025-10-18T10:30:00Z"```

Q3: 如何使用自定义域名？

}

修改 .env 文件中的 DOMAIN
配置 DNS A 记录和 MX 记录]### 获取邮件详情
重启服务：docker-compose restart


### Q4: 邮件保留多久？

```bash

默认 1 小时（3600 秒），可通过 `MESSAGE_TTL` 配置。

### 获取邮件详情GET /api/messages/{local}/{id}

### Q5: 如何配置 HTTPS？



使用 Nginx 反向代理：

```http# 获取原始邮件

```nginx

server {GET /api/messages/{local}/{id}GET /api/messages/{local}/{id}?format=raw

    listen 443 ssl http2;

    server_name mail.example.com;GET /api/messages/{local}/{id}?format=raw  # 获取原始邮件```

    

    ssl_certificate /path/to/cert.pem;```

    ssl_certificate_key /path/to/key.pem;

    ### 发送邮件

    location / {

        proxy_pass http://localhost:8080;### 发送邮件

        proxy_set_header Host $host;

        proxy_set_header X-Real-IP $remote_addr;```bash

    }

}```httpPOST /api/send

POST /api/send

Q6: 为什么可以发送到 QQ 但不能发送到 Gmail？

Content-Type: application/json请求体:

这是正常现象：

{

| 邮件服务商 | 发送成功率 | 说明 |

|-----------|----------|------|{ "from": "test", // 必填，您创建的邮箱本地部分

| QQ.com, 163.com, 126.com | ✅ 高 | 反垃圾策略相对宽松 |

| Gmail, Hotmail, Outlook | ⚠️ 低 | 需要 IP 信誉、PTR、SPF、DKIM 等配置 | "from": "test", "to": ["recipient@example.com"], // 必填，收件人列表

| 企业邮箱 | 🔄 中等 | 取决于具体配置 |

"to": ["recipient@example.com"], "subject": "测试邮件", // 必填

建议：

用于测试和开发：使用国内邮箱即可 "subject": "测试邮件", "body": "邮件正文内容", // 必填
用于生产环境：需要完整配置 DNS 记录并建立 IP 信誉
发送重要邮件：建议使用专业邮件服务（SendGrid、Amazon SES 等） "body": "邮件正文内容", "html": "
HTML内容
" // 可选，HTML格式邮件

--- "html": "

HTML内容

📄 许可证}

MIT License```返回（成功）:

---{

🙏 致谢响应（成功）： "success": true,

基于 emersion/go-smtp 构建```json "message": "邮件已发送",

---{ "from": "test@mail.example.com"

开始使用临时邮箱服务！ 🎉 "success": true,}

"message": "邮件已发送",

"from": "test@example.com"返回（失败）:

}{


}

---```



## 🐳 Docker 镜像---



### 镜像信息## 🐳 Docker 镜像



- **镜像名称**：`neixin/temp-mail`### 拉取镜像

- **最新版本**：`v2.0`

- **镜像大小**：24.5MB```bash

- **基础镜像**：Alpine Linuxdocker pull neixin/temp-mail:latest

拉取镜像

构建镜像


docker pull neixin/temp-mail:v2.0```bash

docker pull neixin/temp-mail:latest# 构建

```docker build -t neixin/temp-mail:latest .



### 构建镜像# 推送到 Docker Hub

docker push neixin/temp-mail:latest

```bash```

# 构建

docker build -t neixin/temp-mail:v2.0 .---



# 运行## 🔧 开发

docker run -d -p 8080:8080 -p 25:25 \

  -e DOMAIN=your-domain.com \### 项目结构

  neixin/temp-mail:v2.0

temp_mail/

---├── cmd/temp-mail/ # 主程序入口

├── internal/

🔧 开发│ ├── httpapi/ # HTTP 服务和 Web 界面

│ ├── smtpserver/ # SMTP 接收服务器

项目结构│ ├── smtpclient/ # SMTP 发送客户端

│ └── storage/ # 内存存储


temp_mail/├── docker-compose.yml  # Docker Compose 配置

├── cmd/temp-mail/      # 主程序入口└── .env                # 环境变量配置

│   └── main.go```

├── internal/

│   ├── httpapi/        # HTTP 服务和 Web 界面### 本地开发

│   ├── smtpserver/     # SMTP 接收服务器

│   ├── smtpclient/     # SMTP 发送客户端（MX 查询）```bash

│   └── storage/        # 内存存储# 安装依赖

├── Dockerfile          # Docker 镜像构建go mod tidy

├── docker-compose.yml  # Docker Compose 配置

├── .env                # 环境变量配置# 运行

└── README.md           # 项目文档go run ./cmd/temp-mail

测试

本地开发go test ./...


```bash

# 安装依赖---

go mod tidy

## � 注意事项

# 运行

go run ./cmd/temp-mail1. **数据存储**：所有邮件存储在内存中，重启服务后数据会丢失

2. **端口 25**：监听 25 端口需要 root 权限或 Docker

# 测试3. **防火墙**：确保开放 25 和 8080 端口

go test ./...4. **DNS 配置**：接收外部邮件需要正确配置 MX 记录

5. **安全性**：建议配置 Nginx 反向代理和 SSL 证书

# 编译

go build -o temp-mail ./cmd/temp-mail---

🔒 安全建议

使用 Nginx 反向代理，配置 SSL/TLS

💡 注意事项- 限制 8080 端口的访问（仅内网或特定 IP）

定期更新 Docker 镜像

数据存储：所有邮件存储在内存中，重启服务后数据会丢失- 监控日志，防止滥用
端口 25：监听 25 端口需要 root 权限或使用 Docker
防火墙：确保开放 25 和 8080 端口---
云服务商：部分云服务商（阿里云、腾讯云）封禁 25 端口，无法接收外部邮件
DNS 配置：使用 IP 地址也可以正常工作，DNS 仅用于提高送达率## 📚 常见问题

---### Q1: 无法接收外部邮件？

🔒 安全建议检查：

DNS MX 记录是否正确
使用 Nginx 反向代理，配置 SSL/TLS- 防火墙是否开放 25 端口
限制访问来源（防火墙规则）- 云服务商是否封禁 25 端口（Aliyun、Tencent 默认封禁）
定期更新 Docker 镜像
监控日志，防止滥用### Q2: 如何修改域名？
不要用于生产环境敏感数据

修改 .env 文件中的 DOMAIN，重启服务即可，无需重新编译。

Q3: 如何配置 SSL？

📚 常见问题

使用 Nginx 反向代理：

Q1: 无法接收外部邮件？


**检查**：server {

- DNS MX 记录是否正确    listen 443 ssl http2;

- 防火墙是否开放 25 端口    server_name mail.example.com;

- 云服务商是否封禁 25 端口（阿里云、腾讯云默认封禁）    

- SMTP 服务是否正常运行：`docker logs temp-mail`    ssl_certificate /path/to/cert.pem;

    ssl_certificate_key /path/to/key.pem;

### Q2: 发送邮件失败？    

    location / {

**可能原因**：        proxy_pass http://localhost:8080;

- 收件人邮箱地址错误    }

- 对方邮件服务器 MX 记录查询失败}

- 对方服务器拒绝接收（IP 信誉问题）```

- 检查日志：`docker logs temp-mail`

---

### Q3: 如何使用自定义域名？

## 📄 许可证

1. 修改 `.env` 文件中的 `DOMAIN`

2. 配置 DNS A 记录和 MX 记录MIT License

3. 重启服务：`docker-compose restart`

---

### Q4: 邮件保留多久？

## 🙏 致谢

默认 1 小时（3600 秒），可通过 `MESSAGE_TTL` 配置。

基于 [emersion/go-smtp](https://github.com/emersion/go-smtp) 构建

### Q5: 如何配置 HTTPS？

---

使用 Nginx 反向代理：

**开始使用临时邮箱服务！** 🎉

```nginx| **2525** | SMTP 邮件接收 | ✅ 必需 | 普通用户 |

server {| **80** | HTTP（通过 Nginx） | ⚪ 可选 | 需要 root |

    listen 443 ssl http2;| **443** | HTTPS（通过 Nginx） | ⚪ 可选 | 需要 root |

    server_name mail.example.com;| **25** | SMTP 标准端口 | ⚪ 可选 | 需要 root |

    

    ssl_certificate /path/to/cert.pem;**✅ 25端口封禁？没问题！**

    ssl_certificate_key /path/to/key.pem;- 本项目默认使用 **2525 端口**，不依赖 25 端口

    - 可以在**阿里云、腾讯云、AWS** 等封禁 25 端口的服务器上正常运行

    location / {- 适用于内部测试、开发环境、团队协作

        proxy_pass http://localhost:8080;- 详细说明请查看 [25端口封禁环境部署指南](PORT25_BLOCKED.md)

        proxy_set_header Host $host;

        proxy_set_header X-Real-IP $remote_addr;**⚠️ 需要接收 Gmail/Outlook 等外部邮件？**

    }- 外部邮件服务器**只使用 25 端口**发送邮件（无法更改）

}- 必须部署在支持 25 端口的服务器上

```- **无需修改代码**：通过端口转发即可（25 → 2525）

- 推荐服务商：Vultr ($5/月)、DigitalOcean ($6/月)

---- 详细说明请查看 [接收外部邮件部署指南](EXTERNAL_EMAIL.md)

- 无需修改代码的配置方法：[NO_CODE_CHANGE.md](NO_CODE_CHANGE.md)

## 📄 许可证

**说明**：

MIT License- 默认使用 **8080** 和 **2525** 端口，无需 root 权限

- 生产环境建议使用 Nginx 反向代理实现 80/443 端口访问

---- 如需接收外部邮件服务器的邮件，需要 25 端口（或使用支持25端口的云服务商）



## 🙏 致谢详细端口配置方案请参考 [PORT_REQUIREMENTS.md](PORT_REQUIREMENTS.md)



基于 [emersion/go-smtp](https://github.com/emersion/go-smtp) 构建### 快速部署（推荐）



---1. **本地编译 Linux 版本**



**开始使用临时邮箱服务！** 🎉```powershell

# Windows PowerShell
$env:GOOS="linux"
$env:GOARCH="amd64"
go build -o temp-mail-linux ./cmd/temp-mail

上传到服务器

scp temp-mail-linux deploy.sh user@your-server:/opt/temp-mail/

服务器上部署

cd /opt/temp-mail
sudo bash deploy.sh

Docker 部署

# 使用 Docker Compose
docker-compose up -d

# 或使用 Docker
docker build -t temp-mail .
docker run -d -p 8080:8080 -p 2525:2525 temp-mail

配置说明

环境变量：编辑 /opt/temp-mail/.env
域名配置：设置 DOMAIN 为你的域名（无需修改代码）
端口配置：修改 HTTP_ADDR 和 SMTP_ADDR
DNS 设置：添加 MX 记录指向你的服务器

自定义域名示例

# 编辑配置文件
sudo nano /opt/temp-mail/.env

# 修改域名
DOMAIN=mail.yourdomain.com
HTTP_ADDR=:8080
SMTP_ADDR=:2525
MESSAGE_TTL=30

# 重启服务
sudo systemctl restart temp-mail

详细域名配置教程：DOMAIN_CONFIG.md

更多详情请参考 DEPLOYMENT.md

26 KiB Raw Blame History Unescape Escape