linuxserver/organizr Docker 镜像 - 轩辕镜像

linuxserver/organizr - Docker镜像文档（已弃用）

⚠️ 重要提示

此镜像已弃用。请使用官方镜像：[***]

1. 镜像概述和主要用途

linuxserver/organizr 是由LinuxServer.io团队提供的Docker镜像，用于部署Organizr应用。Organizr是一个HTPC/家庭实验室服务组织器，采用PHP编写，旨在集中管理多个服务、书签、IP和端口，通过标签式界面在单个网页中展示，简化服务器管理流程。

该镜像原具备LinuxServer.io团队的典型特性（如定期应用更新、用户映射支持、自定义基础镜像等），但目前已停止维护，建议迁移至官方镜像。

2. 核心功能和特性

Organizr应用功能

• 集中管理多个服务，通过标签式界面在单个网页中展示
• 支持多标签并行加载，可并排显示两个标签
• 用户支持：可为不同用户分配特定标签访问权限
• 访客支持：允许访客访问指定标签

LinuxServer.io镜像特性（已停止维护）

• 定期及时的应用更新
• 简化的用户映射（PUID、PGID）
• 基于s6 overlay的自定义基础镜像
• 每周基础操作系统更新，跨生态共享公共层以减少空间占用、 downtime和带宽
• 定期安全更新

3. 使用场景和适用范围

• 管理多个运行在计算机或服务器上的服务
• 整合分散的书签、IP地址和端口，避免记忆负担
• 家庭实验室或个人服务器的服务集中管理界面
• 需要为多用户或访客提供差异化服务访问权限的场景

4. 支持的架构

该镜像原支持以下架构，可通过标签指定（现已弃用）：

5. 使用方法和配置说明

注意：此镜像已弃用，以下示例仅供历史参考。建议迁移至官方镜像。

5.1 Docker Compose（推荐）

yaml
---
version: "2.1"
services:
  organizr:
    image: linuxserver/organizr
    container_name: organizr
    environment:
      - PUID=1000        # 用户ID，详见5.3节
      - PGID=1000        # 组ID，详见5.3节
      - TZ=Europe/London # 时区，如Asia/Shanghai
    volumes:
      - /path/to/data:/config  # 配置文件存储路径
    ports:
      - 9983:80          # 端口映射（主机:容器）
    restart: unless-stopped

5.2 Docker Run

bash
docker run -d \
  --name=organizr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 9983:80 \
  -v /path/to/data:/config \
  --restart unless-stopped \
  linuxserver/organizr

6. 参数说明

容器运行时通过参数配置，格式为<外部>:<内部>。

7. 环境变量配置

7.1 从文件读取环境变量

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

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

上述配置会将/run/secrets/mysecretpassword文件内容作为PASSWORD环境变量的值。

7.2 Umask设置

可通过-e UMASK=022覆盖容器内服务的默认umask值（权限掩码），详情参考umask说明。

8. 用户/组标识符（PUID/PGID）

使用卷挂载（-v）时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID），确保容器内用户与主机用户权限一致。

获取当前用户的PUID和PGID：

bash
id username
# 输出示例：uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

上述示例中，PUID=1000，PGID=1000。

9. 应用设置

启动容器后，通过浏览器访问http://<主机IP>:9983即可进入Organizr配置界面，按提示完成初始设置。

10. Docker Mods

该镜像原支持通过Docker Mods扩展功能，包括：

• 专用Mods：organizr mods
• 通用Mods：universal mods

11. 支持信息

注意：镜像已弃用，官方不再提供支持。

• 容器内Shell访问：docker exec -it organizr /bin/bash
• 实时查看日志：docker logs -f organizr
• 查看容器版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' organizr
• 查看镜像版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/organizr

12. 更新说明

注意：镜像已弃用，以下方法仅适用于历史版本维护。

12.1 Docker Compose更新

bash
# 更新镜像
docker-compose pull organizr
# 重启容器
docker-compose up -d organizr
# 清理旧镜像
docker image prune

12.2 Docker Run更新

bash
# 更新镜像
docker pull linuxserver/organizr
# 停止并删除旧容器
docker stop organizr && docker rm organizr
# 用原参数重新创建容器（配置通过卷挂载保留）
docker run -d [原参数] linuxserver/organizr
# 清理旧镜像
docker image prune

12.3 Watchtower自动更新（不推荐）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once organizr

13. 本地构建

bash
git clone [***]
cd docker-organizr
docker build \
  --no-cache \
  --pull \
  -t linuxserver/organizr:latest .

ARM架构构建

需先注册qemu-user-static：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

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

14. 版本历史

• 18.04.19：修复新安装问题
• 23.03.19：切换到新基础镜像，使用arm32v7标签
• 26.02.19：安装时升级包以避免与基础镜像不匹配
• 22.02.19：基于Alpine 3.9构建
• 11.02.19：修复新应用位置的权限
• 31.12.18：迁移到v1-master分支的流水线构建
• 05.09.18：基于Alpine 3.8构建
• 10.01.18：基于Alpine 3.7构建
• 25.05.17：基于Alpine 3.6构建
• 02.05.17：添加php7-curl包
• 12.04.17：添加php7-ldap包
• 10.03.18：初始发布