群晖 Container Manager 部署 Snipe-IT 资产管理系统指南

本指南将介绍如何利用群晖（Synology DSM）自带的 Container Manager 套件，通过 Docker Compose 快速搭建一套属于自己的专业级开源 IT 资产管理系统 —— Snipe-IT。

第一步：准备持久化存储文件夹

为了保证容器在以后升级或重启后数据不丢失，需要先在群晖中建立好数据持久化文件夹：

打开群晖的 File Station 。
在 docker 共享文件夹下，新建一个文件夹，命名为 snipeit 。
在 snipeit 文件夹内部，新建两个子文件夹：db 和 data 。

第二步：在 Container Manager 中创建项目

打开群晖的 Container Manager 套件。
点击左侧菜单的 “项目 (Project)” 。
点击 “新增” 。
常规设置：
项目名称：输入 snipe-it 。
路径：选择刚才创建的 /docker/snipeit 文件夹。
来源：选择 “创建 docker-compose.yml” 。

第三步：编写配置代码 (YAML)

将下面的配置代码完整复制并粘贴到 Container Manager 的编辑器中。请根据实际情况修改 your_nas_ip 以及相关的数据库密码占位符：

version: '3'

services:
  snipe-db:
    image: mariadb:10.5
    container_name: snipe-db
    restart: always
    environment:
      - MYSQL_DATABASE=snipeit
      - MYSQL_USER=snipeit
      - MYSQL_PASSWORD=your_db_password          # 请修改为您的自定义数据库密码
      - MYSQL_ROOT_PASSWORD=your_root_password    # 请修改为您的自定义数据库ROOT密码
    volumes:
      - ./db:/var/lib/mysql

  snipe-it:
    image: snipe/snipe-it:latest
    container_name: snipe-it
    restart: always
    ports:
      - "8080:80"                                 # 外部访问端口，可根据需要修改
    depends_on:
      - snipe-db
    environment:
      - APP_URL=http://your_nas_ip:8080           # 请将 your_nas_ip 替换为您群晖的实际IP
      - MYSQL_PORT_3306_TCP_ADDR=snipe-db
      - MYSQL_DATABASE=snipeit
      - MYSQL_USER=snipeit
      - MYSQL_PASSWORD=your_db_password          # 必须与上方 snipe-db 中的密码保持一致
      # APP_KEY 是一个格式正确的密钥占位符，用于初始化。如提示错误可在部署后进入终端重新生成。
      - APP_KEY=base64:7f9vJ7p7vR8zXpL5mN2bQ9wT4yU1i03pA6sD0fG2hJ8=
      - APP_TIMEZONE=Asia/Shanghai
      - APP_LOCALE=zh-CN
    volumes:
      - ./data:/var/www/html/storage/uploads

第四步：运行项目

点击 “下一步”，勾选 “创建项目后立即启动” 。
Container Manager 会自动开始下载映像并创建容器。
观察终端机面板，直到看到 Exit Code: 0 并且所有的容器状态都显示为 Started (运行中)，说明容器编排搭建大功告成！

第五步：初始化 Snipe-IT

1. 环境自检 (Pre-flight Check)

打开浏览器（建议使用 Chrome 或 Edge），在地址栏输入：http://your_nas_ip:8080 。你会进入 Snipe-IT 的自检页面，正常情况下，所有的项目右侧都应该是绿色的勾。

💡 关于 Config File 红色报错提示的说明： 如果在检查中看到红色的 Config File 警告，这其实是 Snipe-IT 的一个“安全提醒”，并不是程序出错。它是在告知无法确定 .env 配置文件是否会被外网直接访问。 解决方法：如果在内网环境使用，且没有做特殊的外网映射，可以直接忽略此提示 。直接滚动到页面最底部，点击绿色的 "Next: Create Database Tables" 按钮进入下一步即可。

2. 创建数据库表

系统会自动在配置的 MariaDB 中创建资产管理所需的各种表格。这个过程通常需要跑一会儿进度条（创建上百个数据库表），完成后点击 "Next: Create User" 。

3. 设置管理员账号

在此页面创建您的首个超级管理员用户，并设定基本的应用默认值：

站点名称 (Site Name)：填入您的公司、团队或部门名称。
默认语言：选择 简体中文（若进去后仍为英文，可在系统右上角的个人资料 Profile 中重新修改）。
默认货币：填入 CNY（人民币）。
资产标签前缀：可设为自定义前缀（如 EQ- 或 AST-）。
管理员信息：设置您自己的 Full Name（姓名）、Email（邮箱）、Username（登录用户名）以及 Password（强密码）并妥善记录。

设置完成后，点击底部的 “下一页：保存用户并完成” ，即可进入系统炫酷的控制面板（Dashboard），开始录入和管理您的服务器、内存、显示器及硬盘等 IT 资产了！