为多站站长做的采集方式
传统采集是每个站各自翻上万页、逐条入库;找资源助手把「采集」和「写站」分开:采集只做一次,写站在每台服务器本机完成。
采集一次,全站同步
一台节点采集,所有站点自动跟进;节点每 10 分钟增量一次,新片、更新、下架都同步到每个站。
快:29 万条约 9 分钟
首次全量接口采集约 9 分钟,断了能续采;空站导入全量约 38 秒,不再一页页翻。
不重复、不叠集
按资源 ID 对齐每一部片,不靠片名猜;站上已有数据先「认领」再同步,对不准的交给你选。
站点不用开端口
Agent 主动连接节点,站点服务器不开放任何端口;更新包都经过签名校验。
多个资源站,线路合并
官方推荐 · 内置 巨量资源装好即用;也可以添加其他苹果 CMS 资源站(只支持 https),同一部片只有一条、各家线路挂在一起。
能回到接入前
第一次写站前自动给视频表、分类表做快照,不满意几秒换回;节点、站点在客户端里一键升级。
均为实测:1.0 为站点原生采集巨量资源全量的日志记录;2.0 为节点首次全量采集与空站首次导入,实际耗时受网络、带宽与磁盘影响。目前已适配:苹果 CMS v10。
要装两样东西:一台节点 + 每个站一个 Agent
节点负责「采」,Agent 负责「写」。节点只装一台,所有站点共用;Agent 装在每个苹果 CMS 站点上,从节点领数据写进本站数据库。
资源站
数据来源。巨量资源已内置;也可以加其他苹果 CMS 资源站。
不用你装任何东西
采集节点
统一采集、保存一份完整片库、管理所有站点,自带网页管理后台。
装在:一台常开的 Linux / Windows 服务器(可以就是你的站点服务器)
苹果 CMS + 本站数据库
你的电脑:客户端 可选
在电脑上管理节点和所有站点。不装也行:浏览器打开节点后台,功能相同。
节点 ≈ 总仓库
以前每个站都自己去资源站「进货」;现在由节点统一进货、入库,各站从总仓库领货,资源站只被采一次。
Agent ≈ 每个站的入库员
常驻在站点服务器上,替你做以前「采集入库」那一步:主动去节点领数据,按本站的分类、线路设置写进苹果 CMS 数据库。
客户端 ≈ 遥控器 可选
装在你自己的电脑(macOS / Windows)上,管理节点和所有站点,有告警会提醒。
后台插件 ≈ 站内状态牌 可选
装进苹果 CMS 后台,在站点自己的后台看同步状态(只读),需本机已装 Agent。
你是哪种情况?
选一种,照着做。三种情况都只需要装一台节点,区别只在 Agent 装在哪。
装不了程序
虚拟主机 / 只有数据库
节点装在任意一台服务器上;站点不装 Agent,由你电脑上的客户端远程连站点数据库写入。
- 任意服务器装节点
- 电脑上装客户端并登录
- 客户端「直连站点」页添加
下载安装:四步接入第一个站
只有客户端需要下载安装包;服务器上的程序都用一条命令安装,脚本会自动选对系统和架构。
装节点
在节点服务器上Linux x86_64 / ARM64(CentOS 7+、Ubuntu、Debian 等,宝塔、1Panel 或纯命令行都可以)或 Windows Server 2016+;建议 2 核 · 2 GB 内存 · 10 GB 磁盘。
- 执行安装命令
以 root 登录 SSH(用面板的话,可以用面板里的「终端」):
$ curl -fsSL https://zs.zhaozy.org/install.sh | bash -s -- --role node按提示填写服务器的公网 IP 或域名(可留空)。
以管理员身份打开 PowerShell:
PS> & ([scriptblock]::Create((irm https://zs.zhaozy.org/install.ps1))) -Role node程序装在
C:\zzs,以 Windows 服务运行、开机自启。 - 放行端口
云服务器安全组、面板的安全或防火墙页、系统防火墙都放行 TCP 8443。
- 记下登录信息
API Key 和证书指纹在
/opt/zzs/node/initial-apikey.txt(Windows:C:\zzs\node\initial-apikey.txt),登录后删除该文件。
有域名、想让浏览器不提示「不安全」:见常见问题「想用域名访问节点」。
登录后台
在你的电脑上用浏览器打开 https://服务器IP:8443 就能管理(提示「不安全」是自签证书,连接本身加密,手动继续即可);也可以下载客户端,功能相同,多了托盘告警提醒。
macOS 客户端
下载 dmg第一次打开要放行一次(没有苹果付费证书签名),之后正常使用、自动更新:
- 把「找资源助手」拖进应用程序,双击打开;提示无法验证开发者时点完成
- 打开系统设置 → 隐私与安全性,在下方点仍要打开,输入开机密码
- 提示「已损坏」或找不到按钮:在「终端」执行下面这条后再打开
xattr -dr com.apple.quarantine /Applications/找资源助手.app
Windows 客户端
下载安装程序第一次安装要放行一次(没有微软付费证书签名):
- 双击安装程序,出现「Windows 已保护你的电脑」
- 点更多信息→仍要运行,按提示装完
- 从开始菜单打开「找资源助手」
客户端登录:填节点地址 https://服务器IP:8443,点「读取」获取证书指纹,和 initial-apikey.txt 里的指纹逐位核对一致后,再填 API Key。关闭窗口时客户端缩到托盘继续提醒告警,退出用托盘菜单。
准备片库
在节点后台里点只需一次第一次登录后按看板顶部「完成初始设置」走,先选数据源:
巨量资源
已适配好、有官方资源包:「资源包」页导入(几分钟,已填好官方链接,直接点「开始导入」);或「采集任务」页「首次全量采集」(较慢,可停止、继续)。
官方资源包:读取中…
自定义资源站
填其他苹果 CMS 资源站的采集接口(只支持 https),节点从头采集。之后一个站点可以同时用多个资源站,同一部片只有一条、线路合并。
接入站点:装 Agent
在每台站点服务器上每个苹果 CMS 站点装一次(同一台服务器上有多个站时各装一次;只有一个站时就装在节点那台)。站点服务器不用开放任何端口。
- 生成接入令牌
节点后台看板右上角「接入站点」(或「接入令牌」页),填站名;节点地址填站点服务器能访问到的地址。令牌只显示一次,每个站点一个。
- 停用巨量的定时采集
在苹果 CMS 后台停掉巨量资源的定时采集任务,否则会重复入库,Agent 会拒绝写库。
- 安装 Agent(令牌在提示时粘贴,不显示也不会留在命令历史里)
$ curl -fsSL https://zs.zhaozy.org/install.sh | bash -s -- --role agent按提示填写苹果 CMS 根目录(如
/www/wwwroot/站点)和令牌。脚本会先做只读体检。PS> & ([scriptblock]::Create((irm https://zs.zhaozy.org/install.ps1))) -Role agent -Site D:\www\站点以管理员身份运行 PowerShell,
-Site换成苹果 CMS 根目录。问「现在修复字符集?」时建议输入 yes:否则生僻字、emoji 会被过滤,事后补不回来。修复前建议先备份数据库。
- 对照分类
站点详情「同步策略 → 分类对照 → 编辑」,点「自动对照」,把巨量分类对上本站已有栏目。只有对不上的才点「在本站创建缺少的分类」(按巨量的名字新增栏目,已有栏目不改、不删)。没点「保存并下发」之前可以「撤销」。没对照上的分类不会同步。
- 首次同步
空站点「一键首导」(选节点上的资源包,或填
https://zs.zhaozy.org/packs/juliang/latest.json);站上已有数据先到「认领」页生成报告并执行,无法自动区分的在「冲突处理」页逐条处理。之后节点每次采集,所有站点自动同步。
虚拟主机等装不了程序的站点:不装 Agent,在客户端「直连站点」页添加,由你的电脑远程连接对方 MySQL 写库(需对方开放远程数据库,较慢,有安全风险)。
苹果 CMS 后台插件 可选
在站点自己的后台查看同步状态(只读):在线情况、落后条数、最近错误、认领冲突数。需要本机已装 Agent。
后台应用 → 插件管理 → 本地安装上传 zip(或解压后把
zzsync目录放到站点的addons/下;用 root 解压、上传的,把它的所有者改成网站用户,如宝塔的www)。启用「找资源助手」,后台左侧「快捷菜单」里打开。提示「写不进 …」时见常见问题。
升级与卸载
在客户端里一键升级(推荐):侧边栏底部常驻版本号,有新版本时变蓝。「版本与更新」页:客户端「下载并重启」、「升级节点」、「升级全部站点」。更新包都经过签名校验,节点、Agent 由系统服务自动重启。
命令行(兜底):
curl -fsSL https://zs.zhaozy.org/install.sh | bash -s -- --upgrade
卸载:把 --upgrade 换成 --uninstall(保留数据)。Windows 用 -Upgrade / -Uninstall。
视频教程
跟着视频装一遍,十几分钟接入第一个站。
帮助中心
下面没有你的问题,或想提建议:加入 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)。
| 读取中… |