自建 Hotify 消息推送服务安装教程

本教程在 Ubuntu 24.04 + Docker 环境下实测通过，讲述如何自建一个 Gotify/Hotify 兼容的消息推送服务，并接入 Bark / SmsForwarder 生态。

一、Hotify 是什么

自托管的消息推送服务，兼容 Bark / Gotify 协议，SmsForwarder、Bark App、Uptime Kuma 等换地址即用；支持离线推送、媒体直传、全量备份。

二、部署步骤

1. 创建 docker-compose.yml

mkdir -p ~/hotify && cd ~/hotify

docker-compose.yml 内容：

services:
  hotify-server:
    image: crpi-gi2hyqoir87c0lus.cn-hangzhou.personal.cr.aliyuncs.com/sakura-lolipop/hotify-server:v1.0
    container_name: hotify-server
    restart: unless-stopped
    ports:
      - "40266:8443"
    environment:
      EXTERNAL_URL: "https://你的域名（示例）"
      TZ: "Asia/Shanghai"
    volumes:
      - hotify-data:/data

volumes:
  hotify-data:
    name: hotify-data

2. 启动服务

docker compose up -d
docker compose logs -f --tail 5   # 确认启动
curl -s http://127.0.0.1:40266/ping   # 应返回 pong

3. 验证关键端点

curl -s http://127.0.0.1:40266/api/v1/info
# {"code":200,"version":"v1.0",...}

三、接入客户端

  • Bark：服务器填你的域名（示例），key 填设备 uuid 或别名

  • SmsForwarder：用 gotify 通道，服务器填你的域名，token 填设备 uuid 或别名

  • 接收侧走华为/系统离线通道，锁屏可达、进程被杀也能收到

四、常见问题

  • EdgeOne 回源端口没改？ 确认回源端口指向 40266

  • Bark 不显示媒体图？ EXTERNAL_URL 必须配置为可访问的 https 公网地址

  • 离线推送不通？ 检查推送云函数（默认内置，无需配置）