萌邮 MengPost · 多邮箱管理面板
基于 SMTP / IMAP 协议的轻量多邮箱管理后台。
- 前端: React 18 + Vite + React Router
- 后端: Go 1.22 + Gin + SQLite (
modernc.org/sqlite, 纯 Go, 无需 CGO) - 邮件:
gopkg.in/gomail.v2(SMTP)、github.com/emersion/go-imap(IMAP) - UI: 文档风、简洁, 自适应手机 / 电脑
- 鉴权: 打开站点时若本地未保存密钥，先显示 访问密钥 输入框（与后端
MP_TOKEN一致，默认shumengya520）；通过后写入浏览器本地存储，后续请求带X-Auth-Token
目录结构
mengpost/
dev.bat / dev.sh # 一键本地开发 (双窗口启动前后端)
build.bat / build.sh # 构建前端
mengpost-backend/ # Go + Gin 后端
config/ # 配置(端口/DB/token)
database/ # SQLite 初始化 & 迁移
models/ # 数据模型 (accounts / sent_logs)
services/ # smtp.go / imap.go
middleware/ # token 鉴权中间件
handlers/ # HTTP 处理器
router/ # 路由聚合
main.go # 入口
mengpost-frontend/ # React + Vite 前端
public/ # favicon.ico、logo.png 等静态资源
src/
api/ # 统一 fetch 封装, token 存 localStorage
components/ # AccessGate / MainLayout(侧栏) / Topbar
pages/ # Home / Admin / Accounts / Mailbox / Compose
styles/global.css
scripts/ # publish-gitea：用 tea 创建远端仓库的辅助脚本
本地开发
依赖:
- Go ≥ 1.22、Node.js ≥ 18 (SQLite 使用纯 Go 实现, 无需 CGO / gcc)
# Windows
dev.bat
# macOS / Linux
chmod +x dev.sh && ./dev.sh
- 前端: http://127.0.0.1:5173
- 后端: http://127.0.0.1:8787 (Vite 已代理
/api)
构建
# Windows
build.bat
# macOS / Linux
./build.sh
产物在 mengpost-frontend/dist。npm run preview 已配置与开发环境相同的 /api 代理。
若静态文件与后端不同源部署，构建前设置 VITE_API_URL 指向后端根地址（如 http://127.0.0.1:8787），再执行 build。
环境变量
| 变量名 | 默认值 | 说明 |
|---|---|---|
MP_PORT |
8787 |
后端 HTTP 端口 |
MP_DB |
mengpost.db |
SQLite 文件路径 |
MP_TOKEN |
shumengya520 |
访问密钥（与前端输入一致） |
MP_LOG |
info |
日志级别 |
前端 (Vite)
| 变量名 | 说明 |
|---|---|
VITE_API_URL |
可选。留空时请求相对路径 /api（开发 / preview 走 Vite 代理）。独立部署静态站时设为后端地址。 |
使用
- 用
dev.bat/dev.sh启动后，浏览器打开 http://127.0.0.1:5173（勿用file://打开构建产物）。 - 首次访问输入 访问密钥（与
MP_TOKEN相同）；顶部可 登出 清除本地密钥。 - 在「账户」页新增邮箱 (SMTP / IMAP 与授权码)。
- 「收件箱」拉取邮件；「写信」发信。
常见问题
- 未启动后端 或端口不是 8787：密钥验证会失败或提示无法连接。
- 未通过 Vite 访问：直接双击
dist/index.html没有/api代理，需npm run preview或配置VITE_API_URL后重新构建。 - 使用了
@vitejs/plugin-pwa/ Workbox：勿让 Service Worker 缓存/api/*。开发时可在 DevTools → Application → Service Workers 勾选 Bypass for network 或先 Unregister 再刷新。
常见邮箱参考
| 服务商 | SMTP | IMAP |
|---|---|---|
smtp.qq.com:465 |
imap.qq.com:993 |
|
| 163 | smtp.163.com:465 |
imap.163.com:993 |
| Gmail | smtp.gmail.com:465 |
imap.gmail.com:993 |
| Outlook | smtp.office365.com:587 |
outlook.office365.com:993 |
使用 应用专用密码 / 授权码, 不要直接使用邮箱登录密码。
API 一览
所有受保护接口均需要请求头 X-Auth-Token: <token>。
POST /api/auth/verify # 校验 token
GET /api/accounts # 列出账户
POST /api/accounts # 新增
PUT /api/accounts/:id # 更新 (password 为空则保留)
DELETE /api/accounts/:id # 删除
GET /api/accounts/:id/mailboxes # IMAP 邮件夹
GET /api/accounts/:id/messages # 列出邮件摘要 ?mailbox=&limit=
GET /api/accounts/:id/messages/:uid # 邮件详情
POST /api/accounts/:id/send # 发送邮件
GET /api/accounts/:id/sent # 发送日志
推送到自建 Gitea（tea CLI）
前置：安装 tea，在 Gitea 设置 → 应用 → 生成令牌 创建访问令牌。
# 1. 添加登录（只需一次；将 URL、令牌换成你的实例）
tea login add --url https://你的Gitea地址 --token <访问令牌> --name mygitea
tea login default mygitea
tea whoami
在本项目根目录执行：
# 2. 在 Gitea 上创建空仓库（名称可改；若已存在同名库请先删除或换名）
tea repos create --name mengpost --description "萌邮 MengPost：基于 SMTP/IMAP 的多邮箱管理面板（React + Vite + Go + Gin + SQLite）"
# 3. 添加远程并推送（将下面 URL 换成 Gitea 仓库页的 HTTPS 克隆地址）
git remote add origin https://你的Gitea/用户名/mengpost.git
git branch -M main
git push -u origin main
若本地已有 origin，可改为：git remote set-url origin <HTTPS 地址> 再 git push -u origin main。
辅助脚本（仅执行第 2 步 tea repos create，推送仍需手动 git remote + git push）：
- Windows:
powershell -ExecutionPolicy Bypass -File scripts/publish-gitea.ps1 - Linux / macOS:
chmod +x scripts/publish-gitea.sh && ./scripts/publish-gitea.sh
许可
内部自用项目, 请按需修改。