kwink/kwinkguide repository overview

这是什么 一个跑在你自己 NAS 上的启动页与导航中枢：

• 打开浏览器新标签页就是它（Chrome / Edge / Firefox 插件），磁贴、搜索、组件一行都有；
• NAS 上也有完整管理页，条目、分组、容器、设置全在这里改，改完插件自动同步；
• 手机浏览器打开 NAS 地址也能用，响应式布局，局域网内随手访问；
• NAS 上的 Docker 容器自动识别，容器起来就出现在导航列表，不用手抄端口和图标；
• 一切数据留在自己 NAS，无云账号、无外网依赖（除热榜/favicon 这类可选的公开源）。 一、NAS 端（飞牛 fnOS）

1. 在飞牛 fnOS 打开应用中心 → 手动安装，上传 releases/kwinkguide_<版本>x86<日期>.fpk；
2. 安装完成后在桌面（或应用列表）打开「KwinkGuide 导航」；
3. 首次启动 compose 会自动构建并拉起容器（/var/run/docker.sock 只读挂载，容器状态/端口识别依赖它）。 ⚠️ 需要 fnOS v1.1.3100 以上（实测目标机 v1.2.0800），宿主架构 x86（本项目未提供 arm 版本）。 👉 想要 arm64（树莓派 / ARM 软路由 / ARM 盒子）请用下面的独立 Docker 镜像。 二、独立 Docker 部署（第三方 NAS / 普通 Linux） 镜像同时提供 linux/amd64 与 linux/arm64 两个架构。 📦 镜像地址：docker.io/kwink/kwinkguide（标签 0.5.43 / latest） Docker Hub 页面：https://hub.docker.com/r/kwink/kwinkguide⁠ 方式 A：docker compose（推荐） mkdir -p kwinkguide && cd kwinkguide curl -O https://gitee.com/cool_fashion_palace_2514978304/kwink-guide/raw/master/app/docker/docker-compose.standalone.yaml⁠ docker compose -f docker-compose.standalone.yaml up -d 方式 B：docker run docker run -d --name kwinkguide --restart unless-stopped
   --network host
   -e DATA_DIR=/data -e STATIC_DIR=/app/www -e DEVICE_PORT=39232
   -v kwinkguide-data:/data
   kwink/kwinkguide:latest 打开 http://<你的NAS-IP>:8080 即是管理页。 想要「容器起来自动出现在导航里」？ 那才需要挂载 docker.sock（在 compose 里取消注释）：

• /var/run/docker.sock:/var/run/docker.sock:ro ⚠️ docker.sock 等价于宿主 root 权限，只读挂载只是降低误操作风险。 不需要自动识别容器的话，整行删掉即可，其余功能完全不受影响。 部分 NAS 的 socket 路径不是 /var/run/docker.sock（如 /volume1/@docker/docker.sock），按实际路径改。