中国 帮助

图床管理

官方 免费 插件

Wujies 无界平台(wujies.cn)的图床应用,一个插件一个仓库:

v1.0.10 2 次安装 本季度 1 次

<p> <a href="https://wujies.cn" target="_blank" rel="nofollow"> <img width="100" src="https://wujies.cn/brand/logo-stacked.svg" alt="Wujies 无界 logo"> </a> </p>

<p><b>图床管理</b>,多租户图片与相册:上传、分类、标签、相册、访问日志与存储配置。</p> <p> <a rel="nofollow"><img alt="应用版本" src="https://img.shields.io/badge/app-1.0.9-111111?style=flat-square"></a> <a rel="nofollow"><img alt="应用编码" src="https://img.shields.io/badge/code-gallery-0057FE?style=flat-square"></a> <a rel="nofollow"><img alt="License" src="https://img.shields.io/badge/license-MIT-green?style=flat-square"></a> <br> <a rel="nofollow">功能特性</a> <a rel="nofollow">预览</a> <a rel="nofollow">安装</a> <a rel="nofollow">设置</a> <a rel="nofollow">常见问题</a> <a href="https://docs.wujies.cn/docs/wujies/5.x/platform/plugin" rel="nofollow">插件开发</a> <a href="https://gitee.com/wujies" rel="nofollow">Gitee</a> </p>


Wujies 无界平台(wujies.cn)的图床应用,一个插件一个仓库:

  • 后台:应用市场装上后多一个「图床管理」菜单,前端是远程应用(frontend/,30 个文件), 管图片、分类、标签、相册、访问日志与存储配置。
  • 前台:三个由 CMS 主题直出的公开页 —— /site/gallery(我的图床)、/site/gallery/square(广场)、 /site/gallery/image/{id}(单图详情),样式与模板都在本仓库里(见「公开页与自带样式」)。

应用编码 gallery | 应用版本 1.0.9 | 后端构件 wujies-gallery-plugin

✨ 功能特性

  • 🖼️ 图片管理 — 上传、编辑、批量删除、导出,支持相册与标签。
  • 🗂️ 分类与标签 — 树形分类 + 标签两套组织方式,列表页按分类/标签筛选。
  • 📚 相册 — 把图片归入相册,相册封面与排序可调。
  • 📈 访问日志 — 记录图片访问来源与时间,便于排查与统计。
  • ⚙️ 图床配置 — 存储与展示相关的开关集中在一个页面(菜单「图床配置」)。
  • 🌐 前台三屏 — 我的图床 / 广场 / 单图详情,由 CMS 主题直出,样式跟着插件走。
  • 🔐 多租户 — 数据按 tenant_id 隔离,与平台其它应用同一套租户口径。

📸 预览

图床管理主界面

![图床管理主界面](docs/screenshots/gallery.png)

🚀 安装

环境要求

| 项 | 要求 | |---|---| | 平台版本 | &gt;=5.6.2 &lt;6.0.0(app.json 的 engine) | | 后端构建 | JDK 17+(父 POM 的 java.version 为 17) | | 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm | | 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后拉取 |

从应用市场安装

  1. 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
  2. 安装时自动执行 migrations/ 下的脚本(建表 + 站点配置 + 种子数据)。
  3. 装完刷新菜单,出现「图床管理」即成功。

包里两个产物的路径由 app.json 的 assets 决定: frontend → frontend/index.js | backend → backend/wujies-gallery-plugin-1.0.9.jar。

从源码构建

在本仓库根打包(三条命令各管一段,都在本仓库根执行):

powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -CheckOnly   # ① 打包前检查:清单/产物/迁移/菜单/密钥,几秒返回
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev         # ② 开发包:不签名,落 ..\.plugin-dist\gallery\dev
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1              # ③ 正式包:构建 + 用 keys\private.pem 签名

关于上面三条命令的取值口径:

  • 判据是「脚本所在仓库根有没有 app.json」,所以在本仓库里不要传 -Plugin(它按子目录找清单, 会报「找不到插件目录」);-FrontendProject / -FrontendDist 也不用传 —— 独立布局的前端工程固定就是 本仓库 frontend/、产物 frontend/dist,脚本自己跑 npm run build(首次先 cd frontend &amp;&amp; npm install, 缺依赖时脚本会把这条命令直接报给你)。只想复用现成产物就加 -SkipBuild。
  • -SkipFrontend 只用于没有前端的纯后端应用:带前端时它会连「复制前端产物」一起跳过, 出的包只有 app.json,装上去没有界面。
  • -CheckOnly 打出的 CHECK|级别|项|说明 行就是管理端「开发工具 → 插件开发 → 打包」抽屉里那份体检清单, 两边跑的是同一套检查;有 ERROR 时正式打包会被直接拦下。签名密钥在本仓库 keys/ (private.pem + public.pem,已在 .gitignore 里),生成或更换用 -Keygen (覆盖已有密钥要显式加 -KeygenForce,旧钥先整份备份进 keys\backup\&lt;时间戳&gt;\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。

手工构建(不用打包脚本时):

mvn -B -o package -DskipTests                # 后端(前提见「常见问题」里的父 pom 一条)
cd frontend &amp;&amp; npm install &amp;&amp; npm run build  # 前端,产物 dist/index.js + assets/gallery-app.css

最快的开发路子不用打包、不用重启宿主:启动平台宿主,打开管理端「开发工具 → 插件开发」, 找到 gallery 这一行点「启动后端」(自动编译并加载 target/classes,同时开启监听)与「启动前端」 (常驻 vite build --watch,保存源码即重建,刷新页面生效,没有 HMR)。全流程见 文档站「插件开发」。

升级与卸载

  • 升级:换 app.json 的 version 后重新打包上传;已执行的迁移脚本不可改内容, 新增表结构一律加新编号脚本(本仓 04-add-gallery-image-copyright.sql 就是这种加法)。
  • 卸载:管理端「应用市场」里卸载,平台按 migrations/ 记录的建表脚本清理数据表。

⚙️ 设置

图床运行时的存储与展示配置集中在后台「图床管理 → 图床配置」页(对应菜单 gallery-settings), 无需改配置文件;保存后即时生效。分类、标签、图片、相册、访问日志各自有独立菜单页。

菜单入口

| 菜单 | 路径 | 组件键 | 权限前缀 | |---|---|---|---| | 图床配置 | gallerySettings | remote:gallery/gallery/settings | gallery:settings:list | | 分类管理 | imageCategory | remote:gallery/gallery/imageCategory | gallery:category:* | | 标签管理 | tag | remote:gallery/gallery/imageTag | gallery:tag:* | | 图片管理 | image | remote:gallery/gallery/image | gallery:image:* | | 相册管理 | album | remote:gallery/gallery/imageAlbum | gallery:album:* | | 图片访问日志 | imageAccessLog | remote:gallery/gallery/imageAccessLog | picturebed:imageAccessLog:* |

&gt; 访问日志沿用 picturebed: 前缀(与 app.json 里 F 按钮的 perms 逐字对应);改成 gallery: &gt; 会让已授权角色失效,所以保留。

前台公开页:

| 路径 | 页面 | |---|---| | /site/gallery | 我的图床 | | /site/gallery/square | 广场 | | /site/gallery/image/{id} | 单图详情 |

🧩 依赖与插件支持

| 项 | 说明 | |---|---| | 依赖插件 | 无(app.json 的 dependencies 为空) | | CMS 主题 | 前台三屏由 CMS 插件渲染,需先装 cms | | 平台存储 | 上传落到平台「存储配置」(OSS / 本地),本插件不另存密钥 | | 公共 API | 前端走打进包内的 @wujies/api-client,运行时由宿主 import map 提供 vue / element-plus / @wujies/ui-shared 单例 |

公开页与自带样式

site-templates/ 里那三个模板由 CMS 主题渲染,site-styles/gallery/gallery.css 是这一屏自己的样式, 由本插件的 GallerySiteAssetController 在 /site/apps/gallery/** 发出,`` 清单由 GallerySiteRender 作为页面变量 appStyles 交给主题 head。

为什么端点必须跟着插件走:插件各自的类加载器,本仓库的产物主题那侧读不到(模板能跨过去是因为 渲染时应用把加载器交了过来,静态资源是一次独立请求,没有那次交接)—— 谁的文件谁发。 样式里只准用主题的 CSS 变量,:root 那套令牌不在这里重抄一份。 口径见 wujies-cms-plugin README「写主题时必须守住的五条」第 5 条。

开发环境

git clone git@gitee.com:wujies/wujies-gallery-plugin.git
cd wujies-gallery-plugin

打包脚本:本仓库自带完整的 package.ps1(母本在 wujies-plugins 仓库根,各仓用 node scripts/sync-package-script.mjs 同步过来),clone 下来就能在本仓库根直接体检、构建、签名、出包、 生成密钥,不需要回到单体仓库,也不需要手工传产物路径。

前端 SDK:已迁到已发布的 @wujies/* SDK(ui-shared / components / api-client / ui-plugin-bundler-kit)。frontend/vite.config.ts 只声明 defineRemoteApp({ appCode, root }), 共享依赖一律 external、运行期由宿主 import map 兜到同一份实例;宿主独有工具与业务模块 (@/utils/wujies、@/api/system/*、UserSelect/MemberSelect 等)按原样复制进了 frontend/src/, proxy?.$modal / useDict / download 与 ImageUpload/UserDetail/Module*Settings 由宿主运行时提供。 本仓库前端可独立构建;要直接落位到宿主,构建前设 WUJIES_FRONTEND_DIST=/app-market-dist/remote-apps。

仓库布局

| 位置 | 内容 | |---|---| | pom.xml | Maven 模块(父 pom = cn.wujies.plugins:wujies-plugins-parent,`` 已置空) | | app.json | 应用清单,打包器读的唯一事实来源(code / version / menus / assets) | | src/ | Java 源码(63 个文件) | | migrations/ | 4 个建表/配置/种子脚本:01 建表、02 站点配置、03 种子、04 图片版权列 | | src/main/resources/site-templates/、site-styles/gallery/ | 公开页直出的模板,和本屏自己的样式(见上一节) | | frontend/ | 远程应用源码(src/ 30 个文件),入口 frontend/src/index.ts |

❓ 常见问题

Q:陌生人 clone 后 mvn package 报找不到 wujies-plugins-parent? 父 pom、wujies-common-* 与兄弟插件构件目前只有本地 mvn install 出来的版本,还没发布到 Maven 仓库(后端构件发布那一阶段才补)。本机装过就能通,本机实测 mvn -B -o package -DskipTests 通过。

Q:打包时提示「找不到插件目录」? 在本仓库根不要传 -Plugin —— 脚本按「仓库根有没有 app.json」判定布局,传了它就去找子目录清单。

Q:前台页面样式丢了 / 404? 前台静态资源由本插件的 GallerySiteAssetController 在 /site/apps/gallery/** 发出。跨插件的类加载器 彼此不可见,这类资源必须由文件所属的插件自己发(见「公开页与自带样式」)。

Q:前端构建产物里有裸 vue 之类的 import,会不会找不到? 正常。vue / element-plus / @wujies/ui-shared 由宿主 import map 提供单例,属于刻意 external。

🔒 隐私与外部资源

  • 不收集、不上报任何遥测;访问日志只记录平台内图片的访问,存本平台数据库。
  • 上传文件存放位置由平台「存储配置」决定(本地磁盘或对象存储),本插件代码里不写任何密钥。
  • README 与仓库中不包含任何真实口令、token 或私钥;签名密钥只在本机 keys/(已 gitignore)。

📄 许可证与致谢

MIT,条文见仓库根目录 LICENSE,许可口径与 wujies-platform 一致。

💬 反馈与建议

参考

wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、 wujies-ui(npm 上 @wujies/* 四件套的源码仓)、 文档站「插件开发」章节。

v1.0.10 2026-11-14 平台 >=5.6.2 <6.0.0 371 KB

新增

  • 图片摘要批量接口,供公开页收藏/点赞列表换标题与缩略图

重构

  • 图片页互动条与评论区宽度类同步改名 max-wrap
  • README 改为 Halo/NexT 版式并更新品牌 logo 地址
v1.0.9 2026-11-08 平台 >=5.6.2 <6.0.0 369 KB

新增

  • 会员端图片归类与公开/私密接口;前台直出页与自有静态资源端点

修复

  • 访问日志与分类批量写改逐行调用
  • 同步公钥检查——开源仓 yml 只有环境变量占位符时改比部署仓 keys/package-public.pem

其他

  • gallery 1.0.8 —— 版本号与包内 jar 名同步
  • gallery 1.0.7 —— 版本号与包内 jar 名同步
v1.0.8 2026-11-08 平台 >=5.6.2 <6.0.0 369 KB

patch 升级 1.0.8

v1.0.5 2026-10-01 平台 >=5.6.2 <6.0.0 261 KB

这个版本没有写更新日志。

评论区需要浏览器启用 JavaScript 才能加载。