PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.
Dart airdrop-alternativeclipboardclipboard-sharingclipboard-synccopy-pastecross-platformend-to-end-encryptionfile-syncfile-transferfluttergolanglinuxmacosnat-traversalp2pself-hostedtailscaleuniversal-clipboardwebrtcwindows
// Package pairing 管理配对码的签发与兑换。
//
// 配对码只在内存中存活 5 分钟,服务器不持久化任何设备信息——
// 双方一旦交换到对方公钥,此后的互信就完全不依赖服务器了。
package pairing
import (
"errors"
"sync"
"time"
"github.com/baiyuze/pasteferry/proto/pairingcode"
)
// 配对码的格式与局域网里设备自己生成的一致,见 proto/pairingcode。
const (
CodeLength = pairingcode.Length
CodeTTL = pairingcode.TTL
)
var (
ErrCodeNotFound = errors.New("配对码不存在或已过期")
ErrSelfPairing = errors.New("不能与自己配对")
)
// Peer 是配对双方互相看到的信息。
type Peer struct {
DeviceID string
DeviceName string
Platform string
PublicKey []byte
}
type pending struct {
code string
initiator Peer
expiresAt time.Time
// 兑换方的信息经此通道回传给发起方,让发起方也能拿到对端公钥
redeemed chan Peer
}
type Broker struct {
mu sync.Mutex
codes map[string]*pending
// 便于测试时注入假时钟
now func() time.Time
}
func NewBroker() *Broker {
return &Broker{
codes: make(map[string]*pending),
now: time.Now,
}
}
// Create 为发起方签发一个配对码。
// 返回的通道在有人兑换时收到对方信息;超时或 Cancel 时关闭。
func (b *Broker) Create(initiator Peer) (code string, expiresAt time.Time, ch <-chan Peer, err error) {
b.mu.Lock()
defer b.mu.Unlock()
b.gcLocked()
// 极小概率撞码,重试几次即可
for attempt := 0; attempt < 8; attempt++ {
c, genErr := pairingcode.Generate()
if genErr != nil {
return "", time.Time{}, nil, genErr
}
if _, taken := b.codes[c]; taken {
continue
}
p := &pending{
code: c,
initiator: initiator,
expiresAt: b.now().Add(CodeTTL),
redeemed: make(chan Peer, 1),
}
b.codes[c] = p
return c, p.expiresAt, p.redeemed, nil
}
return "", time.Time{}, nil, errors.New("生成配对码失败:连续撞码")
}
// Redeem 用配对码换取发起方信息,同时把兑换方信息回传给发起方。
// 配对码一次性使用,兑换后立即失效。
func (b *Broker) Redeem(code string, redeemer Peer) (Peer, error) {
b.mu.Lock()
defer b.mu.Unlock()
b.gcLocked()
p, ok := b.codes[code]
if !ok {
return Peer{}, ErrCodeNotFound
}
if p.initiator.DeviceID == redeemer.DeviceID {
return Peer{}, ErrSelfPairing
}
delete(b.codes, code)
// 缓冲为 1,发起方即使暂时没在读也不会阻塞这里
p.redeemed <- redeemer
close(p.redeemed)
return p.initiator, nil
}
// Cancel 撤销尚未被兑换的配对码(发起方关闭配对界面或断线时)。
func (b *Broker) Cancel(code string) {
b.mu.Lock()
defer b.mu.Unlock()
if p, ok := b.codes[code]; ok {
delete(b.codes, code)
close(p.redeemed)
}
}
// gcLocked 清理过期配对码。调用方必须已持有锁。
func (b *Broker) gcLocked() {
now := b.now()
for code, p := range b.codes {
if now.After(p.expiresAt) {
delete(b.codes, code)
close(p.redeemed)
}
}
}
func (b *Broker) Len() int {
b.mu.Lock()
defer b.mu.Unlock()
return len(b.codes)
}