fix(media): allow guest media access, per-file local thumbnails and optional cover proxy

Author: pikachuren

internal/bootstrap/data/setting.go

@@ -277,6 +277,8 @@ func InitialSettings() []model.SettingItem {
 			Help: `开启后提供 OpenSubsonic API（/rest），可供 Symfonium、Feishin、Amperfy 等音乐客户端接入`},
 		{Key: conf.MediaSubsonicProxyStream, Value: "false", Type: conf.TypeBool, Group: model.MEDIA, Flag: model.PRIVATE,
 			Help: `Subsonic 播放默认返回 302 直链；若客户端不跟随重定向，可开启此项改为服务端代理转发（占用服务器带宽）`},
+		{Key: conf.MediaProxyCover, Value: "false", Type: conf.TypeBool, Group: model.MEDIA, Flag: model.PRIVATE,
+			Help: `开启后由服务端代理 TMDB/豆瓣等外部封面图片，适合直连图片域名受限的网络；默认关闭，直接使用原始图片地址`},
 		{Key: conf.MediaStrmOnScan, Value: "false", Type: conf.TypeBool, Group: model.MEDIA, Flag: model.PRIVATE,
 			Help: `扫描完成后自动把媒体条目生成为 .strm 文件并写入下方目录`},
 		{Key: conf.MediaStrmPath, Value: "/strm", Type: conf.TypeString, Group: model.MEDIA, Flag: model.PRIVATE,

internal/conf/const.go

@@ -191,6 +191,7 @@ const (
 	MediaEmbyEnabled         = "media_emby_enabled"           // Emby 兼容 API 开关
 	MediaSubsonicEnabled     = "media_subsonic_enabled"       // OpenSubsonic API 开关
 	MediaSubsonicProxyStream = "media_subsonic_proxy_stream"  // Subsonic 播放是否强制代理（兼容不跟随 302 的客户端）
+	MediaProxyCover           = "media_proxy_cover"           // 是否通过服务端代理外部封面（TMDB/豆瓣等）
 	MediaStrmOnScan          = "media_strm_on_scan"           // 扫描完成后自动生成 STRM
 	MediaStrmPath            = "media_strm_path"              // STRM 输出目录（VFS 路径）
 	MediaStrmOverwrite       = "media_strm_overwrite"         // 生成 STRM 时是否覆盖已存在文件

internal/media/scraper/book_local.go

@@ -79,7 +79,7 @@ func (s *BookLocalScraper) ScrapeBookLocal(item *model.MediaItem, reader io.Read
 				coverData = extractPDFCoverData(data)
 			}
 			if len(coverData) > 0 {
-				cover := s.storeCover(item.FolderPath, coverData)
+				cover := s.storeCover(strings.TrimSuffix(item.FolderPath, "/")+"/"+item.FileName, coverData)
 				if cover != "" {
 					item.Cover = cover
 				}

internal/media/scraper/image.go

@@ -90,7 +90,7 @@ func (s *ImageScraper) ScrapeImage(item *model.MediaItem, reader io.Reader) erro
 	// ── 2. 生成缩略图并存储 ──────────────────────────────────────
 	if s.ThumbnailMode == "local" {
 		// 本地存储模式：将缩略图保存到指定目录，Cover 存储本地路径
-		if localPath := s.saveThumbnailLocal(item.FolderPath, data); localPath != "" {
+		if localPath := s.saveThumbnailLocal(strings.TrimSuffix(item.FolderPath, "/")+"/"+item.FileName, data); localPath != "" {
 			item.Cover = localPath
 		}
 		// 本地存储失败时 cover 保持为空，不降级为文件路径

server/handles/media_extra.go

@@ -28,6 +28,8 @@ type MediaStatus struct {
 	StrmPath         string   `json:"strm_path"`
 	StrmOnScan       bool     `json:"strm_on_scan"`
 	ThumbPath        string   `json:"thumb_path"`
+	Version          string   `json:"version"`
+	ProxyCover       bool     `json:"proxy_cover"`
 }
 
 // PublicMediaStatus 公开的媒体库状态
@@ -38,6 +40,8 @@ func PublicMediaStatus(c *gin.Context) {
 	status.StrmPath = media.DefaultStrmOptions(apiBase).OutputPath
 	status.StrmOnScan = setting.GetBool(conf.MediaStrmOnScan)
 	status.ThumbPath = setting.GetStr(conf.MediaThumbnailPath, "/imgs")
+	status.Version = conf.Version
+	status.ProxyCover = setting.GetBool(conf.MediaProxyCover)
 	if !status.Enabled {
 		common.SuccessResp(c, status)
 		return

server/router.go

@@ -133,6 +133,16 @@ func Init(e *gin.Engine) {
 	g.Any("/rest/*path", handles.SubsonicAPI)
 
 	_fs(auth.Group("/fs"))
+	// 媒体库公开 API：与文件浏览一致，允许访客访问（访客仍受自身 base_path/权限限制）
+	mediaPublic := auth.Group("/fs/media", handles.RequireMediaEnabled)
+	mediaPublic.GET("/list", handles.PublicListMedia)
+	mediaPublic.GET("/item/:id", handles.PublicGetMedia)
+	mediaPublic.GET("/albums", handles.PublicListAlbums)
+	mediaPublic.GET("/album", handles.PublicGetAlbum)
+	mediaPublic.GET("/folders", handles.PublicListFolders)
+	mediaPublic.GET("/scan_paths", handles.PublicListScanPaths)
+	mediaPublic.GET("/strm", handles.GetMediaStrm)
+	mediaPublic.GET("/stream_url", handles.GetMediaStreamURL)
 	fsAndShare(api.Group("/fs", middlewares.Auth(true)))
 	_task(auth.Group("/task", middlewares.AuthNotGuest))
 	_sharing(auth.Group("/share", middlewares.AuthNotGuest))
@@ -262,17 +272,6 @@ func fsAndShare(g *gin.RouterGroup) {
 	a.Any("/meta", handles.FsArchiveMetaSplit)
 	a.Any("/list", handles.FsArchiveListSplit)
 
-	// 媒体库公开API（媒体库关闭时整组 404）
-	mediaPublic := g.Group("/media", handles.RequireMediaEnabled)
-	mediaPublic.GET("/list", handles.PublicListMedia)
-	mediaPublic.GET("/item/:id", handles.PublicGetMedia)
-	mediaPublic.GET("/albums", handles.PublicListAlbums)
-	mediaPublic.GET("/album", handles.PublicGetAlbum)
-	mediaPublic.GET("/folders", handles.PublicListFolders)
-	mediaPublic.GET("/scan_paths", handles.PublicListScanPaths)
-	mediaPublic.GET("/strm", handles.GetMediaStrm)
-	mediaPublic.GET("/stream_url", handles.GetMediaStreamURL)
-
 	// 转码 - 用户态：申请播放
 	g.POST("/transcode/play", handles.RequireMediaEnabled, handles.TranscodePlay)
 }