上游 ZangXincz/FlyPic 已归档停更、飞牛应用商店下架,本提交使其脱离 飞牛应用框架,以普通 Docker 容器继续运行。 - ✨ Docker 独立部署:多阶段 Dockerfile + docker-compose.yml,一键构建 - ✨ OCR 图片内文字搜索:扫描时 tesseract(chi_sim+eng) 提取文字入 ocr_text 列, 搜索同时匹配文件名与图片内容 - 🐛 修复 LibraryService 缺少 logger 引用导致添加素材库 500 - 🐛 移除写权限校验,支持只读挂载素材目录 - 📝 容器内路径与宿主机一致(中文路径直接可用) - 🎨 保持原交互:单击选中、Ctrl/Shift 多选、双击放大 - 🔒 config/(JWT 密钥)加入 gitignore
94 lines
4.4 KiB
Markdown
94 lines
4.4 KiB
Markdown
# 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 搜索
|