linuxserver/fleet 镜像文档

弃用通知

该镜像已弃用。我们将不再为该镜像提供支持，也不会进行更新。
由于难以维持必要的开发水平，我们已弃用Fleet容器及Fleet应用。

镜像概述和主要用途

LinuxServer.io团队提供的fleet容器镜像，原用于提供在线Web界面，展示一个或多个自有仓库中的维护镜像集合。该镜像基于LinuxServer.io的自定义基础镜像构建，现已停止维护。

核心功能和特性

原镜像具备LinuxServer.io容器的典型特性（镜像已弃用，以下特性不再更新）：

• 定期及时的应用更新
• 简易的用户权限映射（PGID、PUID）
• 基于s6 overlay的自定义基础镜像
• 每周基础操作系统更新，通过跨生态通用层减少存储空间占用、 downtime和带宽消耗
• 定期安全更新

使用场景和适用范围

原适用于需要通过Web界面集中管理和展示Docker镜像仓库中维护镜像的场景。由于该镜像已弃用，不推荐用于新部署，现有用户应考虑迁移至其他替代方案。

支持的架构

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

应用设置

1. 访问[***]打开主页。
2. 若认证方式设为DATABASE，需通过[***]创建初始用户。设置完成后，该页面将不可访问，建议重启容器以彻底移除该页面。
3. 通过[***]登录系统管理仓库。

只读操作

该镜像可在只读容器文件系统下运行，详情参考官方文档（镜像已弃用，文档可能失效）。

非Root用户运行

该镜像支持非Root用户运行，详情参考官方文档（镜像已弃用，文档可能失效）。

使用方法

以下为原镜像的部署方法（仅作历史参考，不推荐生产使用）：

Docker Compose（推荐）

---
services:
  fleet:
    image: lscr.io/linuxserver/fleet:latest
    container_name: fleet
    environment:
      - PUID=1000                # 用户ID（详见下方说明）
      - PGID=1000                # 组ID（详见下方说明）
      - TZ=Etc/UTC               # 时区，参考时区列表
      - fleet_admin_authentication_type=DATABASE  # 认证方式（DATABASE或PROPERTIES）
      - fleet_database_url=jdbc:mariadb://<url>:3306/fleet  # 数据库JDBC连接字符串
      - fleet_database_username=fleet_user  # 数据库用户名
      - fleet_database_password=dbuserpassword  # 数据库密码
      - fleet_admin_secret=randomstring  # 可选，密码加密密钥
    volumes:
      - /path/to/fleet/config:/config  # 配置文件和日志存储路径
    ports:
      - 8080:8080                # HTTP端口映射
    restart: unless-stopped

Docker CLI

docker run -d \
  --name=fleet \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e fleet_admin_authentication_type=DATABASE \
  -e fleet_database_url=jdbc:mariadb://<url>:3306/fleet \
  -e fleet_database_username=fleet_user \
  -e fleet_database_password=dbuserpassword \
  -e fleet_admin_secret=randomstring `#可选` \
  -p 8080:8080 \
  -v /path/to/fleet/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/fleet:latest

参数说明

环境变量从文件读取（Docker Secrets）

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

-e FILE__MYVAR=/run/secrets/mysecretvariable

上述命令会将MYVAR环境变量的值设置为/run/secrets/mysecretvariable文件的内容。

应用Umask设置

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

用户/组ID说明

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

获取当前用户的PUID和PGID：

id your_user

示例输出：

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

支持信息（镜像已弃用，以下命令仅作参考）

• 容器运行时进入Shell：

  docker exec -it fleet /bin/bash
  

• 实时查看容器日志：

  docker logs -f fleet
  

• 查看容器版本：

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

• 查看镜像版本：

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

更新信息（镜像已弃用，不再提供更新）

通过Docker Compose更新

• 更新镜像：

  • 所有镜像：docker-compose pull
  • 单个镜像：docker-compose pull fleet

• 更新容器：

  • 所有容器：docker-compose up -d
  • 单个容器：docker-compose up -d fleet

• 清理旧镜像：docker image prune

通过Docker Run更新

• 更新镜像：docker pull lscr.io/linuxserver/fleet:latest
• 停止容器：docker stop fleet
• 删除容器：docker rm fleet
• 重新创建容器（使用原参数，/config目录会保留配置）
• 清理旧镜像：docker image prune

本地构建

如需修改镜像（仅作开发或定制）：

git clone [***]
cd docker-fleet
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/fleet:latest .

在x86_64硬件上构建ARM架构镜像，需使用lscr.io/linuxserver/qemu-static：

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

然后通过-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 03.06.25: - 镜像弃用
• 24.12.24: - 基于Alpine 3.21重新构建
• 04.06.24: - 基于Alpine 3.20重新构建
• 20.03.24: - 基于Alpine 3.19重新构建
• 12.07.23: - 基于Alpine 3.18重新构建
• 13.02.23: - 基于Alpine 3.17重新构建，迁移至s6v3
• 02.05.22: - 基于Alpine 3.15重新构建
• 13.12.21: - 添加CVE-2021-44228漏洞缓解措施
• 26.04.20: - 更新以同步Fleet v2.0.0分支
• 19.12.19: - 基于Alpine 3.11重新构建
• 02.07.19: - 基于Alpine 3.10重新构建；Fleet启动失败时停止容器
• 19.05.19: - ARM版本使用新基础镜像
• 01.04.19: - 初始发布