Snipe-IT资产管理系统Docker部署实战：从零到日常运维的完整指南

Snipe-IT资产管理系统Docker部署实战从零到日常运维的完整指南【免费下载链接】snipe-itA free open source IT asset/license management system项目地址: https://gitcode.com/GitHub_Trending/sn/snipe-itSnipe-IT是一款免费开源的IT资产管理系统本文用Docker把部署时间压缩到一杯咖啡的功夫从环境准备、核心配置、首登设置、数据备份到日常升级一次讲透照着敲命令即可上线专治资产台账靠Excel、到期续费全靠记性的老毛病。一张表搞定几千台设备先从我那次翻车说起接手公司IT运维的第三个月老板让我盘点全公司设备。我打开前任留下的Excel三百多行资产记录有的没序列号有的采购日期是大概2019年还有几台电脑不知道在谁手里。更崩溃的是下季度有两百多个软件许可要到期全靠我手动翻合同。那阵子我每天下班都在想得有个工具把谁在用、什么时候买的、保修到几号、许可还剩几个全部管起来。后来找到了Snipe-IT——免费开源支持中文资产、配件、软件许可、耗材、维护记录全覆盖还能给每台设备打二维码标签。第一次部署我选了传统的源码安装方式装PHP、装MySQL、配Nginx、改权限、调依赖……折腾了一整天最后卡在PHP扩展版本上页面一片空白。后来换成Docker前后不到十分钟系统就跑起来了。今天我把这套折腾出来的完整流程整理给你照着做你大概率比我第一次顺利得多。动手前花两分钟确认环境与拿到项目代码Docker部署的好处是环境随镜像走但前提是你本机得有Docker和Compose。先敲下面两行确认docker --version docker compose version如果提示找不到命令先去Docker官网装好再回来。接着把项目代码拉下来git clone https://gitcode.com/GitHub_Trending/sn/snipe-it cd snipe-it这一步在做什么拉取Snipe-IT源码仓库里面有现成的docker-compose.yml、环境变量模板和启动脚本我们不需要自己从零写任何Dockerfile。一条命令启动资产系统容器编排做了什么项目根目录下有个docker-compose.yml它定义了两个服务appSnipe-IT应用本身PHP运行环境 Apache镜像里全配好了dbMariaDB数据库默认 11.4.7 版本专门存资产、用户、日志这些数据两个服务共享一个网络应用连数据库用的是服务名db不需要去记IP地址。数据通过两个命名卷持久化db_data存数据库文件storage存上传的图片、备份文件。这就是容器删了数据还在的关键。把环境模板复制成正式配置cp docker/docker.env .env然后启动docker compose up -d-d表示后台运行。第一次启动要拉镜像、初始化数据库等一两分钟后再看状态docker compose ps两个服务状态都是running就说明基本成了。如果数据库容器显示healthy、应用容器在正常运行就可以进入下一步——但是先别急着开浏览器APP_KEY还没配呢。开浏览器之前7个环境变量逐项确认.env是整个系统的总开关我把它分成三组讲每一项你都知道它是干嘛的以后排错就不慌。第一组应用基础设置APP_KEYbase64:一串随机字符 APP_URLhttp://你的服务器IP:8000 APP_TIMEZONEAsia/Shanghai APP_LOCALEzh-CNAPP_KEYLaravel框架的加密密钥相当于系统的门锁钥匙。绝对不能留默认值否则应用会直接拒绝启动。生成方法见下方代码块APP_URL系统对外访问地址填你实际访问的IP或域名APP_TIMEZONE时区国内服务器填Asia/Shanghai否则到期提醒、审计日期全乱APP_LOCALE界面语言填zh-CN就是中文界面生成密钥的命令生成后把整行APP_KEY...粘回.envdocker compose run --rm app php artisan key:generate --show第二组数据库设置DB_DATABASEsnipeit DB_USERNAMEsnipeit_user DB_PASSWORD换成强密码 MYSQL_ROOT_PASSWORD再设一个强密码DB_*是应用连数据库用的账号密码MYSQL_ROOT_PASSWORD是数据库管理员密码。这两个密码别设成一样的也别用弱口令——这台机器上存着全公司资产和人员信息。可以用这条命令生成随机密码openssl rand -base64 24第三组邮件服务可后补MAIL_MAILERsmtp MAIL_HOSTsmtp.你的域名.com MAIL_PORT587 MAIL_USERNAME发信账号 MAIL_PASSWORD发信密码 MAIL_FROM_ADDR发件人地址 MAIL_FROM_NAMESnipe-IT邮件用于资产分配通知许可到期提醒这些场景没有邮箱服务可以先留空不影响登录使用后面配好了重启容器即可。配置都填完后重启让新配置生效再刷新页面docker compose restart app浏览器访问http://你的服务器IP:8000能看到登录页就说明部署成功了。默认账号是adminexample.com密码password——这只是演示账号登录后马上改。首次登录先做这三件事再谈管理第一次登录进去别急着录资产先把地基打牢。第一件事换掉默认密码。右上角头像 → 个人资料 → 修改密码。这个默认密码在文档里写得明明白白不换等于裸奔。第二件事设置公司基本信息。左侧菜单管理 → 设置把公司名、Logo、货币单位、日期格式配好。这里有个容易被忽略的开关叫自动递增资产标签打开后新资产会自动生成编号不用手填。第三件事创建管理员之外的普通账号。系统默认只有一个管理员实际使用中建议给同事开普通账号权限按需分配别让所有人都是超级管理员。系统跑起来只是第一步它真正的价值在于录进去的数据。下面这步直接影响你每天用不用得顺手。图设备不可能永远不坏Snipe-IT的维护记录模块就是用来跟踪这些故障、维修和更换的让资产对号入座厂商、分类、状态标签缺一不可录入资产前先把几个字典表建好否则每台设备都要重复填一堆下拉框选项。厂商管理 → 厂商添加联想、戴尔、三星、苹果这些你实际在用的品牌之后录资产时直接从下拉框选。图厂商模块就是资产来源的通讯录一次维护处处引用分类资产分类建议按笔记本、台式机、显示器、手机、服务器这种粒度建。分类会影响报表统计太粗了报表没参考价值太细了维护累按公司实际情况拿捏。状态标签可用、已分配、维修中、报废、待处理——这五个是最基础的状态代表一台设备现在处于什么生命周期阶段。状态设置对了仪表盘上的可用数量、报废数量才是准的。资产型号同一批采购的机器通常型号相同把型号录好含保修时长、折旧年限批量导入时能少填大量字段。基础资料齐了就可以导入资产了。项目里自带CSV模板sample_csvs/目录下按表头填好在资产 → 导入页面直接上传即可。模板里有一列叫asset_tag资产标签建议格式统一比如NB-0001表示笔记本方便后面扫二维码识别。数据安全三板斧持久化、自动备份、恢复演练资产数据丢了比系统宕机更可怕——那意味着又要回到Excel时代。这一节的三件事我建议一件都别省。第一板斧确认数据卷。项目默认用Docker卷持久化容器删了重建数据不丢。docker compose down不会删卷但docker compose down -v会连卷一起删——-v参数平时千万别乱加。第二板斧开启自动备份。Snipe-IT自带备份命令进容器执行docker compose exec app php artisan backup:run备份文件会生成到容器内的/var/lib/snipeit/dumps目录对应storage卷。建议配一条定时任务每天凌晨自动备份。如果你把备份目录映射到了宿主机还能把备份文件同步到异地或对象存储形成双保险。第三板斧演练一次恢复。光备份不练恢复等于没备份。恢复流程大致是把备份文件拷回容器、用php artisan restore命令还原、重启服务。建议你在测试环境完整跑一遍把命令记在运维手册里——真出事那天你肯定没心思现查命令。新手最容易踩的5个坑我基本都踩过一遍坑一APP_KEY没配或用了默认值。症状是容器启动后立刻退出日志提示缺少APP_KEY。解法就是上面那行key:generate命令别偷懒。坑二docker compose down -v手滑删了数据。这个命令会把数据库卷一起删掉等于格式化。规范做法平时只用docker compose down不带-v真要重置才用带-v的版本且确认数据已备份。坑三数据库连不上两个容器时间不同步。如果应用日志报数据库连接错误先看数据库容器是不是健康状态再确认.env里DB_HOST是dbcompose 内的服务名而不是localhost或写死的IP。坑四上传图片/导入CSV报文件过大。默认上传限制偏小。在.env里加一行然后重启echo PHP_UPLOAD_LIMIT100M .env docker compose restart app坑五改完.env不重启配置不生效。.env是在容器启动时读取的改完必须docker compose restart app。改数据库密码之类的关键配置建议直接docker compose up -d --force-recreate重建容器更干净。日常维护与升级别让系统在角落里落灰每天看一眼日志。两个命令就够docker compose logs -f app docker compose logs -f db每周看一眼磁盘。备份文件和上传图片会慢慢变大docker compose exec app df -h升级流程记住四步。Snipe-IT迭代很活跃跟着上游更新能拿到新功能和安全补丁。先备份再拉新代码然后更新镜像并重启最后跑数据库迁移git pull origin master docker compose pull docker compose up -d docker compose exec app php artisan migrate --force升级前一定先做一次backup:run迁移失败还能回滚。定期清理过期登录尝试和日志。系统内置了清理命令比如清除失效的登录尝试记录可以挂在定时任务里避免数据表越积越肥。进阶玩法LDAP登录、Redis加速与到期提醒系统跑顺了之后这三件事能让它从能用变成好用。接入LDAP/AD登录。公司如果已有域控或LDAP服务在设置里配好LDAP地址、基础DN和账号映射员工就能用公司账号直接登录省掉单独维护一套密码的麻烦。上Redis缓存。用户多、查询频繁后文件缓存会吃力。在compose里加一个Redis服务把.env里的CACHE_DRIVER、SESSION_DRIVER、QUEUE_CONNECTION都改成redis页面响应会明显变快。把到期提醒用起来。在设置里配置提醒天数和接收邮箱软件许可到期前系统会自动发邮件给管理员——这是Snipe-IT最值钱的功能之一能把许可逾期被厂商找上门这种事彻底杜绝。相关提醒命令如许可到期、资产审计到期都在artisan里配合 cron 定时执行即可。看完这篇接下来照着做这5件事确认本机有Docker与Compose克隆代码cp docker/docker.env .env生成并填入APP_KEY设置数据库密码、时区、语言docker compose up -d登录后立刻改默认密码在设置里配好公司信息和资产编号规则建厂商、分类、状态标签用sample_csvs/里的模板批量导入第一批资产配置自动备份把每日备份 每月升级前手动备份写进你的运维清单资产管理的收益是用出来的台账清晰、到期有提醒、盘点有依据。今天花二十分钟把系统搭起来往后每个季度能省下的核对时间远不止这二十分钟。【免费下载链接】snipe-itA free open source IT asset/license management system项目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考