Skip to content

docs: 内网直连可以用明文、安装器 --host - #14

Merged
jacob-bytes merged 3 commits into
mainfrom
docs/private-plaintext-and-listen
Sep 30, 2026
Merged

jacob-bytes merged 3 commits into
mainfrom
docs/private-plaintext-and-listen

Conversation

@jacob-bytes

Copy link
Copy Markdown
Collaborator

配合 hub 的 A2/A3:

  • 新增「内网直连可以用明文」一节:判定条件(没有声明 X-Forwarded-Proto、且 hub 看到的客户端是私网地址)、--site 不必填、以及为什么反代部署漏不进来
  • 安装器参数表加 --host <addr>;「升级沿用」那句补上监听地址
  • 改掉三处会说反的话:guide/philosophy(「写死」→「默认」)、install/reverse-proxy(补上内网直连这种可能)、ai.mdx(原文「不要试图改成 0.0.0.0」——公网仍不建议,内网直连是受支持用法)

npm run lint / npm run build 通过,527 条内部链接与锚点全部解析(含新增小节的锚点)。

配合 hub 的两个改动(A2/A3):

- 新增「内网直连可以用明文」一节:判定条件(没有声明 `X-Forwarded-Proto`、且 hub 看到的客户端
  是私网地址)、`--site` 不必填、以及为什么反代部署不受影响
- 安装器参数表加 `--host <addr>`;升级沿用那句补上监听地址
- 改掉三处会说反的话:`guide/philosophy`(「写死」→「默认」并说明例外)、
  `install/reverse-proxy`(「添加节点能点说明是从 HTTPS 域名进的」→ 补上内网直连这种可能,
  并写明反代为什么漏不进来)、`ai.mdx`(原文「不要试图改成 0.0.0.0」——公网仍不建议,
  内网直连是受支持用法)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Failed ❌

View logs ↗
a4d0af0 2026-09-30T03:16:46.193Z View logs ↗

**`config/data.mdx`** 的「保留天数」一节重写:范围 1–365、默认 90;历史分两层——明细层固定
7 天(每分钟一行),汇总层按保留天数存**每小时一行**(均值、峰值、延迟中位数与丢包都留着,
只是没有分钟级抖动)。所以 7 → 90 天占用增长远小于十二倍;90 天/100 节点折叠并整理后实测
约 127 MiB(不折叠 1.77 GiB)。

并写明本批**唯一会删数据**的行为:原设成大于 365 的安装升级后按 365 算,更早的汇总会在之后
几次清理里被删掉(启动日志会写明),调小前先导出备份。

**`dev/architecture.mdx`** 的表加上 `metric_hour` / `ping_hour`,并把 `metric` / `ping_record`
一行的说明改成「先折叠再删」;表下补一段讲清三件事:一小时要等满两小时才折叠(agent 最慢
一小时上报一次)、`INSERT OR REPLACE` 使重复折叠只是重写、水位线持久化所以重启接着折;
以及**明细行只在它的小时已折叠之后才允许删**(汇总落后只会多占磁盘、不会少历史),
和两张表不在 `TABLES` 里(升级前的备份没有它们,必须仍能恢复)。

lint 干净、构建通过、21 个路由预渲染。
`dev/theme.mdx` 已经讲了窗口会被保留天数截短、别把「近 30 天」写死;缺的是主题作者现在
**可以直接读到**这个数:`GET /api/me` 的 `history_days`。

补一条要点 + 一个小例子:按它生成档位、**不要给出超过它的档位**(那会画出比所选窗口更短的图,
看起来像丢数据而不是像上限);这个字段是后来才有的,**旧 hub 不返回**,取不到时回退 7 天。
并指明默认主题的 `src/lib/ranges.ts` 可以直接照抄——那里逻辑与测试都有。
@jacob-bytes
jacob-bytes merged commit 6d49018 into main Sep 30, 2026
1 of 2 checks passed
@jacob-bytes
jacob-bytes deleted the docs/private-plaintext-and-listen branch September 30, 2026 15:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant