Emby媒体服务器Docker镜像

概述

Emby Server是一款基于Service Stack、jQuery、jQuery mobile和Mono等开源技术构建的家庭媒体服务器。本Docker镜像基于Arch Linux系统，集成了最新稳定版Emby Server，提供便捷的家庭媒体管理与流式传输功能，支持将本地媒体内容（电影、音乐、照片等）组织并流式传输到多种设备。

核心功能与特性

• 家庭媒体集中管理：统一组织电影、电视剧、音乐、照片等各类媒体文件，自动生成元数据和封面
• 跨设备流式传输：支持向智能电视、手机、平板、电脑等多设备实时流式传输媒体内容
• 开源技术架构：基于成熟的开源技术栈（Service Stack、jQuery等）构建，确保稳定性和可扩展性
• Arch Linux基础：采用Arch Linux作为基础镜像，提供最新的系统组件和依赖库
• 灵活配置选项：通过环境变量和卷挂载自定义存储路径、用户权限和运行参数

使用场景

适用于构建家庭媒体中心，满足以下需求：

• 集中存储和管理家庭媒体库，避免文件散乱
• 随时随地通过网络访问家庭媒体内容
• 为家庭成员提供个性化的媒体浏览和播放体验
• 简化媒体文件的分类、检索和播放流程

使用方法与配置说明

基本部署命令

docker run -d \
    -p 8096:8096 \
    --name=<容器名称> \
    -v <媒体文件路径>:/media \
    -v <配置文件路径>:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e HEALTHCHECK_COMMAND=<健康检查命令> \
    -e HEALTHCHECK_ACTION=<健康检查操作> \
    -e HEALTHCHECK_HOSTNAME=<健康检查主机名> \
    -e UMASK=<创建文件的权限掩码> \
    -e PUID=<用户ID> \
    -e PGID=<组ID> \
    binhex/arch-emby

参数详解

端口映射

• -p 8096:8096：Emby Server的Web管理界面和媒体流服务端口（必须映射）

数据卷配置

• -v <媒体文件路径>:/media：挂载本地媒体文件目录，Emby将扫描此目录中的媒体内容
• -v <配置文件路径>:/config：挂载本地目录用于持久化存储Emby的配置文件、元数据和日志
• -v /etc/localtime:/etc/localtime:ro：挂载主机时区文件（只读），确保容器与主机时区同步

环境变量配置

• HEALTHCHECK_COMMAND：自定义健康检查命令（可选）
• HEALTHCHECK_ACTION：健康检查失败时执行的操作（可选）
• HEALTHCHECK_HOSTNAME：健康检查使用的主机名（可选）
• UMASK：创建文件的权限掩码，控制新文件的默认权限（例如000表示无权限限制）
• PUID：运行Emby服务的用户ID，用于控制对挂载目录的访问权限
• PGID：运行Emby服务的组ID，与PUID配合控制文件访问权限

应用访问

部署完成后，通过以下地址访问Emby Server管理界面：
<主机IP地址>:8096

部署示例

以下是一个完整的部署示例，挂载本地媒体目录和配置目录，并设置基础权限：

docker run -d \
    -p 8096:8096 \
    --name=emby-server \
    -v /media/movies:/media \
    -v /apps/docker/emby/config:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e UMASK=000 \
    -e PUID=1000 \
    -e PGID=1000 \
    binhex/arch-emby

配置注意事项

获取PUID和PGID

为确保容器内用户对挂载目录有正确访问权限，需指定运行用户的PUID（用户ID）和PGID（组ID）。可通过以下命令获取目标用户的PUID和PGID：

id <用户名>

示例输出（其中1000分别为PUID和PGID）：
uid=1000(username) gid=1000(username) groups=1000(username),4(adm),24(cdrom)...