ganeshlab/protonmail-bridge

ProtonMail IMAP/SMTP Bridge Docker容器

镜像概述和主要用途

项目状态

注意：本镜像已停止更新。维护者Proton订阅到期，无法测试新版本。建议使用替代方案：https://hub.docker.com/r/shenxn/protonmail-bridge%EF%BC%88%E5%B7%B2%E6%81%A2%E5%A4%8D%E6%9B%B4%E6%96%B0%EF%BC%8C%E5%8A%9F%E8%83%BD%E5%85%BC%E5%AE%B9%EF%BC%89%E3%80%82

概述

非官方的https://github.com/ProtonMail/proton-bridge Docker容器，基于源码构建。脚本部分基于Hendrik Meyer的工作，为https://github.com/shenxn/protonmail-bridge-docker%E7%9A%84%E5%88%86%E6%94%AF%E7%89%88%E6%9C%AC%E3%80%82

主要用途

提供Docker化部署方案，使邮件客户端可通过IMAP/SMTP协议连接ProtonMail账户，实现邮件收发功能。

核心功能和特性

• 源码构建：基于ProtonMail Bridge官方源码编译，确保功能一致性
• 交互式配置：支持CLI命令行初始化，兼容双因素认证（2FA）
• 灵活标签：提供稳定版（latest）和预发布版（dev）镜像标签
• 数据持久化：通过卷挂载保存账户配置，避免重复初始化
• 端口映射：默认暴露SMTP（1025）和IMAP（1143）端口，支持自定义绑定

标签说明

使用场景和适用范围

• 邮件客户端集成：需在Thunderbird、Outlook等客户端中使用ProtonMail的用户
• 服务器/NAS部署：适用于Synology DiskStation等设备（需SSH执行交互式命令）
• 安全需求场景：需容器化隔离或自定义网络策略的ProtonMail账户管理
• 双因素认证支持：通过CLI交互实现2FA登录，解决环境变量配置局限性

详细使用方法和配置说明

1. 初始化（添加账户）

通过交互式命令行完成账户配置，需挂载数据卷持久化配置：

bash
docker run --rm -it -v /path/to/data:/root ganeshlab/protonmail-bridge init

操作步骤：

1. 等待Bridge启动后，输入login命令并按提示完成账户登录（支持2FA验证）
2. 登录成功后，输入info命令查看SMTP/IMAP连接信息（含自动生成的客户端用户名和密码）
3. 配置完成后输入exit退出，若无法正常退出可使用CTRL+C终止容器

2. 启动容器

Docker命令部署

bash
docker run -d \
  --name=protonmail-bridge \
  -v /path/to/data:/root \  # 替换为实际数据目录（需包含初始化配置）
  -p 1025:1025/tcp \        # SMTP端口
  -p 1143:1143/tcp \        # IMAP端口
  --restart=unless-stopped \
  ganeshlab/protonmail-bridge

Docker Compose部署

yaml
version: "3"
services:
  protonbridge:
    image: ganeshlab/protonmail-bridge:latest
    container_name: protonmail-bridge
    restart: unless-stopped
    volumes:
      - '/path/to/data:/root'  # 替换为初始化时使用的数据目录
    ports:
      - '1025:1025/tcp'        # SMTP端口映射
      - '1143:1143/tcp'        # IMAP端口映射

3. 安全配置建议

网络安全注意事项

默认端口映射会将服务暴露到主机网络，存在安全风险。建议：

• 限制本地访问：仅绑定本地回环地址（同官方Bridge默认行为）：

  bash
  docker run -d \
    --name=protonmail-bridge \
    -v /path/to/data:/root \
    -p 127.0.0.1:1025:1025/tcp \  # 仅本地可访问SMTP
    -p 127.0.0.1:1143:1143/tcp \  # 仅本地可访问IMAP
    --restart=unless-stopped \
    ganeshlab/protonmail-bridge
  

• 最小端口暴露：仅需发送邮件时，可只映射SMTP端口（1025），省略IMAP端口

4. Bridge CLI功能扩展

初始化阶段暴露完整Bridge命令行接口（CLI），支持高级配置：

• 切换账户模式（合并/拆分视图）
• 配置代理服务器
• 管理多账户登录状态

详细命令参考ProtonMail官方CLI指南。

兼容性说明

• 客户端支持：兼容ProtonMail Bridge官方支持的邮件客户端，详情见官方兼容列表
• 设备兼容性：在Synology DiskStation上测试通过，需通过SSH执行交互式初始化命令
• 架构支持：默认支持x86_64架构，多架构构建需使用buildx工具（见下方构建指南）

自行构建镜像（高级）

如需本地构建镜像（开发测试或安全审计），执行：

bash
docker build .

说明：

• Dockerfile自动处理源码下载、依赖安装及编译打包
• 可添加-t参数自定义标签（如docker build -t my-proton-bridge:latest .）
• 多架构构建需使用docker buildx，例如：

  bash
  docker buildx build --platform linux/amd64,linux/arm64 -t my-proton-bridge:multiarch .
  

注意事项

• 配置备份：数据卷（/path/to/data）包含账户密钥和会话信息，建议定期备份
• 网络策略：未绑定127.0.0.1时需通过防火墙限制端口访问，避免未授权连接
• 替代方案：由于本镜像停止维护，推荐迁移至https://hub.docker.com/r/shenxn/protonmail-bridge%E4%BB%A5%E8%8E%B7%E5%8F%96%E6%9B%B4%E6%96%B0%E6%94%AF%E6%8C%81