shopping2go/email-oauth2-proxy-docker
shopping2go
这是一个基于Debian环境运行Email OAuth2 Proxy的Docker容器，支持无GUI模式，通过挂载卷持久化配置（含OAuth令牌），可解决邮件客户端的OAuth2认证问题。
下载次数: 0状态：社区镜像维护者：shopping2go仓库类型：镜像最近更新：4 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
📧 email-oauth2-proxy-docker
https://github.com/shopping2go/email-oauth2-proxy-docker/actions/workflows/docker-build.yml/badge.svg](https://github.com/shopping2go/email-oauth2-proxy-docker/actions/workflows/docker-build.yml) https://img.shields.io/badge/License-Apache_2.0-blue.svg](LICENSE) https://img.shields.io/badge/Docker-Container-2496ED?logo=docker&logoColor=white](https://github.com/shopping2go/email-oauth2-proxy-docker/pkgs/container/email-oauth2-proxy-docker) https://img.shields.io/badge/Python-3.12-3776AB?logo=python&logoColor=white](https://www.python.org/)
这是一个在Debian环境下以无GUI（--no-gui）模式运行https://github.com/simonrob/email-oauth2-proxy%E7%9A%84Docker%E5%AE%B9%E5%99%A8%EF%BC%8C%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E9%80%9A%E8%BF%87Docker%E5%8D%B7%E6%9A%B4%E9%9C%B2%E4%BB%A5%E4%BE%BF%E6%8C%81%E4%B9%85%E5%8C%96%E3%80%82
🚀 快速开始
1. 准备配置文件
镜像包含默认的emailproxy.config模板。首次启动时，若挂载的/config目录中无配置文件，容器会自动将模板复制到该目录。编辑生成的文件添加邮件服务器和账户详情，参考https://github.com/simonrob/email-oauth2-proxy/blob/main/emailproxy.config%E8%8E%B7%E5%8F%96%E5%AE%8C%E6%95%B4%E6%96%87%E6%A1%A3%E5%92%8C%E6%9C%8D%E5%8A%A1%E5%95%86%E7%89%B9%E5%AE%9A%E7%A4%BA%E4%BE%8B%E3%80%82
重要提示：务必挂载卷到
/config。若无挂载，配置文件仅存储在容器临时层，所有更改（包括代理写入的OAuth令牌）会在容器删除或重建时丢失。
配置文件必须命名为emailproxy.config并放在挂载到/config的目录中。
代理处理配置文件的规则
emailproxy守护进程启动时将整个配置加载到内存，干净关闭时写回内存状态。这意味着：
- ✅ 运行时获取的OAuth令牌会持久化跨重启
- ✅ 启动时的设置会保留跨重启
- ⚠️ 容器运行时的手动编辑会在停止时被覆盖
结论：编辑配置前需停止容器。
2. 本地构建镜像
bashdocker build -t email-oauth2-proxy-docker .
3. Docker Compose运行
bashdocker compose up -d
默认使用命名卷emailproxy-config，首次创建后不会覆盖现有数据。如需绑定主机目录，修改docker-compose.yml中的挂载方式。
4. Docker直接运行
bashdocker run -d \ --name emailproxy \ --restart unless-stopped \ -e DEBUG=false \ -e LOGFILE=true \ -e CACHE_STORE=/config/credstore.config \ -e LOCAL_SERVER_AUTH=false \ -v emailproxy-config:/config \ -p 1993:1993 \ -p 1587:1587 \ email-oauth2-proxy-docker
📂 配置卷
| 挂载方式 | 容器路径 | 描述 |
|---|---|---|
| 命名卷/绑定挂载 | /config | 存储配置、令牌及日志的目录（必需） |
首次启动会生成默认配置，后续启动直接加载现有文件。仅在容器停止时编辑配置。
⚙️ 环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
DEBUG | false | 启用调试日志 |
LOGFILE | false | 日志写入/config/emailproxy.log |
CACHE_STORE | 未设置 | 令牌缓存路径（需在/config内以持久化） |
LOCAL_SERVER_AUTH | false | 启动本地服务器处理OAuth重定向 |
EXTERNAL_AUTH | false | 外部浏览器+复制粘贴授权（LOCAL_SERVER_AUTH=true时无效） |
🔌 暴露端口
| 端口 | 协议 | 服务商示例 |
|---|---|---|
1993 | IMAP | Office 365/Outlook |
1995 | POP | Office 365/Outlook |
1587 | SMTP | Office 365/Outlook（STARTTLS） |
2993 | IMAP | Gmail |
2995 | POP | Gmail |
2465 | SMTP | Gmail |
8080 | HTTP | OAuth重定向（LOCAL_SERVER_AUTH用） |
仅暴露需要的端口。
🔑 首次授权
- 本地服务器授权：
LOCAL_SERVER_AUTH=true，映射8080端口，访问日志中的URL完成认证。 - 外部浏览器授权：
EXTERNAL_AUTH=true，复制日志URL到浏览器，粘贴重定向地址到容器输入（docker attach emailproxy）。 - 预授权配置：若配置已含令牌，无需交互。
🔗 上游项目
此容器封装https://github.com/simonrob/email-oauth2-proxy%EF%BC%8C%E8%AF%A6%E6%83%85%E5%8F%82%E8%80%83%E4%B8%8A%E6%B8%B8%E6%96%87%E6%A1%A3%E3%80%82
📄 许可证
基于Apache License 2.0许可，与上游一致。
⚠️ 免责声明
本项目按“原样”提供，不承担任何使用风险，详见LICENSE。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 email-oauth2-proxy-docker 镜像标签
docker pull docker.xuanyuan.run/shopping2go/email-oauth2-proxy-docker:<标签>
DockerHub 原生拉取命令
docker pull shopping2go/email-oauth2-proxy-docker:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"