6.2 KiB
FlyPic 飞图(Docker 独立部署版)
轻量、快速、稳定的图像素材检索浏览管理应用 —— 支持数十万张图片流畅浏览与 OCR 图片内文字搜索。本仓库为 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,不入库)
🚀 部署 / 更新
# 首次部署:编辑 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 失败不影响扫描主流程。
方式一:docker run(单容器,不使用 compose)
docker pull gitea.88531.cn/jinghui/flypic:latest
docker run -d --name flypic --restart unless-stopped \
-p 15002:15002 \
-e PORT=15002 \
-e FRONTEND_DIST=/app/backend/public \
-e NODE_ENV=production \
-v /vol1/1000/HD1/docker/flypic/config:/root/.flypic \
-v /vol2/1000/HD2/壁纸:/vol2/1000/HD2/壁纸 \
gitea.88531.cn/jinghui/flypic:latest
- 没有镜像就本地构建:
docker build -t flypic:1.0 .,然后把上面的镜像名换成flypic:1.0 - 素材库目录按需增减
-v(容器内路径与宿主机一致),配置持久化在/root/.flypic
方式二:Docker Compose部署
完整 docker-compose.yml(与仓库根目录文件完全一致,含全部 ports / volumes / environment):
services:
flypic:
build:
context: .
dockerfile: Dockerfile
container_name: flypic
restart: unless-stopped
ports:
- "15002:15002"
volumes:
# 素材库目录(容器内路径与飞牛一致,直接填实际路径即可)
- /vol2/1000/HD2/壁纸:/vol2/1000/HD2/壁纸
- /vol2/1000/HD2/我的文档:/vol2/1000/HD2/我的文档
# 持久化配置(config.json 存储素材库路径、密码等,不用改)
- /vol1/1000/HD1/docker/flypic/config:/root/.flypic
environment:
- PORT=15002
- FRONTEND_DIST=/app/backend/public
- NODE_ENV=production
# 如需挂载多个素材库,取消注释并修改路径:
# volumes:
# - /vol1/1000/图片库:/data/library1:ro
# - /vol2/1000/素材:/data/library2:ro
# - /vol1/1000/docker/flypic/config:/root/.flypic
docker compose up -d --build # 首次构建并启动
docker compose up -d # 日常更新 / 重启
📦 其他部署方式
- 飞牛 fpk 应用包:见 飞牛打包部署指南(
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 文件,衍生自 ZangXincz/FlyPic。
上游官网:FlyPic 介绍页 | 本分支:Docker 化 + OCR 搜索