Почтовые ящики в один клик — на 15 минут, на неделю или навсегда.
Регистрируйтесь где угодно, не светя настоящий адрес: получите код, подтвердите аккаунт — и ящик сам исчезнет. А нужные адреса держите в своём аккаунте и открывайте с любого устройства.
Возможности · Быстрый старт · Деплой · Как это работает · API
|
15 минут · 1 час · 12 часов · 24 часа · 7 дней · ∞ навсегда. Обратный отсчёт прямо в ящике, а по истечении срока сервер сам удаляет ящик вместе со всеми письмами — даже если вкладка давно закрыта. Регистрация по имени и паролю или вход через Google. Все ящики, включая вечные, хранятся в аккаунте — наведите на аватар в шапке, чтобы увидеть их и переключиться. У каждого ящика есть пароль: создали на компьютере — открыли на телефоне. Без аккаунта — по адресу и паролю ящика, с аккаунтом — просто войдите. Проверка каждые 5 секунд, тост и системное уведомление о новом письме, пометка непрочитанных. |
HTML-письма открываются в изолированном Держите сразу несколько адресов и переключайтесь между ними из меню аккаунта. Свой логин и выбор домена — по желанию. Тёмная и светлая темы, адаптивная вёрстка под телефон, вложения скачиваются в один клик. |
Проще всего — открыть готовый сайт. Чтобы запустить у себя, нужен только Node.js 18+ — никаких npm install.
git clone https://github.com/wilberods-coder/temp-mail.git
cd temp-mail
npm startОткройте http://127.0.0.1:5190 — готово. Это облегчённый режим без аккаунтов и вечных ящиков.
| Переменная | По умолчанию | Описание |
|---|---|---|
PORT |
5190 |
Порт сервера |
HOST |
127.0.0.1 |
Адрес; для сервера/контейнера — 0.0.0.0 |
Полная версия с аккаунтами запускается через Worker — локально тоже, без аккаунта Cloudflare:
cd worker && npm install
npm run db:init:local
npx wrangler dev # http://127.0.0.1:8787 — страница + API + локальная базаImportant
mail.tm разрешает запросы из браузера только со своего сайта, поэтому одной статической страницы мало — нужен прокси. В репозитории их два: server.js (Node.js) и worker/ (Cloudflare Worker).
Так работает живая версия: страница лежит на GitHub Pages, API — на Cloudflare Workers, сроки ящиков — в базе Cloudflare D1, удаление просроченных — по cron раз в минуту.
-
Worker (нужен бесплатный аккаунт Cloudflare):
cd worker npm install npx wrangler login npx wrangler d1 create temp-mail # вставьте database_id в wrangler.toml npm run db:init npm run deploy # выведет https://temp-mail.<ваш-поддомен>.workers.dev
-
Настройка. Впишите адрес Worker'а в
public/config.js, а адрес своего сайта (https://<логин>.github.io) — вALLOWED_ORIGINSвworker/wrangler.toml, затем повторитеnpm run deploy. -
Pages. В репозитории: Settings → Pages → Source: GitHub Actions. Дальше каждый пуш в
public/выкладывается автоматически черезpages.yml. -
Вход через Google (по желанию). В Google Cloud Console создайте OAuth client ID → Web application, добавьте в Authorized JavaScript origins адрес сайта (
https://<логин>.github.io) и Worker'а, впишите Client ID вGOOGLE_CLIENT_IDвwrangler.tomlи выполнитеnpm run deploy. Client ID не секретный; Worker сам проверяет подпись токена Google. Без него кнопка Google просто не показывается.
Worker заодно отдаёт и саму страницу — сайт доступен и по адресу https://temp-mail.<поддомен>.workers.dev.
Конфигурация лежит в render.yaml. На бесплатном тарифе диск не сохраняется между перезапусками — сроки уже созданных ящиков при рестарте забудутся (сами ящики останутся в mail.tm).
docker build -t temp-mail .
docker run -d -p 5190:5190 -v temp-mail-data:/app/data --name temp-mail temp-mailТом /app/data хранит сроки ящиков между перезапусками.
HOST=0.0.0.0 PORT=80 node server.jsДля продакшена поставьте перед ним nginx/Caddy с HTTPS и запускайте через systemd или pm2.
flowchart LR
U["🧑 Браузер<br/>public/index.html"] -- "/auth/* — аккаунты<br/>/svc/* — ящики<br/>/api/* — письма" --> B
G["🔐 Google"] -. "ID-токен" .-> U
subgraph B ["Бэкенд — один из двух"]
W["☁️ Cloudflare Worker<br/>+ D1 + cron"]
S["🟢 server.js<br/>без аккаунтов"]
end
B -- "прокси" --> M[("📮 api.mail.tm")]
B -. "удаление<br/>просроченных" .-> M
public/index.html— весь интерфейс в одном файле: HTML, CSS и JS без сборки и фреймворков.config.jsвыбирает бэкенд: на github.io — Worker, иначе — тот же сервер, что отдал страницу. Что умеет бэкенд, страница узнаёт из/svc/infoи прячет лишнее.worker/— полный бэкенд на Cloudflare Workers: аккаунты, вечные ящики, сроки в D1, cron раз в минуту.server.js— облегчённый бэкенд на чистом Node.js (~250 строк): ящики со сроком, без аккаунтов; сроки хранит вdata/boxes.json.- Сроки жизни. У mail.tm их нет, поэтому бэкенд запоминает каждый ящик со сроком и сам удаляет просроченные. Вечные ящики не удаляются, пока вы не удалите их сами.
- Аккаунты. Пароли хешируются PBKDF2-SHA256 (100 000 итераций, соль на пользователя); в базе хранится только SHA-256 токена сессии, сессия живёт 30 дней. Вход через Google — по ID-токену Google Identity Services, подпись проверяется по ключам Google.
Worker: https://temp-mail.wilberods.workers.dev. Всё, кроме перечисленного, — прозрачный прокси /api/* → api.mail.tm. Запросы с заголовком X-Session: <токен> выполняются от имени аккаунта, и ящики привязываются к нему.
Ящики (есть и в server.js):
| Метод | Путь | Тело | Ответ |
|---|---|---|---|
GET |
/svc/info |
— | { accounts, googleClientId, lifetimes } |
POST |
/svc/boxes |
{ lifetime, login?, domain? } |
201 { id, address, password, token, expiresAt } |
POST |
/svc/login |
{ address, password } |
200 { id, address, password, token, expiresAt } |
POST |
/svc/forget |
{ id, password } |
200 { ok: true } |
Аккаунты (только Worker):
| Метод | Путь | Тело | Ответ |
|---|---|---|---|
POST |
/auth/register |
{ username, password } |
201 { token, user } |
POST |
/auth/login |
{ username, password } |
200 { token, user } |
POST |
/auth/google |
{ credential } |
200 { token, user } |
GET |
/auth/me |
— | { user, boxes } |
POST |
/auth/boxes/remove |
{ id } |
{ ok: true } |
POST |
/auth/boxes/import |
{ boxes: [{ address, password }] } |
{ boxes } |
POST |
/auth/logout |
{} |
{ ok: true } |
lifetime — одно из 15m, 1h, 12h, 24h, 7d или forever (только с аккаунтом). expiresAt — Unix-время в мс; null — ящик навсегда.
curl -X POST http://127.0.0.1:5190/svc/boxes \
-H 'Content-Type: application/json' \
-d '{"lifetime":"15m"}'temp-mail/
├── public/
│ ├── index.html # интерфейс
│ └── config.js # адрес бэкенда
├── worker/ # бэкенд на Cloudflare Workers (для GitHub Pages)
│ ├── src/index.js
│ ├── schema.sql # таблицы D1: ящики, аккаунты, сессии
│ └── wrangler.toml
├── server.js # бэкенд на Node.js: статика + прокси + сроки жизни
├── data/ # boxes.json для server.js (в .gitignore)
├── docs/ # скриншоты для README
├── .github/workflows/
│ └── pages.yml # выкладка public/ на GitHub Pages
├── Dockerfile
└── render.yaml
- Только приём писем — отправка не поддерживается.
- Лимит mail.tm — около 30 запросов в минуту с одного IP. На сервере все пользователи делят его IP, так что сервис рассчитан на личное или небольшое использование.
- Бэкенд хранит пароли ящиков (
data/boxes.jsonили база D1) — без них нельзя удалить ящик по сроку или открыть его из аккаунта. Не публикуйте их —data/уже в.gitignore. - «Навсегда» — со стороны сервиса. Сервис вечный ящик не удаляет, но письма и аккаунты хранит mail.tm по своим правилам.
- Восстановления пароля аккаунта нет — почтовый адрес при регистрации не спрашивается. Если боитесь забыть пароль, входите через Google.
- Не используйте временную почту для важных аккаунтов: восстановить доступ после удаления ящика будет невозможно.
Почтовый бэкенд — бесплатный публичный API mail.tm.
