
本文详解三种安全、可靠的方式(envsubst、printf 格式化、sed 替换)在 Bash 中动态渲染 HTML 邮件模板,并通过 mail 命令发送富文本邮件,解决变量不展开、MIME 类型失效等常见问题。
本文详解三种安全、可靠的方式(`envsubst`、`printf` 格式化、`sed` 替换)在 bash 中动态渲染 html 邮件模板,并通过 `mail` 命令发送富文本邮件,解决变量不展开、mime 类型失效等常见问题。
在 Bash 自动化运维或用户通知场景中,纯文本邮件已难以满足可读性与专业性需求。若需向用户发送含加粗、列表、链接和强调提示的 HTML 邮件(如启用双因素认证的紧急通知),必须确保两点:模板变量正确替换 + 邮件头声明 Content-Type: text/html。直接使用 cat ./template | mail -a 'Content-Type: text/html' ... 会失败,原因有二:一是 Shell 不会对重定向读入的文件内容执行变量扩展($i、$site 等保持原样);二是 mail 命令默认以 text/plain 发送,即使加了 -a 头,部分 MTA(如 sendmail 兼容层)仍可能忽略或覆盖 MIME 类型。
✅ 推荐首选方案:envsubst(GNU gettext 工具集,轻量且语义清晰)
该工具专为环境变量模板渲染设计,安全、无注入风险,且天然支持 $VAR 和 ${VAR} 语法。使用前需将模板中的变量改为 $(i)、$(site) 等标准 Shell 变量引用格式(注意:不是 $i,而是 $i 在双引号内会被提前展开,应避免;envsubst 要求变量名被 $ 和 {} 或空格界定):
<!-- ./mail_template.html -->
<meta charset="UTF-8"><h2>Urgent Security Notice from $(site)</h2>
<p>Dear <strong>$(i)</strong>,</p>
<p>Please enable <strong>Two-Factor Authentication (2FA)</strong> on <a href="https://%24(site)">$(site)</a>. This is critical to protect your account.</p>
<p><strong>Your initial one-time code:</strong><br><code>$(code)</code></p>
<p>For detailed instructions, visit:<br><a href="https://docs.nextcloud.com/server/latest/user_manual/en/user_2fa.html">
Nextcloud 2FA Setup Guide
</a>
</p>
<ol>
<li>Log in to <strong>$(site)</strong> using the code above</li>
<li>Enable 2FA as shown in the guide</li>
<li>Configure security tokens (also in the guide)</li>
</ol><p><strong style="color:red">⚠ Attention!</strong><br>
Do <em>not</em> save security tokens in Nextcloud File Storage. Store them encrypted elsewhere or print and vault physically.</p>
<p>Regards,<br>Your Site Administrator from <strong>$(site)</strong></p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill10595" title="htmlppt.skill"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d79f23518.jpg" alt="htmlppt.skill" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill10595" title="htmlppt.skill" class="overflowclass">htmlppt.skill</a>
<p class="overflowclass">把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件(幻灯片风格)。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本,并且希望生成演示用的 HTML 时触发。支持任意内容来源:iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区,并通过企微直接发送给用户。触发词示例:帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。</p>
</div>
<a rel="nofollow" href="/xiazai/skill10595" title="htmlppt.skill" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
脚本中调用方式(变量需导出或显式传入):
#!/bin/bash i="John Doe" site="example.com" code="X9F2K7" # 方式1:导出后全局生效(简洁) export i site code template=$(envsubst <p>⚠️ 注意事项: </p>
- 确保系统已安装 gettext(Ubuntu/Debian:sudo apt install gettext-base;CentOS/RHEL:sudo yum install gettext);
- 模板中所有 $ 后紧跟变量名(如 $i)必须是有效环境变量,否则留空;建议统一用 ${i} 避免歧义;
- mail 命令依赖本地 MTA(如 ssmtp、msmtp 或 sendmail),请提前配置好 SMTP 出站;
- 必须在 -a 中明确指定 charset=UTF-8,否则中文或特殊字符可能乱码。
? 备选方案(无需额外依赖):
- printf 占位符法:将模板改为 Dear %s,\n... on %s.\n... code: %s\n,再用 printf "$template" "$i" "$site" "$code" 渲染。优点是零依赖,缺点是占位符顺序易错、不支持条件逻辑。
- sed 批量替换法:模板用 _name_、_site_ 等占位符,执行 sed -e "s/_name_/$i/g" -e "s/_site_/$site/g" ... ./template.html。适合简单替换,但需转义 /、& 等特殊字符(可用 | 作分隔符规避)。
? 总结:对于生产环境,强烈推荐 envsubst 方案——它语义明确、安全性高、与 Shell 生态无缝集成,配合正确的 Content-Type 头和 UTF-8 声明,即可稳定发送结构清晰、样式专业的 HTML 邮件。切勿在模板中拼接未过滤的用户输入,以防 XSS(虽邮件客户端限制较多,但仍属最佳实践)。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










