FlixMedia · 管理
配置参考
环境变量、数据目录、后台设置项和功能开关。
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
DATA_DIR | ../data | FlixMedia 自己的数据目录（数据库、转码缓存、封面）。镜像里设为 /app/data。不和面板共用；面板的内部密钥文件只读挂进这个目录 |
DATABASE_URL | 无（必填） | PostgreSQL 连接串，例如 postgres://flixmedia:密码@postgres:5432/flixmedia。启动时数据库没就绪会等最多 60 秒 |
MEDIASERVER_PORT | 3001 | 监听端口 |
API_UPSTREAM | http://127.0.0.1:8080 | FlixPilot 面板的内部地址 |
HTTP_PROXY / HTTPS_PROXY / ALL_PROXY / NO_PROXY | 空 | 标准代理环境变量，和 Emby 一样：设了之后程序所有出站请求（TMDB 等元数据来源、插件、下载等）都走代理，NO_PROXY 里的地址不走（比如 127.0.0.1,localhost,192.168.0.0/16，本机和局域网的面板、网盘服务要放进去）。支持 http://、socks5://。设置页「元数据」里填了出站代理时，TMDB 以设置页为准 |
MEDIASERVER_DISCOVERY | on | 设为 off 关闭 Emby 局域网发现（UDP 7359） |
MEDIASERVER_ADVERTISE_URL | 空 | 局域网发现和 DLNA 对外宣告的地址（Docker 桥接、反向代理场景填 http://IP:3001） |
FFMPEG_BIN | ffmpeg | ffmpeg 路径（缩略图、录制、转码） |
FFPROBE_BIN | PATH 里的 ffprobe | ffprobe 路径（读取媒体信息） |
COVER_FONT | 内置 | 媒体库封面用的中文字体文件 |
RUST_LOG | info | 日志级别（debug、flixmedia=debug 等） |
TZ | 空 | 同时作为 PostgreSQL 会话时区，统计里「今天」「按天」按它算 |
数据目录
| 文件 / 目录 | 内容 |
|---|---|
mediaserver-internal.token | 和面板对话的内部密钥（由面板生成，只读） |
image-cache/、item-images/、covers/、thumbs/ | 图片缓存、用户指定的条目图片、媒体库封面、剧照缩略图 |
music-art/、photo-thumbs/ | 音乐内嵌封面、照片缩略图 |
transcode/ | 转码分段缓存（一小时没人用自动删除） |
subcache/ | 字幕缓存：从视频里提取出来的内嵌字幕、转成 UTF-8 的外挂字幕 |
recordings/ | 直播录制默认保存位置（可在后台改） |
uploads/ | 上传的图片等 |
后台设置项
网页界面「设置」「通用」里：
| 位置 | 内容 |
|---|---|
| 设置 → 海报与剧照 | 图片方式（由服务器中转并缓存 / 直接跳转 TMDB 图床）、图床镜像、缓存上限 |
| 设置 → 媒体信息探测 | ffprobe 探测方式：播放时探测（默认）/ 扫描后批量（只处理本地文件）/ 关闭 |
| 设置 → 元数据下载器 | TheTVDB、OMDb、Fanart 的 API 密钥（在媒体库设置里按库启用） |
| 设置 → 在线字幕 | SubHD 开关和网址（不需要 Key）、射手网 Token、OpenSubtitles API Key（和账号，可选） |
| 设置 → 转码 | 是否允许、HDR 色调映射开关、最高分辨率、同时转码路数、画质（CRF）、硬件加速（自动 / VAAPI / 不用） |
| 设置 → 影院片头 | 是否启用、预告片数量、自定义片头目录 |
| 通用 | 服务器名称（局域网发现、DLNA 和客户端里显示的名字，默认 FlixMedia） |
| 电视直播 | M3U / XMLTV 来源、频道显示、录制目录 |
密钥类设置保存后不回显，留空表示保持原值，勾选「清除」才会删除。
功能开关（插件中心 → 内置）
可开关：Nfo 元数据、播放报表、Webhook、局域网发现、DLNA。其中局域网发现、DLNA 改动后需要重启服务生效。
DLNA 默认关闭：DLNA 协议没有登录，开启后只接受局域网直连（拒绝带 X-Forwarded-For 等转发头的请求）。
不可开关的是核心能力（TMDB、TheTVDB、OMDb、Fanart、STRM、备份、计划任务等），只显示状态和跳转到对应设置页。
个人首选项
每个用户在网页界面自己设置：显示（浅色 / 深色）、主页面栏目、播放（默认音轨语言、自动下一集等）、字幕（语言、模式、大小）。这些设置同时写进 Emby 的 User.Configuration，Infuse、Emby 官方 App 等客户端也会读到。