marclou/mailcheap

选用指南

AI 根据 README 整理 · 2026/10/11 12:16:06

适用场景

适合需要自托管新闻通讯、控制发送成本并管理订阅者列表的场景，例如定期向读者发送邮件更新。

查看 README 依据

# Mailcheap Mailcheap is a self-hosted newsletter app on Amazon SES. Write an issue, send it to your list, publish it on the web. About $0.10 per 1,000 emails. 

> **No support.** This is a one-time open-source release. Issues are off, and setup questions go unanswered. Fork it, deploy it, make it yours. ## Why Newsletter platforms charge for every subscriber, every month. With your own SES account you pay for the emails you send: 10,000 readers and 4 issues a month is 40,000 emails, about $4. Mailcheap is the rest of what a newsletter needs, in one small Next.js app: an editor, a list, signup forms, unsubscribe handling, bounce and complaint handling, stats and a public archive. One admin, no teams, no plans. Your list stays in your database.

目标用户

面向希望自行部署邮件通讯系统的个人或小团队，支持单管理员操作。

查看 README 依据

> **No support.** This is a one-time open-source release. Issues are off, and setup questions go unanswered. Fork it, deploy it, make it yours. ## Why Newsletter platforms charge for every subscriber, every month. With your own SES account you pay for the emails you send: 10,000 readers and 4 issues a month is 40,000 emails, about $4. Mailcheap is the rest of what a newsletter needs, in one small Next.js app: an editor, a list, signup forms, unsubscribe handling, bounce and complaint handling, stats and a public archive. One admin, no teams, no plans. Your list stays in your database.

使用方式

通过网页界面编写和发送邮件，也提供 API 用于添加联系人和创建草稿。

查看 README 依据

## Features **Write and send** - Editor with a live email preview, slash commands, image uploads and boxes. Markdown and raw HTML work too. - Checks before every send: subject, preview text, unsubscribe link, size under Gmail's 100 KB clip, postal address, verified domain. - Test emails, scheduling, and sending in batches through QStash at the rate you set. - Send in steps: start with your most engaged readers, then send to more. **Grow the list** - Several newsletters in one install, each with its own from address, reply-to and postal address.

| `ARCHIVE_HOSTS` | No | Archive domains, like `news.example.com=weekly,letters.example.org=monthly` | | `UPSTASH_REDIS_REST_URL`, `UPSTASH_REDIS_REST_TOKEN` | No | Shared rate limits | | `BLOB_READ_WRITE_TOKEN` | No | Image uploads in the editor (set by Vercel Blob) | | `ALERT_FROM` | No | From address for alert emails, on a verified domain | [`.env.example`](.env.example) has the same list with more detail. ## API Create a key on the **API keys** page and send it as `Authorization: Bearer <key>`. **Add a contact**: `POST /api/v1/contacts` ```bash

部署要求

需要 MongoDB、Amazon SES、Upstash QStash 和 Node.js 主机（如 Vercel）。可选依赖包括 Upstash Redis 和 Vercel Blob。

查看 README 依据

All names and addresses in the screenshots are made up. ## What you need | Service | For | Cost | | --- | --- | --- | | [MongoDB](https://www.mongodb.com/atlas) | Contacts, campaigns, stats | Free tier works | | [Amazon SES](https://aws.amazon.com/ses/) | Sending | About $0.10 per 1,000 emails | | [Upstash QStash](https://upstash.com/docs/qstash) | Background sending and scheduling | Free tier to start, then pay per message. One message sends 50 emails. | | [Vercel](https://vercel.com) or any Node.js host | Hosting | Free tier works |

| [Upstash Redis](https://upstash.com/docs/redis) (optional) | Rate limits shared by every server instance | Free tier | | [Vercel Blob](https://vercel.com/docs/vercel-blob) (optional) | Image uploads in the editor | Free tier | Without Redis, Mailcheap counts the same rate limits in each server instance's memory. That still stops a script hammering a form, but on serverless hosts the limits aren't shared between instances and reset on each deploy. Add Redis before you put a signup form on a busy site.

已知限制

作者明确表示不提供支持，问题反馈关闭，且不计划更新。

查看 README 依据

> **No support.** This is a one-time open-source release. Issues are off, and setup questions go unanswered. Fork it, deploy it, make it yours. ## Why Newsletter platforms charge for every subscriber, every month. With your own SES account you pay for the emails you send: 10,000 readers and 4 issues a month is 40,000 emails, about $4. Mailcheap is the rest of what a newsletter needs, in one small Next.js app: an editor, a list, signup forms, unsubscribe handling, bounce and complaint handling, stats and a public archive. One admin, no teams, no plans. Your list stays in your database.

There's none: issues are off and pull requests may not be reviewed. This is a one-time release, with no updates planned. See [SECURITY.md](SECURITY.md) for what's built in. ## License [MIT](LICENSE). Made by [Marc Lou](https://x.com/marclou).