Nexus/docs/changelog/2026-06-07-settings-ip-allowlist-subscription.md

Changelog — 设置页恢复 IP 白名单订阅功能

日期：2026-06-07

摘要

Vue SPA 设置页补回代理订阅 URL、解析预览、订阅节点展示，并修正 POST /settings/ip-allowlist 请求体（manual_ips + subscription_url）。

动机

迁移后 IP 白名单仅保留合并 textarea + 错误 payload { ips }，订阅 URL 无法配置，与后端 IpAllowlistSaveRequest 及 parse-subscription 脱节。

涉及文件

• frontend/src/pages/SettingsPage.vue
• frontend/src/types/api.ts

行为

• 订阅 URL 输入 +「解析预览」→ POST /settings/ip-allowlist/parse-subscription
• 保存 → { manual_ips, subscription_url, enabled }，触发后台 2h 刷新
• 展示订阅节点 chip 与 last_refresh
• toggle 改用 query ?enabled=（对齐 FastAPI 参数）

验证

cd frontend && npx vite build；设置页配置订阅 URL → 解析预览 → 保存 → 刷新后见订阅节点。