From c10bb488d6886c4ed99171ccecfe6ed249b4fa10 Mon Sep 17 00:00:00 2001 From: stqfdyr <89149493+stqfdyr@users.noreply.github.com> Date: Fri, 2 Oct 2026 20:39:40 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=E8=8A=82=E7=82=B9=E7=9A=84?= =?UTF-8?q?=E5=85=AC=E5=BC=80=E5=A4=87=E6=B3=A8=EF=BC=9B=E7=99=BB=E5=BD=95?= =?UTF-8?q?=E5=90=8E=E6=8E=A5=E5=8F=A3=E8=BF=94=E5=9B=9E=E7=A7=81=E6=9C=89?= =?UTF-8?q?=E5=A4=87=E6=B3=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/config/nodes.mdx | 7 ++++--- src/content/dev/theme.mdx | 10 ++++++++++ 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/src/content/config/nodes.mdx b/src/content/config/nodes.mdx index bfa741e..747e9ce 100644 --- a/src/content/config/nodes.mdx +++ b/src/content/config/nodes.mdx @@ -7,14 +7,15 @@ |---|---| | 名称 | 公开可见 | | 分组 | 公开可见，见下文[分组](#分组) | -| 备注 | 只在后台显示 | +| 公开备注 | 公开可见，一行，最多 100 字。两个官方主题不显示，供第三方主题使用 | +| 备注 | 访客看不到；登录后在后台和公开页的节点详情里可见 | | 公开显示 | 关闭后节点只在后台出现，公开页和匿名接口里都没有它 | | 离线通知 | 掉线超过宽限期时推送，见[通知](/config/notify) | | 每月额度、计算方式、每月重置日、流量校正 | 见[流量统计](/config/traffic) | | IPv4、IPv6、国家/地区 | 留空为自动，见下文[地址与国家](#地址与国家) | -公开页能看到名称、分组、国家、系统与硬件信息、实时状态、流量、价格和到期日；地址、hostname、备注和 -token 只在后台。 +公开页能看到名称、分组、国家、系统与硬件信息、实时状态、流量、价格和到期日，第三方主题还可能显示公开备注； +地址、hostname、备注和 token 访客看不到，公开接口里也没有。 删除节点会连同它的历史数据一起删除，不可恢复。机器上的 agent 要另外卸载，见[卸载](/install/uninstall)。 diff --git a/src/content/dev/theme.mdx b/src/content/dev/theme.mdx index cd04a3d..5562645 100644 --- a/src/content/dev/theme.mdx +++ b/src/content/dev/theme.mdx @@ -153,6 +153,13 @@ const groups = [...new Set(nodes.map((n) => n.group ?? "").filter(Boolean))] - **分组可能有几十个。** 横排的标签要能滚动或换行 - 按分组切换时，汇总数字（在线数、流量、网速）跟着这一组算，不要一半跟着分组、一半是全站 +## 公开备注 + +每个节点带一个 `public_remark`：站长在面板上写给访客看的一行说明，最多 100 字，不含换行，空字符串表示 +没有。hub 1.3.1 及更早没有这个 key，按空字符串处理。按纯文本渲染。 + +站长的私有备注是另一个 key `remark`，访客拿不到，见下文[匿名拿不到什么](#匿名拿不到什么)。 + ## 主题设置 公告、布局、显示哪些区块这类**整个站点共用**的选项，在 `theme.json` 的 `config` 里声明。面板**主题**页的 @@ -354,6 +361,9 @@ body 是整个设置对象，会替换已保存的那份，规则和面板相同 指标部分走白名单：内核原始计数器 `net_rx_total`、`net_tx_total` 和 `boot_id` 谁都拿不到，`iface` 和地址 一样只在登录后返回。`metrics` 里的 `total_rx`、`total_tx`、`month_rx`、`month_tx` 由 hub 填入，与顶层同名字段相同。 +站长登录后，`/api/nodes` 和 `/api/ws` 返回完整视图：`admin` 为 `true`，包括不公开的节点和上面这些 key。 +请求同源，浏览器自动带上登录凭据，主题不用额外处理，就能在站长登录时显示 `remark` 这类私有信息。 + 字段定义以 hub 的源码为准。写主题时按「这个 key 可能不存在」处理。 ## 三种要处理的状态 From 95190d9ac799569184f56fc1ca7bdfa468c1ef5e Mon Sep 17 00:00:00 2001 From: stqfdyr <89149493+stqfdyr@users.noreply.github.com> Date: Fri, 2 Oct 2026 20:59:11 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=E5=A4=87=E6=B3=A8=E6=94=B9?= =?UTF-8?q?=E7=A7=B0=E7=A7=81=E6=9C=89=E5=A4=87=E6=B3=A8=EF=BC=8C=E4=B8=8E?= =?UTF-8?q?=E9=9D=A2=E6=9D=BF=E4=B8=80=E8=87=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/config/nodes.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/config/nodes.mdx b/src/content/config/nodes.mdx index 747e9ce..37cac03 100644 --- a/src/content/config/nodes.mdx +++ b/src/content/config/nodes.mdx @@ -8,14 +8,14 @@ | 名称 | 公开可见 | | 分组 | 公开可见，见下文[分组](#分组) | | 公开备注 | 公开可见，一行，最多 100 字。两个官方主题不显示，供第三方主题使用 | -| 备注 | 访客看不到；登录后在后台和公开页的节点详情里可见 | +| 私有备注 | 访客看不到；登录后在后台和公开页的节点详情里可见 | | 公开显示 | 关闭后节点只在后台出现，公开页和匿名接口里都没有它 | | 离线通知 | 掉线超过宽限期时推送，见[通知](/config/notify) | | 每月额度、计算方式、每月重置日、流量校正 | 见[流量统计](/config/traffic) | | IPv4、IPv6、国家/地区 | 留空为自动，见下文[地址与国家](#地址与国家) | 公开页能看到名称、分组、国家、系统与硬件信息、实时状态、流量、价格和到期日，第三方主题还可能显示公开备注； -地址、hostname、备注和 token 访客看不到，公开接口里也没有。 +地址、hostname、私有备注和 token 访客看不到，公开接口里也没有。 删除节点会连同它的历史数据一起删除，不可恢复。机器上的 agent 要另外卸载，见[卸载](/install/uninstall)。 @@ -75,7 +75,7 @@ 分组名最多 13 个字，留空即未分组。输入框会列出已有的分组，点选即可，避免手打出写法不同的同名分组。 - 分组名和节点名一样**在公开页可见**。只想自己看的信息写在备注里。 + 分组名和节点名一样**在公开页可见**。只想自己看的信息写在私有备注里。 「分组」对话框里的节点选择器可以搜索、按分组筛选，「全选」「全不选」只作用于列出来的节点，所以这几件事