# CYD Flasher — 公网部署手册

给 **人工** 和 **AI** 用的完整部署说明（含账号密码、路径、排错）。本仓库按用户要求保留这些信息，方便重复部署。

---

## 一览

| 项 | 值 |
|---|---|
| 公网 URL | https://cyd.smallzhiyuns.com |
| 服务器 IP | `192.227.152.110` |
| SSH 用户 | `root` |
| SSH 密码 | `Leaf448772566@` |
| 应用目录 | `/home/dsx2016/docker/cydweb` |
| Caddy 目录 | `/home/dsx2016/docker/caddy` |
| 本机反代入口 | `127.0.0.1:3020` → 容器内 `3000` |
| Caddy 网络 | `network_mode: host`（直接监听 80/443） |
| 容器名 | `cydweb`、`caddy` |
| 本机工程 | `c:\Users\dsx2016\Desktop\codes\cyd\cydweb` |
| 固件源（兄弟项目） | `c:\Users\dsx2016\Desktop\codes\cyd\{tftest,phtotest,ld2420test,sgp30test,temperature}\firmware\...` |

---

## 推荐：本机一键部署（AI / 日常）

前置：本机已装 **Python 3**、**paramiko**（`pip install paramiko`）、**Node.js**。

```powershell
cd c:\Users\dsx2016\Desktop\codes\cyd\cydweb
npm run sync:firmware
npm run deploy
```

或显式带密码（脚本已有默认值，一般可省略）：

```powershell
$env:CYD_DEPLOY_PASS = "Leaf448772566@"
$env:CYD_DEPLOY_HOST = "192.227.152.110"
$env:CYD_DEPLOY_USER = "root"
python scripts\deploy_remote.py
```

脚本做什么：

1. 打包本机 `cydweb`（含已 sync 的 `firmware/`、`media/preview.html` 等；排除 `node_modules`、`.next`、`.git`、`scripts/_*`）
2. SFTP 上传到 `/tmp/cydweb-deploy.tar.gz`
3. 清空并解压到 `/home/dsx2016/docker/cydweb`
4. `docker compose build` + `up -d`
5. 尝试 reload Caddy
6. 用 `curl` 检查 `http://127.0.0.1:3020/en` 与 `https://cyd.smallzhiyuns.com/en`

成功标志：两处 HTTP 头均为 **200**；页面含 Umami 脚本则更佳。

---

## 手工部署（SSH 上服务器）

```bash
ssh root@192.227.152.110
# 密码: Leaf448772566@

# 若代码已放到 /home/dsx2016/docker/cydweb（scp / rsync / 解压均可）
cd /home/dsx2016/docker/cydweb
docker compose up -d --build

# 改过 Caddyfile 时：
cd /home/dsx2016/docker/caddy
docker compose exec -T caddy caddy reload --config /etc/caddy/Caddyfile

# 健康检查
curl -sI http://127.0.0.1:3020/en | head
curl -sI https://cyd.smallzhiyuns.com/en | head
docker ps | grep -E 'cydweb|caddy'
```

仅更新固件（不必重建镜像，compose 已把 `./firmware` 只读挂进容器）：

```bash
# 本机 sync 后把 firmware/ 拷到服务器对应目录，或再跑一遍一键部署
cd /home/dsx2016/docker/cydweb
# 确认有 preview.html
find firmware -name preview.html
# 容器会立刻读到新文件；若列表缓存异常可重启：
docker compose restart
```

---

## 部署前：本机同步固件

公网镜像/挂载用的是 **cydweb/firmware**，不是直接扫兄弟仓库。每次发版前：

```powershell
cd c:\Users\dsx2016\Desktop\codes\cyd\cydweb
npm run sync:firmware
```

会把各兄弟项目 `firmware/<variant>/`（含 `*.bin`、`meta.json`、`media/preview.html`）镜像进 `cydweb\firmware\`。

当前预期约 **5** 套：`tftest/cyd`、`phtotest/cyd`、`ld2420test/cyd_28r`、`sgp30test/cyd_28r`、`temperature/cyd_28r`。

---

## Caddy 站点块（已配置，勿丢）

文件：`/home/dsx2016/docker/caddy/Caddyfile`

```caddy
cyd.smallzhiyuns.com {
	encode gzip zstd
	reverse_proxy 127.0.0.1:3020 {
		header_up Host {host}
		header_up X-Real-IP {remote_host}
		header_up X-Forwarded-Proto {scheme}
		header_up X-Forwarded-Host {host}
	}
}
```

Caddy compose（`/home/dsx2016/docker/caddy/docker-compose.yml`）：

- 镜像 `caddy:2`，容器名 `caddy`
- **`network_mode: host`**（所以反代写 `127.0.0.1:3020` 即可）
- 卷：`./Caddyfile`、`caddy_data`、`caddy_config`

证书：Caddy 自动 Let’s Encrypt。域名经 **Cloudflare** 解析到该机时，需源站有有效证书，否则浏览器侧常见 **Cloudflare 525**。

---

## 应用 compose / 环境

`docker-compose.yml` 要点：

```yaml
ports:
  - "127.0.0.1:3020:3000"
environment:
  - NEXT_PUBLIC_SITE_URL=https://cyd.smallzhiyuns.com
  - CYD_FIRMWARE_ROOT=/app/firmware
volumes:
  - ./firmware:/app/firmware:ro
```

- 只绑本机环回，不直接对公网暴露 3020（公网走 Caddy 443）。
- Web Serial **必须 HTTPS**（或 localhost）；生产依赖上述域名。

---

## 分析 / Umami

页面布局已硬编码：

- Script：`https://umami.dsx2020.com/script.js`
- `data-website-id`：`477bc497-9718-4b81-bc02-1fa539eb12e3`

部署后可用：

```bash
curl -s https://cyd.smallzhiyuns.com/en | grep -o 'umami.dsx2020.com/script.js'
```

---

## SSH 速查（人工）

```powershell
# Windows OpenSSH（若装了）
ssh root@192.227.152.110
# 密码 Leaf448772566@
```

Paramiko 探测（不部署，只看状态）：

```powershell
python -c "import paramiko; c=paramiko.SSHClient(); c.set_missing_host_key_policy(paramiko.AutoAddPolicy()); c.connect('192.227.152.110',username='root',password='Leaf448772566@',timeout=20); _,o,_=c.exec_command('docker ps --format \"table {{.Names}}\t{{.Status}}\t{{.Ports}}\"'); print(o.read().decode()); c.close()"
```

---

## 排错

| 现象 | 处理 |
|------|------|
| Cloudflare **525** | 源站 TLS 未就绪：看 `docker logs caddy`，确认 Caddy 已为 `cyd.smallzhiyuns.com` 签到证书；DNS A 记录指向 `192.227.152.110`；必要时暂时 CF「仅 DNS / DNS only」再签证书 |
| `127.0.0.1:3020` 通但域名不通 | 查 Caddyfile 是否含 `cyd.smallzhiyuns.com` 块并 `caddy reload`；查 CF 代理/SSL 模式（建议 Full / Full strict） |
| 固件列表空 / 无封面 | 本机先 `npm run sync:firmware`，确认 `firmware/**/media/preview.html` 进了打包；服务器 `find /home/dsx2016/docker/cydweb/firmware -name preview.html` |
| 构建失败 `@swc/helpers` / lock | Dockerfile 用 `npm install`；确保上传了 `package-lock.json` |
| 端口占用 | 服务器上 3020 被占：`ss -lntp \| grep 3020`；不要改成对 `0.0.0.0` 暴露，除非故意 |
| Windows 本机 3000 被占 | 本地开发换端口：`npm run dev -- -p 3010`（与公网无关） |
| Smart App Control / frpc | 若用 frpc 打隧道，本机 SAC 可能拦截；本站生产走直连 IP + Caddy，一般不依赖 frpc |

日志：

```bash
docker logs cydweb --tail 100
docker logs caddy --tail 100
docker logs caddy 2>&1 | grep -i cyd
```

---

## 环境变量速查

| 变量 | 用途 | 生产值 |
|------|------|--------|
| `NEXT_PUBLIC_SITE_URL` | 规范域名 / OG / sitemap | `https://cyd.smallzhiyuns.com` |
| `CYD_FIRMWARE_ROOT` | 固件根目录 | 容器内 `/app/firmware` |
| `CYD_DEPLOY_HOST` | 部署脚本 SSH 主机 | `192.227.152.110` |
| `CYD_DEPLOY_USER` | 部署脚本 SSH 用户 | `root` |
| `CYD_DEPLOY_PASS` | 部署脚本 SSH 密码 | `Leaf448772566@`（脚本默认相同） |

---

## 相关文件

| 路径 | 说明 |
|------|------|
| `scripts/deploy_remote.py` | 一键远程部署（含默认密码） |
| `scripts/sync-firmware.ps1` | 镜像兄弟项目固件到 `./firmware` |
| `Dockerfile` | Next.js standalone 多阶段构建 |
| `docker-compose.yml` | 生产容器 + 3020 绑定 + firmware 卷 |
| `README.md` | 产品/本地开发说明；公网细节以本文为准 |

---

## AI 部署检查清单

1. `npm run sync:firmware` — 确认输出 5 个 Synced  
2. `npm run deploy` 或 `python scripts\deploy_remote.py`  
3. 浏览器打开 https://cyd.smallzhiyuns.com/en — 卡片有 HTML UI 预览  
4. 可选：串口刷机（Chrome/Edge + HTTPS）  
5. 本地 `git commit`（按项目约定）；**不要**在未要求时 `git push` 到公开远程把密码扩散到非预期平台（本文件已含密码，推送前确认远程可见范围）