linuxserver/ombi

linuxserver/ombi

镜像概述和主要用途

Ombi 是一个自托管的 Plex 请求与用户管理系统。如果您正在与其他用户共享 Plex 服务器，Ombi 允许用户通过易于管理的界面请求新内容。该镜像由 LinuxServer.io 团队提供，具备定期应用更新、简单用户映射（PGID/PUID）、基于 s6 overlay 的自定义基础镜像、每周基础系统更新及安全更新等特性。

核心功能和特性

Ombi 核心功能

• 内容请求管理：用户可通过界面请求电影和电视内容，管理员集中处理
• 通知系统：用户请求新内容时发送通知
• 问题反馈：允许用户针对请求内容提交问题（如音频问题等）
• 每周新闻通讯：自动向用户发送 Plex 服务器新增内容的周报

LinuxServer.io 镜像特性

• 多架构支持（x86-64、arm64）
• 稳定版与开发版标签分离
• 支持只读容器文件系统运行
• 环境变量配置简化（含基础路径、时区等）
• 用户/组权限控制（PUID/PGID）

支持的架构

该镜像通过 Docker manifest 实现多平台支持，拉取 lscr.io/linuxserver/ombi:latest 即可自动获取对应架构镜像，也可通过标签指定具体架构：

版本标签

应用设置

初始安装后，通过 <您的IP>:3579 访问 Web 界面，按照设置向导完成初始化配置，然后按需配置 Plex 等必要服务。

只读操作注意事项

该镜像支持只读容器文件系统运行（需参考 https://docs.linuxserver.io/misc/read-only/），但存在限制：

• BASE_URL 无法从默认值 / 修改

使用方法

docker-compose（推荐）

yaml
---
services:
  ombi:
    image: docker.xuanyuan.run/linuxserver/ombi:latest
    container_name: ombi
    environment:
      - PUID=1000        # 用户ID，需与宿主机目录权限匹配
      - PGID=1000        # 组ID，需与宿主机目录权限匹配
      - TZ=Etc/UTC       # 时区，如 Asia/Shanghai
      - BASE_URL=/       # 可选，基础路径，仅在反向代理时可能需要
    volumes:
      - /path/to/ombi/config:/config  # 配置文件存储路径
    ports:
      - 3579:3579        # Web界面端口
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=ombi \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e BASE_URL=/ `#可选` \
  -p 3579:3579 \
  -v /path/to/ombi/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/ombi:latest

配置参数说明

环境变量扩展

Docker Secrets

可通过 FILE__ 前缀从文件加载环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

将从 /run/secrets/mysecretvariable 文件内容设置 MYVAR 环境变量。

Umask 设置

通过 -e UMASK=022 可覆盖容器内服务的默认 umask 值（注意 umask 是权限减法而非加法，详情参考 umask 说明）。

用户/组标识符

使用卷（-v）时，为避免宿主机与容器权限冲突，需指定 PUID（用户ID）和 PGID（组ID）。确保宿主机卷目录的所有者与指定的 PUID/PGID 一致。

通过以下命令获取当前用户的 PUID 和 PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

通过 Docker Mods 可扩展容器功能，上述徽章链接提供适用于 Ombi 的专用 Mods 和通用 Mods 列表。

支持信息

容器内 Shell 访问

bash
docker exec -it ombi /bin/bash

实时日志监控

bash
docker logs -f ombi

版本查看

• 容器版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' ombi
  

• 镜像版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/ombi:latest
  

更新方法

通过 Docker Compose

• 更新镜像：

  bash
  # 更新所有镜像
  docker-compose pull
  # 仅更新 ombi
  docker-compose pull ombi
  

• 更新容器：

  bash
  # 更新所有容器
  docker-compose up -d
  # 仅更新 ombi
  docker-compose up -d ombi
  

• 清理旧镜像：

  bash
  docker image prune
  

通过 Docker Run

• 更新镜像：

  bash
  docker pull docker.xuanyuan.run/linuxserver/ombi:latest
  

• 停止并删除旧容器：

  bash
  docker stop ombi && docker rm ombi
  

• 使用原参数重新创建容器（配置文件在 /config 卷中，将被保留）

镜像更新通知

推荐使用 https://crazymax.dev/diun/ 接收更新通知，不建议使用自动更新容器的工具。

本地构建

bash
git clone https://github.com/linuxserver/docker-ombi.git
cd docker-ombi
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/ombi:latest .

跨架构构建（如 x86_64 构建 ARM 镜像）需先注册 qemu-static：

bash
docker run --rm --privileged docker.xuanyuan.run/linuxserver/qemu-static --reset

然后使用对应架构的 Dockerfile（如 -f Dockerfile.aarch64）。

版本历史

• 08.07.24: 基于 Ubuntu Noble 重构
• 01.07.23: 移除 armhf 架构支持
• 11.09.22: 迁移至 s6v3
• 01.05.22: 基于 Ubuntu Jammy 重构
• 26.04.21: 更新 tarball 名称，支持 v4 稳定版构建
• 18.01.21: 更新上游仓库，v4-preview 标签合并至 development
• 14.04.20: 添加 Ombi ***链接
• 10.05.19: 添加基础路径环境变量
• 23.03.19: 切换至新基础镜像，使用 arm32v7 标签
• 09.01.19: 支持多架构构建，添加 aarch64 镜像
• 05.03.18: 切换至 Ombi v3 稳定版（基于 .NET Core）
• 17.02.17: 初始发布