外观
图库设置
本文介绍如何配置和使用系统的图库功能。
功能概述
图库功能用于管理系统中的图片资源，支持图片上传、压缩、水印、缩略图等处理。
主要功能
- 图片上传 - 支持拖拽上传、批量上传
- 图片压缩 - 自动或手动压缩图片
- 图片水印 - 添加文字或图片水印
- 缩略图生成 - 自动生成缩略图
- 分类管理 - 按分类整理图片
- 回收站 - 支持删除恢复
图库配置
基础配置
根据 config.yaml 中的 gallery 配置：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 上传路径 | ../app/public/uploads/gallery | 图片存储目录 |
| 最大文件大小 | 10 MB | max_file_size: 10485760 |
| 缩略图宽度 | 200 px | thumbnail_width: 200 |
| 缩略图高度 | 200 px | thumbnail_height: 200 |
| 缩略图质量 | 85% | thumbnail_quality: 85 |
| 压缩质量 | 80% | compress_quality: 80 |
| 最大并发任务 | 5 | max_concurrent_tasks: 5 |
支持的图片格式
yaml
allowed_formats:
- jpg
- jpeg
- png
- gif
- webp
- bmp图库管理
图片列表
在 图库管理 页面可以：
- 搜索 - 按关键词搜索图片
- 分类筛选 - 按分类筛选图片
- 来源筛选 - 筛选上传图片或视频截图
- 批量操作 - 批量删除、移动分类
图片上传
支持多种上传方式：
- 点击上传 - 点击上传按钮选择图片
- 拖拽上传 - 直接拖拽图片到上传区域
- 批量上传 - 一次选择多张图片上传
图片操作
| 操作 | 说明 |
|---|---|
| 预览 | 查看原图 |
| 编辑 | 修改图片信息 |
| 压缩 | 压缩图片减小体积 |
| 水印 | 添加水印 |
| 复制链接 | 复制图片访问地址 |
| 删除 | 移入回收站 |
图库设置
在 系统设置 → 图库设置 中配置。
上传设置
| 配置项 | 说明 |
|---|---|
| 启用公开上传页 | 是否开放前台图片上传入口 |
| 需要登录 | 上传是否需要登录 |
| 允许匿名上传 | 是否允许未登录用户上传 |
| 最大文件大小 | 单张图片最大大小限制 |
| 每日上传限制 | 每用户每天可上传数量 |
自动处理设置
| 配置项 | 说明 |
|---|---|
| 自动压缩 | 上传时自动压缩图片 |
| 压缩质量 | 压缩后的图片质量 (1-100) |
| 压缩格式 | 需要压缩的图片格式 |
| 自动生成缩略图 | 上传时自动生成缩略图 |
| 缩略图尺寸 | 缩略图的宽度和高度 |
尺寸限制
| 配置项 | 说明 |
|---|---|
| 最大宽度 | 图片最大宽度限制 |
| 最大高度 | 图片最大高度限制 |
| 最小宽度 | 图片最小宽度限制 |
| 最小高度 | 图片最小高度限制 |
自动裁剪
| 配置项 | 说明 |
|---|---|
| 启用自动裁剪 | 是否自动裁剪图片边缘 |
| 裁剪上边距 | 裁剪顶部像素数 |
| 裁剪右边距 | 裁剪右侧像素数 |
| 裁剪下边距 | 裁剪底部像素数 |
| 裁剪左边距 | 裁剪左侧像素数 |
命名规则
| 配置项 | 说明 |
|---|---|
| 启用命名规则 | 是否使用自定义命名规则 |
| 命名规则 | 支持变量：{date}, {time}, {random}, {original} |
图片压缩
手动压缩
- 在图库列表中选择图片
- 点击 压缩 按钮
- 设置压缩质量
- 确认压缩
批量压缩
- 勾选多张图片
- 点击 批量操作 → 压缩
- 设置统一压缩参数
- 开始批量压缩
压缩参数
| 参数 | 说明 |
|---|---|
| 质量 | 1-100，越高质量越好，文件越大 |
| 格式 | 可选转换为其他格式 |
图片水印
水印类型
| 类型 | 说明 |
|---|---|
| 文字水印 | 添加文字作为水印 |
| 图片水印 | 使用图片作为水印 |
水印设置
在 系统设置 → 图库设置 → 水印设置 中配置：
| 配置项 | 说明 |
|---|---|
| 启用水印 | 是否自动添加水印 |
| 水印类型 | 文字或图片 |
| 水印文字 | 文字水印内容 |
| 水印图片 | 图片水印文件 |
| 水印位置 | 左上、右上、居中、左下、右下 |
| 透明度 | 水印透明度 (0-100) |
| 边距 X | 水印距边缘的水平距离 |
| 边距 Y | 水印距边缘的垂直距离 |
| 字体大小 | 文字水印的字体大小 |
| 字体颜色 | 文字水印的颜色 |
添加水印
- 选择要添加水印的图片
- 点击 水印 按钮
- 配置水印参数
- 预览效果
- 确认添加
分类管理
创建分类
在 图库管理 → 分类管理 中：
- 点击 新增分类
- 填写分类名称
- 设置排序权重
- 保存
分类操作
| 操作 | 说明 |
|---|---|
| 编辑 | 修改分类名称和排序 |
| 删除 | 删除分类（图片移至默认分类） |
回收站
回收站功能
删除的图片会先移入回收站：
- 恢复 - 从回收站恢复图片
- 永久删除 - 彻底删除图片文件
- 清空回收站 - 删除所有回收站图片
操作步骤
- 进入 图库管理 → 回收站
- 选择要操作的图片
- 点击 恢复 或 永久删除
视频图片同步
同步视频截图
系统支持将视频转码生成的截图同步到图库：
- 点击 同步视频图片 按钮
- 系统自动扫描视频截图
- 将未同步的截图添加到图库
批量生成缩略图
为所有图片重新生成缩略图：
- 点击 批量生成缩略图
- 选择是否强制重新生成
- 等待处理完成
常见问题
Q: 上传图片失败？
- 检查图片格式是否支持
- 检查图片大小是否超限
- 检查存储目录权限
- 查看错误日志
Q: 图片显示不出来？
- 检查 Nginx 配置的 public 路径是否正确
- 检查图片文件是否存在
- 检查文件访问权限
- 清除浏览器缓存
Q: 压缩后图片质量差？
- 提高压缩质量参数
- 检查原图分辨率
- 避免多次重复压缩