Deploy-Laboratory/docs/05-02-onenav首页面板.md

05-02-OneNav 首页面板

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

TL;DR

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

---

在 armv7 部署 OneNav

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

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

---

在 K3s 做静态转发

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

应用方式：

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

---

验证

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。