{"id":116688,"date":"2026-10-22T00:24:51","date_gmt":"2026-10-21T16:24:51","guid":{"rendered":"https:\/\/www.wsisp.com\/helps\/116688.html"},"modified":"2026-10-22T00:24:51","modified_gmt":"2026-10-21T16:24:51","slug":"maildev-v3-%e7%a8%8b%e5%ba%8f%e5%8c%96-api-%e5%ae%9e%e6%88%98%e6%8c%87%e5%8d%97%ef%bc%9a%e5%9c%a8-node-js-%e4%b8%ad%e5%b5%8c%e5%85%a5-smtp-%e6%b5%8b%e8%af%95%e6%9c%8d%e5%8a%a1%e5%99%a8%e4%b8%8e-web","status":"publish","type":"post","link":"https:\/\/www.wsisp.com\/helps\/116688.html","title":{"rendered":"MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762"},"content":{"rendered":"<ul class=\"gcb-tag-list\">\n<li><span class=\"gcb-tag\">\u540e\u7aef<\/span><\/li>\n<li><span class=\"gcb-tag\">\u5f00\u53d1\u5de5\u5177<\/span><\/li>\n<li><span class=\"gcb-tag\">\u6d4b\u8bd5<\/span><\/li>\n<\/ul>\n<h3 class=\"gcb-project-title\">\u3010\u514d\u8d39\u4e0b\u8f7d\u94fe\u63a5\u3011maildev<\/h3>\n<p class=\"gcb-project-desc\">:mailbox: SMTP Server &#043; Web Interface for viewing and testing emails during development.<\/p>\n<p>    <span class=\"gcb-project-addr-label\">\u9879\u76ee\u5730\u5740&#xff1a;<\/span><br \/>\n    <span class=\"gcb-project-addr-link\">https:\/\/gitcode.com\/gh_mirrors\/ma\/maildev<\/span> <\/p>\n<p>  <span class=\"gcb-project-btn\"> <span class=\"gcb-project-btn-main\">\u70b9\u51fb\u67e5\u770b<\/span> <span class=\"gcb-project-btn-sub\">\u514d\u8d39\u4e0b\u8f7d<\/span> <\/span> <\/p>\n<h3>\u5bfc\u8bfb<\/h3>\n<p>MailDev v3 \u63d0\u4f9b\u4e86\u5b8c\u5168\u57fa\u4e8e TypeScript \u4e0e\u73b0\u4ee3 async\/await \u98ce\u683c\u7684\u7a0b\u5e8f\u5316 API&#xff0c;\u5141\u8bb8\u5f00\u53d1\u8005\u5c06\u672c\u5730 SMTP \u5f00\u53d1\u670d\u52a1\u5668\u3001Web \u90ae\u4ef6\u67e5\u770b\u754c\u9762\u3001REST API \u4e0e WebSocket \u63a8\u9001\u76f4\u63a5\u5d4c\u5165\u81ea\u5df1\u7684 Node.js \u5e94\u7528\u3001\u6d4b\u8bd5\u6846\u67b6\u6216\u5de5\u5177\u94fe\u4e2d\u3002\u672c\u6587\u4ee5\u5b98\u65b9 docs\/api.md \u4e3a\u9aa8\u67b6&#xff0c;\u7ed3\u5408\u4ed3\u5e93\u6e90\u7801\u9010\u5c42\u5c55\u5f00&#xff1a;\u4ece MailDev \u7c7b\u7684\u6784\u9020\u4e0e\u542f\u52a8\u3001\u5185\u5b58\/\u78c1\u76d8\u4e24\u79cd\u5b58\u50a8\u6a21\u578b\u3001\u90ae\u4ef6\u5bf9\u8c61\u7ed3\u6784\u4e0e\u5404\u7c7b\u64cd\u4f5c&#xff08;\u67e5\u8be2\u3001\u9644\u4ef6\u3001\u5220\u9664\u3001\u4e2d\u7ee7&#xff09;&#xff0c;\u5230\u4e8b\u4ef6\u76d1\u542c\u3001\u72ec\u7acb\u5b50\u5305\u7ec4\u5408\u3001\u4e2d\u95f4\u4ef6\u96c6\u6210\u4e0e v2\u2192v3 \u8fc1\u79fb&#xff0c;\u6700\u7ec8\u4f60\u5c06\u80fd\u591f\u628a MailDev \u4f5c\u4e3a\u4e00\u4e2a\u53ef\u7f16\u7a0b\u7ec4\u4ef6\u6df1\u5ea6\u96c6\u6210\u8fdb\u81ea\u5df1\u7684\u9879\u76ee\u4e2d\u3002<\/p>\n<hr \/>\n<h3>\u4e00\u3001\u4e3a\u4ec0\u4e48\u9700\u8981\u7a0b\u5e8f\u5316 API<\/h3>\n<p>MailDev \u5728\u5f00\u53d1\u73af\u5883\u626e\u6f14\u7684\u89d2\u8272\u662f&#034;\u672c\u5730\u90ae\u7bb1&#034;&#xff1a;\u5e94\u7528\u628a\u90ae\u4ef6\u53d1\u5230\u672c\u673a SMTP \u7aef\u53e3&#xff08;\u9ed8\u8ba4 1025&#xff09;&#xff0c;\u5f00\u53d1\u8005\u901a\u8fc7 Web \u754c\u9762&#xff08;\u9ed8\u8ba4 1080&#xff09;\u67e5\u770b\u3001\u641c\u7d22\u3001\u4e0b\u8f7d\u4e0e\u5220\u9664\u8fd9\u4e9b\u90ae\u4ef6\u3002CLI \u65b9\u5f0f&#xff08;maildev \u547d\u4ee4&#xff09;\u9002\u5408\u72ec\u7acb\u4f7f\u7528&#xff0c;\u4f46\u9047\u5230\u4ee5\u4e0b\u573a\u666f\u65f6&#xff0c;\u7a0b\u5e8f\u5316 API \u662f\u66f4\u4f18\u89e3&#xff1a;<\/p>\n<ul>\n<li>\u81ea\u52a8\u5316\u6d4b\u8bd5&#xff1a;\u4e3a\u6bcf\u4e2a\u5e76\u884c\u6d4b\u8bd5 worker \u542f\u52a8\u72ec\u7acb\u5b9e\u4f8b&#xff0c;\u901a\u8fc7 smtp: 0 \u8ba9\u64cd\u4f5c\u7cfb\u7edf\u5206\u914d\u7a7a\u95f2\u7aef\u53e3&#xff0c;\u907f\u514d\u7aef\u53e3\u51b2\u7a81&#xff1b;<\/li>\n<li>\u5de5\u5177\u94fe\u96c6\u6210&#xff1a;\u628a SMTP \u670d\u52a1\u5668\u5d4c\u5165\u81ea\u5df1\u7684 Express\/Fastify \u5e94\u7528\u6216 CI \u811a\u672c&#xff0c;\u7edf\u4e00\u7aef\u53e3\u4e0e\u751f\u547d\u5468\u671f\u7ba1\u7406&#xff1b;<\/li>\n<li>\u4e8b\u4ef6\u9a71\u52a8&#xff1a;\u901a\u8fc7 &#039;new&#039;\u3001&#039;delete&#039; \u7b49\u4e8b\u4ef6\u5b9e\u65f6\u54cd\u5e94\u90ae\u4ef6&#xff0c;\u4f8b\u5982\u81ea\u52a8\u4e2d\u7ee7\u5173\u952e\u90ae\u4ef6\u5230\u771f\u5b9e\u90ae\u7bb1&#xff1b;<\/li>\n<li>\u7cbe\u7ec6\u63a7\u5236&#xff1a;\u76f4\u63a5\u64cd\u4f5c\u5e95\u5c42 &#064;maildev\/core\u3001&#064;maildev\/smtp\u3001&#064;maildev\/api \u5b50\u5305&#xff0c;\u7ed5\u8fc7 MailDev \u95e8\u9762\u7c7b\u3002<\/li>\n<\/ul>\n<p>\u4ece\u6e90\u7801\u7ed3\u6784\u770b&#xff0c;MailDev \u7c7b\u672c\u8eab\u662f\u4e00\u4e2a\u95e8\u9762&#xff08;facade&#xff09;&#xff1a;\u6784\u9020\u65f6\u5c06\u914d\u7f6e\u5408\u5e76\u8fdb\u9ed8\u8ba4\u503c&#xff0c;\u5e76\u59d4\u6258\u7ed9\u5185\u90e8\u7684 Orchestrator \u7edf\u4e00\u521b\u5efa\u3001\u542f\u52a8\u4e0e\u505c\u6b62\u5b58\u50a8\u3001SMTP\u3001API \u4e09\u7ec4\u670d\u52a1&#xff08;\u89c1 packages\/cli\/src\/index.ts \u4e0e packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002<\/p>\n<h3>\u4e8c\u3001\u5feb\u901f\u5f00\u59cb\u4e0e\u5b89\u88c5<\/h3>\n<p>\u5b89\u88c5\u4e0e\u4f7f\u7528\u540c\u6837\u7b80\u5355&#xff1a;<\/p>\n<p>npm install maildev<\/p>\n<p>import { MailDev } from &#039;maildev&#039;<\/p>\n<p>const maildev &#061; new MailDev({<br \/>\n  smtp: 1025,<br \/>\n  web: 1080,<br \/>\n})<\/p>\n<p>await maildev.start()<\/p>\n<p>\/\/ Access server instances<br \/>\nconst servers &#061; maildev.getServers()<\/p>\n<p>\/\/ Listen for new emails<br \/>\nservers.smtp.on(&#039;new&#039;, (email) &#061;&gt; {<br \/>\n  console.log(&#039;Received:&#039;, email.subject)<br \/>\n})<\/p>\n<p>\/\/ Stop when done<br \/>\nawait maildev.stop()<\/p>\n<p>\u4ece\u4ed3\u5e93\u6e90\u7801\u770b&#xff0c;start() \u5185\u90e8\u4f9d\u6b21\u6267\u884c&#xff1a;\u521d\u59cb\u5316\u5b58\u50a8&#xff08;MemoryStorage \u6216 FileStorage&#xff09;\u2192 \u521b\u5efa SMTP \u670d\u52a1\u5668 \u2192 \u914d\u7f6e\u4e2d\u7ee7 \u2192 \u542f\u52a8 SMTP \u2192 \u53ef\u9009\u88c1\u526a\u4e0e\u6062\u590d\u78c1\u76d8\u90ae\u4ef6 \u2192 \u521b\u5efa\u5e76\u542f\u52a8 API \u670d\u52a1\u5668&#xff08;\u9664\u975e disableWeb&#xff09;&#xff0c;\u6700\u540e\u628a { storage, smtp, api? } \u8fd4\u56de\u7ed9\u8c03\u7528\u65b9&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002\u5982\u679c\u670d\u52a1\u5df2\u7ecf\u542f\u52a8&#xff0c;\u518d\u6b21\u8c03\u7528 start() \u4f1a\u629b\u51fa &#039;Servers are already running&#039; \u5f02\u5e38\u3002<\/p>\n<h3>\u4e09\u3001MailDev \u7c7b&#xff1a;\u6784\u9020\u51fd\u6570\u9009\u9879\u8be6\u89e3<\/h3>\n<p>MailDev \u7c7b\u63d0\u4f9b\u6700\u7b80\u6d01\u7684\u7a0b\u5e8f\u5316\u4f7f\u7528\u65b9\u5f0f&#xff0c;\u6784\u9020\u51fd\u6570\u63a5\u53d7\u4e00\u4e2a PartialMailDevConfig&#xff0c;\u672a\u63d0\u4f9b\u7684\u5b57\u6bb5\u4f1a\u4e0e\u9ed8\u8ba4\u914d\u7f6e\u5408\u5e76&#xff08;\u89c1 packages\/cli\/src\/config\/types.ts&#xff09;\u3002\u4ee5\u4e0b\u662f\u5b8c\u6574\u914d\u7f6e\u9009\u9879&#xff1a;<\/p>\n<p>import { MailDev } from &#039;maildev&#039;<\/p>\n<p>const maildev &#061; new MailDev({<br \/>\n  \/\/ SMTP Server<br \/>\n  smtp: 1025,              \/\/ SMTP port (default: 1025)<br \/>\n  ip: &#039;::&#039;,                \/\/ SMTP bind address (default: &#039;::&#039;)<\/p>\n<p>  \/\/ Web\/API Server<br \/>\n  web: 1080,               \/\/ Web UI port (default: 1080)<br \/>\n  webIp: &#039;0.0.0.0&#039;,        \/\/ Web bind address (default: &#039;0.0.0.0&#039;)<br \/>\n  disableWeb: false,       \/\/ Disable web interface<br \/>\n  basePathname: &#039;\/&#039;,       \/\/ Base path for web interface<\/p>\n<p>  \/\/ Storage<br \/>\n  mailDirectory: &#039;\/tmp\/maildev&#039;,  \/\/ Persist emails to disk (optional)<br \/>\n  maxEmails: 0,            \/\/ Keep at most this many emails (0 &#061; unlimited, default)<\/p>\n<p>  \/\/ Authentication<br \/>\n  incomingUser: &#039;user&#039;,    \/\/ SMTP auth username<br \/>\n  incomingPass: &#039;pass&#039;,    \/\/ SMTP auth password<br \/>\n  webUser: &#039;admin&#039;,        \/\/ Web UI username<br \/>\n  webPass: &#039;admin&#039;,        \/\/ Web UI password<\/p>\n<p>  \/\/ Relay (outgoing mail)<br \/>\n  outgoingHost: &#039;smtp.example.com&#039;,<br \/>\n  outgoingPort: 587,<br \/>\n  outgoingUser: &#039;user&#039;,<br \/>\n  outgoingPass: &#039;pass&#039;,<br \/>\n  outgoingSecure: true,<br \/>\n  autoRelay: true,         \/\/ Auto-forward emails<\/p>\n<p>  \/\/ Logging<br \/>\n  verbose: false,<br \/>\n  silent: false,<br \/>\n  logMailContents: false,<\/p>\n<p>  \/\/ MCP (Claude integration)<br \/>\n  mcp: true,               \/\/ Enable MCP server at \/mcp endpoint<br \/>\n})<\/p>\n<p>\u4e0b\u9762\u5bf9\u51e0\u4e2a\u5173\u952e\u9009\u9879\u505a\u6e90\u7801\u7ea7\u89e3\u8bfb&#xff1a;<\/p>\n<table>\n<tr>\u914d\u7f6e\u9879\u9ed8\u8ba4\u503c\u4f5c\u7528\u4e0e\u6e90\u7801\u4f9d\u636e<\/tr>\n<tbody>\n<tr>\n<td>smtp<\/td>\n<td>1025<\/td>\n<td>SMTP \u76d1\u542c\u7aef\u53e3\u3002\u6ce8\u610f SMTP \u670d\u52a1\u5668\u6e90\u7801\u4e2d\u4f7f\u7528 ?? \u800c\u975e \\\\|\\\\| \u5224\u65ad\u9ed8\u8ba4\u503c&#xff0c;\u56e0\u6b64\u663e\u5f0f\u4f20\u5165 smtp: 0 \u4f1a\u88ab\u5f53\u4f5c&#034;\u7531\u64cd\u4f5c\u7cfb\u7edf\u5206\u914d\u7a7a\u95f2\u7aef\u53e3&#034;\u800c\u4e0d\u662f\u56de\u9000\u9ed8\u8ba4\u503c&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;<\/td>\n<\/tr>\n<tr>\n<td>ip<\/td>\n<td>&#039;::&#039;<\/td>\n<td>SMTP \u7ed1\u5b9a\u5730\u5740&#xff0c;\u9ed8\u8ba4\u76d1\u542c\u6240\u6709 IPv6\/IPv4 \u5730\u5740<\/td>\n<\/tr>\n<tr>\n<td>web<\/td>\n<td>1080<\/td>\n<td>Web\/API \u670d\u52a1\u5668\u7aef\u53e3<\/td>\n<\/tr>\n<tr>\n<td>webIp<\/td>\n<td>&#039;0.0.0.0&#039;<\/td>\n<td>Web \u670d\u52a1\u5668\u7ed1\u5b9a\u5730\u5740<\/td>\n<\/tr>\n<tr>\n<td>disableWeb<\/td>\n<td>false<\/td>\n<td>\u4e3a true \u65f6\u4e0d\u521b\u5efa API\/UI \u670d\u52a1\u5668&#xff0c;\u9002\u7528\u4e8e\u7eaf SMTP \u573a\u666f<\/td>\n<\/tr>\n<tr>\n<td>mailDirectory<\/td>\n<td>\u4e0d\u8bbe\u7f6e<\/td>\n<td>\u8bbe\u7f6e\u540e\u4f7f\u7528 FileStorage \u6301\u4e45\u5316\u90ae\u4ef6&#xff1b;\u4e0d\u8bbe\u7f6e\u5219\u7528\u5185\u5b58\u5b58\u50a8\u3002\u89c1\u4e0b\u65b9&#034;\u5b58\u50a8\u6a21\u578b&#034;\u5c0f\u8282<\/td>\n<\/tr>\n<tr>\n<td>maxEmails<\/td>\n<td>0<\/td>\n<td>\u90ae\u4ef6\u6570\u91cf\u4e0a\u9650&#xff0c;0 \u8868\u793a\u4e0d\u9650\u91cf&#xff08;\u5386\u53f2\u9ed8\u8ba4\u884c\u4e3a&#xff09;\u3002\u8bbe\u7f6e\u4e3a\u6b63\u6570\u540e&#xff0c;\u8d85\u51fa\u4e0a\u9650\u65f6\u6700\u65e7\u7684\u90ae\u4ef6\u8fde\u540c\u78c1\u76d8 .eml \u6587\u4ef6\u4e0e\u9644\u4ef6\u4e00\u5e76\u5220\u9664<\/td>\n<\/tr>\n<tr>\n<td>incomingUser \/ incomingPass<\/td>\n<td>\u4e0d\u8bbe\u7f6e<\/td>\n<td>SMTP \u8ba4\u8bc1\u51ed\u636e&#xff0c;\u4e24\u8005\u540c\u65f6\u8bbe\u7f6e\u624d\u542f\u7528&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;<\/td>\n<\/tr>\n<tr>\n<td>webUser \/ webPass<\/td>\n<td>\u4e0d\u8bbe\u7f6e<\/td>\n<td>Web \u754c\u9762 HTTP Basic Auth \u51ed\u636e&#xff1b;\/api\/healthz \u5065\u5eb7\u68c0\u67e5\u7aef\u70b9\u59cb\u7ec8\u514d\u8ba4\u8bc1&#xff08;\u89c1 packages\/api\/src\/server.ts&#xff09;<\/td>\n<\/tr>\n<tr>\n<td>outgoingHost \/ outgoingPort<\/td>\n<td>\u4e0d\u8bbe\u7f6e \/ 25<\/td>\n<td>\u51fa\u7ad9\u4e2d\u7ee7\u670d\u52a1\u5668\u5730\u5740\u3002\u6ce8\u610f outgoingPort \u7f3a\u7701\u65f6\u5728 orchestrator \u4e2d\u56de\u9000\u4e3a 25&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;<\/td>\n<\/tr>\n<tr>\n<td>outgoingSecure<\/td>\n<td>\u4e0d\u8bbe\u7f6e<\/td>\n<td>\u4e2d\u7ee7\u8fde\u63a5\u662f\u5426\u4f7f\u7528 TLS\/SSL<\/td>\n<\/tr>\n<tr>\n<td>autoRelay<\/td>\n<td>\u4e0d\u8bbe\u7f6e<\/td>\n<td>\u81ea\u52a8\u8f6c\u53d1\u6240\u6709\u6536\u4ef6\u90ae\u4ef6&#xff1b;\u4f20\u5165\u5b57\u7b26\u4e32&#xff08;\u5982 &#039;catch-all&#064;example.com&#039;&#xff09;\u5219\u628a\u5168\u90e8\u90ae\u4ef6\u8f6c\u53d1\u5230\u8be5\u56fa\u5b9a\u6536\u4ef6\u4eba<\/td>\n<\/tr>\n<tr>\n<td>verbose \/ silent<\/td>\n<td>false<\/td>\n<td>\u63a7\u5236\u65e5\u5fd7\u8f93\u51fa<\/td>\n<\/tr>\n<tr>\n<td>mcp<\/td>\n<td>false<\/td>\n<td>\u542f\u7528 MCP&#xff08;Model Context Protocol&#xff09;\u670d\u52a1\u5668&#xff0c;\u6302\u8f7d\u4e8e \/mcp \u7aef\u70b9&#xff0c;\u4f9b Claude \u7b49 Agent \u8bfb\u53d6\u4e0e\u64cd\u4f5c\u90ae\u4ef6<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4>\u6784\u9020\u80cc\u540e\u7684\u673a\u5236<\/h4>\n<p>MailDev \u6784\u9020\u51fd\u6570\u5728\u6e90\u7801\u4e2d\u505a\u4e09\u4ef6\u4e8b&#xff1a;\u7528\u9ed8\u8ba4\u914d\u7f6e\u5408\u5e76\u7528\u6237\u914d\u7f6e\u3001\u6839\u636e verbose\/silent \u521b\u5efa\u65e5\u5fd7\u5668\u3001\u521b\u5efa Orchestrator&#xff08;\u89c1 packages\/cli\/src\/index.ts&#xff09;\u3002Orchestrator \u7684 createStorage() \u6839\u636e\u662f\u5426\u8bbe\u7f6e mailDirectory \u51b3\u5b9a\u5b9e\u4f8b\u5316 FileStorage \u8fd8\u662f MemoryStorage&#xff0c;\u4e24\u8005\u90fd\u63a5\u6536 maxEmails \u4f5c\u4e3a\u4e0a\u9650&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002<\/p>\n<h3>\u56db\u3001\u6838\u5fc3\u65b9\u6cd5&#xff1a;start \/ stop \/ isRunning \/ getServers<\/h3>\n<p>\/\/ \u542f\u52a8\u6240\u6709\u670d\u52a1\u5668&#xff08;\u5f02\u6b65&#xff09;<br \/>\nconst servers &#061; await maildev.start()<br \/>\n\/\/ servers.smtp &#8211; SMTP server instance<br \/>\n\/\/ servers.storage &#8211; Storage instance<br \/>\n\/\/ servers.api &#8211; API server instance (if not disabled)<\/p>\n<p>\/\/ \u4f18\u96c5\u505c\u6b62\u6240\u6709\u670d\u52a1\u5668&#xff08;\u5f02\u6b65&#xff09;<br \/>\nawait maildev.stop()<\/p>\n<p>\/\/ \u68c0\u67e5\u670d\u52a1\u5668\u662f\u5426\u8fd0\u884c<br \/>\nif (maildev.isRunning()) {<br \/>\n  console.log(&#039;MailDev is running&#039;)<br \/>\n}<\/p>\n<p>\/\/ \u83b7\u53d6\u670d\u52a1\u5668\u5b9e\u4f8b<br \/>\nconst servers &#061; maildev.getServers()<\/p>\n<p>\u51e0\u4e2a\u503c\u5f97\u6ce8\u610f\u7684\u7ec6\u8282&#xff1a;<\/p>\n<ul>\n<li>stop() \u7684\u5173\u95ed\u987a\u5e8f&#xff1a;\u6e90\u7801\u4e2d\u6309\u7167&#034;API \u2192 SMTP \u2192 \u5b58\u50a8&#034;\u9006\u5e8f\u505c\u6b62\u3002API \u5173\u95ed\u65f6\u4f1a\u5148\u5173\u95ed\u6240\u6709 MCP \u4f1a\u8bdd\u4e0e WebSocket \u8fde\u63a5\u518d\u5173\u95ed Fastify&#xff1b;\u5b58\u50a8\u5219\u8c03\u7528 close()&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002<\/li>\n<li>getServers() \u7684\u8fd4\u56de\u65f6\u673a&#xff1a;\u53ea\u6709\u5728 running \u4e14\u5b58\u50a8\u3001SMTP \u90fd\u5df2\u521b\u5efa\u65f6\u624d\u8fd4\u56de\u5b9e\u4f8b\u5bf9\u8c61&#xff0c;\u5426\u5219\u8fd4\u56de null&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002<\/li>\n<li>Servers \u7ed3\u6784&#xff1a;{ storage, smtp, api? }&#xff0c;api \u5728 disableWeb \u65f6\u4e3a\u53ef\u9009&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002<\/li>\n<\/ul>\n<h3>\u4e94\u3001\u4e34\u65f6\u7aef\u53e3&#xff08;Ephemeral Ports&#xff09;&#xff1a;\u5e76\u884c\u6d4b\u8bd5\u7684\u5173\u952e\u6280\u5de7<\/h3>\n<p>\u5e76\u884c\u6d4b\u8bd5\u8fd0\u884c\u5668&#xff08;\u5982 Jest\u3001Vitest \u7684\u591a worker&#xff09;\u6700\u5927\u7684\u75db\u70b9\u4e4b\u4e00\u662f\u7aef\u53e3\u51b2\u7a81\u3002MailDev \u652f\u6301\u4f20 smtp: 0&#xff08;\u6216 web: 0&#xff09;\u8ba9\u64cd\u4f5c\u7cfb\u7edf\u5206\u914d\u7a7a\u95f2\u7aef\u53e3&#xff0c;\u518d\u8bfb\u56de\u5b9e\u9645\u7ed1\u5b9a\u7684\u7aef\u53e3\u2014\u2014\u8fd9\u662f\u5b98\u65b9\u63a8\u8350\u7684\u5728\u5e76\u884c\u6d4b\u8bd5\u4e2d&#034;\u6bcf\u4e2a worker \u4e00\u4e2a MailDev&#034;\u7684\u53ef\u9760\u65b9\u5f0f&#xff0c;\u65e0\u9700\u624b\u5de5\u5206\u914d\u7aef\u53e3&#xff1a;<\/p>\n<p>const maildev &#061; new MailDev({ smtp: 0, disableWeb: true })<br \/>\nconst { smtp } &#061; await maildev.start()<\/p>\n<p>const { host, port } &#061; smtp.getAddress()<br \/>\nconsole.log(&#096;SMTP listening on ${host}:${port}&#096;)<\/p>\n<p>\/\/ Point your app&#039;s mail transport at &#096;port&#096; \u2014 e.g. nodemailer:<br \/>\n\/\/ nodemailer.createTransport({ host, port, secure: false })<\/p>\n<p>SMTP \u4e0e API \u670d\u52a1\u5668\u90fd\u66b4\u9732\u4e86\u7ed1\u5b9a\u5730\u5740\u8bbf\u95ee\u5668&#xff1a;<\/p>\n<ul>\n<li>smtp.getAddress() \u2192 { host, port }&#xff08;\u4ee5\u53ca smtp.getPort()&#xff09;<\/li>\n<li>servers.api?.getAddress() \u2192 { host, port } | null&#xff08;\u4ee5\u53ca api.getPort()&#xff09;<\/li>\n<\/ul>\n<p>API \u670d\u52a1\u5668\u7684\u8bbf\u95ee\u5668\u5728\u5f00\u59cb\u76d1\u542c\u4e4b\u524d\u8fd4\u56de null\u3002<\/p>\n<p>const maildev &#061; new MailDev({ smtp: 0, web: 0 })<br \/>\nconst { smtp, api } &#061; await maildev.start()<\/p>\n<p>const smtpPort &#061; smtp.getPort()          \/\/ OS-assigned SMTP port<br \/>\nconst webPort &#061; api?.getPort()           \/\/ OS-assigned web\/API port<\/p>\n<p>\u539f\u7406&#xff1a;SMTP \u670d\u52a1\u5668\u5728 start() \u6210\u529f\u540e\u901a\u8fc7 this.smtp!.server.address() \u8bfb\u53d6\u64cd\u4f5c\u7cfb\u7edf\u5b9e\u9645\u7ed1\u5b9a\u7684\u7aef\u53e3\u5e76\u5199\u56de this.port&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;&#xff1b;API \u670d\u52a1\u5668\u540c\u7406&#xff0c;\u5728 listen() \u4e2d\u8bb0\u5f55 boundAddress&#xff08;\u89c1 packages\/api\/src\/server.ts&#xff09;\u3002\u6240\u4ee5 smtp: 0 \u62a5\u544a\u7684\u662f\u771f\u5b9e\u7aef\u53e3\u800c\u975e 0\u3002<\/p>\n<p>\u53e6\u5916 SMTP \u670d\u52a1\u5668\u6e90\u7801\u5bf9 port: 0 \u4f7f\u7528 ?? \u56de\u9000\u9ed8\u8ba4\u503c\u7684\u5904\u7406&#xff0c;\u4fdd\u8bc1\u4e86&#034;0 \u662f\u6709\u6548\u503c&#034;\u8bed\u4e49\u6b63\u786e&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;\u3002<\/p>\n<h3>\u516d\u3001\u4e0e\u90ae\u4ef6\u4ea4\u4e92&#xff1a;\u4e8b\u4ef6\u3001\u67e5\u8be2\u3001\u5206\u9875\u4e0e\u6301\u4e45\u5316<\/h3>\n<h4>6.1 \u76d1\u542c\u65b0\u90ae\u4ef6<\/h4>\n<p>MailDev \u8fd0\u884c\u540e&#xff0c;\u53ef\u4ee5\u901a\u8fc7 SMTP \u670d\u52a1\u5668\u5b9e\u4f8b\u8bbf\u95ee\u90ae\u4ef6&#xff1a;<\/p>\n<p>const maildev &#061; new MailDev()<br \/>\nconst { smtp } &#061; await maildev.start()<\/p>\n<p>smtp.on(&#039;new&#039;, (email) &#061;&gt; {<br \/>\n  console.log(&#039;New email received!&#039;)<br \/>\n  console.log(&#039;From:&#039;, email.from[0].address)<br \/>\n  console.log(&#039;To:&#039;, email.to.map(t &#061;&gt; t.address).join(&#039;, &#039;))<br \/>\n  console.log(&#039;Subject:&#039;, email.subject)<br \/>\n  console.log(&#039;Text:&#039;, email.text)<br \/>\n  console.log(&#039;HTML:&#039;, email.html)<br \/>\n})<\/p>\n<p>\u6ce8\u610f&#xff1a;email.html \u7ecf\u8fc7 sanitizeHtml \u51c0\u5316\u5904\u7406&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;&#xff0c;\u907f\u514d\u5728 Web \u754c\u9762\u4e2d\u6e32\u67d3\u6076\u610f\u811a\u672c\u3002<\/p>\n<h4>6.2 \u9650\u5236\u4fdd\u7559\u7684\u90ae\u4ef6\u6570\u91cf<\/h4>\n<p>MailDev \u9ed8\u8ba4\u4fdd\u7559\u6240\u6709\u90ae\u4ef6&#xff08;maxEmails: 0&#xff09;\u3002\u8bbe\u7f6e\u6b63\u6570 maxEmails \u540e&#xff0c;\u53ea\u4fdd\u7559\u6700\u65b0\u7684 N \u5c01&#xff0c;\u65b0\u90ae\u4ef6\u5230\u8fbe\u65f6\u4e22\u5f03\u6700\u65e7\u7684\u3002\u5f53\u90ae\u4ef6\u6301\u4e45\u5316\u5230\u78c1\u76d8\u65f6&#xff0c;.eml \u6587\u4ef6\u548c\u9644\u4ef6\u4f1a\u968f\u90ae\u4ef6\u4e00\u5e76\u5220\u9664&#xff0c;\u90ae\u4ef6\u76ee\u5f55\u540c\u6837\u4fdd\u6301\u6709\u754c&#xff1a;<\/p>\n<p>const maildev &#061; new MailDev({<br \/>\n  mailDirectory: &#039;\/var\/mail\/maildev&#039;,<br \/>\n  maxEmails: 5000,<br \/>\n})<\/p>\n<p>\u6027\u80fd\u63d0\u9192&#xff1a;maxEmails: 0&#xff08;\u9ed8\u8ba4&#xff09;\u4f1a\u65e0\u9650\u589e\u957f\u3002\u5185\u5b58\u4f7f\u7528\u4e0e\u90ae\u4ef6\u76ee\u5f55\u90fd\u4f1a\u6301\u7eed\u81a8\u80c0&#xff1a;\u6309\u5178\u578b\u90ae\u4ef6\u5927\u5c0f\u4f30\u7b97&#xff0c;10000 \u5c01\u90ae\u4ef6\u7ea6\u5360\u7528 150 MB \u5806\u5185\u5b58&#xff0c;\u4e14\u78c1\u76d8\u6587\u4ef6\u6c38\u8fdc\u4e0d\u4f1a\u88ab\u79fb\u9664\u2014\u2014\u957f\u65f6\u8fd0\u884c\u6216\u9ad8\u541e\u5410\u573a\u666f\u52a1\u5fc5\u8bbe\u7f6e\u6b63\u6570\u4e0a\u9650\u3002<\/p>\n<p>\u5b9e\u73b0\u7ec6\u8282&#xff1a;SMTP \u670d\u52a1\u5668\u5728\u6784\u9020\u65f6\u5411\u5b58\u50a8\u6ce8\u518c onEvicted \u56de\u8c03&#xff0c;\u4e00\u65e6\u5b58\u50a8\u56e0\u4e0a\u9650\u6dd8\u6c70\u90ae\u4ef6&#xff0c;\u5c31\u4f1a\u540c\u6b65\u5220\u9664\u78c1\u76d8\u4e0a\u7684 .eml \u4e0e\u9644\u4ef6\u76ee\u5f55&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;\u3002\u542f\u52a8\u65f6\u82e5\u914d\u7f6e\u4e86 maxEmails &gt; 0&#xff0c;orchestrator \u8fd8\u4f1a\u8c03\u7528 pruneMailDir \u9884\u5148\u6e05\u7406\u5386\u53f2\u4e0a\u9057\u7559\u7684\u8d85\u9650 .eml \u6587\u4ef6&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002<\/p>\n<h4>6.3 \u5217\u51fa\u5927\u578b\u6536\u4ef6\u7bb1&#xff1a;\u4f18\u5148\u4f7f\u7528 storage.list()<\/h4>\n<p>smtp.getAllEmails() \u4f1a\u628a\u6bcf\u5c01\u90ae\u4ef6&#xff08;\u5305\u62ec\u6b63\u6587&#xff09;\u5b8c\u6574\u7269\u5316\u5230\u5185\u5b58\u3002\u5217\u8868\u573a\u666f\u5e94\u6539\u7528 storage.list()\u2014\u2014\u5b83\u8fd4\u56de\u4e00\u9875\u90ae\u4ef6\u53ca\u5206\u9875\u6240\u9700\u7684\u8ba1\u6570&#xff0c;\u5de5\u4f5c\u91cf\u4e0e\u9875\u5927\u5c0f\u6210\u6b63\u6bd4&#xff0c;\u800c\u4e0d\u662f\u4e0e\u6574\u4e2a\u5b58\u50a8\u89c4\u6a21\u6210\u6b63\u6bd4&#xff1a;<\/p>\n<p>const { items, total, unread } &#061; await servers.storage.list({<br \/>\n  skip: 0,<br \/>\n  limit: 50,<br \/>\n  search: &#039;welcome&#039;,   \/\/ optional: subject, participants and body text<br \/>\n  sort: &#039;desc&#039;,        \/\/ &#039;desc&#039; (default) is newest first<br \/>\n})<\/p>\n<p>\u8981\u4e22\u5f03\u90ae\u4ef6\u6b63\u6587\u4e0e\u5934\u4fe1\u606f&#xff08;REST \/api\/email\/summary \u7aef\u70b9\u4e0e Web UI \u6b63\u662f\u8fd9\u6837\u505a\u7684&#xff09;&#xff0c;\u628a\u7ed3\u679c\u9875\u6620\u5c04\u5230 toSummary&#xff1a;<\/p>\n<p>import { toSummary } from &#039;&#064;maildev\/core&#039;<\/p>\n<p>const summaries &#061; items.map(toSummary)<\/p>\n<p>\u539f\u7406&#xff1a;EmailSummary \u662f\u523b\u610f\u8bbe\u8ba1\u4e3a&#034;\u8f7b\u91cf\u6295\u5f71&#034;\u7684\u7c7b\u578b&#xff0c;\u4e0d\u5305\u542b html\u3001text\u3001headers \u8fd9\u4e09\u4e2a\u4f53\u79ef\u5927\u6237\u2014\u2014\u6bcf\u5c01\u90ae\u4ef6\u5728\u5217\u8868\u4e2d\u53ea\u5360\u51e0\u767e\u5b57\u8282&#xff0c;\u800c\u975e\u51e0\u5341 KB&#xff0c;\u8fd9\u6b63\u662f Web UI \u5728\u5927\u6536\u4ef6\u7bb1\u4e0b\u4ecd\u4fdd\u6301\u54cd\u5e94\u6027\u7684\u5173\u952e&#xff08;\u89c1 packages\/core\/src\/types\/email.ts&#xff09;\u3002API \u670d\u52a1\u7aef\u5728 \/api\/email\/summary \u8def\u7531\u4e2d\u6b63\u662f\u8c03\u7528 storage.list() \u540e\u9010\u6761 toSummary \u8fd4\u56de&#xff08;\u89c1 packages\/api\/src\/server.ts&#xff09;\u3002<\/p>\n<h4>6.4 \u90ae\u4ef6 CRUD \u64cd\u4f5c<\/h4>\n<p>\/\/ \u83b7\u53d6\u5168\u90e8\u90ae\u4ef6<br \/>\nconst emails &#061; await smtp.getAllEmails()<br \/>\nconsole.log(&#096;Total emails: ${emails.length}&#096;)<\/p>\n<p>\/\/ \u83b7\u53d6\u5355\u5c01\u90ae\u4ef6<br \/>\nconst email &#061; await smtp.getEmail(&#039;email-id&#039;)<br \/>\nconsole.log(email.subject)<\/p>\n<p>\/\/ \u83b7\u53d6\u539f\u59cb\u90ae\u4ef6&#xff08;EML \u683c\u5f0f&#xff09;&#xff0c;\u53ef\u5199\u6d41\u843d\u76d8<br \/>\nconst stream &#061; await smtp.getRawEmail(&#039;email-id&#039;)<br \/>\nstream.pipe(fs.createWriteStream(&#039;email.eml&#039;))<\/p>\n<p>\/\/ \u5220\u9664\u5355\u5c01\u90ae\u4ef6<br \/>\nawait smtp.deleteEmail(&#039;email-id&#039;)<\/p>\n<p>\/\/ \u5220\u9664\u5168\u90e8\u90ae\u4ef6<br \/>\nawait smtp.deleteAllEmails()<\/p>\n<p>\/\/ \u5168\u90e8\u6807\u8bb0\u4e3a\u5df2\u8bfb<br \/>\nconst count &#061; await smtp.markAllRead()<br \/>\nconsole.log(&#096;Marked ${count} emails as read&#096;)<\/p>\n<p>\u5b9e\u73b0\u7ec6\u8282&#xff1a;<\/p>\n<ul>\n<li>getRawEmail \u76f4\u63a5\u4ee5\u6d41\u5f62\u5f0f\u8fd4\u56de mailDir\/&lt;id&gt;.eml \u6587\u4ef6&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;&#xff1b;<\/li>\n<li>deleteEmail \u4f1a\u5148\u5220\u9664\u78c1\u76d8\u6587\u4ef6\u518d\u5220\u9664\u5b58\u50a8\u8bb0\u5f55&#xff0c;\u6210\u529f\u65f6\u53d1\u51fa &#039;delete&#039; \u4e8b\u4ef6&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;&#xff1b;<\/li>\n<li>deleteAllEmails \u4f1a\u6e05\u7a7a\u6574\u4e2a\u90ae\u4ef6\u76ee\u5f55&#xff08;\u542b\u9644\u4ef6&#xff09;&#xff0c;\u5e76\u53d1\u51fa { id: &#039;all&#039; } \u7684 &#039;delete&#039; \u4e8b\u4ef6&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;&#xff1b;<\/li>\n<li>markAllRead \u8fd4\u56de\u88ab\u6807\u8bb0\u7684\u90ae\u4ef6\u6570\u91cf&#xff0c;\u5e95\u5c42\u8c03\u7528\u5b58\u50a8\u7684 markAllRead()\u3002<\/li>\n<\/ul>\n<h4>6.5 \u9644\u4ef6\u64cd\u4f5c<\/h4>\n<p>const email &#061; await smtp.getEmail(&#039;email-id&#039;)<\/p>\n<p>for (const attachment of email.attachments) {<br \/>\n  console.log(&#096;Attachment: ${attachment.filename}&#096;)<br \/>\n  console.log(&#096;Type: ${attachment.contentType}&#096;)<br \/>\n  console.log(&#096;Size: ${attachment.size} bytes&#096;)<br \/>\n}<\/p>\n<p>\/\/ \u83b7\u53d6\u9644\u4ef6\u5185\u5bb9<br \/>\nconst { contentType, stream } &#061; await smtp.getEmailAttachment(&#039;email-id&#039;, &#039;filename.pdf&#039;)<br \/>\nstream.pipe(fs.createWriteStream(&#039;filename.pdf&#039;))<\/p>\n<p>\u5b9e\u73b0\u7ec6\u8282&#xff1a;\u9644\u4ef6\u4ee5&#034;\u751f\u6210\u6587\u4ef6\u540d&#034;&#xff08;generatedFileName&#xff0c;\u57fa\u4e8e MD5 \u54c8\u5e0c&#xff0c;\u89c1 packages\/core\/src\/types\/email.ts&#xff09;\u4fdd\u5b58\u4e3a mailDir\/&lt;id&gt;\/ \u76ee\u5f55\u4e0b\u7684\u6587\u4ef6&#xff0c;getEmailAttachment \u6309 generatedFileName \u5339\u914d\u5e76\u8fd4\u56de\u53ef\u8bfb\u6d41&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;\u3002\u91c7\u7528\u54c8\u5e0c\u6587\u4ef6\u540d\u800c\u975e\u539f\u59cb\u6587\u4ef6\u540d&#xff0c;\u662f\u4e3a\u4e86\u907f\u514d\u8def\u5f84\u7a7f\u8d8a\u7b49\u5b89\u5168\u95ee\u9898\u3002<\/p>\n<h3>\u4e03\u3001\u90ae\u4ef6\u5bf9\u8c61\u7ed3\u6784<\/h3>\n<p>Email \u5bf9\u8c61\u662f MailDev \u7684\u6838\u5fc3\u6570\u636e\u7ed3\u6784&#xff08;\u89c1 packages\/core\/src\/types\/email.ts&#xff09;&#xff0c;\u5b9a\u4e49\u5982\u4e0b&#xff1a;<\/p>\n<p>interface Email {<br \/>\n  id: string<br \/>\n  time: Date<br \/>\n  read: boolean<br \/>\n  subject: string<br \/>\n  source: string<br \/>\n  size: number<br \/>\n  sizeHuman: string<br \/>\n  from: Address[]<br \/>\n  to: Address[]<br \/>\n  cc?: Address[]<br \/>\n  bcc?: Address[]<br \/>\n  calculatedBcc?: Address[]<br \/>\n  date?: Date<br \/>\n  html?: string<br \/>\n  text?: string<br \/>\n  headers: Record&lt;string, string | string[]&gt;<br \/>\n  inReplyTo?: string<br \/>\n  priority?: &#039;high&#039; | &#039;normal&#039; | &#039;low&#039;<br \/>\n  attachments: Attachment[]<br \/>\n  envelope: Envelope<br \/>\n  relayedAt?: Date      \/\/ when the email was last successfully relayed<br \/>\n  relayedTo?: string[]  \/\/ recipients delivered to on the last successful relay<br \/>\n}<\/p>\n<p>interface Address {<br \/>\n  address: string<br \/>\n  name?: string<br \/>\n}<\/p>\n<p>interface Envelope {<br \/>\n  from: EnvelopeAddress<br \/>\n  to: EnvelopeAddress[]<br \/>\n  host?: string<br \/>\n  remoteAddress?: string<br \/>\n}<\/p>\n<p>interface EnvelopeAddress extends Address {<br \/>\n  args?: boolean | Record&lt;string, unknown&gt;<br \/>\n}<\/p>\n<p>interface Attachment {<br \/>\n  filename: string<br \/>\n  generatedFileName: string<br \/>\n  contentType: string<br \/>\n  contentDisposition: &#039;inline&#039; | &#039;attachment&#039;<br \/>\n  contentId?: string<br \/>\n  size?: number<br \/>\n  transferred?: boolean<br \/>\n}<\/p>\n<p>\u5b57\u6bb5\u8bf4\u660e&#xff1a;<\/p>\n<ul>\n<li>id&#xff1a;8 \u4f4d\u5b57\u6bcd\u6570\u5b57\u552f\u4e00\u6807\u8bc6&#xff0c;\u7531 makeId() \u751f\u6210&#xff0c;\u540c\u65f6\u4e5f\u662f\u78c1\u76d8 .eml \u6587\u4ef6\u540d&#xff1b;<\/li>\n<li>source&#xff1a;.eml \u6587\u4ef6\u5728\u78c1\u76d8\u4e0a\u7684\u7edd\u5bf9\u8def\u5f84&#xff1b;<\/li>\n<li>calculatedBcc&#xff1a;\u7531 SMTP \u4fe1\u5c01\u6536\u4ef6\u4eba\u51cf\u53bb\u5934\u90e8 To\/Cc \u63a8\u5bfc\u51fa\u7684\u5bc6\u9001\u6536\u4ef6\u4eba&#xff08;\u7531 calculateBcc \u8ba1\u7b97&#xff0c;\u89c1 packages\/core\/src\/helpers\/bcc.ts&#xff09;&#xff1b;<\/li>\n<li>relayedAt \/ relayedTo&#xff1a;\u8bb0\u5f55\u6700\u8fd1\u4e00\u6b21\u6210\u529f\u4e2d\u7ee7\u7684\u65f6\u95f4\u4e0e\u6536\u4ef6\u4eba&#xff0c;\u4ec5\u5728\u542f\u7528\u51fa\u7ad9\u4e2d\u7ee7\u65f6\u5b58\u5728&#xff1b;<\/li>\n<li>attachments&#xff1a;\u4ec5\u5143\u6570\u636e&#xff08;\u6587\u4ef6\u540d\u3001MIME \u7c7b\u578b\u3001CID \u7b49&#xff09;&#xff0c;\u9644\u4ef6\u4e8c\u8fdb\u5236\u5185\u5bb9\u901a\u8fc7 getEmailAttachment() \u4ee5\u6d41\u83b7\u53d6\u3002<\/li>\n<\/ul>\n<h3>\u516b\u3001\u4e2d\u7ee7&#xff08;\u8f6c\u53d1&#xff09;\u90ae\u4ef6<\/h3>\n<p>MailDev \u53ef\u4ee5\u628a\u6536\u5230\u7684\u90ae\u4ef6\u8f6c\u53d1\u5230\u771f\u5b9e SMTP \u670d\u52a1\u5668\u3002<\/p>\n<h4>8.1 \u624b\u52a8\u4e2d\u7ee7<\/h4>\n<p>const maildev &#061; new MailDev({<br \/>\n  outgoingHost: &#039;smtp.gmail.com&#039;,<br \/>\n  outgoingPort: 587,<br \/>\n  outgoingUser: &#039;you&#064;gmail.com&#039;,<br \/>\n  outgoingPass: &#039;app-password&#039;,<br \/>\n  outgoingSecure: true,<br \/>\n})<\/p>\n<p>const { smtp } &#061; await maildev.start()<\/p>\n<p>\/\/ \u624b\u52a8\u4e2d\u7ee7\u6307\u5b9a\u90ae\u4ef6<br \/>\nsmtp.on(&#039;new&#039;, async (email) &#061;&gt; {<br \/>\n  if (email.to.some(t &#061;&gt; t.address &#061;&#061;&#061; &#039;important&#064;example.com&#039;)) {<br \/>\n    await smtp.relayEmail(email.id)<br \/>\n    console.log(&#039;Email relayed!&#039;)<br \/>\n  }<br \/>\n})<\/p>\n<p>\u6210\u529f\u4e2d\u7ee7&#xff08;\u624b\u52a8\u6216\u81ea\u52a8&#xff09;\u540e&#xff0c;\u90ae\u4ef6\u8bb0\u5f55 relayedAt \u4e0e relayedTo&#xff0c;\u53ef\u7528\u4e8e\u5224\u65ad\u6d88\u606f\u662f\u5426\u4ee5\u53ca\u5728\u54ea\u91cc\u88ab\u6295\u9012&#xff1a;<\/p>\n<p>const email &#061; await smtp.getEmail(&#039;email-id&#039;)<br \/>\nif (email.relayedAt) {<br \/>\n  console.log(&#096;Relayed at ${email.relayedAt} to ${email.relayedTo?.join(&#039;, &#039;)}&#096;)<br \/>\n}<\/p>\n<p>\u6301\u4e45\u5316\u5dee\u5f02&#xff1a;\u4f7f\u7528 FileStorage \u65f6\u8be5\u72b6\u6001\u4f1a\u6301\u4e45\u5316\u5230\u78c1\u76d8\u5e76\u5728\u4e0b\u6b21\u542f\u52a8\u65f6\u6062\u590d&#xff1b;\u5185\u5b58\u5b58\u50a8\u4e0b\u5b83\u53ea\u5728\u8fdb\u7a0b\u751f\u547d\u5468\u671f\u5185\u6709\u6548\u3002\u4e2d\u7ee7\u6210\u529f\u540e relayEmail() \u4f1a\u628a relayedAt \u4e0e relayedTo \u5199\u56de\u5b58\u50a8&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;\u3002<\/p>\n<h4>8.2 \u81ea\u52a8\u4e2d\u7ee7<\/h4>\n<p>const maildev &#061; new MailDev({<br \/>\n  outgoingHost: &#039;smtp.example.com&#039;,<br \/>\n  outgoingPort: 587,<br \/>\n  outgoingUser: &#039;user&#039;,<br \/>\n  outgoingPass: &#039;pass&#039;,<br \/>\n  autoRelay: true,  \/\/ \u81ea\u52a8\u4e2d\u7ee7\u6240\u6709\u90ae\u4ef6<br \/>\n})<\/p>\n<h4>8.3 \u81ea\u52a8\u4e2d\u7ee7\u5230\u6307\u5b9a\u5730\u5740<\/h4>\n<p>const maildev &#061; new MailDev({<br \/>\n  outgoingHost: &#039;smtp.example.com&#039;,<br \/>\n  outgoingPort: 587,<br \/>\n  outgoingUser: &#039;user&#039;,<br \/>\n  outgoingPass: &#039;pass&#039;,<br \/>\n  autoRelay: &#039;catch-all&#064;example.com&#039;,  \/\/ \u8986\u76d6\u6536\u4ef6\u4eba<br \/>\n})<\/p>\n<p>autoRelay \u4f20\u5165\u5b57\u7b26\u4e32\u65f6&#xff0c;orchestrator \u4f1a\u628a\u5b83\u4f5c\u4e3a defaultRecipient \u6ce8\u5165\u4e2d\u7ee7\u914d\u7f6e\u2014\u2014\u5373\u6240\u6709\u90ae\u4ef6\u6539\u5199\u4e3a\u53d1\u7ed9\u8be5\u56fa\u5b9a\u5730\u5740&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002<\/p>\n<h3>\u4e5d\u3001\u4e8b\u4ef6\u7cfb\u7edf<\/h3>\n<p>SMTP \u670d\u52a1\u5668\u5bf9\u5916\u53d1\u51fa\u4ee5\u4e0b\u4e8b\u4ef6&#xff08;\u4e8b\u4ef6\u7c7b\u578b\u5b9a\u4e49\u89c1 packages\/smtp\/src\/types.ts&#xff09;&#xff1a;<\/p>\n<h4>&#039;new&#039; \u2014 \u6536\u5230\u65b0\u90ae\u4ef6<\/h4>\n<p>smtp.on(&#039;new&#039;, (email: Email) &#061;&gt; {<br \/>\n  console.log(&#039;New email:&#039;, email.subject)<br \/>\n})<\/p>\n<h4>&#039;delete&#039; \u2014 \u90ae\u4ef6\u88ab\u5220\u9664<\/h4>\n<p>smtp.on(&#039;delete&#039;, (data: { id: string }) &#061;&gt; {<br \/>\n  console.log(&#039;Deleted email:&#039;, data.id)<br \/>\n})<\/p>\n<h4>&#039;error&#039; \u2014 \u670d\u52a1\u5668\u9519\u8bef<\/h4>\n<p>smtp.on(&#039;error&#039;, (error: Error) &#061;&gt; {<br \/>\n  console.error(&#039;SMTP error:&#039;, error.message)<br \/>\n})<\/p>\n<h4>&#039;close&#039; \u2014 \u670d\u52a1\u5668\u5173\u95ed<\/h4>\n<p>smtp.on(&#039;close&#039;, () &#061;&gt; {<br \/>\n  console.log(&#039;SMTP server closed&#039;)<br \/>\n})<\/p>\n<p>\u5b9e\u73b0\u7ec6\u8282&#xff1a;&#039;new&#039; \u4e8b\u4ef6\u5728\u90ae\u4ef6\u6210\u529f\u4fdd\u5b58\u5230\u5b58\u50a8\u540e\u53d1\u51fa&#xff1b;&#039;delete&#039; \u5728\u5220\u9664\u6210\u529f\u540e\u53d1\u51fa&#xff1b;&#039;close&#039; \u7531 stop() \u89e6\u53d1&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;\u3002WebSocket \u5c42\u6b63\u662f\u901a\u8fc7\u8ba2\u9605\u8fd9\u4e24\u4e2a\u4e8b\u4ef6\u628a\u66f4\u65b0\u5b9e\u65f6\u63a8\u9001\u7ed9 Web UI \u7684\u6240\u6709\u6807\u7b7e\u9875&#xff08;\u89c1 packages\/api\/src\/server.ts&#xff09;\u3002<\/p>\n<h3>\u5341\u3001\u9ad8\u7ea7\u7528\u6cd5<\/h3>\n<h4>10.1 \u76f4\u63a5\u4f7f\u7528\u72ec\u7acb\u5b50\u5305<\/h4>\n<p>\u8ffd\u6c42\u66f4\u7cbe\u7ec6\u63a7\u5236\u65f6&#xff0c;\u53ef\u4ee5\u7ed5\u8fc7 MailDev \u95e8\u9762\u7c7b&#xff0c;\u76f4\u63a5\u7ec4\u5408\u5e95\u5c42\u5305&#xff1a;<\/p>\n<p>import { MemoryStorage } from &#039;&#064;maildev\/core&#039;<br \/>\nimport { createSMTPServer } from &#039;&#064;maildev\/smtp&#039;<br \/>\nimport { createAPIServer } from &#039;&#064;maildev\/api&#039;<\/p>\n<p>\/\/ \u521b\u5efa\u5b58\u50a8<br \/>\nconst storage &#061; new MemoryStorage()<br \/>\nawait storage.initialize()<\/p>\n<p>\/\/ \u521b\u5efa SMTP \u670d\u52a1\u5668<br \/>\nconst smtp &#061; createSMTPServer({<br \/>\n  port: 1025,<br \/>\n  host: &#039;::&#039;,<br \/>\n  storage,<br \/>\n  mailDir: &#039;\/tmp\/maildev&#039;,<br \/>\n})<\/p>\n<p>await smtp.start()<\/p>\n<p>\/\/ \u521b\u5efa API \u670d\u52a1\u5668<br \/>\nconst api &#061; createAPIServer({<br \/>\n  port: 1080,<br \/>\n  storage,<br \/>\n  smtp,<br \/>\n  mcp: { enabled: true },<br \/>\n})<\/p>\n<p>await api.start()<\/p>\n<p>\u8bf4\u660e&#xff1a;\u5b50\u5305\u8fb9\u754c\u6e05\u6670\u2014\u2014&#064;maildev\/core \u63d0\u4f9b\u5b58\u50a8\u4e0e\u7c7b\u578b&#xff08;Storage\u3001Email \u7b49&#xff09;&#xff0c;&#064;maildev\/smtp \u63d0\u4f9b createSMTPServer \u4e0e\u4e2d\u7ee7\u80fd\u529b&#xff0c;&#064;maildev\/api \u63d0\u4f9b\u57fa\u4e8e Fastify \u7684 REST API\u3001WebSocket \u4e0e MCP \u7aef\u70b9\u3002APIServer \u8fd8\u66b4\u9732 registerPlugins() \u65b9\u6cd5&#xff0c;\u53ef\u5148\u6ce8\u518c\u63d2\u4ef6\u4e0e\u8def\u7531\u3001\u518d listen()&#xff0c;\u4fbf\u4e8e\u5728\u6ce8\u518c UI \u524d\u540e\u63d2\u5165\u81ea\u5b9a\u4e49\u903b\u8f91&#xff08;\u89c1 packages\/api\/src\/server.ts&#xff09;\u3002<\/p>\n<h4>10.2 \u4f7f\u7528 FileStorage \u6301\u4e45\u5316<\/h4>\n<p>import { FileStorage } from &#039;&#064;maildev\/core&#039;<\/p>\n<p>const storage &#061; new FileStorage({<br \/>\n  mailDirectory: &#039;\/var\/mail\/maildev&#039;,<br \/>\n  maxEmails: 1000, \/\/ optional: cap the store (0\/omitted &#061; unlimited)<br \/>\n})<br \/>\nawait storage.initialize()<\/p>\n<p>\u5f53 maxEmails \u88ab\u8d85\u51fa\u65f6&#xff0c;\u6700\u65e7\u7684\u90ae\u4ef6\u88ab\u4e22\u5f03\u4e14\u5176\u6587\u4ef6\u88ab\u5220\u9664\u3002\u82e5\u8981\u6e05\u7406\u4f60\u81ea\u5df1\u5728\u90ae\u4ef6\u65c1\u8fb9\u5199\u5165\u7684\u5176\u4ed6\u6570\u636e&#xff0c;\u53ef\u6ce8\u518c evict \u56de\u8c03\u2014\u2014save() \u4f1a\u7b49\u5f85\u5b83\u5b8c\u6210&#xff0c;\u56e0\u6b64\u56de\u8c03 resolve \u540e\u90ae\u4ef6\u624d\u7b97\u5b8c\u5168\u6d88\u5931&#xff1a;<\/p>\n<p>storage.onEvicted(async (email) &#061;&gt; {<br \/>\n  await removeMyIndexEntry(email.id)<br \/>\n})<\/p>\n<p>\u5b9e\u73b0\u7ec6\u8282&#xff1a;SMTP \u670d\u52a1\u5668\u6b63\u662f\u901a\u8fc7 onEvicted \u6302\u94a9\u6765\u5220\u9664\u78c1\u76d8 .eml \u4e0e\u9644\u4ef6\u76ee\u5f55\u7684&#xff08;\u89c1 packages\/smtp\/src\/server.ts&#xff09;&#xff0c;\u8fd9\u4e00\u673a\u5236\u540c\u6837\u53ef\u4ee5\u670d\u52a1\u4e8e\u4f60\u7684\u81ea\u5b9a\u4e49\u6e05\u7406\u903b\u8f91\u3002<\/p>\n<h4>10.3 \u81ea\u5b9a\u4e49\u65e5\u5fd7\u5668<\/h4>\n<p>import { MailDev, createLogger } from &#039;maildev&#039;<\/p>\n<p>const logger &#061; createLogger({<br \/>\n  verbose: true,<br \/>\n  silent: false,<br \/>\n})<\/p>\n<p>\/\/ The MailDev class uses the logger internally<br \/>\nconst maildev &#061; new MailDev({<br \/>\n  verbose: true,<br \/>\n})<\/p>\n<p>MailDev \u6784\u9020\u65f6\u6839\u636e verbose\/silent \u521b\u5efa\u5185\u90e8 Logger&#xff08;\u89c1 packages\/cli\/src\/index.ts&#xff09;&#xff0c;\u65e5\u5fd7\u5668\u63d0\u4f9b log \/ info \/ warn \/ error \/ debug \u7b49\u7ea7\u522b&#xff08;\u89c1 packages\/cli\/src\/utils\/logger.ts&#xff09;\u3002<\/p>\n<h4>10.4 \u4e2d\u95f4\u4ef6\u96c6\u6210&#xff08;\u4ee3\u7406 \/ \u5b50\u8def\u5f84\u6302\u8f7d&#xff09;<\/h4>\n<p>MailDev \u53ef\u4ee5\u6302\u5728\u53cd\u5411\u4ee3\u7406\u4e4b\u540e&#xff0c;\u6216\u901a\u8fc7 basePathname \u8fd0\u884c\u5728\u73b0\u6709 Express\/Fastify \u5e94\u7528\u7684\u5b50\u8def\u5f84\u4e0b&#xff1a;<\/p>\n<p>const maildev &#061; new MailDev({<br \/>\n  basePathname: &#039;\/maildev&#039;,<br \/>\n  web: 3001,<br \/>\n})<\/p>\n<p>await maildev.start()<br \/>\n\/\/ MailDev UI now available at http:\/\/localhost:3001\/maildev<\/p>\n<p>\u7136\u540e\u628a\u8bf7\u6c42\u4ee3\u7406\u5230 MailDev&#xff1a;<\/p>\n<p>import express from &#039;express&#039;<br \/>\nimport { createProxyMiddleware } from &#039;http-proxy-middleware&#039;<\/p>\n<p>const app &#061; express()<\/p>\n<p>app.use(&#039;\/maildev&#039;, createProxyMiddleware({<br \/>\n  target: &#039;http:\/\/localhost:3001&#039;,<br \/>\n  ws: true,<br \/>\n}))<\/p>\n<p>app.listen(3000)<br \/>\n\/\/ MailDev accessible at http:\/\/localhost:3000\/maildev<\/p>\n<p>\u5b9e\u73b0\u7ec6\u8282&#xff1a;orchestrator \u4f1a\u5f52\u4e00\u5316 basePathname\u2014\u2014\u6839\u8def\u5f84 \/ \u88ab\u89c4\u8303\u4e3a\u7a7a\u5b57\u7b26\u4e32\u3001\u5c3e\u90e8\u659c\u6760\u88ab\u53bb\u9664&#xff0c;\u518d\u4f20\u7ed9 API \u670d\u52a1\u5668&#xff08;\u89c1 packages\/cli\/src\/server\/orchestrator.ts&#xff09;\u3002\u6240\u6709 REST \u8def\u7531\u3001Socket.io \u8def\u5f84&#xff08;&lt;basePath&gt;\/socket.io&#xff09;\u4e0e MCP \u7aef\u70b9&#xff08;&lt;basePath&gt;\/mcp&#xff09;\u90fd\u4f1a\u81ea\u52a8\u52a0\u4e0a\u8be5\u524d\u7f00&#xff08;\u89c1 packages\/api\/src\/server.ts&#xff09;\u3002ws: true \u786e\u4fdd WebSocket \u4e5f\u80fd\u7a7f\u900f\u4ee3\u7406&#xff0c;\u8ba9\u591a\u6807\u7b7e\u9875\u5b9e\u65f6\u5237\u65b0\u6b63\u5e38\u5de5\u4f5c\u3002<\/p>\n<h3>\u5341\u4e00\u3001TypeScript \u652f\u6301<\/h3>\n<p>MailDev v3 \u5b8c\u5168\u7528 TypeScript \u7f16\u5199&#xff0c;\u5bfc\u51fa\u5168\u90e8\u7c7b\u578b&#xff1a;<\/p>\n<p>import type {<br \/>\n  MailDevConfig,<br \/>\n  Email,<br \/>\n  EmailSummary,<br \/>\n  Address,<br \/>\n  Attachment,<br \/>\n  Storage,<br \/>\n  ListOptions,<br \/>\n  ListResult,<br \/>\n} from &#039;maildev&#039;<\/p>\n<p>import type {<br \/>\n  SMTPServer,<br \/>\n  SMTPServerOptions,<br \/>\n  RelayConfig,<br \/>\n} from &#039;&#064;maildev\/smtp&#039;<\/p>\n<p>import type {<br \/>\n  APIServer,<br \/>\n  APIServerOptions,<br \/>\n} from &#039;&#064;maildev\/api&#039;<\/p>\n<p>\u6b64\u5916 &#064;maildev\/api \u8fd8\u5bfc\u51fa\u4e86 AuthConfig\u3001CorsConfig\u3001EmailQuery\u3001ConfigResponse\u3001SummaryResponse\u3001DeleteResponse\u3001ErrorResponse \u7b49 API \u76f8\u5173\u7c7b\u578b&#xff0c;\u5e76\u91cd\u5bfc\u51fa\u6838\u5fc3\u7c7b\u578b&#xff08;\u89c1 packages\/api\/src\/index.ts \u4e0e packages\/api\/src\/types.ts&#xff09;\u3002\u4f8b\u5982 SummaryQuery \u660e\u786e\u4e86 \/api\/email\/summary \u7aef\u70b9\u63a5\u53d7\u7684 skip\u3001limit\u3001search\u3001sort\u3001unread \u53c2\u6570&#xff08;\u89c1 packages\/api\/src\/types.ts&#xff09;\u3002<\/p>\n<h3>\u5341\u4e8c\u3001\u4ece v2 \u8fc1\u79fb\u5230 v3<\/h3>\n<h4>\u5173\u952e\u53d8\u5316<\/h4>\n<li>Promise \u5316 API&#xff1a;\u6240\u6709\u65b9\u6cd5\u6539\u4e3a async\/await&#xff1b;<\/li>\n<li>\u65e0\u56de\u8c03&#xff1a;\u7528 Promise \u66ff\u4ee3\u6240\u6709\u56de\u8c03\u6a21\u5f0f&#xff1b;<\/li>\n<li>\u5305\u7ed3\u6784\u8c03\u6574&#xff1a;\u6838\u5fc3\u529f\u80fd\u62c6\u5206\u4e3a &#064;maildev\/core\u3001&#064;maildev\/smtp\u3001&#064;maildev\/api&#xff08;\u4ee5\u53ca UI \u76f8\u5173\u7684 &#064;maildev\/ui\/server&#xff09;&#xff1b;<\/li>\n<li>TypeScript&#xff1a;\u5185\u7f6e\u5b8c\u6574\u7c7b\u578b\u5b9a\u4e49&#xff1b;<\/li>\n<li>\u4e8b\u4ef6\u4e0d\u53d8&#xff1a;\u4e8b\u4ef6\u540d\u4e0e\u8f7d\u8377\u4fdd\u6301\u5411\u540e\u517c\u5bb9\u3002<\/li>\n<h4>\u8fc1\u79fb\u793a\u4f8b<\/h4>\n<p>v2&#xff08;\u56de\u8c03\u98ce\u683c&#xff09;&#xff1a;<\/p>\n<p>const MailDev &#061; require(&#039;maildev&#039;)<\/p>\n<p>const maildev &#061; new MailDev()<\/p>\n<p>maildev.listen(function(err) {<br \/>\n  if (err) throw err<br \/>\n  console.log(&#039;MailDev running&#039;)<br \/>\n})<\/p>\n<p>maildev.on(&#039;new&#039;, function(email) {<br \/>\n  console.log(&#039;New email:&#039;, email.subject)<br \/>\n})<\/p>\n<p>maildev.getAllEmail(function(err, emails) {<br \/>\n  console.log(&#039;Total:&#039;, emails.length)<br \/>\n})<\/p>\n<p>v3&#xff08;async\/await \u98ce\u683c&#xff09;&#xff1a;<\/p>\n<p>import { MailDev } from &#039;maildev&#039;<\/p>\n<p>const maildev &#061; new MailDev()<\/p>\n<p>const { smtp } &#061; await maildev.start()<br \/>\nconsole.log(&#039;MailDev running&#039;)<\/p>\n<p>smtp.on(&#039;new&#039;, (email) &#061;&gt; {<br \/>\n  console.log(&#039;New email:&#039;, email.subject)<br \/>\n})<\/p>\n<p>const emails &#061; await smtp.getAllEmails()<br \/>\nconsole.log(&#039;Total:&#039;, emails.length)<\/p>\n<p>\u6ce8\u610f v3 \u4e2d\u6536\u4ef6\u63a5\u53e3\u4ece maildev.getAllEmail(cb) \u53d8\u4e3a smtp.getAllEmails()&#xff0c;\u4e8b\u4ef6\u76d1\u542c\u5bf9\u8c61\u4ece maildev \u53d8\u66f4\u4e3a start() \u8fd4\u56de\u7684 smtp \u5b9e\u4f8b\u2014\u2014\u8fd9\u6b63\u662f v3 \u628a&#034;\u670d\u52a1\u5668&#034;\u4e0e&#034;\u95e8\u9762&#034;\u89e3\u8026\u7684\u76f4\u63a5\u4f53\u73b0\u3002<\/p>\n<h3>\u603b\u7ed3<\/h3>\n<p>MailDev v3 \u7684\u7a0b\u5e8f\u5316 API \u628a&#034;\u672c\u5730 SMTP \u6536\u4ef6 &#043; Web \u67e5\u770b &#043; REST\/WebSocket &#043; MCP&#034;\u6574\u5408\u4e3a\u4e00\u4e2a\u53ef\u7f16\u7a0b\u7684 TypeScript \u7ec4\u4ef6\u3002\u672c\u6587\u8986\u76d6\u4e86\u4ece MailDev \u95e8\u9762\u7c7b\u7684\u5168\u90e8\u914d\u7f6e\u9879\u3001\u751f\u547d\u5468\u671f\u65b9\u6cd5&#xff0c;\u5230\u4e34\u65f6\u7aef\u53e3\u3001\u5206\u9875\u67e5\u8be2\u3001\u9644\u4ef6\u6d41\u5f0f\u8bfb\u53d6\u3001\u90ae\u4ef6\u4e2d\u7ee7\u3001\u4e8b\u4ef6\u9a71\u52a8\u3001\u5b50\u5305\u7ea7\u7ec4\u5408\u4e0e v2 \u8fc1\u79fb\u7684\u5b8c\u6574\u94fe\u8def\u3002\u5982\u679c\u4f60\u6b63\u5728\u642d\u5efa\u81ea\u52a8\u5316\u90ae\u4ef6\u6d4b\u8bd5\u3001\u5f00\u53d1\u8c03\u8bd5\u5de5\u5177\u6216\u9700\u8981\u628a\u90ae\u4ef6\u6536\u4ef6\u80fd\u529b\u5d4c\u5165 Node.js \u670d\u52a1&#xff0c;\u8fd9\u4e9b API \u5373\u5f00\u5373\u7528\u3002<\/p>\n<p>\u5982\u9700\u67e5\u770b\u66f4\u591a\u7ec6\u8282&#xff0c;\u53ef\u7ee7\u7eed\u9605\u8bfb\u4ed3\u5e93\u5185\u7684 docs\/rest.md&#xff08;REST \u7aef\u70b9&#xff09;\u3001docs\/mcp.md&#xff08;MCP \u96c6\u6210&#xff09;\u4e0e docs\/https.md&#xff08;HTTPS \u914d\u7f6e&#xff09;&#xff0c;\u4ee5\u53ca\u5404\u5b50\u5305\u7684 README&#xff08;packages\/core\/README.md\u3001packages\/smtp\/README.md\u3001packages\/api\/README.md&#xff09;\u3002<\/p>\n<p>  <img loading=\"lazy\" decoding=\"async\" class=\"gcb-icon-like\" src=\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/10\/20261021162450-6ad8e75245775.svg\" alt=\"\" width=\"16\" height=\"16\" \/> <span class=\"gcb-like-text\">\u8d5e<\/span>  <\/p>\n<p>   <span class=\"gcb-share-text\">\u5206\u4eab<\/span>  <\/p>\n<ul class=\"gcb-tag-list\">\n<li><span class=\"gcb-tag\">\u540e\u7aef<\/span><\/li>\n<li><span class=\"gcb-tag\">\u5f00\u53d1\u5de5\u5177<\/span><\/li>\n<li><span class=\"gcb-tag\">\u6d4b\u8bd5<\/span><\/li>\n<\/ul>\n<h3 class=\"gcb-project-title\">\u3010\u514d\u8d39\u4e0b\u8f7d\u94fe\u63a5\u3011maildev<\/h3>\n<p class=\"gcb-project-desc\">:mailbox: SMTP Server &#043; Web Interface for viewing and testing emails during development.<\/p>\n<p>    <span class=\"gcb-project-addr-label\">\u9879\u76ee\u5730\u5740&#xff1a;<\/span><br \/>\n    <span class=\"gcb-project-addr-link\">https:\/\/gitcode.com\/gh_mirrors\/ma\/maildev<\/span> <\/p>\n<p>  <span class=\"gcb-project-btn\"> <span class=\"gcb-project-btn-main\">\u70b9\u51fb\u67e5\u770b<\/span> <span class=\"gcb-project-btn-sub\">\u514d\u8d39\u4e0b\u8f7d<\/span> <\/span> <\/p>\n<h4 class=\"gcb-related-title\">\u76f8\u5173\u63a8\u8350<\/h4>\n<ul class=\"gcb-related-list\">\n<li class=\"gcb-related-item\">\n<h5 class=\"gcb-related-item-title\"> MailDev\u5165\u95e8\u6559\u7a0b&#xff1a;\u5982\u4f55\u5728\u672c\u5730\u642d\u5efaSMTP\u670d\u52a1\u5668<\/h5>\n<p class=\"gcb-related-item-desc\">MailDev\u5165\u95e8\u6559\u7a0b&#xff1a;\u5982\u4f55\u5728\u672c\u5730\u642d\u5efaSMTP\u670d\u52a1\u5668 \u60f3\u8981\u5728\u5f00\u53d1\u8fc7\u7a0b\u4e2d\u8f7b\u677e\u6d4b\u8bd5\u90ae\u4ef6\u529f\u80fd&#xff0c;\u5374\u4e0d\u60f3\u914d\u7f6e\u590d\u6742\u7684\u90ae\u4ef6\u670d\u52a1\u5668&#xff1f;MailDev\u6b63\u662f\u60a8\u9700\u8981\u7684\u7ec8\u6781\u89e3\u51b3\u65b9\u6848&#xff01;&#x1f680;<\/p>\n<p>     <span class=\"gcb-tag\">\u540e\u7aef<\/span><br \/>\n     <span class=\"gcb-tag\">\u5f00\u53d1\u5de5\u5177<\/span><br \/>\n     <span class=\"gcb-tag\">\u6d4b\u8bd5<\/span>\n      <\/li>\n<li class=\"gcb-related-item\">\n<h5 class=\"gcb-related-item-title\">\u89e3\u51b3viral-clips-crew\u5e38\u89c1\u95ee\u9898&#xff1a;TypeError\u4e0eAPI\u5bc6\u94a5\u9519\u8bef\u7ec8\u6781\u65b9\u6848<\/h5>\n<p class=\"gcb-related-item-desc\">\u89e3\u51b3viral clips crew\u5e38\u89c1\u95ee\u9898&#xff1a;TypeError\u4e0eAPI\u5bc6\u94a5\u9519\u8bef\u7ec8\u6781\u65b9\u6848 viral clips crew\u662f\u4e00\u6b3e\u57fa\u4e8eCrewAI\u7684\u89c6\u9891\u7f16\u8f91\u52a9\u624b&#xff0c;<\/p>\n<p>     <span class=\"gcb-tag\">\u4eba\u5de5\u667a\u80fd<\/span><br \/>\n     <span class=\"gcb-tag\">AI \u5e94\u7528<\/span><br \/>\n     <span class=\"gcb-tag\">\u97f3\u89c6\u9891<\/span>\n      <\/li>\n<li class=\"gcb-related-item\">\n<h5 class=\"gcb-related-item-title\"> STM32Cube\u5d4c\u5165\u5f0fWeb\u670d\u52a1\u5668\u5feb\u901f\u90e8\u7f72\u5b9e\u6218\u6307\u5357<\/h5>\n<p class=\"gcb-related-item-desc\">\u8fd8\u5728\u4e3a\u5d4c\u5165\u5f0f\u8bbe\u5907\u7684\u8fdc\u7a0b\u7ba1\u7406\u53d1\u6101\u5417&#xff1f;\u6bcf\u6b21\u8c03\u8bd5\u90fd\u8981\u8fde\u63a5\u4e32\u53e3&#xff0c;\u67e5\u770b\u65e5\u5fd7\u8fd8\u8981\u63a5\u663e\u793a\u5668&#xff1f;\u4eca\u5929&#xff0c;\u6211\u5c06\u4e3a\u4f60\u5c55\u793a\u5982\u4f55\u7528STM32Cube\u548cMongoose\u572810\u5206\u949f\u5185\u6784\u5efa\u4e00\u4e2a\u529f<\/p>\n<p>     <span class=\"gcb-tag\">\u5d4c\u5165\u5f0f<\/span><br \/>\n     <span class=\"gcb-tag\">\u7f51\u7edc<\/span><br \/>\n     <span class=\"gcb-tag\">\u901a\u4fe1<\/span><br \/>\n     <span class=\"gcb-tag\">\u7269\u8054\u7f51<\/span>\n      <\/li>\n<\/ul>\n<p>  <span class=\"gcb-prev-next-label\">\u4e0a\u4e00\u7bc7&#xff1a;<\/span><br \/>\n   \u514d\u8d39\u97f3\u9891\u8f6c\u6362\u795e\u5668fre:ac\u5b8c\u6574\u4f7f\u7528\u6307\u5357&#xff1a;\u4ece\u5165\u95e8\u5230\u7cbe\u901a <\/p>\n<p>  <span class=\"gcb-prev-next-label\">\u4e0b\u4e00\u7bc7&#xff1a;<\/span><br \/>\n   OPC-UA\u5ba2\u6237\u7aef\u5de5\u5177&#xff1a;\u5de5\u4e1a\u81ea\u52a8\u5316\u6570\u636e\u4ea4\u4e92\u7684\u7ec8\u6781\u89e3\u51b3\u65b9\u6848 <\/p>\n<p>\u521b\u4f5c\u58f0\u660e\uff1a\u672c\u6587\u90e8\u5206\u5185\u5bb9\u7531AI\u8f85\u52a9\u751f\u6210\uff08AIGC\uff09\uff0c\u4ec5\u4f9b\u53c2\u8003<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u540e\u7aef\u5f00\u53d1\u5de5\u5177\u6d4b\u8bd5 \u3010\u514d\u8d39\u4e0b\u8f7d\u94fe\u63a5\u3011maildev :mailbox: SMTP Server  Web Interface for viewing and testing emails during development. \u9879\u76ee\u5730\u5740&#xff1a; https:\/\/gitcode.com\/gh_mirrors\/ma\/maildev \u70b9\u51fb\u67e5\u770b \u514d\u8d39\u4e0b\u8f7d  \u5bfc\u8bfb<br \/>\nMailDev v3 \u63d0\u4f9b\u4e86\u5b8c\u5168\u57fa\u4e8e TypeScript \u4e0e\u73b0\u4ee3 async\/await \u98ce\u683c\u7684\u7a0b\u5e8f\u5316 API&amp;<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"topic":[],"class_list":["post-116688","post","type-post","status-publish","format-standard","hentry","category-server"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v20.3 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wsisp.com\/helps\/116688.html\" \/>\n<meta property=\"og:locale\" content=\"zh_CN\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"og:description\" content=\"\u540e\u7aef\u5f00\u53d1\u5de5\u5177\u6d4b\u8bd5 \u3010\u514d\u8d39\u4e0b\u8f7d\u94fe\u63a5\u3011maildev :mailbox: SMTP Server Web Interface for viewing and testing emails during development. \u9879\u76ee\u5730\u5740&#xff1a; https:\/\/gitcode.com\/gh_mirrors\/ma\/maildev \u70b9\u51fb\u67e5\u770b \u514d\u8d39\u4e0b\u8f7d \u5bfc\u8bfb MailDev v3 \u63d0\u4f9b\u4e86\u5b8c\u5168\u57fa\u4e8e TypeScript \u4e0e\u73b0\u4ee3 async\/await \u98ce\u683c\u7684\u7a0b\u5e8f\u5316 API&amp;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wsisp.com\/helps\/116688.html\" \/>\n<meta property=\"og:site_name\" content=\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-21T16:24:51+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/10\/20261021162450-6ad8e75245775.svg\" \/>\n<meta name=\"author\" content=\"admin\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u4f5c\u8005\" \/>\n\t<meta name=\"twitter:data1\" content=\"admin\" \/>\n\t<meta name=\"twitter:label2\" content=\"\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4\" \/>\n\t<meta name=\"twitter:data2\" content=\"11 \u5206\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/116688.html\",\"url\":\"https:\/\/www.wsisp.com\/helps\/116688.html\",\"name\":\"MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"isPartOf\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\"},\"datePublished\":\"2026-10-21T16:24:51+00:00\",\"dateModified\":\"2026-10-21T16:24:51+00:00\",\"author\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/116688.html#breadcrumb\"},\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.wsisp.com\/helps\/116688.html\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/116688.html#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u9996\u9875\",\"item\":\"https:\/\/www.wsisp.com\/helps\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\",\"url\":\"https:\/\/www.wsisp.com\/helps\/\",\"name\":\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"description\":\"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"zh-Hans\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\",\"name\":\"admin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"contentUrl\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"caption\":\"admin\"},\"sameAs\":[\"http:\/\/wp.wsisp.com\"],\"url\":\"https:\/\/www.wsisp.com\/helps\/author\/admin\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wsisp.com\/helps\/116688.html","og_locale":"zh_CN","og_type":"article","og_title":"MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","og_description":"\u540e\u7aef\u5f00\u53d1\u5de5\u5177\u6d4b\u8bd5 \u3010\u514d\u8d39\u4e0b\u8f7d\u94fe\u63a5\u3011maildev :mailbox: SMTP Server Web Interface for viewing and testing emails during development. \u9879\u76ee\u5730\u5740&#xff1a; https:\/\/gitcode.com\/gh_mirrors\/ma\/maildev \u70b9\u51fb\u67e5\u770b \u514d\u8d39\u4e0b\u8f7d \u5bfc\u8bfb MailDev v3 \u63d0\u4f9b\u4e86\u5b8c\u5168\u57fa\u4e8e TypeScript \u4e0e\u73b0\u4ee3 async\/await \u98ce\u683c\u7684\u7a0b\u5e8f\u5316 API&amp;","og_url":"https:\/\/www.wsisp.com\/helps\/116688.html","og_site_name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","article_published_time":"2026-10-21T16:24:51+00:00","og_image":[{"url":"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/10\/20261021162450-6ad8e75245775.svg"}],"author":"admin","twitter_card":"summary_large_image","twitter_misc":{"\u4f5c\u8005":"admin","\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4":"11 \u5206"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wsisp.com\/helps\/116688.html","url":"https:\/\/www.wsisp.com\/helps\/116688.html","name":"MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","isPartOf":{"@id":"https:\/\/www.wsisp.com\/helps\/#website"},"datePublished":"2026-10-21T16:24:51+00:00","dateModified":"2026-10-21T16:24:51+00:00","author":{"@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41"},"breadcrumb":{"@id":"https:\/\/www.wsisp.com\/helps\/116688.html#breadcrumb"},"inLanguage":"zh-Hans","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wsisp.com\/helps\/116688.html"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wsisp.com\/helps\/116688.html#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u9996\u9875","item":"https:\/\/www.wsisp.com\/helps"},{"@type":"ListItem","position":2,"name":"MailDev v3 \u7a0b\u5e8f\u5316 API \u5b9e\u6218\u6307\u5357\uff1a\u5728 Node.js \u4e2d\u5d4c\u5165 SMTP \u6d4b\u8bd5\u670d\u52a1\u5668\u4e0e Web \u754c\u9762"}]},{"@type":"WebSite","@id":"https:\/\/www.wsisp.com\/helps\/#website","url":"https:\/\/www.wsisp.com\/helps\/","name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","description":"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"zh-Hans"},{"@type":"Person","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41","name":"admin","image":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/","url":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","contentUrl":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","caption":"admin"},"sameAs":["http:\/\/wp.wsisp.com"],"url":"https:\/\/www.wsisp.com\/helps\/author\/admin"}]}},"_links":{"self":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/116688","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/comments?post=116688"}],"version-history":[{"count":0,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/116688\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/media?parent=116688"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/categories?post=116688"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/tags?post=116688"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/topic?post=116688"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}