1775ababf67055816eb19ce01ae33e1873859c79
牛仔库(FlyPic 飞图,Docker 独立部署版)
2026-11-18 起正式更名为「牛仔库」(原名:牛图 / FlyPic 飞图)。仓库地址、镜像名、数据目录
.flypic保持不变。
本仓库是 ZangXincz/FlyPic 的 Docker 化分支(上游已归档停更)。本文档只介绍本分支修改过的功能与部署方式,上游原有功能不再重复。
- 访问:
http://<主机IP>:15002(首次打开设置管理员密码,随后添加素材库)
✨ 本分支修改的功能
1. Docker 独立部署(新增)
- 多阶段
Dockerfile+docker-compose.yml,docker compose up -d --build一键启动 - 不依赖飞牛 fnOS 应用框架,任意 Linux 主机可跑
- 中文路径直接可用:容器内路径与宿主机一致,素材库目录中文名原样挂载
- 支持素材库目录只读(
:ro)挂载(移除了原写权限校验,只验证可读) - apt 已换清华镜像源,修复 Docker Hub / Debian 官方源超时导致的构建失败
2. OCR 图片内文字搜索(新增)
- 扫描图片时用系统
tesseract(chi_sim+eng中英双语)提取图片内文字 - 文字存入索引库
ocr_text列(带索引),搜索时文件名和图片内文字同时匹配 - OCR 失败不影响扫描主流程;镜像内已预装 tesseract 及中英文语言包
3. 设置页(新增)
- 右上角 ⚙ 设置 打开「左菜单 + 右参数」弹窗:
- OCR 识别:识别方式二选一(本地 tesseract / 线上视觉模型),线上默认已填
https://ai.88531.cn/v1+ 模型mimo-v2.6-flash(可改),再填API Key,支持一键测试识别(返回耗时与识别文字),留空密钥 = 保持原值 - 关于:当前版本号、开源地址
- OCR 识别:识别方式二选一(本地 tesseract / 线上视觉模型),线上默认已填
- 配置持久化在
config/settings.json,保存后立即生效,无需重启
4. 右上角:开源地址 / 版本号 / 通知(新增)
- 🔗 开源地址:一键打开
gitea.88531.cn/jinghui/flypic - 🔔 通知公告:铃铛带未读红点,下拉展示授权系统推送的公告与在线人数
- 版本号徽标:显示当前运行版本(
v1.2.0) - 搜索框提示已标明支持 OCR 图内文字搜索
5. 授权系统接入(CardAuth,新增)
- 最新版本推送:服务端定时比对授权中心,发现新版本时铃铛面板出现「发现新 vX,去更新」
- 公告推送:管理后台发布公告 → 铃铛 60 秒内同步展示(删除公告即同步消失)
- 在线人数统计:服务端 30 分钟一次心跳上报,管理后台可看本项目在线数
- 失败开放:授权中心不可达时只降级显示,不阻塞任何功能;机器码只存服务端,不下发浏览器
6. Bug 修复
- 修复添加素材库报
Internal server error(LibraryService.js使用logger但未 require) - 修复中文路径素材库提示
Path does not exist .gitignore排除config/(含 JWT 密钥与管理员密码哈希,禁止入库)
7. 交互保持原样
- 图片区保持原交互:单击选中、Ctrl/Shift 多选、双击放大预览(未改动)
8. 重新扫描按钮与 OCR 补扫(v1.2.1 新增)
- 右上角刷新按钮旁新增**「重新扫描」图标**(移动端同样提供):确认后对当前素材库全量重新索引并补跑 OCR 文字识别,进度条复用现有扫描进度显示,扫描期间按钮自动禁用防重复触发
- 修复 OCR 文字搜索不到:OCR 功能上线前已入库的图片文字索引一直为空,且旧扫描逻辑对"文件没变"的记录永远跳过、不补识别;现在新增
ocr_done标记列,重新扫描时自动为这些旧图片补跑 OCR(识别为空也记为已完成,不会反复重试) - 扫描统计新增
ocr(OCR 补扫张数)计数
9. 图片编辑器 / 批量水印 / AI 生图 / 收藏(v1.3.0 新增)
- 图片编辑器:右键「编辑图片」进入,提供 PS 常用功能 —— 裁剪(拖拽选区 + 四角把手 + 三分线,自由/1:1/4:3/3:2/16:9/9:16 比例锁定,按原图分辨率烘焙)、旋转翻转(左右 90°/180°/水平/垂直)、图像大小(等比缩放 16~12000 px)、调色(亮度/对比度/饱和度/色相/模糊滑杆实时预览 + 黑白/反色/复古/自动色阶 + 一键还原),文字与贴图图层随裁剪/旋转同步变换,保存前自动按原分辨率烘焙
- 批量水印:右键菜单「批量加水印…/批量去水印…」,弹窗对选中图片批量处理
- AI 生图:设置页「AI 生图设置」可配生图渠道 —— 默认走内置 NewAPI(Pollinations / Cloudflare Workers AI 两大量产模型开箱即用),也可切换到自己的 OpenAI 兼容
/v1/images/generations接口(地址/模型/Key),并提供提示词预设库 - 收藏体系:图片左上角星标一键收藏/取消,侧边栏「我的收藏」视图 + Header 筛选项,右键菜单同步提供收藏入口
- 图片右上角「在新窗口打开」:悬停图片右上角出现外链按钮,点击在新标签页打开原图,不打断当前浏览(非图片类型的文件类型标识自动左移让位)
- 合拼拼图与返回顶部按钮
10. 视频功能:目录导入 / 播放 / 常用编辑 / AI 一键成片(v1.4.0 新增)
- 素材库兼容视频目录:扫描时识别视频文件(mp4 等),瀑布流卡片显示 MP4 类型徽标与时长角标(如
0:09),与图片混排、同一套搜索/收藏/回收站体系 - 单击播放:点击视频卡弹出全屏播放器(原片直接播放,可暂停/进度/音量),右上角可新窗口打开原片
- 常用视频编辑(右键「编辑视频(水印/字幕声音)…」,弹窗四选一 + 开始处理,后端 ffmpeg):
- 加水印:文字水印(内容/位置/字号/透明度/颜色),可叠加时间戳
- 去水印:框选区域模糊/填充去除
- 加字幕声音:外挂字幕轨烧录进画面(支持 SRT 字幕文件),可同时合成朗读音轨
- 去字幕声音:移除画面字幕区与原音轨
- 处理完自动入库,新文件可在瀑布流直接看到
- AI 一键生成视频(多选 ≥2 张图片 → 右键「AI 生成视频…」):
- 表单:视频标题(AI 按此写分镜旁白,成片同名)+ 模型 KEY(OpenAI 兼容,留空用服务器已配 KEY)+ 朗读音色(晓晓/云希/云健/晓伊/云扬/晓臻 6 种)+ 画幅(1920×1080 / 1080×1920 / 1280×720)+ 补充要求
- 流程全自动:AI 写分镜脚本 → 逐段朗读配音 → 图片逐段配字幕合成 → 拼接成片入库(约 10–60 秒/张),完成后成片出现在素材库
🚀 部署方式
方式一:Docker Compose(推荐)
services:
flypic:
# 镜像公网可匿名拉取;内网镜像为 192.168.68.19:3200/jinghui/flypic:latest
image: jpccr.ccs.tencentyun.com/jinghui/flypic:latest
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/我的文档
# 持久化配置(素材库列表、管理员密码,不用改)
- /vol3/1000/HD3/docker/flypic/config:/root/.flypic
environment:
- PORT=15002
- FRONTEND_DIST=/app/backend/public
- NODE_ENV=production
# 授权系统(可选,留空/删除即关闭,不影响使用)
- HUB_URL=https://auth.88531.cn/api
- HUB_PROJECT_ID=15
- HUB_API_KEY=ak_xxx # 自己项目的密钥,写进 .env(已 gitignore)
# 首次部署(编辑 volumes 换成你的素材库目录)
docker compose up -d --build
# 新增素材库:volumes 加一行挂载后重启
docker compose up -d
# 更新代码
git pull && docker compose up -d --build
# 日志 / 重启 / 停止
docker compose logs -f
docker compose restart
docker compose down
方式二:docker run(单容器)
docker pull jpccr.ccs.tencentyun.com/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 /vol3/1000/HD3/docker/flypic/config:/root/.flypic \
-v /vol2/1000/HD2/壁纸:/vol2/1000/HD2/壁纸 \
jpccr.ccs.tencentyun.com/jinghui/flypic:latest
- 公网镜像
jpccr.ccs.tencentyun.com/jinghui/flypic:latest(匿名可拉);内网镜像192.168.68.19:3200/jinghui/flypic:latest - 没有镜像就本地构建:
docker build -t flypic:latest .,替换上面的镜像名 - 素材库目录按需增减
-v(容器内路径与宿主机一致)
📝 使用注意
- 添加/更新素材库后需重新扫描,图片内 OCR 文字才可被搜索到(旧索引无文字数据)——点击右上角**「重新扫描」图标**即可,扫描时会自动补齐历史图片的 OCR 文字索引
- 素材库全量 OCR 扫描逐张识别、耗时较长,建议在不用的时候执行
- 数据存储:素材目录下
.flypic/(缩略图 + SQLite 索引,含ocr_text列);应用配置在config/(已 gitignore) - 删除素材目录下的
.flypic即可清除该库索引,重新扫描重建
📄 License
MIT License - 详见 LICENSE 文件,衍生自 ZangXincz/FlyPic。
Description
FlyPic 飞图 Docker 独立部署版 — 数十万图片素材浏览 + OCR 图片内文字搜索(衍生自 ZangXincz/FlyPic)
23 MiB
0 Stars
1 Watchers
0 Forks