Yeomai/FileHost
1
0 Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity
Files
a2289a564fb5060711ec23d8cf749b0d2038c164
FileHost/CHANGELOG.md
T
tianmo a2289a564f feat: 完善媒体管理与低内存环境稳定性 
- 统一图片、视频和文件的上传策略，支持文件大小、格式和限流配置
- 新上传的图片、视频和文件默认保存到本地磁盘，并支持修改默认存储后端
- 图库、视频库和文件库新增搜索与批量删除功能
- 更新视频与文件 API 文档，并完善服务端扩展名和内容类型校验
- 完善备份恢复统计，分别展示媒体记录和存储对象进度
- 完善用户级清空存储流程，清理当前用户的媒体、任务和缓存
- 修复清空存储后最近任务残留以及媒体逻辑遗漏视频和文件的问题
- 增加站点同步异常恢复和超时兜底处理
- 缩略图 FFmpeg 限制为单线程并增加 10 秒超时保护
- 低内存服务器开启 HLS 转码时显示风险提示
- 完善 m3u8 临时合并文件的下载后、到期和启动时清理
- 更新中英文更新日志，并将版本号提升至 1.5.0
2026-10-17 16:34:38 +08:00

402 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Changelog
本仓库自 **v1.0.0** 起作为正式版维护；此前历史提交已归档重置。
## [Unreleased]
## [1.5.0] - 2026-10-17
### 新增
- 图库、视频库和文件库支持搜索与批量删除，列表管理体验进一步完善
- 视频与文件 API 文档按新增上传、查询、批量删除和转码能力同步更新
- 所有媒体上传统一使用可配置策略，包括文件大小、格式限制和上传限流
- 新上传的图片、视频和文件默认保存到「本地磁盘」，支持切换默认存储后端
- 存储页新增高危操作二次确认，可清空当前用户的媒体、任务和缓存且不影响其他用户
- 低内存服务器在开启 HLS 转码时显示风险提示
### 改进
- 备份与恢复统一统计「媒体记录」和「存储对象」，提升迁移前后数据一致性
- 视频上传入口仅允许 MP4、MOV、MKV、WebM 等完整容器格式，服务端增加扩展名与内容类型校验
- 缩略图 FFmpeg 限制为单线程并增加 10 秒超时，降低低内存服务器卡死风险
- m3u8 临时合并文件支持下载后清理、到期清理及启动兜底清理
### 修复
- 修复清空存储后最近任务残留并可继续下载的问题
- 修复部分媒体相关文案和逻辑仍仅针对图片、遗漏视频与文件的问题
- 修复站点同步异常后的兜底恢复流程
## [1.4.4] - 2026-10-10
### 修复
- Cap 登录验证支持新的 hashwx 挑战，旧的 SHA-256 site key 仍可使用
- 求解用的 wasm 改由本站提供，不再依赖 jsDelivr
## [1.4.3] - 2026-10-09
### 新增
- **Telegram 存储后端**：用 Bot 把图片存入频道或群组（含私有）；直链仍由 PicHost 代理，不暴露 Bot Token
- 可选 HTTP/HTTPS API 代理，供服务器访问 Telegram
- 群组升级为超级群组时自动改用新的 Chat ID
### 说明
- 单文件约 20MB，同一聊天约 20 条/分钟
- 图库删除会尝试删除对应 Telegram 消息；备份包不含 Bot Token
## [1.4.2] - 2026-09-23
### 修复
- 图库批量打标：管理员/跨归属场景下标签解析与失败提示
- 上传鉴权：`Auth-Token` 与表单 `token` 优先于会话；兼容全局 `API_UPLOAD_TOKEN`（上传归属首位管理员）
### 改进
- **API 页**：每账号单一 API Token，界面与文档统一
- **上传 API**：仅支持 `tagNames`（按名创建或复用标签）；Twikoo 兼容路由同步
- **标签管理**：按图片数/最近使用排序；桌面列布局；窄屏卡片列表
- **API 文档**：参数表列宽，避免 form-data 列异常换行
## [1.4.1] - 2026-09-16
### 新增
- **上传策略（设置 → 基础）**：单文件大小、允许格式、上传/登录限流、保留原图（关闭服务端 WebP 转换）；支持 `.env` 覆盖
- **上传 API**：可选 `tagNames`（名称不存在则创建，存在则复用）；与 `tagIds` 可并用
### 改进
- 登录接口接入可配置的登录限流
- 设置页将全站上传策略并入「上传偏好 / 图片处理」；访问控制保留登录限流
- API 文档补充 `tagIds` / `tagNames` 参数说明
## [1.4.0] - 2026-09-09
### 新增
- **标签系统**：每用户独立标签与彩色标记；设置页管理（新建、改色、合并、删除）
- **图片打标**：上传后单张/批量打标；图库按标签筛选（OR / AND）、批量打标与解标
- **操作日志扩展**：记录登录、删除、设置变更、标签操作等；支持日期、用户、操作类型、来源与 IP 筛选
- **API**：标签 CRUD、图片打标、`batch-tags`；上传支持 `tagIds`；列表/搜索/统计支持标签筛选
### 改进
- 操作日志页 UI 改版（操作/来源徽章、移除备注列）
- 设置侧栏增加「标签管理」
### 文档
- README 与文档站截图更新（上传、图库、标签、操作日志等）
## [1.3.0] - 2026-09-07
### 新增
- **站点备份**：存储页导出 `.phost.tar.gz`（含 `pichost.db` 与全部图片），支持下载与任务进度
- **站点恢复**：存储页或 setup 未初始化时从备份包恢复，支持预检与跳过/覆盖冲突
- **跨后端同步**：在已配置存储后端之间拷贝图片并更新索引；后端卡片快捷「迁入 / 迁出」
- **任务中心**：`backup_jobs` 记录最近导出/恢复/同步任务，失败可重试；列表分页
- 运维 CLI：`backup-export`、`backup-restore`、`storage-sync`（`docker exec pichost …`）
### 移除
- 遗留目录迁移 CLI `migrate` / `migrate-to-single-images.mjs`（由启动索引同步与整站备份恢复替代）
### 文档
- [存储](./docs-site/guide/storage.md) 补充备份与迁移说明；更新截图；移除 v1.2 迁移专页
## [1.2.8] - 2026-09-04
### 改进
- 双域名：保存或初始化时弹出风险确认（说明可能锁死及 `clear-domains` 恢复方式），不再强制校验当前 Host
### 新增
- 运维 CLI `clear-domains`：清除数据库中的网站域 / 图片域配置（`docker exec pichost clear-domains`）
### 文档
- FAQ、双域名、反向代理文档补充锁死原因与恢复步骤
## [1.2.7] - 2026-09-03
### 新增
- 登录/注册人机验证：本地滑块、Cloudflare Turnstile、Cap；管理员在「设置 → 访问控制」中切换
- 运维 CLI `slider`：将登录验证重置为本地滑块（`docker exec pichost slider`）
### 改进
- 登出后登录页验证码可正常重新加载
## [1.2.6] - 2026-09-01
### 新增
- 设置、API、图库、存储页 UI 重构（侧栏导航、统计卡片、在线调试等）
- 图库筛选增加存储后端下拉
- 新建对象存储后端按类型生成存储标识：`r2-*`、`cos-*`、`oss-*`、`s3-*`
### 改进
- 操作日志表格：操作/来源标签同行展示，路径列省略号截断、无横向滚动条
- 存储后端卡片：存储标识与类型同一行左对齐排列
- README 与文档站截图、导航说明同步新界面
## [1.2.5] - 2026-08-31
### 新增
- 图库页（`/gallery`）替代原「统计」导航；图片点击放大详情弹层（尺寸、上传方式、存储路径、链接复制）
- 图库列表支持全选、反选；单张删除移至详情弹层
- 图片列表 API 返回上传来源（网页 / API，来自活动日志）
### 改进
- README 补充技术栈说明
### 移除
- `/stats` 路由（不再兼容跳转）
## [1.2.4] - 2026-08-31
### 修复
- 访问控制（Referer 防盗链）留空时仍会拦截外链图片：浏览器直开无 Referer 可访问，博客/论坛嵌入带 Referer 会 403 图裂；现仅在配置了白名单时才校验
## [1.2.3] - 2026-08-30
### 修复
- 开启「简短图片链接」且按年/月分组时，纯文件名直链（如 `/xxx.webp`）误解析为 `images/xxx.webp` 导致 404；现先经 SQLite 索引反查完整 key
## [1.2.2] - 2026-08-30
### 修复
- 双域名：设置页保存时误清空管理域（`site_base_url`）；仅改图片域时保护已有网站域配置
- 双域名：设置 API 配置值与 request origin fallback 混淆，导致「当前生效」显示错误
- 双域名：未配置的第三 Host（`pages.dev`、裸 IP 等）可绕过 Host 隔离访问后台
### 改进
- 设置 API 拆分 `siteBaseUrl` / `imageBaseUrl`（配置值）、`effective*`（直链）、`runtime`（当前访问检测）
- `PATCH /api/settings` 增加 `domainSeparation` 字段与保存校验
- 设置页：检测地址展示、关闭双域名确认、反代 Host 不一致警告；首次设置不再自动填入 origin
- Host 中间件：双域名开启时对未知 Host 返回 404（开发 `localhost` 例外）
- 文档站：新增 [更新日志](https://o96u.github.io/PicHost/guide/changelog)；重写 Cloudflare 部署说明；同步 FAQ / 双域名文档
## [1.2.1] - 2026-08-29
### 新增
- 登录滑动拼图验证（缺口对齐）；验证与登录分两步，登录接口校验 `captchaId` / `captchaPosition`
- VitePress 文档站（`docs-site/`）：中英文指南，部署至 GitHub Pages <https://o96u.github.io/PicHost/>
- `npm run docs:dev` / `docs:build` / `docs:preview`；CI 增加 `docs:build`；`.github/workflows/docs.yml` 发布文档
### 修复
- 修复统计页删除图片后图库不刷新的问题
- 修复分页跳转输入框在 `type="number"` 下无法跳转的问题
- 修复非首页路由下复制链接格式偏好不持久化的问题（`useUploadPreferences` 首次使用时自动加载）
- 滑动验证 UI：滑块垂直居中、缺口尺寸与滑块一致
### 改进
- README 精简为产品宣传页，详细说明指向文档站
- 双域名文档补充：未知 Host 风险、Cloudflare 橙云部署、勿用 Pages/Workers 整站反代
- 文档截图更新（登录页等）；旧 `docs/*.md` 长文迁入 `docs-site/`
## [1.2.0] - 2026-08-28
### 变更
- 图片统一存放在 `data/images/`；遗留 `blog/`、`twikoo/` 等并列目录需迁移后升级
### 新增
- CLI 迁移工具：`docker exec pichost migrate` / `migrate --apply`（`server/cli/migrate-to-single-images.mjs`）
- 扫描 `data/` 下除 `images` 外所有顶层目录中的图片，输出 `data/mapping.json`
- 启动时自动同步图片索引（扫描磁盘、归一化遗留 key、清理孤儿记录），并打印同步日志
### 改进
- 启动时归一化遗留 SQLite key、清理无文件的孤儿索引；支持删除仅索引无文件的记录
## [1.1.5] - 2026-08-28
### 修复
- 修复 API 上传后图库预览偶发失败、需等待刷新才显示的问题
- 图库卡片加载失败后自动重试，刷新列表时重置预览状态
### 改进
- 出图前校验存储文件实际存在，避免索引与磁盘短暂不一致
- 图片 404/403 与域名隔离 404 禁止 CDN 缓存，降低反代误判影响
## [1.1.4] - 2026-08-28
### 新增
- 上传目录可按年/月分组或扁平保存（`storage_use_date_path` / `STORAGE_USE_DATE_PATH`），设置页可切换
- 双域名分离下网站域禁止直链出图，仅图片域可访问图片路径
### 改进
- 隐藏 `images/` 前缀时外链改为仅文件名（如 `xxx.webp`）；图片域仍兼容旧版 `/2026/08/xxx.webp` 短链
- 设置页重构：功能开关、域名配置、存储路径分组展示
- 本地磁盘索引扫描支持扁平路径；文件夹列表 `images` 置顶
## [1.1.3] - 2026-08-27
### 新增
- 后台与图片域名分离（`SITE_BASE_URL` / `IMAGE_BASE_URL`）：单实例双域名，Host 中间件隔离图片域非图片路径
- `/setup` 与系统设置支持启用/关闭域名分离，设置页可后续关闭并恢复单域
- 可选隐藏外链中的 `images/` 前缀（多文件夹时确认提示）
- 设置页加载时检测 GitHub 最新版本并提示更新
- 双域名部署文档（Nginx / Lucky / 本地 hosts 测试）：[文档站 · 双域名分离](https://o96u.github.io/PicHost/guide/domain-separation)
### 改进
- 双域名下防盗链自动放行网站域与图片域主机名
- 开发服务器默认绑定 `127.0.0.1:3000`，便于 hosts 双域本地测试
- API 文档补充自定义文件夹的 cURL 示例
### 其他
- 许可证变更为 GPL-3.0-only
- `scripts/` 目录改为本地维护，不再纳入仓库
## [1.1.2] - 2026-08-26
### 新增
- 操作日志页（`/logs`）：记录上传/删除，管理员可查看全部用户并筛选
- 图库记录支持按存储后端筛选
- 上传 IP / API Token 限流（15 分钟窗口）
### 改进
- 操作日志记录存储后端；图库卡片可展示存储来源
- 存储筛选下拉固定「本地磁盘」排在第二位
- 系统设置页版本号链接至 GitHub Releases
### 修复
- 修复删除存储后端后确认弹窗闪出空名称
## [1.1.1] - 2026-08-26
### 修复
- 移除启动时自动创建的空白「S3 兼容存储」占位；升级后自动清理旧占位记录
- 修复管理页切换路由时反复闪现「正在验证登录状态」
- 修复静默会话校验后设置 / 统计 / API 页不加载数据
### 改进
- Docker 日志：4xx/5xx 分级输出，记录错误原因与堆栈；上传/启动任务失败写入详细错误
## [1.1.0] - 2026-08-26
### 新增
- S3 兼容对象存储后端（R2 / AWS S3 / 腾讯云 COS / 阿里云 OSS）
- `storage_backends` + `images` 索引表，列表/搜索/统计改查 SQLite
- 混合直链：`proxy`（默认，PicHost 代理）与 `public`（302 到 CDN）
- 管理员 `/storage` 存储管理页：多后端卡片、用量条、添加/编辑/删除云存储实例
- 可选环境变量覆盖存储配置（`STORAGE_BACKEND`、`S3_*`）
### 改进
- 启动时自动将本地磁盘图片扫描迁入 `images` 索引（幂等）
- 上传/删除/直链/auto-delete 按 `backend_id` 路由到对应后端
## [1.0.4] - 2026-08-25
### 新增
- 密码输入框支持显示/隐藏切换（`PasswordInput` 组件，含无障碍文案）
### 改进
- 遗留 `ADMIN_SECRET` 部署：`/setup`、`/register` 路由与 `needsMigration` 检测对齐
- 合并重复的密码不一致 i18n 文案；移除未使用的 `jose` 依赖
### 修复
- 修复 `PasswordInput` 导致 CI typecheck 失败
## [1.0.3] - 2026-08-23
### 修复
- 修复 CI typecheck 失败（移动端菜单、i18n、统计页图库刷新）
- Docker 构建：arm64 改用原生 ARM Runner，避免 QEMU 下 `npm ci` 极慢
- Docker 构建：启用 npm 缓存挂载，加快依赖安装
## [1.0.2] - 2026-08-23
### 新增
- 中英文界面（`@nuxtjs/i18n`），语言切换与主题切换独立菜单
- 移动端导航：汉堡菜单 + 分组用户菜单（语言 / 外观 / 账户）
- Docker 忘记密码：`docker exec pichost reset-password`（随机密码，见 `server/cli/`）
- Docker 升级到 v1.2.0 前迁移遗留目录：`docker exec pichost migrate` / `migrate --apply`
### 改进
- 统计页工具栏与图库布局（桌面单行、移动端适配）
- 上传卡片视觉优化（背景图、插图、悬停边框动效）
- Logo 与上传区图片压缩，减小体积
## [1.0.1] - 2026-08-22
### 修复
- 系统设置页底部显示当前应用版本号
- 修复移动端上传偏好面板内容被裁剪、无法完整展示的问题
## [1.0.0] - 2026-08-22
### 新增
- 多用户账号体系：Web 引导创建管理员、用户名密码登录、可选开放注册
- 角色权限：管理员 / 普通用户；图库按 `userId` 隔离，服务端强制校验
- 个人 API Token：每用户独立 Token，脚本上传归属对应账号
- 上传偏好：客户端预压缩、WebP 质量、自动复制链接、按用户自动删除策略
- 管理员系统设置：注册开关、防盗链、访问域名、默认上传目录
- 统计页：图库浏览 / 搜索 / 批量删除；管理员显示注册用户数量
- Twikoo / EasyImage 2.0 兼容：`POST /api/index.php`
- 遗留 `ADMIN_SECRET` 一次性迁移至账号密码
### 技术栈
- Nuxt 4 + Nuxt UI 4
- 本地磁盘存储 + SQLite
- sharp 服务端 WebP 压缩
- Docker 多架构镜像（amd64 / arm64）
### 路线图
- **v1.2.0**（开发中）：统一 `images/` 存储、遗留目录迁移 CLI、启动索引同步
[1.2.0]: https://github.com/O96u/PicHost/releases/tag/v1.2.0
[1.1.1]: https://github.com/O96u/PicHost/releases/tag/v1.1.1
[1.1.0]: https://github.com/O96u/PicHost/releases/tag/v1.1.0
[1.0.4]: https://github.com/O96u/PicHost/releases/tag/v1.0.4
[1.0.3]: https://github.com/O96u/PicHost/releases/tag/v1.0.3
[1.0.2]: https://github.com/O96u/PicHost/releases/tag/v1.0.2
[1.0.1]: https://github.com/O96u/PicHost/releases/tag/v1.0.1
[1.0.0]: https://github.com/O96u/PicHost/releases/tag/v1.0.0
Reference in new issue View Git Blame Copy Permalink