用Docker快速部署Snipe-IT：一份从零开始的IT资产管理系统完整指南

用Docker快速部署Snipe-IT：一份从零开始的IT资产管理系统完整指南

【免费下载链接】snipe-itA free open source IT asset/license management system项目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it

想象一下这个场景：周五下午，老板突然问"咱们公司现在有多少台笔记本还在保修期内？去年采购的那批显示器到底分给谁了？"如果你还在翻 Excel 表、挨个问同事，那这篇文章就是为你准备的。Snipe-IT 是一款免费开源的 IT 资产与许可证管理系统，专门解决"设备去哪了、谁在用、什么时候该维护"这三件事，而本文将带你用 Docker 在 30 分钟内把它跑起来。

第一章·初见：Snipe-IT 能帮你管什么

先花一分钟搞清楚它到底是什么。Snipe-IT 基于 PHP + Laravel 开发，通过浏览器访问，不需要安装任何客户端。它的核心职责可以浓缩成一句话：让每一台设备、每一份软件许可都有据可查。

谁最适合用它？团队 5 人以上、开始有专职行政或运维人员的中小企业；被 Excel 台账折磨的 IT 管理员；以及那些设备数量超过 50 台、靠脑子已经记不住的组织。如果你是单机个人玩家、设备就三五台，那它对你来说反而有点重。

第二章·启程：上手前的环境清单

好在 Snipe-IT 官方提供了成熟的 Docker 镜像，你不需要手动装 PHP、配 Apache、调数据库。不过有几样东西得先备好。

📌提示：Windows 用户建议启用 WSL2 后端，macOS 用户记得给 Docker Desktop 至少分配 4GB 内存，否则后续运行会卡顿。

准备工作就三步：装好 Docker、装好 Git、留出 2GB 磁盘空间。接下来进入正题。

第三章·实战：Snipe-IT 的一键安装步骤

从拉取代码到登录后台，全程 6 步。

第1步：克隆项目仓库

git clone https://gitcode.com/GitHub_Trending/sn/snipe-it cd snipe-it

第2步：生成环境配置文件

项目自带一份配置模板，复制一份改名为.env即可：

cp docker/docker.env .env

这份文件里集中了数据库、邮件、缓存等所有关键设置，后续调整都改它。

第3步：生成应用密钥 APP_KEY

Laravel 应用要求一个随机密钥用于加密，用官方镜像一行生成：

docker run --rm snipe/snipe-it php artisan key:generate --show

把输出的长字符串复制下来，填到.env的APP_KEY=后面。

第4步：修改数据库连接配置

用编辑器打开.env，重点核对这几项（注意 Docker Compose 环境下主机名必须是db）：

DB_HOST=db DB_DATABASE=snipeit DB_USERNAME=snipeit DB_PASSWORD=换成你自己的强密码 MYSQL_ROOT_PASSWORD=再换一个根密码 APP_URL=http://服务器IP:8000 APP_TIMEZONE=Asia/Shanghai

⚠️注意：模板里DB_HOST默认是${MYSQL_PORT_3306_TCP_ADDR}，这是老式 Docker 链接的变量，在 Compose 环境里不会被解析，必须手动改成db，否则应用连不上数据库。这是新手最常见的第一个坑。

第5步：启动服务

docker compose up -d

它会拉取snipe/snipe-it应用镜像和mariadb:11.4.7数据库镜像，自动完成建库、迁移数据表等初始化动作。首次运行需要几分钟，耐心等它跑完。

第6步：验证部署

# 查看容器状态，两个服务都应为 Up docker compose ps # 实时查看应用日志，确认没有报错 docker compose logs -f app

浏览器访问http://服务器IP:8000，看到 Snipe-IT 登录页就成功了。默认管理员账号是admin@example.com，密码password（登录后请立刻修改）。

第四章·进阶：场景化配置与个性化玩法

系统跑起来只是开始，下面三个配置能让你在日常使用中真正省心。

场景一：数据备份的配置方法

数据库卷虽安全，但"备份"永远要掌握在自己手里。利用容器自带的 mysqldump 写个备份脚本：

#!/bin/bash # backup.sh：每日凌晨备份数据库到本地 TIMESTAMP=$(date +%Y%m%d_%H%M%S) docker compose exec -T db mysqldump \ -u snipeit -p你的密码 snipeit > backup_$TIMESTAMP.sql # 只保留最近30天的备份 find . -name "backup_*.sql" -mtime +30 -delete

再用 crontab 挂个定时任务：

(crontab -l 2>/dev/null; echo "0 2 * * * $(pwd)/backup.sh") | crontab -

场景二：缓存与队列的优化配置

用户多了以后，文件缓存和同步队列会成为瓶颈。.env里切换到 Redis：

CACHE_DRIVER=redis SESSION_DRIVER=redis QUEUE_CONNECTION=redis

同时把 session 有效期调短、开启自动过期，减少僵尸会话占用的内存：

SESSION_LIFETIME=1200 EXPIRE_ON_CLOSE=true

场景三：邮件通知的接入配置

保修到期提醒、归还催办全靠它。用 SMTP 服务商（如 QQ 邮箱、阿里云邮件推送）：

MAIL_MAILER=smtp MAIL_HOST=smtp.example.com MAIL_PORT=587 MAIL_USERNAME=你的发件账号 MAIL_PASSWORD=你的授权码 MAIL_FROM_ADDR=noreply@example.com MAIL_FROM_NAME=IT资产中心

改完.env后记得重启容器使配置生效：docker compose up -d --force-recreate。

第五章·避坑：高频问题速查手册

Q1：页面一直转圈，登录页都出不来？A：先docker compose ps看 app 容器是否在跑；再用docker compose logs app查日志。90% 是端口没放开——云服务器记得在安全组里放行 8000 端口。

Q2：报错"APP_KEY is missing"？A：.env里APP_KEY为空或没填对。重新执行第3步生成密钥，粘贴后重启容器。

Q3：应用能打开，但提示数据库连接失败？A：检查.env的DB_HOST是否为db（Compose 服务名），以及DB_DATABASE、DB_USERNAME、DB_PASSWORD是否与 docker-compose.yml 中MYSQL_*环境变量一致。

Q4：上传图片或附件总失败？A：默认上传体积受限。进入容器确认限制值：docker compose exec app php -i | grep upload_max_filesize。若需要调大，可在docker/000-default.conf对应的 PHP 配置中提升upload_max_filesize后重建容器。

Q5：docker compose up -d之后没数据了？A：检查是否误删了命名卷。项目用db_data和storage两个命名卷持久化数据库和上传文件，严禁用docker compose down -v或手动删卷，否则数据永久丢失。

💡技巧：升级版本前务必先跑一次备份脚本，再把git pull、docker compose pull、docker compose up -d、php artisan migrate --force按顺序执行，最后登录后台验证功能。

收尾：从一台设备到一套体系

到这里，你已经拥有了一套能追溯每台设备"从采购到报废"全生命周期的管理系统。下一步建议：先录入 10 台真实设备走通"建型号→建资产→借出归还→打印标签"全流程，再让行政和财务同步使用。想要深入，可以从项目的数据库迁移文件（database/migrations/）理解数据模型，或参考docker/目录定制自己的容器编排。

参考入口：项目说明 README.md、Docker 部署说明 docker/README.md、接口测试说明 TESTING.md、容器定义 Dockerfile。

【免费下载链接】snipe-itA free open source IT asset/license management system项目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it