删除上游原有介绍(核心特性/技术栈/目录说明/文件格式等), 保留:Docker 独立部署、OCR 图内文字搜索、Bug 修复、交互保持、 compose 与 docker run 两种部署方式、使用注意
3.8 KiB
3.8 KiB
FlyPic 飞图(Docker 独立部署版)
本仓库是 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. Bug 修复
- 修复添加素材库报
Internal server error(LibraryService.js使用logger但未 require) - 修复中文路径素材库提示
Path does not exist .gitignore排除config/(含 JWT 密钥与管理员密码哈希,禁止入库)
4. 交互保持原样
- 图片区保持原交互:单击选中、Ctrl/Shift 多选、双击放大预览(未改动)
🚀 部署方式
方式一:Docker Compose(推荐)
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/我的文档
# 持久化配置(素材库列表、管理员密码,不用改)
- /vol3/1000/HD3/docker/flypic/config:/root/.flypic
environment:
- PORT=15002
- FRONTEND_DIST=/app/backend/public
- NODE_ENV=production
# 首次部署(编辑 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 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 /vol3/1000/HD3/docker/flypic/config:/root/.flypic \
-v /vol2/1000/HD2/壁纸:/vol2/1000/HD2/壁纸 \
gitea.88531.cn/jinghui/flypic:latest
- 没有镜像就本地构建:
docker build -t flypic:latest .,替换上面的镜像名 - 素材库目录按需增减
-v(容器内路径与宿主机一致)
📝 使用注意
- 添加/更新素材库后需重新扫描,图片内 OCR 文字才可被搜索到(旧索引无文字数据)
- 素材库全量 OCR 扫描逐张识别、耗时较长,建议在不用的时候执行
- 数据存储:素材目录下
.flypic/(缩略图 + SQLite 索引,含ocr_text列);应用配置在config/(已 gitignore) - 删除素材目录下的
.flypic即可清除该库索引,重新扫描重建
📄 License
MIT License - 详见 LICENSE 文件,衍生自 ZangXincz/FlyPic。