Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions src/content/config/nodes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,15 @@
|---|---|
| 名称 | 公开可见 |
| 分组 | 公开可见,见下文[分组](#分组) |
| 备注 | 只在后台显示 |
| 公开备注 | 公开可见,一行,最多 100 字。两个官方主题不显示,供第三方主题使用 |
| 私有备注 | 访客看不到;登录后在后台和公开页的节点详情里可见 |
| 公开显示 | 关闭后节点只在后台出现,公开页和匿名接口里都没有它 |
| 离线通知 | 掉线超过宽限期时推送,见[通知](/config/notify) |
| 每月额度、计算方式、每月重置日、流量校正 | 见[流量统计](/config/traffic) |
| IPv4、IPv6、国家/地区 | 留空为自动,见下文[地址与国家](#地址与国家) |

公开页能看到名称、分组、国家、系统与硬件信息、实时状态、流量、价格和到期日;地址、hostname、备注和
token 只在后台。
公开页能看到名称、分组、国家、系统与硬件信息、实时状态、流量、价格和到期日,第三方主题还可能显示公开备注;
地址、hostname、私有备注和 token 访客看不到,公开接口里也没有。

删除节点会连同它的历史数据一起删除,不可恢复。机器上的 agent 要另外卸载,见[卸载](/install/uninstall)。

Expand Down Expand Up @@ -74,7 +75,7 @@ token 只在后台。
分组名最多 13 个字,留空即未分组。输入框会列出已有的分组,点选即可,避免手打出写法不同的同名分组。

<Note warn>
分组名和节点名一样**在公开页可见**。只想自己看的信息写在备注里。
分组名和节点名一样**在公开页可见**。只想自己看的信息写在私有备注里。
</Note>

「分组」对话框里的节点选择器可以搜索、按分组筛选,「全选」「全不选」只作用于列出来的节点,所以这几件事
Expand Down
10 changes: 10 additions & 0 deletions src/content/dev/theme.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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` 里声明。面板**主题**页的
Expand Down Expand Up @@ -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 可能不存在」处理。

## 三种要处理的状态
Expand Down
Loading