Hermes Agent d96986ec79 feat: Docker 独立部署版 v1.1.0 + OCR 图片文字搜索
上游 ZangXincz/FlyPic 已归档停更、飞牛应用商店下架,本提交使其脱离
飞牛应用框架,以普通 Docker 容器继续运行。

- ✨ Docker 独立部署:多阶段 Dockerfile + docker-compose.yml,一键构建
- ✨ OCR 图片内文字搜索:扫描时 tesseract(chi_sim+eng) 提取文字入 ocr_text 列,
  搜索同时匹配文件名与图片内容
- 🐛 修复 LibraryService 缺少 logger 引用导致添加素材库 500
- 🐛 移除写权限校验,支持只读挂载素材目录
- 📝 容器内路径与宿主机一致(中文路径直接可用)
- 🎨 保持原交互:单击选中、Ctrl/Shift 多选、双击放大
- 🔒 config/(JWT 密钥)加入 gitignore
2026-10-22 12:25:20 +08:00
2025-12-07 10:17:17 +08:00
2025-12-05 20:11:34 +08:00
2025-12-03 15:57:04 +08:00
2025-12-01 10:15:32 +08:00
2025-12-07 10:17:17 +08:00
2025-12-04 18:11:27 +08:00

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 失败不影响扫描主流程。

📦 其他部署方式

  • 飞牛 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 搜索

S
Description
FlyPic 飞图 Docker 独立部署版 — 数十万图片素材浏览 + OCR 图片内文字搜索(衍生自 ZangXincz/FlyPic)
Readme MIT
23 MiB
0 Stars 1 Watchers 0 Forks
v1.4.18
Latest
2026-11-22 14:27:05 +08:00
Languages
JavaScript 93.6%
HTML 3.1%
CSS 2.8%
Shell 0.3%
Dockerfile 0.2%