秋月不会解梦的头像 秋月不会解梦

KOKONA NOTIFY · SELF-HOSTED PUSH

KokonaNotify

DSH 插件在电脑上跑完任务,往自己的服务器发一条 HTTP 请求, 手机和浏览器立刻收到通知。全程不经过任何第三方服务, 消息只落在自己的机器上。

DSH 插件 · 电脑 → akizukikokona.com:8443 · ntfy → 手机 App / 浏览器
SERVICE ntfy v2.28.0 Go 单二进制
ENDPOINT akizukikokona.com:8443 nginx 反代 · 独立端口
TOPIC dsh 默认主题
ACCESS deny-all + Token 未授权一律 403

开始用

WEB UI

网页版:打开上面这个地址,用服务端建的账号登录,订阅主题 dsh, 然后在设置里打开「启用通知」。桌面浏览器和安卓 Chrome 这样就能收到后台推送了。
iOS 注意:苹果只允许「添加到主屏幕」后的网页收推送 —— 先在 Safari 里 把这个地址添加到主屏幕,再从主屏幕图标打开并授权通知。

插件怎么接

ONE HTTP REQUEST

01 — 最小可用

一条 POST 就完事

插件里只要发这么一个请求,手机就响了。主题名就是 URL 的最后一段。

POST https://akizukikokona.com:8443/dsh
Authorization: Bearer <PLUGIN_TOKEN>
Content-Type: text/plain; charset=utf-8

任务完成:构建成功,耗时 1m23s
02 — 带标题和样式

用 HTTP 头控制显示

标题、优先级、标签、点击跳转都走自定义头,正文仍然是纯文本(或 JSON)。

Title: DSH 任务完成
Priority: default
Tags: white_check_mark
Click: https://akizukikokona.com/kharness/
Markdown: yes
03 — 可选字段

常用头一览

  • Title —— 通知标题
  • Priority —— min / low / default / high / max(max 会绕过勿扰)
  • Tags —— 逗号分隔,如 warning,robot;或用 emoji 短代码
  • Click —— 点通知时打开的链接
  • Actions —— 通知上的按钮
  • Delay —— 延迟投递,如 30m
04 — Python 示例

插件里直接抄这段

只用标准库,不用装任何依赖。

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 正文发,中文标题就不会出问题。

05 — 推荐写法

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 里即可,其余配置不用动。