# http/ — 运维工具箱（公开静态托管）

本目录**不是**站点业务代码。它是挂在 `https://www.mgrsc.top/http/*` 下、供下载和
`curl` 安装的运维工具箱。

仓库根目录的 `Caddyfile` 配置的是**本站**。Caddy 安装辅助脚本在
`linux/caddy/`。

## 怎么选工具

| 目标 | 路径 | 入口 |
| --- | --- | --- |
| 安装 Caddy（binary / Docker） | `linux/caddy/` | 只跑 `install_caddy.sh` |
| Debian/Ubuntu 新机终端与 CLI | `linux/bootstrap/debian/` | 先 `00_` 再 `01_`；可选 `10_`–`12_` |
| 多 Compose 项目管理 | `linux/docker/cpman/` | `cpman.sh` |
| Docker named volume 冷备 | `linux/backup/docker-volumes/` | `docker_volume_cold_restic.sh` |
| 主机路径 restic 备份 | `linux/backup/paths/` | `restic_backup.sh` |
| MySQL / Postgres / SQLite 热备 | `linux/backup/databases/` | 各库脚本 |
| 添加 swap | `linux/system/swap/` | `add_swap.sh` |
| 系统校时 | `linux/system/time/` | `sync_system_time.sh` |
| k3s / kubectl shell | `linux/k3s/` | `setup.sh` |
| 简易多线程文件服务 | `linux/network/file-server/` | `file_server.py` |
| NTP 延迟探测 | `linux/network/ntp-probe/` | `ntp_test.py` |
| TCP ping | `linux/network/tcpping/` | `tcpping` |
| 编辑器 / 提示符 / 应用配置 | `linux/config/`、`windows/config/` | 仅复制 |
| 公开 WinRAR 配置 | `windows/config/winrar/` | `rarreg.key` |
| 软件包下载笔记 | `linux/notes/` | 仅 markdown |

备份选型见 [linux/backup/README.md](linux/backup/README.md)。

## 包约定

每个**工具包**结构：

```
<package>/
├── README.md              # 用途、何时用、唯一入口
├── <entry>.sh|.py         # 用户只跑这个
├── lib/                   # 可选；被 source 的库，不要直接跑
├── templates/             # 可选；安装器复制到目标机的文件
├── examples/              # 可选示例
└── config.example.env     # 可选；在目标机复制为运行时配置名
```

规则：

1. 只执行包 README 标明的入口。
2. 不要把 `lib/*` 当安装脚本执行。
3. 运行时凭据只放目标机（从 `*.example.env` 复制）。允许公开分发的授权与配置文件应放入对应场景包。
4. 语言（shell/Python）是实现细节；路径按**场景**分。

## 不应放在这里的内容

- 站点应用（`files_md/`、`tools/`、`book/`）
- 运行时密码、token、私钥或已填写的环境文件
- 本站生产 `Caddyfile`（在仓库根目录）