79816a7316fc791b072a0f255cb2087aa048c5c6
FlyPic 飞图
主要飞牛 fnOS 设计的轻量、快速、稳定的图像素材检索浏览应用。
✨ 核心特性
- 🚀 轻量快速 - 支持数十万级别图片流畅浏览,基于 SQLite 本地数据库,毫秒级响应
- 🛡️ 非侵入式 - 只在素材库目录创建 .flypic 文件夹存储索引和缩略图,不修改任何原始文件
- 🔄 实时同步 - 基于 Worker Thread 的文件监控,自动检测新增、删除、修改
- 🌐 远程访问 - 支持 FN Connect 远程访问,随时随地浏览管理图片素材库
- 🎨 现代界面 - 固定行高瀑布流布局,支持亮色/暗色主题,响应式设计
- 🔍 智能搜索 - 多关键词组合搜索,高级筛选(格式/大小/方向)
- 📱 移动适配 - 响应式设计,手机上也能流畅使用
- 🆓 开源免费 - 100% 开源,MIT 协议
- 其他平台
🛠️ 技术栈
前端:React 18 + Vite 5 + TailwindCSS + Zustand + react-window + react-photo-view
后端:Node.js + Express + Sharp + better-sqlite3 + Socket.IO + chokidar
🚀 快速开始
开发环境
# 安装依赖
npm install
# 启动前端开发服务器
npm run dev:frontend
# 访问 http://localhost:5173
# 启动后端开发服务器
npm run dev:backend
# API 运行在 http://localhost:15002
构建部署
# 使用 Docker 构建(推荐)
# 包含 Linux 版本的依赖,上传后直接可用
npm run build:fpk:docker
📦 部署到飞牛 fnOS
详细步骤请查看:飞牛打包部署指南
快速部署
- 构建:
npm run build:fpk:docker - 上传:将
flypic/目录上传到飞牛 - 打包:
fnpack build - 安装:
appcenter-cli install-fpk flypic.fpk - 访问:
http://你的飞牛IP:15002(端口可在安装时自定义)
安装提示
- 自定义端口:安装时可自定义应用端口(默认 15002),避免与其他应用冲突
- 素材库路径:添加素材库时需输入飞牛文件系统的完整路径,如
/vol1/1000/图片库 - 文件夹权限:请确保应用对素材库文件夹有读取权限,可在飞牛应用设置中配置授权目录
📁 项目结构
FlyPic/
├── frontend/ # React 前端
├── backend/ # Node.js 后端
├── flypic/ # 飞牛打包目录(构建生成)
├── scripts/ # 构建脚本
├── website/ # 官网静态页面
└── 飞牛打包部署指南.md # 完整部署文档
🎯 支持的文件格式
完整支持:JPG、PNG、WebP、GIF、BMP、TIFF、SVG
可识别:视频(MP4/MOV/AVI...)、音频(MP3/WAV...)、文档(PDF/TXT...)、设计文件(PSD/AI...)
📝 数据存储
素材库目录/
├── 用户图片文件...
└── .flypic/ # FlyPic 数据目录(隐藏)
├── thumbnails/ # WebP 缩略图
└── metadata.db # SQLite 数据库
删除 .flypic 文件夹即可完全清除索引数据,不留任何痕迹。
🐛 故障排查
常见问题请查看 飞牛打包部署指南 - 故障排查
📄 License
MIT License - 详见 LICENSE 文件
官网:FlyPic 介绍页 | 最后更新:2025-12-01
Description
FlyPic 飞图 Docker 独立部署版 — 数十万图片素材浏览 + OCR 图片内文字搜索(衍生自 ZangXincz/FlyPic)
23 MiB
0 Stars
1 Watchers
0 Forks