Skip to content

列表分组、排序、批量操作与复制 ​

条目较多的列表都可以分组、手动排序、搜索和批量操作,操作方式在各页面一致。顺序和分组只影响管理界面的显示,修改后不会重启运行中的实例,也不会断开连接。

支持的列表 ​

页面列表
动态域名任务;任务内的解析记录
STUN 穿透规则
端口转发规则
SSL 证书证书
Web 服务监听内的站点(监听本身可上移、下移)
WAF 防火墙实例
入侵防护日志规则
frpfrpc 实例、frps 实例、代理
Cloudflare 隧道隧道
File Browser实例
存储挂载挂载
网络唤醒设备
计划任务任务
通知中心渠道、规则
Web 终端保存的连接
API 令牌令牌

这些列表大多同时提供卡片视图与紧凑视图,在列表右上角切换;窄屏下固定为卡片视图。

分组 ​

在编辑对话框中填写「分组」(最长 64 个字符,可从已有分组中选择),留空为未分组。只要有一个条目设置了分组,列表就按分组显示可折叠的区块:分组按首次出现的顺序排列,未分组的条目排在最后,各分组的折叠状态保存在浏览器中。搜索框可按名称、分组、备注等过滤条目,搜索时展开全部分组。

鼠标移到分组标题上,点铅笔按钮可以重命名分组:组内条目一起改为新名称,位置和顺序不变;改成已有分组的名称时,确认后两个分组合并。

排序模式 ​

点击「排序与批量」进入排序模式,此时显示全部条目,搜索与筛选暂不生效:

  • 用箭头在分组内上移、下移条目,或在分组标题上整组移动;
  • 桌面端可以直接拖动条目;拖到其他分组的条目或分组标题上即加入该分组;
  • 勾选多个条目(分组标题的复选框可选中整组)后拖动其中任一项,所有选中项按当前顺序一起移动;
  • 工具栏可以把选中的条目批量移到指定分组,留空则移出分组。

手机等窄屏设备不支持拖动,用箭头和工具栏完成同样的操作。

批量操作 ​

在排序模式下勾选条目后,工具栏还可以:

  • 启用 / 停用:一次保存全部选中条目,已经是目标状态的条目不会重启;
  • 删除:确认对话框会列出将删除的条目,删除后无法恢复。任一条目不允许删除(例如证书仍被站点引用)时一个都不删,并提示原因。

批量操作一次最多处理 500 个条目,全部校验通过才保存,任一条目失败都不做修改。网络唤醒设备没有启用开关,只提供批量删除;API 令牌暂不提供批量启停与删除。Web 服务另有批量修改域名与选项,见 Web 服务。站点还可以移到其他监听,见 移动站点。

复制条目 ​

除 API 令牌外,上表中的条目都可以「复制」,另外订阅 IP 列表、备份目的地、Web 终端的认证预设、动态域名任务内的解析记录与 Web 服务监听内的站点也可以复制:点击条目上的「复制」,以它为模板打开新增对话框,名称自动加上「副本」后缀,改好需要区分的设置后保存即新增一条,原条目不受影响,副本排在原条目之后。

  • 密钥沿用原条目:密码、令牌、私钥等已保存的密钥在对话框中保持脱敏,不修改就沿用原条目的值,明文不经过浏览器;点眼睛按钮可以查看原条目的明文。Web 终端的连接与认证预设需要先通过用户协议与二次验证才能沿用密钥。
  • 系统维护的内容不复制:ACME 申请和从文件读取的证书会按副本的设置重新签发或读取,上传的证书连同私钥一起复制;证书的部署记录清空;订阅 IP 列表重新下载;站点的分享链接不复制,因为其令牌可以绕过认证。
  • 证书的部署目标:副本中的部署目标先停用,避免写到与原证书相同的文件,确认文件名不冲突后再启用。
  • Web 服务:复制站点时可以选择放到其他监听下(例如从 HTTP 监听复制到 HTTPS 监听);复制监听时可以选择是否同时复制其中的站点。
  • 副本保持原条目的启用状态,保存前记得修改端口、域名、记录等需要区分的设置,避免与原条目冲突。

各页面的补充说明 ​

  • 动态域名:任务卡片上的「记录排序」打开对话框,调整该任务内解析记录的顺序与分组,保存后立即生效,不会重新同步;编辑任务时也可在「解析记录」页签中打开同一对话框,随任务一起保存。记录设置了分组时,卡片中的记录按分组显示,每组可以单独收起。
  • frp:代理列表可以按 frpc 实例筛选;排序模式下显示全部代理,调整的是完整顺序。
  • API 令牌:未手动排序前按创建时间从新到旧显示;调整过顺序后按保存的顺序显示,新建的令牌排在最前。
  • 认证用户:「使用共享用户的站点」按监听显示,监听内的站点再按 Web 服务中的分组归类;监听和分组都可以单独收起,工具栏可一键全部收起或展开。

接口 ​

通用列表接口都提供 PUT <列表路径>-order(请求体 {"keys": [...]},须包含全部条目)调整顺序,PUT <列表路径>-group(请求体 {"keys": [...], "group": "..."})批量设置分组,PUT <列表路径>-enable(请求体 {"keys": [...], "enable": true})批量启停,POST <列表路径>-delete(请求体 {"keys": [...]})批量删除,例如 PUT /api/stun/rules-group、POST /api/portforward/rules-delete。DDNS 任务内的记录使用 PUT /api/ddns/tasks/{key}/records-layout,API 令牌使用 PUT /api/tokens/order 与 PUT /api/tokens/group。详见接口清单。

复制条目使用 POST <列表路径>/{key}/copy,请求体为新条目,仍为占位符 ******** 的密钥沿用 {key} 条目的值,例如 POST /api/frp/clients/{key}/copy。

以 Apache-2.0 许可证开源发布。