lsiodev/snipe-it

linuxserver/snipe-it

https://github.com/snipe/snipe-it 简化资产管理流程，由解决实际IT与资产管理问题的团队开发，始终将出色的用户体验作为优先事项。直观的设计和批量操作功能帮助用户更高效地完成工作。

!snipe-it

镜像概述与主要用途

linuxserver/snipe-it是由LinuxServer.io团队维护的Docker镜像，提供Snipe-it资产管理系统的容器化部署方案。Snipe-it是一款开源资产管理工具，适用于IT设备、软件许可证、耗材等资产的追踪与管理，支持自定义字段、审计跟踪、报告生成等功能。该镜像具备定期更新、简化的用户权限管理、安全加固等特性，适合企业、组织或个人用于高效管理资产 inventory。

核心功能与特性

• 定期应用更新：及时获取Snipe-it应用的最新功能与安全修复
• 用户权限映射：通过PUID/PGID参数轻松配置容器内用户权限，避免权限冲突
• 自定义基础镜像：基于s6覆盖层构建，提供可靠的进程管理
• 高效维护：每周基础操作系统更新，共享通用层以减少存储空间、 downtime和带宽消耗
• 安全更新：定期进行安全补丁更新，增强容器安全性
• 多架构支持：兼容x86-64和arm64架构

支持的架构

该镜像利用Docker manifest实现多平台支持。直接拉取 lscr.io/linuxserver/snipe-it:latest 即可获取对应架构的镜像，也可通过标签指定特定架构。

应用设置

基本访问

通过 <your-ip>:8080 访问Web界面，更多信息请参考 https://github.com/snipe/snipe-it%E3%80%82

数据库要求

此容器需要连接MySQL或MariaDB服务器，推荐使用 https://github.com/linuxserver/docker-mariadb%E3%80%82

SSL配置

容器会自动生成SSL证书并存储在：

/config/keys/cert.crt
/config/keys/cert.key

如需使用自定义证书，替换上述文件即可。若要启用SSL访问，需将主机端口映射到容器的443端口，例如：

-p 443:443

环境变量配置

应用支持通过环境变量进行自定义配置，主要参数如下：

PHP自定义配置

该镜像基于LinuxServer的NGINX基础镜像构建，PHP和NGINX配置文件位于 /config/php。如需覆盖默认配置，修改 /config/php/php-local.ini 文件即可。例如调整上传文件大小：

upload_max_filesize = 16M
post_max_size = 16M

使用场景与适用范围

• IT部门资产管理：跟踪计算机、服务器、网络设备等硬件资产
• 软件许可证管理：记录软件授权信息、有效期及分配情况
• 耗材库存管理：监控办公耗材（如打印机墨盒、纸张）的库存水平
• 企业资产审计：提供资产变更历史和审计跟踪，满足合规要求
• 教育机构设备管理：管理教学设备、投影仪、实验室仪器等

使用方法

Docker Compose（推荐）

yaml
---
version: "2.1"
services:
  snipe-it:
    image: lscr.io/linuxserver/snipe-it:latest
    container_name: snipe-it
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - APP_URL=http://localhost:8080
      - MYSQL_PORT_3306_TCP_ADDR=  # MySQL服务器地址
      - MYSQL_PORT_3306_TCP_PORT=  # MySQL端口
      - MYSQL_DATABASE=  # 数据库名称
      - MYSQL_USER=  # 数据库用户
      - MYSQL_PASSWORD=  # 数据库密码
    volumes:
      - /path/to/data:/config  # 本地数据目录映射
    ports:
      - 8080:80  # Web界面端口映射
    restart: unless-stopped

Docker CLI

bash
docker run -d \
  --name=snipe-it \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e APP_URL=http://localhost:8080 \
  -e MYSQL_PORT_3306_TCP_ADDR= \  # MySQL服务器地址
  -e MYSQL_PORT_3306_TCP_PORT= \  # MySQL端口
  -e MYSQL_DATABASE= \  # 数据库名称
  -e MYSQL_USER= \  # 数据库用户
  -e MYSQL_PASSWORD= \  # 数据库密码
  -p 8080:80 \  # Web界面端口映射
  -v /path/to/data:/config \  # 本地数据目录映射
  --restart unless-stopped \
  lscr.io/linuxserver/snipe-it:latest

参数说明

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

环境变量从文件（Docker secrets）

可通过特殊前缀 FILE__ 从文件中读取环境变量。例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这会将 /run/secrets/mysecretvariable 文件的内容设置为环境变量 MYVAR。

Umask设置

所有镜像支持通过 -e UMASK=022 参数覆盖默认umask设置。umask用于控制文件权限，具体请参考 umask说明。

用户/组ID（PUID/PGID）

使用卷（-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

LinuxServer提供多种 https://github.com/linuxserver/docker-mods 以扩展容器功能。上方徽章链接至该镜像专用mods及适用于所有镜像的通用mods。

支持信息

容器内Shell访问

bash
docker exec -it snipe-it /bin/bash

实时查看日志

bash
docker logs -f snipe-it

查看容器版本

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

查看镜像版本

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

更新说明

大多数镜像为静态版本，需更新镜像并重建容器以更新应用（nextcloud、plex等少数例外）。不建议在容器内更新应用。

通过Docker Compose更新

• 更新镜像：
  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull snipe-it
    

• 更新容器：
  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d snipe-it
    

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run更新

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/snipe-it:latest
  

• 停止运行中的容器：

  bash
  docker stop snipe-it
  

• 删除容器：

  bash
  docker rm snipe-it
  

• 使用相同参数重建容器（若卷映射正确，/config 目录及设置将保留）
• 清理旧镜像：

  bash
  docker image prune
  

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

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

清理旧镜像：docker image prune

警告：不推荐使用Watchtower作为容器自动更新方案，建议长期使用 Docker Compose。

镜像更新通知 - Diun（Docker Image Update Notifier）

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

本地构建

如需本地修改或开发：

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

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

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

注册后使用 -f Dockerfile.aarch64 指定ARM64构建文件。

版本历史

• 03.07.23: - 弃用armhf架构（详见 公告）
• 13.04.23: - 将ssl.conf包含移至default.conf
• 13.04.23: - 添加php81-pecl-redis以支持Redis
• 28.12.22: - 基于Alpine 3.17重建，迁移至s6v3
• 20.08.22: - 基于Alpine 3.15重建，使用php8，重构NGINX配置（变更说明）
• 14.05.22: - 添加php7-sodium以支持v6版本
• 12.04.22: - 不构建开发组件
• 02.03.22: - 重构初始化逻辑，不显示默认compose配置
• 29.06.21: - 基于Alpine 3.14重建
• 30.04.21: - 基于Alpine 3.13重建，添加启动时artisan migrate
• 01.06.20: - 基于Alpine 3.12重建
• 19.12.19: - 基于Alpine 3.11重建
• 28.06.19: - 基于Alpine 3.10重建
• 10.04.19: - 添加V4.7.0所需的PHP依赖，确保构建时框架目录可用
• 10.04.19: - 修复新bootstrap缓存目录的权限
• 23.03.19: - 切换至新基础镜像，使用arm32v7标签
• 22.02.19: - 基于Alpine 3.9重建
• 31.10.18: - 基于Alpine 3.8重建
• 05.08.18: - 迁移至实时构建服务器
• 13.06.18: - 初始发布