Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

fix(config): 按应用服务协议生成 CloudDrive2 通知配置

longmeidaofa4b1626f1bb
diff --git a/docs/CLOUDDRIVE.md b/docs/CLOUDDRIVE.md
index 450c643a9..b74e9f0f3 100644
--- a/docs/CLOUDDRIVE.md
+++ b/docs/CLOUDDRIVE.md
@@ -113,7 +113,7 @@ Peach 不实时监视网盘目录,因为每列一次目录都是一次网络
注意事项:
-- 配置里的地址是 Peach 所在电脑的局域网地址。Peach 只接受本机和私有网络发来的通知,来自公网的请求一律忽略。
+- 配置里的地址是 Peach 所在电脑的局域网地址,协议和端口与应用服务一致:独立版局域网模式使用 HTTP,启用 TLS 的服务使用 HTTPS。Peach 只接受本机和私有网络发来的通知,来自公网的请求一律忽略。
- Windows 版 CloudDrive2 的编辑框会把换行存坏,列表里显示「无效」。解决办法:把这段配置存成一个 `.toml` 文件,放进 `%LOCALAPPDATA%\CloudDrive.WinUI\webhooks\`,然后重启 CloudDrive2。Webhooks 页的「刷新」不会重新读取这个文件夹。
- CloudDrive2 发通知时也走它自己的代理设置,代理要让局域网地址直连。
diff --git a/docs/REUSE.md b/docs/REUSE.md
index 24f5ee301..291e8af4a 100644
--- a/docs/REUSE.md
+++ b/docs/REUSE.md
@@ -619,6 +619,8 @@ A 盘垃圾隔离使用短名称 `peach-purge-<32 位 UUID>.peach-quarantine`,
| 本地 NFO 导入 | Kodi/Jellyfin NFO 协议(2026-09-06 核对 [Kodi](https://kodi.wiki/view/NFO_files/Movies)、[Jellyfin](https://jellyfin.org/docs/general/server/metadata/nfo/)),标准库 ElementTree,图片走项目固定版 Pillow;实现在 `library_nfo.py` | 只适配影片、单集与音乐视频(整剧、专辑、播放记录与远端图片引用不套用),拒绝 DTD、超大输入与越目录图片引用。同名边车优先,`movie.nfo` 与通用海报只用于单影片目录;正片和图片同属一组连号(`(1).mp4` 配 `(1).jpg`…)时同名图是图集的一张。已知内容词投影为中文标签,画质、促销、发行属性与演员编成丢弃,未收录的自定义标签保留;远端补厂牌、导演、发行商、时长与图片出处,人物主名精确一致时补 DMM id、假名、罗马字与首次头像,不替换演员真值。网络复用 R18 JSON 入口、SourceTransport、头像缓存与封面解析器。候选按资产 ID 与路径定位,批准时复核目标,时长证据不覆盖探测时长(ADR-0029) |
| JAV 高清封面 | Javinizer-Go `dd56998328d078c9baf68ff4fde2e6fcaa2a691a`(MIT)的 DMM modern `awsimgsrc.dmm.com/dig/...` 映射与尺寸门槛;Prestige 公开 API 的查询模型参考 MDCX `58e3f930f2e864fceb8a53ceef818716e2a6413d`(GPL-3.0,只作协议证据) | 候选、Range 量尺寸、面积最大者胜出与仅更大才原子升级见 `peach-jav-cover-workflow`。批量流程不请求社区来源,历史快照里的社区站只借厂牌;既有库采集在官方落空时经 `peach.community_catalog` 查 AVBase(取商品号认得出这个番号的店铺条目,名寄せ的标题可能来自合集)、JavBus 与 JavDB,两个图源先按 dHash 求一致,取景不同时用 OpenCV ORB(相似变换内点 ≥60 算同一张)。JavDB 只参与复核,不作为安装候选;其他单一图源留空 `verified_by`,遇验证页不绕过(ADR-0107)。MDC-NG 只证明 Amazon 日本渠道存在,只留 POC 候选。不写 ledger |
+CloudDrive2 配置生成复用现有 TOML 模板、mDNS 公布地址和应用服务设置。HTTP 与 HTTPS 按各自默认端口生成 origin,非默认端口完整保留;配置读取、保存与更换密钥共用生成函数。该差异属于 Peach 部署配置,无需引入协议库或新增依赖;模板沿用现有 CloudDrive2 结构。回归用临时服务验证 HTTP 通知接收、密钥和来源校验,真实 ledger 与生产监听设置不参与验证。
+
依赖的第一个消费者及其隔离测试必须在同一改动落地,否则不引入依赖。
表里没有单列的 Python 依赖及首个消费者:`numpy`(vision 组,`face_detect.decode` 直接 import)、`socksio`(PikPak 的 SOCKS 代理)、
`opencc==1.4.2`(naming 组,`harvest_javdb_cn_names` 繁转简与字形表复核)、`psutil`(开发依赖,`agent_worktree.py processes`)。前端每个包的用途见 [前端岛层](FRONTEND.md#依赖清单),引入时机按 ADR-0031「前端基础库」。
diff --git a/frontend/src/react/settings/push-discovery-settings.tsx b/frontend/src/react/settings/push-discovery-settings.tsx
index ecc665b1c..db41fb406 100644
--- a/frontend/src/react/settings/push-discovery-settings.tsx
+++ b/frontend/src/react/settings/push-discovery-settings.tsx
@@ -96,7 +96,7 @@ export function PushDiscoveryForm({ initial, receipt }: {
? '贴进 CloudDrive2「设置 → Webhooks」,需要会员;更换密钥后要重贴。'
: live.origin
? '还没有共享密钥,保存配置后生成。'
- : '要先有 CloudDrive2 能访问的 HTTPS 地址才能生成。'}>
+ : '要先有 CloudDrive2 能访问的局域网地址才能生成。'}>
</SettingsRow>
) : null}
</Rows>
diff --git a/frontend/test/react/push-discovery.test.tsx b/frontend/test/react/push-discovery.test.tsx
index 13744b7b5..409657309 100644
--- a/frontend/test/react/push-discovery.test.tsx
+++ b/frontend/test/react/push-discovery.test.tsx
@@ -20,19 +20,21 @@ const clipboard = () => {
return writeText;
};
-it('配置块给的是服务端拼好的那一段,复制键把它整个写进剪贴板', async () => {
+it.each(['https://192.0.2.10', 'http://192.0.2.10:38473'])(
+ '%s 的配置块展示并复制服务端生成的完整配置', async (origin) => {
// 地址和密钥不再单独列成读数:抄两处就会抄漏一处,而 CloudDrive2 要的本来就是整段。
const writeText = clipboard();
const receipt = vi.fn();
- const host = await mount(<PushDiscoveryForm initial={state()} receipt={receipt} />);
+ const toml = TOML.replace('https://192.0.2.10', origin);
+ const host = await mount(<PushDiscoveryForm initial={state({ origin, config_toml: toml })} receipt={receipt} />);
// 卡片自己就是 `secondary`,代码块用同一档等于没有块——底色要比它亮一级才看得出来。
expect(host.querySelector('[data-code-block]')?.className).toContain('bg-background-tertiary-default');
- expect(host.querySelector('pre')?.textContent).toBe(TOML);
+ expect(host.querySelector('pre')?.textContent).toBe(toml);
expect(host.textContent).not.toContain('共享密钥');
expect(host.textContent).not.toContain('通知地址');
await click(buttonNamed('复制配置', host));
await settle();
- expect(writeText).toHaveBeenCalledWith(TOML);
+ expect(writeText).toHaveBeenCalledWith(toml);
expect(receipt).toHaveBeenCalledWith('已复制 CloudDrive2 配置');
});
@@ -51,12 +53,12 @@ it('配置块默认收起,横向滚动用全站的覆盖式滑块', async () =
expect(pre.parentElement?.querySelector('.ovtrack')).not.toBeNull();
});
-it('这台机器没有对外的 HTTPS 地址时说出原因,不发一段填了也不通的配置', async () => {
+it('这台机器没有局域网地址时说明生成条件', async () => {
const host = await mount(
<PushDiscoveryForm initial={state({ origin: '', config_toml: '' })} receipt={vi.fn()} />);
expect(host.querySelector('pre')).toBeNull();
expect(buttonNamed('复制配置', host)).toBeNull();
- expect(host.textContent).toContain('要先有 CloudDrive2 能访问的 HTTPS 地址');
+ expect(host.textContent).toContain('要先有 CloudDrive2 能访问的局域网地址');
});
it('配置块跟着已保存的开关走,拨一下不算数', async () => {
diff --git a/src/peach/push_discovery.py b/src/peach/push_discovery.py
index 1b888a11f..d46192ac0 100644
--- a/src/peach/push_discovery.py
+++ b/src/peach/push_discovery.py
@@ -201,8 +201,8 @@ body = '{"data": []}'
def clouddrive_config(origin: str, secret: str) -> str:
"""整段抄进 CloudDrive2 的配置文本。两样缺一样就给空串,页面据此说还不能抄。
- 地址只能是 HTTPS。80 口上那条服务对 `POST` 回的是 426 而不是重定向——跨 origin
- 的 307 会让 CloudDrive2 把密钥和正文原样再发一遍到另一个地址上。
+ 地址由配置接口按应用服务的协议与端口生成。源码部署的 HTTPS 应用入口与 HTTP
+ 跳转入口分开,后者对 `POST` 回 426;独立版的 HTTP 应用入口直接接收通知。
正文只留 Peach 要读的那四个字段,默认模板里的设备名、事件时间那些一概不要:
`parse_notification` 本来就忽略它们,少发一样东西就少一处能对不上的地方。
diff --git a/src/peach/routes_configuration.py b/src/peach/routes_configuration.py
index f67dd3db9..02c55d9dc 100644
--- a/src/peach/routes_configuration.py
+++ b/src/peach/routes_configuration.py
@@ -235,8 +235,8 @@ def push_discovery_payload(request: Request, payload: dict[str, Any] | None = No
地址不取这次请求的 origin:配置页多半是从回环地址打开的,而 TLS 那条服务只绑在
局域网地址上,把 `127.0.0.1` 抄过去 CloudDrive2 连不上。取这台机器对外公布的那个
- 地址,也就是 mDNS 登记的同一个。没开 TLS 或者不知道自己的地址时给空串,页面据此
- 说这段现在给不出来,而不是发一段填了也不通的配置出去。
+ 地址,也就是 mDNS 登记的同一个。协议与端口取实际应用服务的设置;独立版的局域网
+ 服务使用 HTTP,启用 TLS 的服务使用 HTTPS。不知道自己的地址时给空串。
"""
if payload is None:
payload = request.app.state.push_discovery.snapshot(reveal=True)
@@ -245,8 +245,9 @@ def push_discovery_payload(request: Request, payload: dict[str, Any] | None = No
address = str(getattr(mdns, "address", "") or settings.mdns_address or "").strip()
port = int(settings.mdns_port or 0)
origin = ""
- if settings.tls_enabled and address:
- origin = f"https://{address}" if port in (0, 443) else f"https://{address}:{port}"
+ if address:
+ scheme, default_port = ("https", 443) if settings.tls_enabled else ("http", 80)
+ origin = f"{scheme}://{address}" if port in (0, default_port) else f"{scheme}://{address}:{port}"
payload["origin"] = origin
payload["config_toml"] = push_discovery.clouddrive_config(origin, payload.get("secret", ""))
return payload
diff --git a/tests/test_push_discovery.py b/tests/test_push_discovery.py
index bf84a834e..5ef3a86c2 100644
--- a/tests/test_push_discovery.py
+++ b/tests/test_push_discovery.py
@@ -16,6 +16,7 @@ import threading
import time
import tomllib
import unittest
+from dataclasses import replace
from pathlib import Path, PureWindowsPath
from types import SimpleNamespace
from unittest import mock
@@ -164,11 +165,21 @@ class ConfigPagePayloadTests(unittest.TestCase):
payload = self._payload(self._request(port=8443))
self.assertEqual(payload["origin"], "https://192.0.2.10:8443")
- def test_without_tls_or_an_address_the_block_is_withheld_rather_than_guessed(self):
- """HTTP 的地址发出去就是白发:80 口那条服务对写请求回 426,不替它转发。"""
- for request in (self._request(tls=False), self._request(declared="", port=443)):
- with self.subTest(request=request):
- payload = self._payload(request)
+ def test_http_service_uses_its_published_address_and_listening_port(self):
+ for port, origin in ((38473, "http://198.51.100.7:38473"),
+ (80, "http://198.51.100.7"),
+ (443, "http://198.51.100.7:443")):
+ with self.subTest(port=port):
+ payload = self._payload(self._request(tls=False, published="198.51.100.7", port=port))
+ self.assertEqual(payload["origin"], origin)
+ config = tomllib.loads(payload["config_toml"])
+ self.assertEqual(config["global_params"]["base_url"], origin)
+ self.assertEqual(config["file_system_watcher"]["headers"][push.SECRET_HEADER], "tok")
+
+ def test_without_an_address_the_block_is_withheld(self):
+ for tls in (True, False):
+ with self.subTest(tls=tls):
+ payload = self._payload(self._request(tls=tls, declared=""))
self.assertEqual(payload["origin"], "")
self.assertEqual(payload["config_toml"], "")
@@ -581,6 +592,36 @@ class WebhookRouteTests(_ServiceCase):
_wait_for(lambda: path in self.rows())
self.assertEqual(self.rows().get(path), ("video", 5))
+ def test_http_configuration_saves_rotates_and_delivers_a_notification(self):
+ from fastapi.testclient import TestClient
+ origin = "http://127.0.0.1:38473"
+ self.app.state.settings = replace(
+ self.app.state.settings, mdns_address="127.0.0.1", mdns_port=38473, tls_enabled=False)
+ client = TestClient(self.app, base_url=origin, client=("127.0.0.1", 9000))
+ saved = client.post("/api/configuration/push-discovery", json={
+ "enabled": True, "watch_local": False, "cloud": True,
+ "prefixes": [{"prefix": "/115", "root": self.declared["115"][0]}]})
+ self.assertEqual(saved.status_code, 200, saved.text)
+ self.assertEqual(saved.json()["origin"], origin)
+ rotated = client.post("/api/configuration/push-discovery/secret")
+ self.assertEqual(rotated.status_code, 200, rotated.text)
+ payload = rotated.json()
+ config = tomllib.loads(payload["config_toml"])
+ self.assertEqual(config["global_params"]["base_url"], origin)
+ self.assertNotEqual(payload["secret"], saved.json()["secret"])
+ self.assertEqual(self.post(secret=saved.json()["secret"]).status_code, 404)
+ watcher = config["file_system_watcher"]
+ body = watcher["body"]
+ for placeholder, value in (("{action}", "create"), ("{is_dir}", "false"),
+ ("{source_file}", "/115/a.mp4"), ("{destination_file}", "")):
+ body = body.replace(placeholder, value)
+ response = client.post(watcher["url"].replace("{base_url}", origin),
+ headers=watcher["headers"], json=json.loads(body))
+ self.assertEqual(response.status_code, 204)
+ path = self.ledger("115", "a.mp4")
+ _wait_for(lambda: path in self.rows())
+ self.assertEqual(self.rows().get(path), ("video", 5))
+
def test_a_wrong_or_missing_secret_is_refused_without_admitting_the_endpoint(self):
for supplied in (None, "", self.secret + "x"):
with self.subTest(supplied=supplied):
diff --git a/web/dist/peach-app.js b/web/dist/peach-app.js
index 6208cf3ff..3c6aad50b 100644
--- a/web/dist/peach-app.js
+++ b/web/dist/peach-app.js
@@ -75144,7 +75144,7 @@ function jIe({ initial: e, receipt: t }) {
}),
u.enabled && u.cloud ? /* @__PURE__ */ (0, C.jsx)(hA, {
label: "Webhook 配置",
- description: u.config_toml ? "贴进 CloudDrive2「设置 → Webhooks」,需要会员;更换密钥后要重贴。" : u.origin ? "还没有共享密钥,保存配置后生成。" : "要先有 CloudDrive2 能访问的 HTTPS 地址才能生成。"
+ description: u.config_toml ? "贴进 CloudDrive2「设置 → Webhooks」,需要会员;更换密钥后要重贴。" : u.origin ? "还没有共享密钥,保存配置后生成。" : "要先有 CloudDrive2 能访问的局域网地址才能生成。"
}) : null
] }),
u.enabled && u.cloud && u.config_toml ? /* @__PURE__ */ (0, C.jsx)(bA, {