文档首页 / 用户中心设置 / 青龙面板推送教程（官方托管脚本 V3）

青龙面板推送教程（官方托管脚本 V3）

2026-07-20 …

推荐：官方托管脚本（V3，2026-10-19 上线）——无需写代码、无需加群拿脚本。2026-10-19 起用户中心提供一键生成配置：选脚本语言、填个备注名，直接下载 xb_config.json / 复制环境变量 / 复制定时任务命令，不用再手工拼 JSON。规则/渠道/额度全在用户中心管理，改完实时生效。
先看这条：想 24 小时收推送但不想折腾脚本？只装浏览器扩展就够了（关掉页面也能推，弹窗渠道只有它能显示）——本教程属于「设备托管 · 托管脚本」路线，适合有青龙/VPS/NAS/旧手机的玩家。

零、启动器：下载一个几 KB 的小文件就能跑（Windows / macOS / Linux，最省事）

这条路线专门给「不想折腾」的人：不用把配置文件放到指定目录、不用自己配开机自启、以后脚本更新也不用重新下载——启动器每次双击都会自动取最新脚本。
青龙 / VPS / NAS / 旧手机请继续看下面的一、官方托管脚本；两条路功能完全一样，选一条即可。

1. 先装一次 Node.js（只装这一次）

到 nodejs.org/zh-cn/download 下载对应系统的安装包（Windows 选 .msi，macOS 选 .pkg），一路下一步即可。
装完若提示「找不到 node」，注销或重启一次电脑让 PATH 生效。青龙等面板类不需要这一步，它们自带运行环境。

2. 下载启动器

用户中心 → 信息推送设置 → 设备托管 → 切到「💻 自己电脑」段 → 「🖥 第 2 步 · 双击启动器」卡片：

Windows：点「⬇ Windows 启动器」（zip，内含使用说明 · 推荐）。
macOS：点「⬇ macOS 启动器」（zip，内含 Start-Xianbao-Push.command 与说明）。

把它放在一个固定的文件夹里，比如 Windows 的 D:\\xianbao、macOS 的 ~/xianbao。同一目录会自动生成配置和日志。

3. 生成接入码并粘贴

同一页往下，在「🛠 接入」卡片的「生成接入码」一步点「一键生成配置」；
结果区最上面出现「⓪ 接入码」（XB1. 开头的一长串），点「复制」；
双击启动器（macOS 见下方「注意」），窗口会提示「在这里粘贴接入码后按回车」，粘贴后回车；
看到 config ok：规则 N 条 / 挂机渠道 N 个 就成功了；程序会顺带问要不要开机自启，直接回车 = 要。

接入码等于密钥，只显示这一次，关掉页面就看不到了。想重新拿：点「重置密钥并重新生成」（旧密钥立即作废，正在跑的程序要换成新接入码）。

4. 第一次运行会被系统拦一次（正常现象）

Windows：双击 .bat 若弹出「Windows 已保护你的电脑」→ 点「更多信息」→「仍要运行」。浏览器提示「不常下载的文件」→ 下载列表里选「保留」。
macOS：解压后右键点 Start-Xianbao-Push.command →「打开」（首次必须右键，直接双击会被系统拦）；若提示「无法验证开发者」→ 系统设置 → 隐私与安全性 → 点「仍要打开」。
被 360 / 火绒等拦下：改用 zip 版解压，或把该文件夹加白名单。启动器只做两件事——下载脚本、运行它，不写系统目录。

5. 在 Linux / VPS 上跑：一定要放后台（否则 Ctrl+C 就停）

不要直接在终端里 node xianbao_push.js：按 Ctrl+C、关掉 SSH、终端窗口关闭、网络断开重连——进程都会跟着结束，推送也就停了。推送需要它一直跑着。

本站提供一个守护脚本 xianbao-push.sh（在「设备托管」页的「🐉 青龙 / VPS / NAS」段下载），放进一个空文件夹即可——它会自动下载推送脚本，机器上有 Node 就用 Node 版、没有就自动用 Python 版：

首次启动（会提示粘贴一次「⓪ 接入码」，之后自动转后台）：
chmod +x xianbao-push.sh
./xianbao-push.sh start
装成开机自启 + 崩溃自动重启（推荐）：sudo ./xianbao-push.sh autostart

命令	作用
`./xianbao-push.sh start`	后台启动（关终端不停）
`./xianbao-push.sh status`	看是否在跑 + 最近日志
`./xianbao-push.sh log`	实时看日志（Ctrl+C 只是退出查看，不影响推送）
`./xianbao-push.sh stop`	停止
`./xianbao-push.sh restart`	重启（改完配置可用）
`sudo ./xianbao-push.sh autostart`	开机自启 + 崩溃自动重启（systemd）

没有 Node / Python 时：直接运行 ./xianbao-push.sh start，它会给出对应发行版的安装命令（Debian/Ubuntu：sudo apt install -y nodejs；CentOS/RHEL：sudo dnf module install -y nodejs:22）。

不想用守护脚本、想手工放后台时，至少要 nohup ... &，但那不会自动重启也不会开机自启，出问题排查更难——不推荐。

6. 它怎么保持最新（这是启动器最大的好处）

启动器每次双击都会从服务器拉一次最新脚本（约 25KB）。所以官方修了脚本、加了功能，你只要重新双击一次就自动用上新版，不需要回来重新下载、也不用重装。
连不上服务器时会用本地已有脚本继续跑，不影响已经配好的推送。

7. 必须知道的三件事

窗口不能关（可以最小化）。关掉窗口 = 停止推送。
电脑关机 / 睡眠 / 休眠时不推送——和只开浏览器扩展一样。想 24 小时不断，需要常开设备（青龙 / VPS / NAS / 旧手机）。
多账号托管：这台机器可以同时替多个线报酷账号推送（帮家人朋友一起挂）。每个账号的主人在他自己的用户中心「设备托管」页生成「⓪ 接入码」发给你；桌面上按 M 打开账号面板再按 a 逐枚粘贴即可（面板里能看到每个账号的规则数、渠道数、今日推送与失败原因）。接入码等于该账号的推送执行权——只交给你信任的人；不想给了一起用了，账号主人重置密钥即可立刻作废。
日志在同目录 xianbao_push.log；配置在同目录 xb_config.json（想换账号就删掉它，重新双击启动器粘贴新接入码）。
每次重启都会重建一次基线：日志出现「启动基线：…（跳过停机期间的 N 条，不补推）」是正常的——只推从现在起的新线报，不会把停机期间的积压一次性全推（避免突发流量被接收方拦截）。

一、官方托管脚本（推荐）

0. 先确认前置条件（90% 的人卡在这里）

至少 1 个「设备托管」渠道：用户中心 → 推送渠道 → 新增，推送方式选「🖥️ 设备托管」。浏览器弹窗渠道不行——弹窗通知只有浏览器扩展能显示，托管脚本不认领也不下发这类渠道。
至少 1 条启用中的推送规则，并把上面的渠道勾上。
用户中心「设备托管」页有接入检查，会逐项告诉你缺哪个（✅/❌ + 一键跳转），配好再看下去。

1. 一键生成配置

登录线报酷 → 用户中心 → 信息推送设置 → 设备托管 → 切到「🐉 青龙 / VPS / NAS」
第 1 步选脚本语言（Node.js 推荐 / Python3），填个备注名（只用于日志区分，可留空），点【一键生成配置】
页面立刻给出四样东西，一次到位：可下载的 xb_config.json、环境变量 XB_CLIENTS、定时任务命令、配置内容预览。
⚠ 密钥只显示这一次，请立即下载或复制保存，关闭页面后无法再查看（只能点「重置密钥」生成新的，旧密钥立即作废）。

2. 放脚本 + 放配置

青龙面板 → 脚本管理 → 新建文件，粘贴官方脚本内容（两个版本功能完全一致，任选其一）：Node.js 版（推荐，青龙内置）xianbao_push.js 或 Python3 版（适合 VPS/NAS/Termux 等有 Python 的设备，零依赖）xianbao_push.py
A. 放文件（最简单）：把上一步下载的 xb_config.json 上传到面板的「脚本管理」目录（就是刚放脚本的那个目录）。✅ 这样不用设任何环境变量。

B. 用环境变量（不想上传文件就选这个）。环境变量一共三个，多数人只填第一个：

名称	值填什么	必填？
`XB_CLIENTS`	上一步生成的「XB_CLIENTS 的值」那一整串（含最外层 `[ ]`）	必填
`XB_HOST`	站点域名，如 `new.xianbao.fun`。镜像站/测试站必须改，否则连到正式站会鉴权失败	选填
`XB_INTERVAL`	轮询间隔秒，默认 `5`（不能小于 5）	选填

面板操作（青龙 / 呆呆面板一样）：左侧「环境变量」→ 新建 → 名称填 XB_CLIENTS（一字不差，全大写，中间下划线）→ 值粘贴上面那一整串 → 备注随便写 → 保存。

⚠ 三个最常见的错（都会被脚本当成「没配置」）：①名称写成 xb_clients/XB_CLIENT/XB-CLIENTS；②只粘了里面的 {...}，丢了最外层 [ ]；③引号被输入法换成中文 “ ”（必须英文 "）。

两种方式同时配了谁生效？有 xb_config.json → 优先用文件，环境变量被忽略；没有文件 → 用环境变量；都没有 → 打印「未配置 XB_CLIENTS…退出」。

「同一目录」到底是哪个目录？脚本读的是运行脚本时所在的目录（process.cwd()），不是脚本文件所在目录：面板定时任务跑 → 面板的「脚本管理」目录；自己终端跑 → 你先 cd 进去的那个目录。所以把 xb_config.json 和脚本放一起、在同一目录执行最稳。

配了却报「未配置」？按顺序查 5 条：①名称是否正好 XB_CLIENTS；②值是否完整 JSON 数组（首尾 [ ] 都在）；③引号是否英文；④密钥是否正好 32 位十六进制（格式不对会被脚本当垃圾过滤，过滤完为空同样打印「未配置」，看起来像没读到）；⑤放文件的话文件是否在运行时目录。

推送渠道/推送规则全部在线报酷用户中心设置，改完实时生效——脚本每次轮询自动拉取最新配置。

可选环境变量：XB_HOST（默认 new.xianbao.fun）、XB_INTERVAL（轮询秒，默认 5）
定时任务：命令 node /path/to/xianbao_push.js（Python 版 python3 xianbao_push.py），规则 * * * * *（脚本自己常驻 5 秒轮询，任务只负责拉起与崩溃重启）
手动运行一次，日志出现 config ok 即接入成功；下一行「基线同步 N 条（不推送历史）」属正常——从现在开始的新线报才会推送

3. 推送渠道怎么配

渠道与规则全部在用户中心 → 推送渠道 / 推送规则里管理，脚本只负责执行，改配置实时生效（无需动面板、无需重启任务）
推送方式选「浏览器挂机推送」的渠道即由托管脚本执行；浏览器弹窗渠道仅浏览器扩展可执行（托管脚本不下发、不认领）
与浏览器扩展共存：其他渠道两端同时开也不会重复推送（服务端认领去重），建议二选一常开

3. 怎么确认成功（按顺序看）

脚本日志出现 config ok：规则 N 条 / 挂机渠道 N 个 / feed … ＝密钥对、网络通、配置读到了。
紧接一行 基线同步 N 条（不推送历史） 是正常的——只推从现在起的新线报。
回用户中心「设备托管」页点【刷新】，状态卡变成 ● 运行中（最多等 1 分钟）。
等一条命中：推送日志出现推送方式为 🐉 托管 且结果=成功＝全链路已通；脚本日志里的 ✓ 渠道名：标题 就是本次实证。

4. 额度与常见报错

额度：设备托管基本免费——浏览器弹窗不限量（仅扩展能弹）；其他渠道每渠道 300 条/天（注册会员），VIP 不限量。不占云端额度、不扣积分。
状态心跳：脚本约 5 分钟报一次心跳（配置刷新降到 60 秒后，心跳受 300 秒落库节流限制，实际约 5 分钟一次），用户中心在线状态最多有同样时长的延迟，属正常。
未配置 XB_CLIENTS…退出 → 配置没读到：xb_config.json 要和脚本同目录，或改用环境变量。
HTTP 401/403 → 密钥错或已被重置：回用户中心重新生成并更新配置。
浏览器弹窗渠道仅支持浏览器扩展执行 → 规则绑了弹窗渠道：托管只发「设备托管」渠道。
已达设备托管每日上限（300 条） → 该渠道今日额度用满，明日 0 点恢复或升级 VIP。
请求过于频繁（每分钟限 60 次） → 每账号用自己 key、interval ≥ 5、同一账号别跑两份脚本。
服务端规则引擎版本…不一致 → 脚本过期，重新下载最新脚本覆盖。

6. 改完设置多久生效

最长 60 秒：脚本每 60 秒自动重拉一次规则 / 渠道 / 额度（旧版是 10 分钟，已缩短）。
想立刻生效：在脚本所在文件夹新建一个空文件，命名为 xb_reload。脚本 5 秒内检测到就会立刻重拉配置，然后自动删除该文件。
Windows：右键 → 新建 → 文本文档 → 重命名为 xb_reload（去掉 .txt）；macOS / Linux：在该目录执行 touch xb_reload。
怎么确认已生效：终端日志会多一行 ⚡ 配置已更新：启用规则 4 → 5 条（条数、启用数、渠道、feed 任一变化都会报）；没有变化则只有常规 config ok。
不用重启脚本——只有换了托管密钥才需要更新配置并重启。

二、在自己的电脑上跑（Windows / macOS）

脚本只依赖语言标准库（Node.js 用内置 https、Python 用 urllib），Windows / macOS / Linux 都能跑，不需要服务器。

先想清楚要不要这么做：电脑关机 / 睡眠 / 休眠时脚本同样停推——和你只开浏览器扩展是一回事。只是想让「关掉浏览器也继续推」→ 电脑跑脚本就够；想真正 24 小时不断 → 用常开设备（青龙面板 / VPS / NAS / 旧安卓）。

1. 装运行环境（二选一）

Node.js（推荐）：到 nodejs.org 下载 LTS 版安装包，一路下一步。装完在终端执行 node -v 应显示 v16 以上。
Python：Windows 到 python.org 下载（安装时勾选 Add Python to PATH）；macOS 多数自带 python3。执行 python3 -V 应显示 3.8 以上。

2. 放文件

新建一个文件夹，比如 Windows 的 D:\\xianbao、macOS 的 ~/xianbao。
把下载的脚本（xianbao_push.js 或 xianbao_push.py）和 xb_config.json 都放进这个文件夹。
在这个文件夹里打开终端：Windows — 资源管理器地址栏输入 cmd 回车；macOS — 右键文件夹 → 服务 → 新建位于文件夹位置的终端窗口。

3. 先手动跑一次

node xianbao_push.js          # Python 版：python3 xianbao_push.py（Windows 多为 python xianbao_push.py）

看到 config ok：规则 N 条 / 挂机渠道 N 个 / feed … 就说明配好了。按 Ctrl+C 停掉，再做下一步设开机自启。

4. 设开机自启

Windows：任务计划程序 → 创建基本任务 → 触发器选「登录时」→ 操作选「启动程序」→ 程序填 node（或 python）、参数填 xianbao_push.js（或 xianbao_push.py）、「起始于」填脚本所在文件夹（如 D:\\xianbao）。
macOS：做一个 start.command（内容先 cd 到脚本目录再 node xianbao_push.js，chmod +x 授权）→ 系统设置 → 通用 → 登录项 → 添加该文件。

配好后重启一次电脑，回用户中心「设备托管」页看状态卡是否变「运行中」——这一步能验证自启真的生效。

5. 注意事项

「同一目录」= 运行脚本时所在的目录，不是脚本文件所在目录。所以一定要先 cd 进那个文件夹再跑，或用任务计划/登录项把「起始目录」设对。
Windows 自启任务常用「登录时」触发；如果希望不登录也跑，需改成「计算机启动时」并勾选「不管用户是否登录都运行」（可能需要管理员权限）。
运行期间窗口关掉不影响（进程独立），但不要「注销 / 关机」。

二、没有青龙面板？其他设备都能跑

依赖说明（先看这个）：两个官方脚本都是零第三方依赖——Node.js 版只需要设备上有 Node.js ≥16（青龙面板自带；其他设备要先装），Python 版只需要 Python 3.8+（绝大多数 Linux 自带），不需要 pip/npm 装任何包。设备上没有 Node/Python 就按下面各宿主的说明先装。

环境变量在哪里设（两种方式任选其一）：

方式 A（推荐，新手友好）：直接把配置写在脚本同目录的一个文件里——新建 xb_config.json（与脚本放一起），内容：
```
{"host":"new.xianbao.fun","interval":5,"clients":[{"uid":123,"key":"你的密钥","name":"主号"}]}
```
脚本启动时若发现同目录有 xb_config.json 就优先读它（环境变量可全部不设）。
方式 B（环境变量）：按各宿主的习惯设 XB_HOST/XB_CLIENTS 两个变量（见下面各宿主的具体位置）。

VPS / 云服务器（假设 Ubuntu/Debian）：①装运行时 apt install -y nodejs（或 apt install -y python3）；②设环境变量：写进 /etc/environment（XB_CLIENTS=[{"uid":123,"key":"...","name":"主号"}]，重登录生效）或启动命令前直接带（XB_CLIENTS='...' node xianbao_push.js &）；③常驻：推荐 pm2（npm i -g pm2 && pm2 start xianbao_push.js --name xbpush && pm2 save）或写一个 systemd 服务。注意 /etc/environment 里写 JSON 不需要引号转义技巧，直接粘贴即可。
群晖 / fnOS 等 NAS：①套件中心装 Node.js（或用 NAS 的 Docker 跑青龙更省事）；②环境变量：控制面板 → 计划任务 → 新增「开机触发」任务，命令里 export 后再启动（export XB_CLIENTS='...' && node /volume1/xb/xianbao_push.js）——NAS 没有全局环境变量面板，变量随任务命令一起给。
旧安卓手机：①装 Termux（F-Droid 版）→ pkg install nodejs（或 pkg install python）；②环境变量：Termux 里 echo 'export XB_CLIENTS=...' >> ~/.bashrc && source ~/.bashrc；③下载脚本到手机（curl -O https://new.xianbao.fun/zb_users/plugin/xbpush/client/xianbao_push.js）→ node xianbao_push.js 常驻；④配合 Termux:Boot 插件开机自启（装好后建 ~/.termux/boot/start-xb.sh 内容为启动命令）。注意：手机要保持 Termux 不被系统杀后台（通知栏常驻/电池白名单）。
软路由 openWrt：①opkg update && opkg install node（空间不足就选 python3-light）；②环境变量：变量写进启动命令里（XB_CLIENTS=... nohup node /root/xianbao_push.js >/tmp/xb.log 2>&1 &）；③把启动命令追加到 /etc/rc.local 的 exit 之前实现开机自启。
Docker：docker run -d --name xbpush --restart unless-stopped -e XB_CLIENTS='[{"uid":123,"key":"...","name":"主号"}]' -v /opt/xb:/app node:16-alpine node /app/xianbao_push.js（Python 版同理换 python:3-alpine 镜像与 python3 命令；-e 注入即环境变量；-v 挂载目录放脚本，水位文件也会落在里面、容器重启不丢）。
额度与状态查看与青龙完全一致（用户中心「设备托管」页看在线心跳、推送日志看执行明细）。

三、旧方式：万能 API 自建（已下架）

原来的「万能 API 自建」教程（基础准备/文章监控/进阶功能/注意事项，含群文件脚本下载）已于 2026-10-19 下架：其「与用户中心规则不同步、需要手工维护脚本参数、无推送日志」等问题，官方托管脚本已全部解决——请改用本文「一、官方托管脚本」，配置全在线报酷用户中心、实时生效、有执行端心跳与推送日志。

已在用旧方式且工作正常的可以继续用（接口未关闭），但不再提供教程与技术支持；遇到问题请迁移到官方托管脚本。

根目录