- 5 个逐目录挂载合并为 1 行父挂载, 等价无损 - 端到端验证: 新建零配置目录建库 200, 清理无残留 - README compose/docker run 示例与部署注释同步简化, CHANGELOG 并入 v1.4.14
162 lines
10 KiB
Markdown
162 lines
10 KiB
Markdown
# 牛仔库(FlyPic 飞图,Docker 独立部署版)
|
||
|
||
> **2026-11-18 起正式更名为「牛仔库」**(原名:牛图 / FlyPic 飞图)。仓库地址、镜像名、数据目录 `.flypic` 保持不变。
|
||
|
||
本仓库是 [ZangXincz/FlyPic](https://github.com/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`,支持**一键测试识别**(返回耗时与识别文字),留空密钥 = 保持原值
|
||
- **关于**:当前版本号、开源地址
|
||
- 配置持久化在 `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(推荐)
|
||
|
||
```yaml
|
||
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
|
||
# 持久化配置(素材库列表、管理员密码,不用改)
|
||
- /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)
|
||
```
|
||
|
||
```bash
|
||
# 首次部署(编辑 volumes 把整盘或你的素材目录挂进来)
|
||
docker compose up -d --build
|
||
|
||
# 新增素材库:整盘挂载后直接在页面添加即可,无需改配置
|
||
docker compose up -d
|
||
|
||
# 更新代码
|
||
git pull && docker compose up -d --build
|
||
|
||
# 日志 / 重启 / 停止
|
||
docker compose logs -f
|
||
docker compose restart
|
||
docker compose down
|
||
```
|
||
|
||
### 方式二:docker run(单容器)
|
||
|
||
```bash
|
||
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 "/数据盘:/数据盘"`(盘下任意子目录直接添加、免改配置),也可只挂需要的子目录 `-v`(容器内路径与宿主机一致)
|
||
|
||
## 📝 使用注意
|
||
|
||
- **添加/更新素材库后需重新扫描**,图片内 OCR 文字才可被搜索到(旧索引无文字数据)——点击右上角**「重新扫描」图标**即可,扫描时会自动补齐历史图片的 OCR 文字索引
|
||
- **添加素材库提示 `Path does not exist`** = 该目录没有挂载进容器(容器里看不到宿主机目录)——在 `docker-compose.yml` 的 `volumes` 下加一行 `- /宿主机路径:/宿主机路径`(两边写一样的路径),再 `docker compose up -d`,然后重新添加即可
|
||
- 素材库全量 OCR 扫描逐张识别、耗时较长,建议在不用的时候执行
|
||
- 数据存储:素材目录下 `.flypic/`(缩略图 + SQLite 索引,含 `ocr_text` 列);应用配置在 `config/`(已 gitignore)
|
||
- 删除素材目录下的 `.flypic` 即可清除该库索引,重新扫描重建
|
||
|
||
## 📄 License
|
||
|
||
MIT License - 详见 [LICENSE](./LICENSE) 文件,衍生自 [ZangXincz/FlyPic](https://github.com/ZangXincz/FlyPic)。
|