# 05-02-OneNav 首页面板

> OneNav 运行在集群外（如 armv7 主机），通过 K3s Traefik 做静态转发接入。


## TL;DR

- **自动化验收**：`./ansible/bin/verify.sh run 05-02`
- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
- **成功判据**：达到本文「预期」且 playbook 断言通过
- **排障**：见本文「排障」

---

## 在 armv7 部署 OneNav

使用 Docker 启动 OneNav，确认本机可访问管理页面，例如：

```bash
docker run -d --name onenav \
  -p 7070:7070 \
  -v /data/onenav:/data \
  helloz/onenav:latest
```

---

## 在 K3s 做静态转发

**唯一真源**：[`ansible/files/05-02/onenav-proxy.yaml`](../ansible/files/05-02/onenav-proxy.yaml)（修改 `Endpoints` IP 与 `Ingress` host）。

应用方式：

```bash
kubectl apply -f ansible/files/05-02/onenav-proxy.yaml
```

---

## 验证

```bash
kubectl get svc,endpoints,ing -n default | grep -i onenav
curl -I --max-time 3 http://192.168.2.61/
```

---

## 下一步

- `05-01-k3s-部署homer首页面板.md`
- `03-04-k3s-cloudflare-tunnel-配置接入.md`

## 排障

- **先看 playbook 输出**：失败时先定位是 deploy/wait/http_check 哪一步。
- **集群侧总览**：`kubectl get nodes -o wide`、`kubectl -n kube-system get pods -o wide`。
- **事件与日志**：`kubectl -n <ns> describe ...`、`kubectl -n <ns> logs ... --tail=200`。