更新日志

0.0.5 · 2026-10-25

• 一键备份还原回来了：后台「备份还原」重新可用，而且不再依赖 pg_dump。备份是一个压缩文件（.fmbak），每天自动备份一次；还原在一个事务里完成，中途出错整体回滚，不会把库弄坏。
• 旧数据库自动导入：数据目录里有旧的 mediaserver.db、新库又是空的，启动时自动导入一次，不用再手动敲命令。新库里已经有数据时不会自动导入（避免覆盖），需要的话仍可手动执行 migrate-sqlite。
• 播放失败会告诉你为什么：以前只是黑屏。现在读不到文件时，播放器直接显示原因，比如”找不到媒体文件：容器里没有这个路径，请检查 compose 里是否把对应目录挂进来了（/strm、/CloudNAS、/CloudHub）“，没权限、连不上服务器也都有对应提示。
• 环境自检：控制台顶部新增「环境自检」（启动时也写进日志）。检查数据库、数据目录能否写入、ffmpeg / ffprobe、核显转码设备、每个媒体库的路径是否存在、抽查 STRM 指向的文件是否真的在容器里、面板连接、TMDB 连通性和响应速度、代理设置。黑屏、刮削慢这类问题，先看这里。
• 部署更省事：新增 .env.example（填一下数据库密码即可），compose 示例补上了代理写法和说明；文档新增「环境自检」「代理」两节。

0.0.4 · 2026-10-24

• 新增媒体库后自动扫描一次：和 Emby 一样，添加完媒体库就开始扫描并刮削，不用再手动点。修改已有媒体库不会触发。
• 去掉媒体库里的「刮削方式」选项（轻量 / 直读）：Emby 没有这个选项，现在扫描后就是刮削元数据。要不要读取媒体信息（分辨率、编码等）由「设置」里统一的「探测方式」决定（播放时探测 / 扫描后批量探测 / 不探测）。旧媒体库里存着的这个选项会被忽略。

0.0.3 · 2026-10-24

• 数据库换成 PostgreSQL：不再用 SQLite 文件，多人同时使用、媒体多时不再互相卡住。部署时要多带一个 PostgreSQL 容器，compose 示例已经包含；DATABASE_URL 是必填项。
• 旧数据可以导入：已有的 mediaserver.db / playback_reporting.db 用 migrate-sqlite 命令一次导入，可重复执行，旧文件不会被改动。步骤见部署指南。
• 播放报表的「自定义查询」改为在 PostgreSQL 的只读事务里执行（限时 10 秒、最多 1000 行），写 SQL 时用 PostgreSQL 语法。
• 应用内的「备份还原」暂时不可用（接口会提示），请用 pg_dump 备份，命令见部署指南。
• 启动时 PostgreSQL 还没就绪会自动等待（最多 60 秒），不用再手工排启动顺序。

0.0.2 · 2026-10-22

• 修复：不挂载数据目录、直接 docker run 镜像时启动失败（找不到 /app/data）。现在镜像自带数据目录并声明为卷；正式使用仍建议把数据目录挂载出来，参考 compose 示例。

0.0.1 · 2026-10-22

FlixMedia 首个公开版本：Emby 兼容的媒体服务器，Docker Hub 镜像 huanhq99/flixmedia（amd64 / arm64）。

• Emby 兼容：Infuse、Emby 客户端等直接添加使用；影视 / 音乐 / 照片 / 书籍 / 电视直播（M3U + XMLTV、预约录制）。
• 自带用户系统：和 Emby 一样创建用户、改密码、设管理员；第一次打开是设置向导（语言 → 授权码 → 管理员 → 添加媒体库 → 元数据）。界面支持简体中文 / English。
• 授权：和 FlixPilot 面板共用同一个授权码，买了面板就能用（一个授权码 = 1 个面板 + 1 个 FlixMedia）；接了已激活的面板会自动激活，没授权时除激活页外都不能用。
• 可单独运行：不接 FlixPilot 面板也能用；TMDB 默认走内置中转，不用自己申请密钥。接了面板还能用面板账号登录、网盘直链和秒传校验。
• 刮削与整理：TMDB 刮削（TheTVDB / OMDb / Fanart 可选）、NFO、二级分类、多版本合并、虚拟媒体库、归档刮削。
• 转码：HLS 按需转码，拖动不用从头转；HDR 自动色调映射（含杜比视界 Profile 5，Intel 核显 Vulkan）；画质档位、字幕烧录、选音轨；Intel 核显硬件加速，失败自动退回 CPU。
• 网页播放器：照 Emby 的播放界面重做——进度条拖动 / 悬停预览、上一集 / 下一集、信息 / 章节、音轨 / 字幕 / 画质 / 倍速、键盘快捷键、自动播放下一集；海报上一键播放。
• 在线字幕：SubHD（免账号）、射手网、OpenSubtitles。
• 运维：播放报表、计划任务、任务中心、Webhook、备份还原、并发 / 设备限制、API 密钥、插件中心；可从另一台 Emby 导入已看 / 收藏 / 播放历史。
• 部署：独立容器、独立数据目录；docker compose up -d 即可，详见部署指南。

2026-10-21（SubHD 字幕源）

• 在线字幕新增 SubHD（subhd.tv）：中文字幕最全，不需要账号；搜索 + 下载 + zip 解压；网址可改（subhd.me / subhd.one）。

2026-10-21（转码补全）

• 转码：HDR 片源自动做色调映射；画质档位（1080 / 720 / 480）；字幕烧录（外挂、内嵌文本、内嵌图形）；选音轨；同一部片换设置时旧会话让位，名额满了让给最久没人要分段的会话；核显失败自动退回 CPU，失败按片子记录，多部失败才整体停用核显。
• 网页播放器：新增「音轨 / 字幕 / 画质」菜单；内嵌文本字幕直接显示（首次提取后缓存）。
• 音乐：浏览器放不了的格式（APE / WMA / DSD…）自动转 MP3 播放。
• 修复：字幕烧录时 -copyts 下的关键帧间隔不对导致分段长度异常。

2026-10-21（独立成项目）

• 媒体服务器从 FlixPilot 仓库独立出来，成为独立项目 FlixMedia（本目录），换用新的 logo，网页界面的名称、标题同步改为 FlixMedia；二进制由 flixpilot-mediaserver 改名为 flixmedia。
• 面板通过 MEDIASERVER_EXTERNAL 对接独立部署的 FlixMedia，不再把 FlixMedia 打进面板镜像；面板里旧的 Go 版媒体服务器已删除，面板不再负责拉起媒体服务器。

2026-10-20

FlixPilot 内置的 Emby 兼容媒体服务器正式命名为 FlixMedia，并补齐了 Emby 的主要能力。

部署

• 面板（3005）和 FlixMedia（3001）可以拆成两个容器、两个独立项目，升级或重启面板不再打断播放。
• 面板启动时会自动清掉上次留下的失效云盘挂载点，普通重启也能自动恢复挂载。

新功能

• 音乐库：读取 MP3 / FLAC / M4A / OGG 标签和内嵌封面，按歌手 → 专辑 → 曲目浏览，MusicBrainz 补封面；同名 .lrc 或内嵌歌词，网页播放条歌词随播放滚动；按歌曲 / 专辑 / 歌手生成电台（Instant Mix）。
• 照片库、书籍库：按文件夹浏览，照片缩略图、大图查看；电子书在线打开或下载，有声书直接播放。
• 电视直播：导入 M3U 频道和 XMLTV 节目单（支持 .gz），频道分组、当前节目、节目单；预约录制（DVR），录好后网页和 Emby 客户端都能播放。
• 转码：浏览器或播放器放不了的格式由服务器转成 HLS（H.264 + AAC），按段生成，拖动进度不用从头转；可设最高分辨率、并发路数、画质，可选 VAAPI 硬件加速。
• 在线字幕：射手网（assrt）和 OpenSubtitles 搜索下载，Emby 客户端的「搜索字幕」同样可用。
• 蓝光 / DVD 原盘目录、本地预告片、影院片头（播放前先放预告片）。
• DLNA：电视、投影、VLC 在局域网里直接浏览播放（默认关闭，需要 host 网络）。
• 右键菜单：添加到合集、播放列表、编辑字幕、片头 / 片尾标记、清除章节图；个人首选项（音轨、字幕、自动下一集等）会同步到 Emby 客户端。
• 播放报表：新增「谁看过」和「清理已删除用户」；从 Emby 导入时，装了播放报表插件的完整播放历史也会一起导入。