lsiodev/fleet

linuxserver/fleet

镜像概述和主要用途

https://github.com/linuxserver/fleet 是由LinuxServer.io团队提供的Docker镜像，它提供一个在线Web界面，用于显示一个或多个自有仓库中的维护镜像。该镜像具有定期应用更新、简单的用户映射(PGID/PUID)、基于s6 overlay的自定义基础镜像、每周基础操作系统更新以及定期安全更新等特点。

核心功能和特性

• 提供直观的Web界面，集中展示维护的Docker镜像
• 支持多架构部署（x86-64、arm64v8）
• 灵活的用户认证管理（DATABASE或PROPERTIES模式）
• 与数据库集成（如MariaDB）存储用户和配置信息
• 支持通过环境变量自定义配置
• 遵循LinuxServer.io容器标准，确保安全性和稳定性

支持的架构

该镜像利用Docker manifest实现多平台支持，拉取lscr.io/linuxserver/fleet:latest即可自动获取适合您架构的镜像，也可通过标签指定特定架构：

应用设置

1. 导航至http://your_ip_here:8080访问主页
2. 若认证类型设置为DATABASE，需通过http://your_ip_here:8080/setup创建初始用户
3. 用户创建完成后，该设置页面将不再可用，建议重启容器以完全移除该页面
4. 通过http://your_ip_here:8080/login登录应用管理仓库

使用方法和配置说明

docker-compose（推荐）

yaml
---
version: "2.1"
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  # 数据库连接URL
      - fleet_database_username=fleet_user  # 数据库用户名
      - fleet_database_password=dbuserpassword  # 数据库密码
      - fleet_admin_secret=randomstring # 可选，密码密钥派生字符串
    volumes:
      - /path/to/appdata/config:/config  # 配置文件和日志存储路径
    ports:
      - 8080:8080               # HTTP端口映射
    restart: unless-stopped     # 重启策略

docker cli

bash
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/appdata/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/fleet:latest

参数说明

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

环境变量从文件获取（Docker secrets）

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

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

这将根据/run/secrets/mysecretpassword文件内容设置PASSWORD环境变量。

Umask设置

所有镜像支持通过-e UMASK=022覆盖默认umask设置。注意umask是权限减法而非加法，详情参考umask说明。

用户/组标识符

使用卷（-v标志）时，主机OS和容器之间可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机上的卷目录由指定用户拥有。

使用id user命令获取您的PUID和PGID：

bash
$ id username
  uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Docker Mods

LinuxServer.io提供多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%93%E7%94%A8%E5%8F%8A%E9%80%9A%E7%94%A8mods%E3%80%82

支持信息

• 容器运行时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
• 使用相同参数重新创建容器（配置将通过卷保留）
• 清理旧镜像：docker image prune

通过Watchtower自动更新（仅推荐用于忘记原始参数的情况）

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

注意：不建议将Watchtower用于自动化更新，长期推荐使用Docker Compose。

镜像更新通知 - Diun

推荐使用Diun接收更新通知，不建议使用自动更新容器的工具。

本地构建

如需本地修改或自定义镜像：

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

在x86_64硬件上构建ARM变体需使用multiarch/qemu-user-static：

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

注册后使用-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 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：初始发布