Snipe-IT 자체 구축 완전 가이드: 오픈소스 IT 자산 관리의 신, 무료 JAMF 및 Snipe-IT Cloud 대안

mkdir -p ~/snipe-it && cd ~/snipe-it

version: '3.8'

services:
  snipeit-db:
    image: mysql:8.0
    container_name: snipeit-db
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword123
      MYSQL_DATABASE: snipeit
      MYSQL_USER: snipeit
      MYSQL_PASSWORD: snipeit_password_456
    volumes:
      - db-data:/var/lib/mysql
    restart: always
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

  snipeit:
    image: snipe/snipe-it:latest
    container_name: snipe-it
    ports:
      - "8080:80"
    environment:
      # 데이터베이스 설정
      DB_HOST: snipeit-db
      DB_DATABASE: snipeit
      DB_USERNAME: snipeit
      DB_PASSWORD: snipeit_password_456
      # 애플리케이션 설정
      APP_KEY: base64:CHANGE_ME_GENERATE_KEY
      APP_ENV: production
      APP_DEBUG: false
      APP_URL: http://localhost:8080
      APP_TIMEZONE: Asia/Shanghai
      APP_LOCALE: zh-CN
      # 이메일 설정(선택사항)
      MAIL_PORT_587_TCP_ADDR: smtp.example.com
      MAIL_PORT_587_TCP_PORT: 587
      MAIL_ENV_FROM_ADDR: admin@yourcompany.com
      MAIL_ENV_FROM_NAME: Snipe-IT Admin
      MAIL_ENV_ENCRYPTION: tls
      MAIL_ENV_USERNAME: admin@yourcompany.com
      MAIL_ENV_PASSWORD: your-email-password
    depends_on:
      snipeit-db:
        condition: service_healthy
    volumes:
      - snipeit-images:/var/lib/snipeit
    restart: always

volumes:
  db-data:
  snipeit-images:

# 임시 컨테이너를 실행하여 키 생성
docker run --rm snipe/snipe-it:latest php artisan key:generate --show

# 출력 예시: base64:abcdef1234567890...
# 출력 값을 docker-compose.yml의 APP_KEY에 대체

docker compose up -d

# 로그로 시작 상태 확인
docker compose logs -f snipeit

# Admin → Custom Fields에서 추가
필드명          유형        형식
CPU 모델         텍스트
메모리 크기       텍스트
운영체제         드롭다운    macOS, Windows, Linux
소속 부서        드롭다운    R&D, 제품부, 디자인부
내부망 IP 주소    텍스트       ^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$

curl -X GET "https://snipeit.yourcompany.com/api/v1/hardware" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X POST "https://snipeit.yourcompany.com/api/v1/hardware" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Dell XPS 15",
    "asset_tag": "DELL-2026-001",
    "model_id": 3,
    "status_id": 1,
    "rtd_location_id": 1,
    "purchase_date": "2026-07-30",
    "purchase_cost": "9999.00",
    "serial": "SN123456789"
  }'

#!/usr/bin/env python3
"""신입 직원 온보딩 시 IT 자산 기록 자동 생성"""

import requests

SNIPE_URL = "https://snipeit.yourcompany.com/api/v1"
API_TOKEN = "YOUR_API_TOKEN"

def onboard_employee(name, email, asset_tag, model_id=1):
    """신규 직원에게 노트북 할당"""
    headers = {
        "Accept": "application/json",
        "Authorization": f"Bearer {API_TOKEN}",
        "Content-Type": "application/json",
    }

    # 1. 사용자 생성
    user = requests.post(f"{SNIPE_URL}/users", headers=headers, json={
        "first_name": name.split()[0],
        "last_name": name.split()[-1],
        "username": email.split("@")[0],
        "email": email,
    })

    if user.status_code != 200:
        print(f"사용자 생성 실패: {user.text}")
        return

    user_id = user.json()["payload"]["id"]

    # 2. 자산 할당
    checkout = requests.post(
        f"{SNIPE_URL}/hardware/{asset_tag}/checkout",
        headers=headers,
        json={"assigned_user": user_id}
    )

    if checkout.status_code == 200:
        print(f"✅ {name} 님에게 자산 {asset_tag} 할당 완료")
    else:
        print(f"❌ 자산 할당 실패: {checkout.text}")

# 사용 예시
onboard_employee("张三", "zhangsan@company.com", "MBP-2026-015")

# 데이터베이스 내보내기
docker exec snipeit-db mysqldump -u snipeit -psnipeit_password_456 snipeit > \
  ~/backup/snipeit-$(date +%Y%m%d).sql

# 영구 볼륨 데이터 내보내기
tar czf ~/backup/snipeit-images-$(date +%Y%m%d).tar.gz \
  /var/lib/docker/volumes/snipe-it_snipeit-images/

cd ~/snipe-it

# 최신 이미지 풀
docker compose pull snipeit

# 컨테이너 재생성
docker compose up -d snipeit

# 버전 확인
docker exec snipe-it php artisan snipeit:version