Skip to content
wilberods-coderPublic

About

✉️ Временная почта: одноразовые ящики со сроком жизни от 15 минут до недели. Node.js без зависимостей, бэкенд mail.tm

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

✉️ Временная почта

Почтовые ящики в один клик — на 15 минут, на неделю или навсегда.

Регистрируйтесь где угодно, не светя настоящий адрес: получите код, подтвердите аккаунт — и ящик сам исчезнет. А нужные адреса держите в своём аккаунте и открывайте с любого устройства.

Node.js Zero dependencies mail.tm License: MIT GitHub Pages Cloudflare Workers

Возможности · Быстрый старт · Деплой · Как это работает · API


Ящик с входящими письмами

✨ Возможности

⏱ Срок жизни на выбор

15 минут · 1 час · 12 часов · 24 часа · 7 дней · ∞ навсегда. Обратный отсчёт прямо в ящике, а по истечении срока сервер сам удаляет ящик вместе со всеми письмами — даже если вкладка давно закрыта.

👤 Аккаунты

Регистрация по имени и паролю или вход через Google. Все ящики, включая вечные, хранятся в аккаунте — наведите на аватар в шапке, чтобы увидеть их и переключиться.

🔑 Вход с любого устройства

У каждого ящика есть пароль: создали на компьютере — открыли на телефоне. Без аккаунта — по адресу и паролю ящика, с аккаунтом — просто войдите.

📬 Живые входящие

Проверка каждые 5 секунд, тост и системное уведомление о новом письме, пометка непрочитанных.

🛡 Безопасный просмотр

HTML-письма открываются в изолированном iframe без права запускать скрипты; ссылки — в новой вкладке без referrer.

🗂 Несколько ящиков

Держите сразу несколько адресов и переключайтесь между ними из меню аккаунта. Свой логин и выбор домена — по желанию.

🎨 Приятно пользоваться

Тёмная и светлая темы, адаптивная вёрстка под телефон, вложения скачиваются в один клик.

Стартовый экран: создание почты или вход    Мобильная версия

🚀 Быстрый старт

Проще всего — открыть готовый сайт. Чтобы запустить у себя, нужен только 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 + Cloudflare Worker — бесплатно и без сервера

Так работает живая версия: страница лежит на GitHub Pages, API — на Cloudflare Workers, сроки ящиков — в базе Cloudflare D1, удаление просроченных — по cron раз в минуту.

  1. 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
  2. Настройка. Впишите адрес Worker'а в public/config.js, а адрес своего сайта (https://<логин>.github.io) — в ALLOWED_ORIGINS в worker/wrangler.toml, затем повторите npm run deploy.

  3. Pages. В репозитории: Settings → Pages → Source: GitHub Actions. Дальше каждый пуш в public/ выкладывается автоматически через pages.yml.

  4. Вход через 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 — в один клик

Deploy to Render

Конфигурация лежит в render.yaml. На бесплатном тарифе диск не сохраняется между перезапусками — сроки уже созданных ящиков при рестарте забудутся (сами ящики останутся в mail.tm).

Docker

docker build -t temp-mail .
docker run -d -p 5190:5190 -v temp-mail-data:/app/data --name temp-mail temp-mail

Том /app/data хранит сроки ящиков между перезапусками.

Любой VPS

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
Loading
  • 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.

📡 API

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.

📄 Лицензия

MIT

About

✉️ Временная почта: одноразовые ящики со сроком жизни от 15 минут до недели. Node.js без зависимостей, бэкенд mail.tm

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages