lsiodev/tester

linuxserver/tester

镜像概述和主要用途

linuxserver/tester是LinuxServer.io团队提供的内部工具镜像，主要用作CI（持续集成）流程中的桌面沙箱，用于抓取功能端点的截图，以验证端点是否正常工作。该镜像基于LinuxServer.io的自定义基础镜像构建，包含s6 overlay，并定期进行应用更新和安全更新。

核心功能和特性

• CI流程集成：作为桌面沙箱，用于CI过程中抓取端点截图，验证功能
• 自动协议识别：可自动确定目标端点的正确协议和使用程序
• 多平台支持：通过Docker manifest实现多架构支持（当前仅支持x86-64）
• 简化用户映射：支持PUID/PGID用户映射，方便权限管理
• 定期更新：包含定期应用更新、每周基础OS更新和安全更新

支持的架构

该镜像利用Docker manifest实现多平台感知，拉取lscr.io/linuxserver/tester:latest即可获取适合当前架构的镜像，也可通过标签指定特定架构。

使用方法和配置说明

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  tester:
    image: docker.xuanyuan.run/linuxserver/tester:latest
    container_name: tester
    environment:
      - URL=http://google.com
    ports:
      - 3000:3000
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=tester \
  -e URL=http://google.com \
  -p 3000:3000 \
  --restart unless-stopped \
  docker.xuanyuan.run/linuxserver/tester:latest

参数说明

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

环境变量与Docker secrets

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

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

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

应用Umask设置

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

Docker Mods

LinuxServer.io提供多种https://github.com/linuxserver/docker-mods以扩展容器功能。上述徽章链接可查看此镜像专用及通用的mods。

支持信息

• 容器运行时Shell访问：docker exec -it tester /bin/bash
• 实时监控容器日志：docker logs -f tester
• 查看容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' tester
• 查看镜像版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/tester:latest

更新信息

大多数镜像为静态版本化，需更新镜像并重建容器以更新应用。不建议在容器内更新应用。

通过Docker Compose更新

• 更新所有镜像：docker-compose pull
• 更新单个镜像：docker-compose pull tester
• 重建容器：docker-compose up -d（或单个容器：docker-compose up -d tester）
• 清理旧镜像：docker image prune

通过Docker Run更新

• 更新镜像：docker pull docker.xuanyuan.run/linuxserver/tester:latest
• 停止容器：docker stop tester
• 删除容器：docker rm tester
• 用相同参数重建容器（若正确映射主机文件夹，/config及设置将保留）
• 清理旧镜像：docker image prune

通过Watchtower自动更新（仅用于忘记原始参数时）

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

注意：不推荐使用Watchtower作为自动更新容器的解决方案，建议长期使用https://docs.linuxserver.io/general/docker-compose。

镜像更新通知 - Diun

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

本地构建

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

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

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

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

注册后，可使用-f Dockerfile.aarch64指定ARM64的Dockerfile。

版本历史

• 16.04.23：使用Chromium镜像作为基础
• 16.11.22：回滚rdesktop基础镜像中引入延迟的sesman变更
• 24.10.22：基底更新至Alpine 3.16，迁移至s6v3
• 18.04.20：初始发布