47 lines
2.6 KiB
Markdown
47 lines
2.6 KiB
Markdown
# MailGo 项目记忆
|
||
|
||
## 技术栈
|
||
- Go + Gin + html/template + GORM + SQLite(default)/MySQL
|
||
- SMTP: github.com/emersion/go-smtp
|
||
- IMAP: github.com/emersion/go-imap v1 (NOT v2 beta)
|
||
- POP3: 手写TCP协议实现
|
||
- 配置: TOML (github.com/BurntSushi/toml)
|
||
- 会话: github.com/gin-contrib/sessions (cookie store)
|
||
- 密码: golang.org/x/crypto/bcrypt
|
||
|
||
## 关键架构决策
|
||
- 模板采用自包含+子模板模式（Go html/template不支持变量模板名）
|
||
- 每个模板是完整HTML文档，通过 {{template "styles" .}} 和 {{template "navbar" .}} 引入公共部分
|
||
- Handler调用 c.HTML(200, "define_name", data)，define_name 对应模板名
|
||
- SMTP TLS: 创建独立Server实例设置 TLSConfig
|
||
- Windows路径回退: ./win/etc/mail_go 和 ./win/srv/mail_go
|
||
- 默认管理员: admin@example.com / admin
|
||
|
||
## 增强功能（v2）
|
||
- DKIM: 创建域名时自动生成RSA 2048密钥对，DNS提示页显示DKIM TXT记录，internal/dkim/keys.go
|
||
- 域名编辑: /admin/domains/:id/edit，可改端口/TLS/重新生成DKIM
|
||
- 附件配额: 上传时检查用户QuotaBytes，同步更新UsedBytes，SMTP收信也更新
|
||
- 富文本: compose页集成Quill.js(CDN)，保存纯文本+HTML到数据库，发送multipart/alternative
|
||
- OAuth2/LDAP: 默认关闭，配置文件控制；internal/auth/ 包（provider.go/ldap.go/oauth2.go）
|
||
- 依赖: github.com/go-ldap/ldap/v3, golang.org/x/oauth2
|
||
- Domain模型新增: DkimSelector, DkimPrivateKey, DkimPublicKey
|
||
- Config新增: Auth AuthConfig（OAuth2+LDAP各项配置）
|
||
|
||
## 增强功能（v3）
|
||
- Banlist系统: 登录失败N次ban IP，次数/时长后台可配(BanConfig)，admin /admin/bans 查看/解ban
|
||
- BanEntry模型、BanStore、BanMiddleware、banned.html、admin/bans.html
|
||
- AuthHandler新增banCfg字段，DoLogin/LDAPLogin集成ban检查
|
||
- 配置: max_fail_attempts(默认5), ban_duration_min(默认30分钟)
|
||
- 管理仪表盘增强: 邮件分布表(INBOX/Sent/Drafts/Trash计数+大小)、今日/7日收发统计、ban计数
|
||
- MailStore新增: CountByFolder, CountAll, TotalSizeByFolder, TotalSize, CountByFolderSince
|
||
- 全量邮件查看: /admin/mails 支持文件夹筛选(INBOX/Sent/Drafts/Trash)，分页
|
||
- MailStore新增: ListAll, ListAllByFolder
|
||
- admin/mails.html
|
||
- Admin sidebar统一: 控制面板/域名管理/用户管理/所有邮件/IP黑名单
|
||
|
||
## 已知坑
|
||
- go-imap v2 是beta，API不稳定，必须用v1
|
||
- Go filepath.Glob 不支持 ** 递归匹配，模板分两轮加载
|
||
- SMTP ListenAndServeTLS() 不接受参数，TLS需通过 TLSConfig 设置
|
||
- User模型密码字段为 PasswordHash，数据库列为 password_hash
|