jinghui 50c53a5e21 feat: 设置页(本地/线上OCR可配+一键测试) + 右上角开源地址/版本/通知 + CardAuth 授权接入(v1.2.0)
- 后端: utils/settings.js(settings.json持久化)、utils/ocr.js(本地tesseract+线上视觉模型,失败回退本地)、
  routes/settings.js(GET/PUT/test-ocr,密钥掩码)、utils/hub.js(开机查+6h版本比对+30min心跳+60s公告,失败开放,
  机器码仅存服务端)、routes/hub.js(免登录 /api/hub)、server.js 启动拉起 hub
- 前端: SettingsModal(左菜单右参数,线上OCR默认 ai.88531.cn/v1 + mimo-v2.6-flash)、useHub 60s轮询、
  Header 右上角 开源地址/通知铃铛(红点+公告+在线人数)/设置/版本徽标 v1.2.0、搜索框提示改「支持 OCR 图内文字」
- CardAuth: HUB_API_KEY 经 compose 插值 + .env(不入库), 项目「FlyPic 素材库」project_id=15
- 修复: 前端端点 /api 重复拼接、设置响应结构对齐、测试识别结果解析、版本徽标 v 前缀
2026-11-16 21:57:03 +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 独立部署版)

本仓库是 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 多选、双击放大预览(未改动)

🚀 部署方式

方式一: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
      # 授权系统(可选,留空/删除即关闭,不影响使用)
      - 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 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。

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%