使用go-imap实现IMAP客户端与服务器功能

go-imap是一个用Go语言编写的IMAP协议库，支持IMAP4rev1协议，可以用于开发IMAP客户端和服务器应用。下面我将介绍如何使用这个库来实现基本的IMAP功能。

安装go-imap

首先安装go-imap核心库和相关的扩展：

go get github.com/emersion/go-imap
go get github.com/emersion/go-imap/client
go get github.com/emersion/go-imap/server

IMAP客户端实现

1. 连接到IMAP服务器

package main

import (
	"log"

	"github.com/emersion/go-imap/client"
)

func main() {
	// 连接到IMAP服务器
	c, err := client.DialTLS("imap.example.com:993", nil)
	if err != nil {
		log.Fatal(err)
	}
	log.Println("Connected")

	// 不要忘记退出时断开连接
	defer c.Logout()

	// 登录
	if err := c.Login("username@example.com", "password"); err != nil {
		log.Fatal(err)
	}
	log.Println("Logged in")
}

2. 列出邮箱

// 列出所有邮箱
mailboxes := make(chan *imap.MailboxInfo, 10)
done := make(chan error, 1)
go func() {
	done <- c.List("", "*", mailboxes)
}()

log.Println("Mailboxes:")
for m := range mailboxes {
	log.Println("* " + m.Name)
}

if err := <-done; err != nil {
	log.Fatal(err)
}

3. 选择邮箱并获取邮件

// 选择收件箱
mbox, err := c.Select("INBOX", false)
if err != nil {
	log.Fatal(err)
}
log.Println("Flags for INBOX:", mbox.Flags)

// 获取最新的4封邮件
from := uint32(1)
to := mbox.Messages
if mbox.Messages > 3 {
	from = mbox.Messages - 3
}
seqset := new(imap.SeqSet)
seqset.AddRange(from, to)

messages := make(chan *imap.Message, 10)
done = make(chan error, 1)
go func() {
	done <- c.Fetch(seqset, []imap.FetchItem{imap.FetchEnvelope}, messages)
}()

log.Println("Latest messages:")
for msg := range messages {
	log.Printf("* %s\n", msg.Envelope.Subject)
}

if err := <-done; err != nil {
	log.Fatal(err)
}

IMAP服务器实现

1. 创建基本IMAP服务器

package main

import (
	"log"
	"net"

	"github.com/emersion/go-imap/server"
	"github.com/emersion/go-imap/backend/memory"
)

func main() {
	// 创建一个内存后端（仅用于演示，实际应用中应使用持久化后端）
	be := memory.New()
	
	// 创建新服务器
	s := server.New(be)
	s.Addr = ":1143"
	// 启用调试模式
	s.Debug = os.Stdout
	
	log.Println("Starting IMAP server at :1143")
	if err := s.ListenAndServe(); err != nil {
		log.Fatal(err)
	}
}

2. 自定义后端实现

要实现自定义后端，需要实现backend.Backend接口：

type Backend interface {
	Login(connInfo *imap.ConnInfo, username, password string) (User, error)
}

以及backend.User、backend.Mailbox等接口。下面是一个简单示例：

package main

import (
	"log"
	"net"

	"github.com/emersion/go-imap/server"
	"github.com/emersion/go-imap/backend"
)

type SimpleUser struct {
	username string
}

func (u *SimpleUser) Username() string {
	return u.username
}

func (u *SimpleUser) ListMailboxes(subscribed bool) ([]backend.Mailbox, error) {
	// 返回用户邮箱列表
	return []backend.Mailbox{&SimpleMailbox{name: "INBOX"}}, nil
}

// 实现其他User接口方法...

type SimpleMailbox struct {
	name string
}

func (m *SimpleMailbox) Name() string {
	return m.name
}

// 实现其他Mailbox接口方法...

type SimpleBackend struct{}

func (b *SimpleBackend) Login(connInfo *imap.ConnInfo, username, password string) (backend.User, error) {
	// 简单的认证 - 实际应用中应该更安全
	if password != "password" {
		return nil, errors.New("bad credentials")
	}
	return &SimpleUser{username: username}, nil
}

func main() {
	be := &SimpleBackend{}
	
	s := server.New(be)
	s.Addr = ":1143"
	s.AllowInsecureAuth = true // 仅用于测试
	
	log.Println("Starting IMAP server at :1143")
	if err := s.ListenAndServe(); err != nil {
		log.Fatal(err)
	}
}

高级功能

1. 支持IDLE命令（实时通知）

// 客户端代码
// 先选择邮箱
mbox, err := c.Select("INBOX", true)
if err != nil {
	log.Fatal(err)
}

// 设置一个通道接收更新
updates := make(chan client.Update)
c.Updates = updates

// 启动IDLE命令
stop := make(chan struct{})
done := make(chan error, 1)
go func() {
	done <- c.Idle(stop, nil)
}()

// 监听更新
for {
	select {
	case update := <-updates:
		switch update.(type) {
		case *client.MailboxUpdate:
			log.Println("Mailbox updated")
		}
	case err := <-done:
		if err != nil {
			log.Println("IDLE error:", err)
		}
		return
	}
}

// 要停止IDLE，关闭stop通道
// close(stop)

2. 搜索邮件

criteria := imap.NewSearchCriteria()
criteria.WithoutFlags = []string{imap.SeenFlag} // 未读邮件
ids, err := c.Search(criteria)
if err != nil {
	log.Fatal(err)
}

log.Println("Unread messages:", ids)

注意事项

1. 生产环境中应该使用TLS加密连接
2. 内存后端仅用于测试，生产环境需要持久化存储
3. 实现完整服务器需要处理更多细节，如并发控制、状态管理等
4. 客户端代码应该正确处理超时和重连

go-imap提供了灵活且强大的IMAP协议实现，可以用于构建各种邮件相关的应用，从简单的邮件检查工具到完整的邮件服务器。