0

hydroxide

一个第三方的、开源的 ProtonMail CardDAV、IMAP 和 SMTP 桥。「A third-party, open-source ProtonMail CardDAV, IMAP and SMTP bridge」

Github repo
Main metrics

Github stars Tracking Chart

hydroxide

一个第三方的、开源的 ProtonMail 桥。仅适用于高级用户，设计用于在服务器上运行。

hydroxide 支持 CardDAV、IMAP 和 SMTP。

理由是：

  • 没有 GUI，只有 CLI（所以它可以在无头环境下运行）
  • 符合标准（我们并不关心微软的 Outlook）
  • 完全开放源代码

欢迎加入 IRC 频道。#emersion on Libera Chat.

它是如何工作的？

hydroxide 是一个将标准协议（SMTP、IMAP、CardDAV）翻译成 ProtonMail API 请求的服务器。它允许你在 ProtonMail 中使用你喜欢的电子邮件客户端和 git-send-email。

+-----------------+             +-------------+  ProtonMail  +--------------+
|                 | IMAP, SMTP  |             |     API      |              |
|  E-mail client  <------------->  hydroxide  <-------------->  ProtonMail  |
|                 |             |             |              |              |
+-----------------+             +-------------+              +--------------+

设置

Go

hydroxide 是在 Go 中实现的。请到 Go 网站 了解设置信息。

安装

从安装 hydroxide 开始。 

git clone https://github.com/emersion/hydroxide.git
GO111MODULE=on go build ./cmd/hydroxide

然后你需要通过 hydroxide 登录到 ProtonMail，这样 hydroxide 就可以从 ProtonMail 中检索到电子邮件。你可以用这个命令来做： 

hydroxide auth <username>

一旦你登录了，就会打印出一个 "bridge password"。先不要关闭你的终端，因为这个密码并不被 hydroxide 储存在任何地方，在配置你的电子邮件客户端时，会需要它。

你的 ProtonMail 凭证与这个桥接密码（登录时产生的32字节的随机密码）一起加密存储在磁盘上。

使用方法

hydroxide 可以在多种模式下使用。

不要多次启动 hydroxide，相反，你可以使用 hydroxide 服务。这需要 1025（smtp）、1143（imap）和8080（carddav）端口。

SMTP

将 hydroxide 作为 SMTP 服务器运行。

hydroxide smtp

一旦桥接器启动，您可以用以下设置来配置您的电子邮件客户端。

  • 主机名: localhost
  • 端口：1025
  • 安全性：无
  • 用户名：你的 ProtonMail 用户名
  • 密码：网桥密码(不是你的 ProtonMail 密码)

CardDAV

你必须设置一个 HTTPS 反向代理来转发对氢氧的请求。 

hydroxide carddav

在 GNOME（Evolution）和 Android（DAVDroid）上测试。

IMAP

目前，它只支持未加密的本地连接。 

hydroxide imap

授权许可

MIT


Overview

Name With Owneremersion/hydroxide
Primary LanguageGo
Program languageGo (Language Count: 1)
PlatformLinux, Mac, Windows
License:MIT License
Release Count30
Last Release Namev0.2.28 (Posted on 2023-08-24 08:22:41)
First Release Namev0.1.0 (Posted on )
Created At2017-08-21 15:33:40
Pushed At2024-04-07 03:21:02
Last Commit At2023-11-09 09:49:37
Stargazers Count1.4k
Watchers Count39
Fork Count119
Commits Count280
Has Issues Enabled
Issues Count199
Issue Open Count64
Pull Requests Count33
Pull Requests Open Count9
Pull Requests Close Count25
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private

hydroxide

A third-party, open-source ProtonMail bridge. For power users only, designed to
run on a server.

hydroxide supports CardDAV, IMAP and SMTP.

Rationale:

  • No GUI, only a CLI (so it runs in headless environments)
  • Standard-compliant (we don't care about Microsoft Outlook)
  • Fully open-source

Feel free to join the IRC channel: ##emersion on irc.freenode.net.

How does it work?

hydroxide is a server that translates standard protocols (SMTP, IMAP, CardDAV)
into ProtonMail API requests. It allows you to use your preferred e-mail clients
and git-send-email with ProtonMail.

+-----------------+             +-------------+  ProtonMail  +--------------+
To the top