drone-line 插件使用指南

功能概述

drone-line 是一个用于通过二进制文件、Docker 或 Drone CI 发送 LINE 通知的插件。它支持以下功能：

• 发送多种消息类型（文本、视频、音频、贴纸、位置）
• 支持 Prometheus 指标 API
• 自动从 Let’s Encrypt 安装 TLS 证书
• 支持 Localtunnel 用于 webhook 隧道
• 支持 LINE Notify

安装方式

1. 二进制安装

预编译的二进制文件可以从发布页面下载，支持以下操作系统：

• Windows amd64/386
• Linux amd64/386
• Darwin amd64/386

使用 Go 安装：

go get -u -v github.com/appleboy/drone-line

或手动构建：

make build

2. Docker 安装

构建 Docker 镜像：

make docker

使用示例

1. 二进制方式使用

设置 Webhook 服务

默认端口 8088：

drone-line \
  --secret xxxx \
  --token xxxx \
  webhook

更改端口到 8089：

drone-line \
  --port 8089 \
  --secret xxxx \
  --token xxxx \
  webhook

使用 Localtunnel：

drone-line \
  -s secret \
  -t token \
  --tunnel \
  --port 2002 \
  webhook

使用 Let’s Encrypt：

drone-line \
  -s secret \
  -t token \
  -autotls \
  -host example.com \
  -cache /var/www/.cache \
  --port 443 \
  webhook

发送通知

drone-line \
  --secret xxxx \
  --token xxxx \
  --to xxxx \
  --message "Test Message"

发送 LINE Notify

drone-line \
  --token xxxx \
  --message "Test Message" \
  notify

2. Docker 方式使用

设置 Webhook 服务

默认端口 8088：

docker run --rm \
  -e LINE_CHANNEL_SECRET=xxxxxxx \
  -e LINE_CHANNEL_TOKEN=xxxxxxx \
  appleboy/drone-line webhook

更改端口到 8089：

docker run --rm \
  -e LINE_CHANNEL_SECRET=xxxxxxx \
  -e LINE_CHANNEL_TOKEN=xxxxxxx \
  -e LINE_PORT=8089 \
  appleboy/drone-line webhook

发送通知

docker run --rm \
  -e LINE_CHANNEL_SECRET=xxxxxxx \
  -e LINE_CHANNEL_TOKEN=xxxxxxx \
  -e LINE_TO=xxxxxxx \
  -e LINE_MESSAGE=test \
  -e LINE_IMAGES=https://example.com/1.png \
  -e LINE_VIDEOS=https://example.com/1.mp4 \
  -e LINE_AUDIOS=https://example.com/1.mp3::1000 \
  -e LINE_STICKERS=1::1 \
  -e LINE_LOCATIONS=title::address::latitude::longitude \
  -e LINE_DELIMITER=:: \
  appleboy/drone-line

3. Drone CI 方式使用

docker run --rm \
  -e PLUGIN_CHANNEL_SECRET=xxxxxxx \
  -e PLUGIN_CHANNEL_TOKEN=xxxxxxx \
  -e PLUGIN_TO=xxxxxxx \
  -e PLUGIN_MESSAGE=test \
  -e PLUGIN_IMAGES=https://example.com/1.png \
  -e PLUGIN_VIDEOS=https://example.com/1.mp4 \
  -e PLUGIN_AUDIOS=https://example.com/1.mp3::1000 \
  -e PLUGIN_STICKERS=1::1 \
  -e PLUGIN_LOCATIONS=title::address::latitude::longitude \
  -e PLUGIN_DELIMITER=:: \
  -e PLUGIN_ONLY_MATCH_EMAIL=false \
  -e DRONE_REPO_OWNER=appleboy \
  -e DRONE_REPO_NAME=go-hello \
  -e DRONE_COMMIT_SHA=e5e82b5eb3737205c25955dcc3dcacc839b7be52 \
  -e DRONE_COMMIT_BRANCH=master \
  -e DRONE_COMMIT_AUTHOR=appleboy \
  -e DRONE_COMMIT_AUTHOR_EMAIL=appleboy@gmail.com \
  -e DRONE_COMMIT_MESSAGE=Test_Your_Commit \
  -e DRONE_BUILD_NUMBER=1 \
  -e DRONE_BUILD_STATUS=success \
  -e DRONE_BUILD_LINK=http://github.com/appleboy/go-hello \
  -e DRONE_JOB_STARTED=1477550550 \
  -e DRONE_JOB_FINISHED=1477550750 \
  -v $(pwd):$(pwd) \
  -w $(pwd) \
  appleboy/drone-line

测试

运行测试：

make test

图片示例

内存使用情况：

通知计数使用情况：