3分钟掌握Discord.sh：终极命令行通知神器

3分钟掌握Discord.sh：终极命令行通知神器

【免费下载链接】discord.sh Write-only command-line Discord webhooks integration written in 100% Bash script 项目地址: https://gitcode.com/gh_mirrors/di/discord.sh

想要在服务器监控、CI/CD流水线或日常脚本中快速发送Discord通知吗？Discord.sh正是你需要的工具！这个纯Bash脚本的Discord webhook集成工具，让命令行通知变得前所未有的简单。

🚀 快速入门指南

第一步：获取脚本

通过以下任一方式获取discord.sh脚本：

# 使用curl下载
curl -o discord.sh https://gitcode.com/gh_mirrors/di/discord.sh

# 或者使用wget
wget -O discord.sh https://gitcode.com/gh_mirrors/di/discord.sh

# 赋予执行权限
chmod +x discord.sh

第二步：配置Webhook

在Discord服务器中创建webhook后，有三种方式配置：

1. 命令行参数：--webhook-url="你的webhook地址"
2. 环境变量：设置DISCORD_WEBHOOK变量
3. 配置文件：在脚本同目录创建.webhook文件

第三步：发送第一条消息

./discord.sh --webhook-url="$WEBHOOK" --text "Hello, world!"

💡 实战应用场景

服务器监控通知

当CPU使用率超过阈值时自动发送警告：

./discord.sh \
  --webhook-url="$WEBHOOK" \
  --username "System Monitor" \
  --text "🚨 CPU usage at 95%! Immediate attention required."

CI/CD构建状态

在GitLab CI或GitHub Actions中通知构建结果：

./discord.sh \
  --webhook-url="$WEBHOOK" \
  --title "Build Complete" \
  --description "✅ Pipeline successfully deployed to production" \
  --color "0x00FF00"

日志文件推送

将重要日志文件直接发送到Discord频道：

./discord.sh \
  --webhook-url="$WEBHOOK" \
  --file error.log \
  --username "Log Bot"

🔧 高级功能详解

富文本嵌入消息

创建专业级的通知卡片：

./discord.sh \
  --webhook-url="$WEBHOOK" \
  --username "Deployment Bot" \
  --title "New Release v1.2.3" \
  --description "✨ Features added:\n- User authentication\n- File upload\n- Real-time notifications" \
  --color "0x3498DB" \
  --field "Environment;Production;true" \
  --field "Version;1.2.3;true" \
  --field "Status;Live;true" \
  --timestamp

自定义身份标识

修改webhook的默认用户名和头像：

./discord.sh \
  --modify \
  --username "DeploymentBot" \
  --avatar "https://example.com/bot-avatar.png"

🛠️ 系统要求与依赖

Discord.sh极其轻量，仅需以下依赖：

• bash：GNU Bourne-Again Shell
• curl：HTTP请求处理
• jq：JSON解析工具

📋 核心参数速查

参数类别	常用选项	功能描述
基础功能	--text	发送普通文本消息
身份设置	--username --avatar	自定义发送者信息
嵌入内容	--title --description	创建富文本卡片
文件操作	--file	上传文件（最大8MB）
高级选项	--field --timestamp	添加字段和时间戳

🎯 使用技巧与最佳实践

字符转义处理

当发送包含特殊字符的内容时，使用jq进行正确转义：

# 发送文件内容（自动转义）
cat logfile.txt | ./discord.sh --webhook-url="$WEBHOOK" --stdin

# 复杂内容的转义处理
./discord.sh --webhook-url="$WEBHOOK" --text "$(jq -Rs . <filename | cut -c 2- | rev | cut -c 2- | rev)"

错误处理策略

在脚本中集成错误检查：

# 检查命令执行状态
if some_command; then
  ./discord.sh --webhook-url="$WEBHOOK" --text "✅ Command executed successfully"
else
  ./discord.sh --webhook-url="$WEBHOOK" --text "❌ Command failed with exit code $?"
fi

🔍 常见问题解答

Q: 如何同时发送嵌入消息和文件？ A: Discord API限制不允许同时发送，建议先发送消息再单独发送文件。

Q: 支持的最大消息长度是多少？ A: 标题最多256字符，描述最多2048字符，确保内容在这些限制内。

Q: 在生产环境中如何安全使用？ A: 推荐使用环境变量或配置文件存储webhook URL，避免在命令行中暴露敏感信息。

Discord.sh将Discord通知功能带入了命令行世界，无论是系统管理员、开发者还是DevOps工程师，都能从中受益。立即开始使用，让你的自动化流程更加完善！

【免费下载链接】discord.sh Write-only command-line Discord webhooks integration written in 100% Bash script 项目地址: https://gitcode.com/gh_mirrors/di/discord.sh