# 05-02-OneNav 首页面板

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

---

## 在 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/onenav-proxy.yaml`](../ansible/files/05-02-onenav/onenav-proxy.yaml)（修改 `Endpoints` IP 与 `Ingress` host）。

应用方式：

```bash
kubectl apply -f ansible/files/05-02-onenav/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`