# FlyPic 飞图(Docker 独立部署版) 轻量、快速、稳定的图像素材检索浏览管理应用 —— 支持数十万张图片流畅浏览与 **OCR 图片内文字搜索**。本仓库为 [ZangXincz/FlyPic](https://github.com/ZangXincz/FlyPic) 的 Docker 化分支:上游已归档停更(原开发者不再使用飞牛)、飞牛应用商店下架,本分支让它以普通 Docker 容器继续运行,**不依赖飞牛 fnOS 应用框架**。 - 在线地址:`http://<主机IP>:15002`(首次打开设置管理员密码,随后添加素材库) ## ✨ 核心特性 - 🚀 **轻量快速** - 数十万级图片流畅浏览,SQLite 本地索引 + 虚拟滚动瀑布流,毫秒级响应 - 🔍 **智能搜索** - 多关键词 AND 匹配,**文件名 + 图片内 OCR 文字**同时检索(中英双语) - 🛡️ **非侵入式** - 只在素材目录创建 `.flypic` 索引文件夹,不修改任何原始文件 - 🔄 **实时同步** - 文件新增/删除/修改自动更新索引,无需手动刷新 - 📱 **现代界面** - 固定行高瀑布流、亮/暗主题、响应式移动端适配、右键菜单、撤销操作 - 🔒 **管理员密码** - 登录保护素材库隐私 - 🐳 **Docker 独立部署** - 多阶段构建,容器内路径与宿主机一致(中文路径直接可用) ## 🛠️ 技术栈 **前端**:React 18 + Vite 5 + TailwindCSS + Zustand + react-window + react-photo-view **后端**:Node.js + Express + Sharp + better-sqlite3 + Socket.IO + tesseract(系统命令行 OCR) **架构**:三层架构(Config → Model → Service → Route)+ 模块化前端(Store → Hooks → API) ## 📁 目录说明 ``` flypic/ ├── Dockerfile # 多阶段构建(前端编译 → 后端依赖 → 运行时 + tesseract) ├── docker-compose.yml # 一键部署(挂载素材库 + 持久化配置) ├── CHANGELOG.md # 更新日志 ├── backend/ # Node.js 后端 │ ├── utils/ocr.js # ✨ OCR 模块(系统 tesseract,chi_sim+eng) │ ├── utils/scanner.js # 扫描器(已集成 OCR 提取) │ ├── database/db.js # SQLite schema(新增 ocr_text 列 + 索引) │ └── src/ # config / models / services / routes / middleware ├── frontend/ # React 前端(stores / hooks / api / components) ├── scripts/ # 飞牛 fpk 打包脚本(上游遗留,Docker 部署不需要) ├── 飞牛打包部署指南.md # 上游的 fpk 打包文档 └── config/ # 运行时配置(gitignore,不入库) ``` ## 🚀 部署 / 更新 ```bash # 首次部署:编辑 docker-compose.yml 挂载你的素材库目录(容器内路径与宿主机一致) docker compose up -d --build # 添加新素材库目录:volumes 加一行挂载后重启 # - /vol2/1000/HD2/我的文档:/vol2/1000/HD2/我的文档 docker compose up -d # 更新代码 git pull && docker compose up -d --build # 日志 / 重启 / 停止 docker compose logs -f docker compose restart docker compose down ``` > 新增素材库需**重新扫描**后 OCR 文字才可被搜索到。镜像内预装 `tesseract-ocr` + `chi-sim` + `eng` 语言包,OCR 失败不影响扫描主流程。 ## 📦 其他部署方式 - **飞牛 fpk 应用包**:见 [飞牛打包部署指南](./飞牛打包部署指南.md)(`npm run build:fpk:docker` → `fnpack build`,仅当飞牛应用框架可用时适用) - **裸机开发**:`npm install` 后分别 `npm run dev:frontend`(5173)与 `npm run dev:backend`(15002) ## 📝 数据存储 ``` 素材库目录/ ├── 用户图片文件... └── .flypic/ # 索引数据(隐藏目录) ├── thumbnails/ # WebP 缩略图 └── metadata.db # SQLite(含 ocr_text 列) 项目 config/ # 应用配置(JWT 密钥、素材库列表),已 gitignore ``` 删除素材库下的 `.flypic` 即可完全清除该库索引,重新扫描重建。 ## 🎯 支持的文件格式 **完整支持**:JPG、PNG、WebP、GIF、BMP、TIFF、SVG **可识别**:视频(MP4/MOV/AVI...)、音频(MP3/WAV...)、文档(PDF/TXT...)、设计文件(PSD/AI...) ## 📄 License MIT License - 详见 [LICENSE](./LICENSE) 文件,衍生自 [ZangXincz/FlyPic](https://github.com/ZangXincz/FlyPic)。 **上游官网**:[FlyPic 介绍页](https://flypic.shikejk.com/) | **本分支**:Docker 化 + OCR 搜索