当前为开发环境,请使用 App 为此服务器注册生成的 Webhook。
推送加密
通常,Breeze、Apple 和 Google 在投递时能看到通知的文字。开启加密后,由你的脚本加密内容,只有你的 iPhone 能解密。格式与 Bark 兼容。
设置密钥#
在 App 中打开“设置 → 加密”,选择:
| 设置 | 选项 |
|---|---|
| 算法 | AES-128、AES-192 或 AES-256,密钥分别为 16、24、32 个字符 |
| 模式 | GCM(推荐)、CBC 或 ECB |
| IV | GCM 为 12 个字符,CBC 为 16 个字符,ECB 不需要 |
在 App 中生成密钥并复制到脚本里,除此之外密钥不会离开手机。App 还会给出一条可直接运行的命令,用来发送加密测试通知。
发送加密通知#
- 把参数写成 JSON,例如
{"title":"Server","body":"Disk usage is above 90%"}。 - 用你的密钥和 IV 加密这段 JSON,再做 Base64 编码。GCM 模式需要先把 16 字节的 tag 拼接在密文末尾再编码。
- 把结果作为
ciphertext发送。如果每条消息使用不同的 IV,也一并发送iv。
KEY='YOUR_32_CHARACTER_KEY' # AES-256
IV='YOUR_16_CHAR_IV' # CBC
JSON='{"title":"Server","body":"Disk usage is above 90%"}'
CIPHERTEXT=$(printf '%s' "$JSON" | openssl enc -aes-256-cbc \
-K "$(printf '%s' "$KEY" | xxd -p -c 256)" \
-iv "$(printf '%s' "$IV" | xxd -p -c 256)" | base64 | tr -d '\n')
curl https://push.breezelabs.dev/v1/send \
-H 'Authorization: Bearer YOUR_KEY' \
--data-urlencode "ciphertext=$CIPHERTEXT" \
--data-urlencode "iv=$IV"
使用 Python 和 AES-GCM:
import base64, json, os
from cryptography.hazmat.primitives.ciphers.aead import AESGCM
key = b'YOUR_32_CHARACTER_KEY'
iv = os.urandom(6).hex().encode() # 12 characters, new for every message
payload = json.dumps({'title': 'Server', 'body': 'Disk usage is above 90%'}).encode()
ciphertext = base64.b64encode(AESGCM(key).encrypt(iv, payload, None)).decode()
# Send {"ciphertext": ciphertext, "iv": iv.decode()} to /v1/send
哪些内容仍然可见#
放在 ciphertext 之外的参数(例如 group 或 sound)对服务可见。请把所有私密内容放进加密的 JSON。如果密钥或 IV 不匹配,手机会显示“Decryption failed”而不是内容。
加密目前只支持 iPhone。Android 暂不支持,会返回 HTTP 422。