苹果 CMS 资源采集助手 2.0

采集一次,
所有站点一键同步

一台「采集节点」替你采好全部资源,每个站点上的「Agent」在本机批量写库,之后只同步变化。不再每个站各采各的。

9分钟接口采集 29 万条
38秒每个站点导入全量
0重复按资源 ID 对齐,不叠集
开始安装
当前版本 读取中…更新说明 →
资源站巨量 · 自定义 采集节点只装一台 · 采集一次保存完整片库 你的电脑客户端 / 浏览器 站点 AAgent 站点 BAgent 站点 C …Agent
FEATURES

为多站站长做的采集方式

传统采集是每个站各自翻上万页、逐条入库;找资源助手把「采集」和「写站」分开:采集只做一次,写站在每台服务器本机完成。

采集一次,全站同步

一台节点采集,所有站点自动跟进;节点每 10 分钟增量一次,新片、更新、下架都同步到每个站。

快:29 万条约 9 分钟

首次全量接口采集约 9 分钟,断了能续采;空站导入全量约 38 秒,不再一页页翻。

不重复、不叠集

按资源 ID 对齐每一部片,不靠片名猜;站上已有数据先「认领」再同步,对不准的交给你选。

站点不用开端口

Agent 主动连接节点,站点服务器不开放任何端口;更新包都经过签名校验。

多个资源站,线路合并

官方推荐 · 内置 巨量资源装好即用;也可以添加其他苹果 CMS 资源站(只支持 https),同一部片只有一条、各家线路挂在一起。

能回到接入前

第一次写站前自动给视频表、分类表做快照,不满意几秒换回;节点、站点在客户端里一键升级。

采集 1.0每个站各采各的采集 2.0找资源助手
首次采集 29 万条32 小时,中途报错重启 800 多次约 9 分钟,断了能续采
多个站点N 个站各采 N 遍节点采集一次,每个站导入 38 秒
日常更新按片名猜是不是同一部,容易重复、叠集每 10 分钟增量,按资源 ID 对齐,0 重复

均为实测:1.0 为站点原生采集巨量资源全量的日志记录;2.0 为节点首次全量采集与空站首次导入,实际耗时受网络、带宽与磁盘影响。目前已适配:苹果 CMS v10。

HOW IT WORKS

要装两样东西:一台节点 + 每个站一个 Agent

节点负责「采」,Agent 负责「写」。节点只装一台,所有站点共用;Agent 装在每个苹果 CMS 站点上,从节点领数据写进本站数据库。

资源站

数据来源。巨量资源已内置;也可以加其他苹果 CMS 资源站。

不用你装任何东西

采集
只装一台

采集节点

统一采集、保存一份完整片库、管理所有站点,自带网页管理后台。

装在:一台常开的 Linux / Windows 服务器(可以就是你的站点服务器)

同步
站点服务器 AAgent插件 可选

苹果 CMS + 本站数据库

站点服务器 BAgent
站点 C …Agent

你的电脑:客户端 可选

在电脑上管理节点和所有站点。不装也行:浏览器打开节点后台,功能相同。

节点 ≈ 总仓库

以前每个站都自己去资源站「进货」;现在由节点统一进货、入库,各站从总仓库领货,资源站只被采一次。

Agent ≈ 每个站的入库员

常驻在站点服务器上,替你做以前「采集入库」那一步:主动去节点领数据,按本站的分类、线路设置写进苹果 CMS 数据库。

客户端 ≈ 遥控器 可选

装在你自己的电脑(macOS / Windows)上,管理节点和所有站点,有告警会提醒。

后台插件 ≈ 站内状态牌 可选

装进苹果 CMS 后台,在站点自己的后台看同步状态(只读),需本机已装 Agent。

WHERE TO START

你是哪种情况?

选一种,照着做。三种情况都只需要装一台节点,区别只在 Agent 装在哪。

最常见

我只有一个站

节点和 Agent 都装在这台站点服务器上,不用另买服务器。

  1. 在这台服务器上装节点
  2. 登录后台,导入资源包
  3. 还在这台服务器上装 Agent
从第 1 步开始 →

2 个站以上

我有很多站

找一台常开的服务器装节点(可以就是其中一个站),每个站各装一个 Agent。

  1. 选一台服务器装节点
  2. 登录后台,导入资源包
  3. 每个站点生成令牌、装 Agent
从第 1 步开始 →

装不了程序

虚拟主机 / 只有数据库

节点装在任意一台服务器上;站点不装 Agent,由你电脑上的客户端远程连站点数据库写入。

  1. 任意服务器装节点
  2. 电脑上装客户端并登录
  3. 客户端「直连站点」页添加
看直连站点说明 →
INSTALL

下载安装:四步接入第一个站

只有客户端需要下载安装包;服务器上的程序都用一条命令安装,脚本会自动选对系统和架构。

1

装节点

在节点服务器上

Linux x86_64 / ARM64(CentOS 7+、Ubuntu、Debian 等,宝塔、1Panel 或纯命令行都可以)或 Windows Server 2016+;建议 2 核 · 2 GB 内存 · 10 GB 磁盘。

  1. 执行安装命令

    以 root 登录 SSH(用面板的话,可以用面板里的「终端」):

    $ curl -fsSL https://zs.zhaozy.org/install.sh | bash -s -- --role node

    按提示填写服务器的公网 IP 或域名(可留空)。

  2. 放行端口

    云服务器安全组、面板的安全或防火墙页、系统防火墙都放行 TCP 8443。

  3. 记下登录信息

    API Key 和证书指纹在 /opt/zzs/node/initial-apikey.txt(Windows:C:\zzs\node\initial-apikey.txt),登录后删除该文件。

有域名、想让浏览器不提示「不安全」:见常见问题「想用域名访问节点」。

2

登录后台

在你的电脑上

用浏览器打开 https://服务器IP:8443 就能管理(提示「不安全」是自签证书,连接本身加密,手动继续即可);也可以下载客户端,功能相同,多了托盘告警提醒。

你的系统

macOS 客户端

Apple 芯片与 Intel 通用 · macOS 11 及以上

下载 dmg

第一次打开要放行一次(没有苹果付费证书签名),之后正常使用、自动更新:

  • 把「找资源助手」拖进应用程序,双击打开;提示无法验证开发者时点完成
  • 打开系统设置 → 隐私与安全性,在下方点仍要打开,输入开机密码
  • 提示「已损坏」或找不到按钮:在「终端」执行下面这条后再打开
xattr -dr com.apple.quarantine /Applications/找资源助手.app
你的系统

Windows 客户端

Windows 10 / 11 · 64 位

下载安装程序

第一次安装要放行一次(没有微软付费证书签名):

  • 双击安装程序,出现「Windows 已保护你的电脑」
  • 点更多信息→仍要运行,按提示装完
  • 从开始菜单打开「找资源助手」

客户端登录:填节点地址 https://服务器IP:8443,点「读取」获取证书指纹,和 initial-apikey.txt 里的指纹逐位核对一致后,再填 API Key。关闭窗口时客户端缩到托盘继续提醒告警,退出用托盘菜单。

3

准备片库

在节点后台里点只需一次

第一次登录后按看板顶部「完成初始设置」走,先选数据源:

官方推荐 · 内置

巨量资源

已适配好、有官方资源包:「资源包」页导入(几分钟,已填好官方链接,直接点「开始导入」);或「采集任务」页「首次全量采集」(较慢,可停止、继续)。

官方资源包:读取中…

也可以

自定义资源站

填其他苹果 CMS 资源站的采集接口(只支持 https),节点从头采集。之后一个站点可以同时用多个资源站,同一部片只有一条、线路合并。

4

接入站点:装 Agent

在每台站点服务器上

每个苹果 CMS 站点装一次(同一台服务器上有多个站时各装一次;只有一个站时就装在节点那台)。站点服务器不用开放任何端口。

  1. 生成接入令牌

    节点后台看板右上角「接入站点」(或「接入令牌」页),填站名;节点地址填站点服务器能访问到的地址。令牌只显示一次,每个站点一个。

  2. 停用巨量的定时采集

    在苹果 CMS 后台停掉巨量资源的定时采集任务,否则会重复入库,Agent 会拒绝写库。

  3. 安装 Agent(令牌在提示时粘贴,不显示也不会留在命令历史里)
    $ curl -fsSL https://zs.zhaozy.org/install.sh | bash -s -- --role agent

    按提示填写苹果 CMS 根目录(如 /www/wwwroot/站点)和令牌。脚本会先做只读体检。

    问「现在修复字符集?」时建议输入 yes:否则生僻字、emoji 会被过滤,事后补不回来。修复前建议先备份数据库。

  4. 对照分类

    站点详情「同步策略 → 分类对照 → 编辑」,点「自动对照」,把巨量分类对上本站已有栏目。只有对不上的才点「在本站创建缺少的分类」(按巨量的名字新增栏目,已有栏目不改、不删)。没点「保存并下发」之前可以「撤销」。没对照上的分类不会同步。

  5. 首次同步

    空站点「一键首导」(选节点上的资源包,或填 https://zs.zhaozy.org/packs/juliang/latest.json);站上已有数据先到「认领」页生成报告并执行,无法自动区分的在「冲突处理」页逐条处理。之后节点每次采集,所有站点自动同步。

虚拟主机等装不了程序的站点:不装 Agent,在客户端「直连站点」页添加,由你的电脑远程连接对方 MySQL 写库(需对方开放远程数据库,较慢,有安全风险)。

苹果 CMS 后台插件 可选

在站点自己的后台查看同步状态(只读):在线情况、落后条数、最近错误、认领冲突数。需要本机已装 Agent。

  1. 后台应用 → 插件管理 → 本地安装上传 zip(或解压后把 zzsync 目录放到站点的 addons/ 下;用 root 解压、上传的,把它的所有者改成网站用户,如宝塔的 www)。

  2. 启用「找资源助手」,后台左侧「快捷菜单」里打开。提示「写不进 …」时见常见问题。

下载插件

升级与卸载

在客户端里一键升级(推荐):侧边栏底部常驻版本号,有新版本时变蓝。「版本与更新」页:客户端「下载并重启」、「升级节点」、「升级全部站点」。更新包都经过签名校验,节点、Agent 由系统服务自动重启。

命令行(兜底):

curl -fsSL https://zs.zhaozy.org/install.sh | bash -s -- --upgrade

卸载:把 --upgrade 换成 --uninstall(保留数据)。Windows 用 -Upgrade / -Uninstall。

VIDEOS

视频教程

跟着视频装一遍,十几分钟接入第一个站。

HELP

帮助中心

下面没有你的问题,或想提建议:加入 Telegram 交流群 https://t.me/zhaozycjzs

加入交流群

下载与登录

macOS 提示「已损坏,无法打开」

没有苹果付费证书签名,系统会拦截从网上下载的程序。在「终端」执行 xattr -dr com.apple.quarantine /Applications/找资源助手.app 后再打开。只对从本站下载的安装包这样做。

macOS 更新时提示「客户端正在安装包(dmg)里…」

你打开的是安装包里的那份(安装包没推出时,从启动台、聚焦搜索或程序坞打开可能选中它)。从菜单栏图标「退出」,推出安装包并删除 dmg,从「应用程序」文件夹打开后再更新(中文名字排在列表后面)。仍然提示时,在「终端」执行 xattr -dr com.apple.quarantine /Applications/找资源助手.app 后再打开。

Windows 提示「Windows 已保护你的电脑」

没有微软付费证书签名。点「更多信息」→「仍要运行」即可。

浏览器打开节点后台提示「不安全」

节点默认用自签证书,连接本身是加密的,手动继续即可。用客户端登录时会按证书指纹锁定节点,更安全。

客户端连不上节点

检查安全组 / 防火墙是否放行 TCP 8443,节点服务是否在运行(Linux:systemctl status zzs-node)。

想用域名访问节点

不用域名也能直接用,连接同样加密。想让浏览器正常显示,安装节点时二选一:

反向代理(推荐):命令后加 --tls-mode proxy --domain 你的域名,节点只监听本机。在面板或 Nginx 中为该域名申请 SSL,反向代理到 http://127.0.0.1:8443,并加上(节点的长连接需要):

proxy_buffering off;
proxy_read_timeout 1h;
proxy_set_header X-Forwarded-For $remote_addr;

证书文件:命令后加 --tls-mode file --domain 你的域名 --cert 证书.pem --key 私钥.pem,证书续期后自动加载。

用域名时,接入令牌的节点地址填 https://域名(反向代理)或 https://域名:8443(证书文件),客户端登录时证书指纹留空。Windows 对应参数为 -TlsMode、-Domain、-Cert、-Key。

站点同步与资源站

站点显示「暂不满足写库条件」

看板会写出具体原因,常见的是巨量的定时采集还开着、播放器没有登记。处理好后一分钟内自动恢复,不用重装。

能用巨量以外的资源站吗

可以。巨量资源是官方推荐、已内置适配的数据源(有官方资源包,几分钟装好);其他苹果 CMS 资源站在客户端「采集任务」→「新建采集任务」里填它的采集接口(只支持 https),测试通过后采集。站点在「同步策略 → 数据源」里启用:选一个主数据源负责片名、简介等资料,其他资源站可以只补线路或也新增片。启用前先在苹果 CMS 后台「视频 → 播放器」登记它的线路编码。

后台插件

启用插件提示「网站运行用户写不进 addons/zzsync/info.ini」

插件文件不属于网站的运行用户(PHP 进程,宝塔一般是 www),PHP 改不了它们,插件就拒绝启用、保持原状。常见原因是用 root 解压或上传了插件。下面三种办法任选一种,改好后在插件管理里再点一次「启用」:

宝塔面板:「文件」里进入站点根目录,在 addons/zzsync 文件夹上右键 →「权限」→ 所有者选 www,勾选「应用到子目录」后保存;提示里还列出了别的文件(如 application/extra/quickmenu.php、application/extra/addons.php、static/js/addons.js)时,照样把所有者改成 www。

命令:在站点根目录执行(提示里写的用户名是什么就填什么,下面以 www 为例):

chown -R www addons/zzsync application/extra/quickmenu.php application/extra/addons.php static/js/addons.js

节点后台一键修复(站点装了 Agent 时):不用装客户端,浏览器打开 https://节点IP:8443 用 API Key 登录,站点详情 →「体检报告」→「后台插件文件权限」→「一键修复」。

升级、数据与版本

升级后显示「需手动重启」

程序已经替换好,但节点 / Agent 不是由系统服务运行的。用安装脚本安装的会自动重启;用宝塔进程守护、Docker 等方式运行时,在启动命令后加 --supervised。

软件会发送哪些数据

匿名统计:采集节点每天发送一次程序版本、系统、站点数量,以及安装、升级的次数,用于统计有多少站点在用。不带任何 ID,不包含域名、IP、站名、数据库信息和影片数据。

错误报告(默认关闭):在客户端「设置」里可以打开,只用于定位问题、优化软件;发送前会去掉域名、IP、数据库地址与账号、密码、令牌、文件路径,「设置」页可以查看最近一次发送的内容。站点服务器上的 Agent 不直接连外网,数据都由采集节点统一发送。

更新说明

读取中…

本版本全部文件与校验

服务器程序由安装脚本自动选择,一般不需要手动下载。校验清单 SHA256SUMS 由官方私钥签名(SHA256SUMS.sig)。

读取中…

装的过程中卡住了?

到交流群里问,附上看板或安装脚本的提示文字,回复更快。

加入 Telegram 交流群