本文详解三种安全、可靠的方式（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 -->
<!DOCTYPE html>
<html>
<head><meta charset="UTF-8"></head>
<body>
<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://$(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><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记（深入）</a>”；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill10828" title="财经HTML高端海报生成"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="财经HTML高端海报生成" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill10828" title="财经HTML高端海报生成">财经HTML高端海报生成</a>
<p>复杂得财经如何变成清晰，适合手机看的海报？如何加上你的IP</p>
</div>
<a href="/xiazai/skill10828" title="财经HTML高端海报生成" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<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>
</body>
</html>脚本中调用方式（变量需导出或显式传入）：
#!/bin/bash
i="John Doe"
site="example.com"
code="X9F2K7"
# 方式1：导出后全局生效（简洁）
export i site code
template=$(envsubst < ./mail_template.html)
# 方式2：不污染环境，更安全（推荐）
template=$(i="$i" site="$site" code="$code" envsubst < ./mail_template.html)
# 发送 HTML 邮件（关键：-a 指定 Content-Type，-r 设置发件人）
echo "$template" | mail -a 'Content-Type: text/html; charset=UTF-8' \
-s "Urgent notice from $site" \
"$email" \
-r "$mail_from"⚠️ 注意事项：
- 确保系统已安装 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（虽邮件客户端限制较多，但仍属最佳实践）。
