一条 POST 就完事
插件里只要发这么一个请求,手机就响了。主题名就是 URL 的最后一段。
POST https://akizukikokona.com:8443/dsh Authorization: Bearer <PLUGIN_TOKEN> Content-Type: text/plain; charset=utf-8 任务完成:构建成功,耗时 1m23s
KOKONA NOTIFY · SELF-HOSTED PUSH
DSH 插件在电脑上跑完任务,往自己的服务器发一条 HTTP 请求, 手机和浏览器立刻收到通知。全程不经过任何第三方服务, 消息只落在自己的机器上。
WEB UI
网页版:打开上面这个地址,用服务端建的账号登录,订阅主题 dsh,
然后在设置里打开「启用通知」。桌面浏览器和安卓 Chrome 这样就能收到后台推送了。
iOS 注意:苹果只允许「添加到主屏幕」后的网页收推送 —— 先在 Safari 里
把这个地址添加到主屏幕,再从主屏幕图标打开并授权通知。
ONE HTTP REQUEST
插件里只要发这么一个请求,手机就响了。主题名就是 URL 的最后一段。
POST https://akizukikokona.com:8443/dsh Authorization: Bearer <PLUGIN_TOKEN> Content-Type: text/plain; charset=utf-8 任务完成:构建成功,耗时 1m23s
标题、优先级、标签、点击跳转都走自定义头,正文仍然是纯文本(或 JSON)。
Title: DSH 任务完成 Priority: default Tags: white_check_mark Click: https://akizukikokona.com/kharness/ Markdown: yes
Title —— 通知标题Priority —— min / low / default / high / max(max 会绕过勿扰)Tags —— 逗号分隔,如 warning,robot;或用 emoji 短代码Click —— 点通知时打开的链接Actions —— 通知上的按钮Delay —— 延迟投递,如 30m只用标准库,不用装任何依赖。
import json, urllib.request
NTFY_URL = "https://akizukikokona.com:8443/dsh"
NTFY_TOKEN = "tk_.........................." # 见 README
def notify(title: str, body: str, priority: str = "default",
tags: str = "", click: str = "") -> None:
"""任务结束后调它。失败不抛异常,别把主流程搞挂。"""
req = urllib.request.Request(NTFY_URL, data=body.encode("utf-8"), method="POST")
req.add_header("Authorization", f"Bearer {NTFY_TOKEN}")
req.add_header("Content-Type", "text/plain; charset=utf-8")
req.add_header("Title", title.encode("utf-8").decode("latin-1", "ignore"))
req.add_header("Priority", priority)
if tags: req.add_header("Tags", tags)
if click: req.add_header("Click", click)
try:
with urllib.request.urlopen(req, timeout=10) as resp:
return json.loads(resp.read().decode()) # {"id": "...", ...}
except Exception:
return None
notify("DSH 任务完成", "构建成功,耗时 1m23s", "default", "white_check_mark",
"https://akizukikokona.com/kharness/")
关于中文标题:HTTP 头只能是 ASCII,所以 Title 里要发中文时,
要么把标题塞进 JSON 正文(Content-Type: application/json,
用 {"title": "...", "message": "..."}),要么在插件侧直接用
requests 之类的库让它自己处理编码。最省事的做法是
用 JSON 正文发,中文标题就不会出问题。
import json, urllib.request
def notify(title, message, priority=3, tags=None, click=None):
payload = {"topic": "dsh", "title": title, "message": message, "priority": priority}
if tags: payload["tags"] = tags
if click: payload["click"] = click
req = urllib.request.Request(
"https://akizukikokona.com:8443/", # 主题放进 body,这里用根路径
data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
method="POST",
)
req.add_header("Authorization", "Bearer tk_..........................")
req.add_header("Content-Type", "application/json")
with urllib.request.urlopen(req, timeout=10) as resp:
return json.loads(resp.read().decode())
SSH CHEATSHEET
systemctl status ntfy # 看服务 journalctl -u ntfy -f # 看日志 ntfy user list # 用户与权限 ntfy token list # 令牌 ntfy token add --label new-device akizuki # 给新设备发令牌 # 手动推一条测试 curl -H "Authorization: Bearer <TOKEN>" -d "测试" https://akizukikokona.com:8443/dsh # 配置 /etc/ntfy/server.yml # 服务端配置 /var/cache/ntfy/cache.db # 消息历史(48 小时) /var/lib/ntfy/user.db # 用户与令牌 /root/ntfy-credentials.txt # 网页版登录密码
换端口/换域名:/etc/ntfy/server.yml 里的 base-url
必须与外部访问地址完全一致,否则网页版通知授权会失败。改完
systemctl restart ntfy。
如果以后想用 ntfy.akizukikokona.com:在 Cloudflare 加一条 A 记录指向服务器
(先关掉小云朵),然后 certbot --nginx -d ntfy.akizukikokona.com 签证书,
再把 nginx 那段搬到 443 的 vhost 里即可,其余配置不用动。