diff --git a/src/content/config/nodes.mdx b/src/content/config/nodes.mdx index bfa741e..37cac03 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)。 @@ -74,7 +75,7 @@ token 只在后台。 分组名最多 13 个字，留空即未分组。输入框会列出已有的分组，点选即可，避免手打出写法不同的同名分组。 - 分组名和节点名一样**在公开页可见**。只想自己看的信息写在备注里。 + 分组名和节点名一样**在公开页可见**。只想自己看的信息写在私有备注里。 「分组」对话框里的节点选择器可以搜索、按分组筛选，「全选」「全不选」只作用于列出来的节点，所以这几件事 diff --git a/src/content/dev/theme.mdx b/src/content/dev/theme.mdx index c1bfe72..038e845 100644 --- a/src/content/dev/theme.mdx +++ b/src/content/dev/theme.mdx @@ -206,6 +206,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` 里声明。面板**主题**页的 @@ -407,6 +414,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 可能不存在」处理。 ## 三种要处理的状态