platform_admin/bootstrap-public
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: record native bootstrap validation and Headscale tag contract

Browse Source
This commit is contained in:
kaka
2026-11-04 07:18:59 +08:00
parent 0b18353a2b
commit f5f6104b7a
1 changed files with 9 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
README.md
View File

@@ -1,7 +1,7 @@
# 原生 Shell 安装入口 # 原生 Shell 安装入口
这里直接维护 Bash 源码，由 Gitea 保存版本，Caddy 提供 HTTPS 下载。无需 Python 安装载荷。 这里直接维护 Bash 源码，由 Gitea 保存版本，Caddy 提供 HTTPS 下载。无需 Python 安装载荷。
当前已完成本地实现，尚未在真实 Debian 主机和实际 Caddy 域名验收。 已在实际 Caddy HTTPS 域名、一个测试宿主机和三个 Debian 13 VM 验证固定 release、Periphery/Core 接入、Docker 和 Headscale。Debian 12 升级与 SSH 管理密钥切换仍未真机验证；逐项证据在 platform 的验收记录中维护。
## Debian 13 接入 Komodo ## Debian 13 接入 Komodo
@@ -11,7 +11,7 @@
apt update && apt install -y curl ca-certificates apt update && apt install -y curl ca-certificates
``` ```
以下为域名占位示例；正式域名在控制机部署后替换： 以下为域名占位示例；部署时替换为该环境的实际域名：
```bash ```bash
curl -fsSL 'https://scripts.example.com/releases/<40位小写Git提交>/install.sh' | bash -s -- \ curl -fsSL 'https://scripts.example.com/releases/<40位小写Git提交>/install.sh' | bash -s -- \
@@ -29,6 +29,12 @@ curl -fsSL 'https://scripts.example.com/releases/<40位小写Git提交>/install.
Docker、Headscale、公钥注入和安全配置后续由 Komodo 任务处理。没有 Core API 凭据下发。 Docker、Headscale、公钥注入和安全配置后续由 Komodo 任务处理。没有 Core API 凭据下发。
已有身份、配置或二进制不符时停止，不自动替换身份。源文件可直接 bash install.sh --help。 已有身份、配置或二进制不符时停止，不自动替换身份。源文件可直接 bash install.sh --help。
## Headscale 接入
`tailscale.sh` 使用显式版本、已准备的本地 DEB、SHA-256、HTTPS 控制端和节点名称。首次接入还需 root 所有、0600 权限的短期单次授权 key 文件；执行后清除临时 key 文件。既有 Running 节点直接复核身份，不需要新 key。
Headscale 0.29.6 从预授权 key 授予节点标签，拒绝预授权注册请求同时携带客户端 `--advertise-tags`。在控制端创建 key 时指定授权标签，`tailscale.sh --tags tag:NAME,...` 核对接入后实际获得的完整标签集合。控制端、名称或标签不一致时停止，不重置节点身份。服务 /32 地址、精确路由批准和业务访问另外验证。
## 独立手工升级 ## 独立手工升级
```bash ```bash
@@ -55,6 +61,6 @@ Caddy 同时提供 /install.sh 稳定入口与 /releases/<40位小写Git提交>/
`artifacts.lock` 是数据清单，每行三个制表符分隔字段：SHA-256、仓库内路径、准备时使用的上游 HTTPS URL。文件实际保存在 `vendor/<组件>/<版本>/<文件>`，与清单一同提交到 Gitea。目标机不读取上游 URL。 `artifacts.lock` 是数据清单，每行三个制表符分隔字段：SHA-256、仓库内路径、准备时使用的上游 HTTPS URL。文件实际保存在 `vendor/<组件>/<版本>/<文件>`，与清单一同提交到 Gitea。目标机不读取上游 URL。
当前包含 `vendor/komodo/2.3.4/periphery-x86_64`，不是空目录或下载占位符。控制端使用 platform 的 `control/vendor.sh --source <本仓库目录>` 准备资源，再用 `--check` 做完全离线校验。已有正确文件直接复用；摘要不符时停止，不静默覆盖。 当前包含 Periphery 2.3.4 x86_64、Tailscale 1.104.4 amd64 DEB 和 PG 扩展构建资源，准确路径、摘要与来源见 `artifacts.lock`。控制端使用 platform 的 `control/vendor.sh --source <本仓库目录>` 准备资源，再用 `--check` 做完全离线校验。已有正确文件直接复用；摘要不符时停止，不静默覆盖。
新增版本时增加新路径和已核实摘要，准备二进制，同步修改 install.sh 的固定版本/摘要，检查后提交发布。不得改写已发布版本文件；固定提交及其 Caddy release 用于同版本回退。版本维护单独执行。 新增版本时增加新路径和已核实摘要，准备二进制，同步修改 install.sh 的固定版本/摘要，检查后提交发布。不得改写已发布版本文件；固定提交及其 Caddy release 用于同版本回退。版本维护单独执行。