실행 프로그램과 확장

최종 업데이트

잘 쓰던 로컬 LLM, 모델 파일을 어떻게 백업하고 복원할까?

실행 중인 모델을 다른 저장장치에 복사하고, 원본을 그대로 둔 채 복사본으로 다시 답을 받아 봐요.

로컬 LLM1 백업2은 이미 쓰는 모델 폴더와 버전·실행 설정을 다른 저장장치에 보관하는 일이에요. 복원할 때는 백업 파일을 실행 앱에 등록하고 평소 작업이 되는지 시험해요. 폴더를 통째로 복사하는 방법부터 살펴보고, LM Studio에 단일 텍스트 GGUF3를 가져와 요약하는 예제로 복원 과정을 따라가볼게요.

실행 조건과 핵심 내용
  • 모델 저장소 ID, 고정 커밋 ID, 원래 파일명과 형식을 백업 기록에 적어요.
  • GGUF는 한 파일일 수도 있지만 분할 모델에는 모든 샤드가 필요하고, MLX와 safetensors 모델은 관련 파일을 함께 보관해요.
  • 원본 모델 폴더를 유지하고 다른 경로에 복사본을 시험하면, 문제가 생겨도 평소 쓰던 모델을 계속 사용할 수 있어요.

평소 쓰는 모델과 시험할 문서부터 정해요

문서 요약에 늘 쓰는 모델 하나로 시작해보세요. 복사하기 전에 ‘다음 주 화요일 오후 3시 점검으로 서비스가 10분 중단됩니다’라는 공지문을 넣고, ‘일정과 예상 영향을 한 문장으로 요약해줘’라고 요청해요. 이 공지문과 요청을 함께 남겨두면, 나중에 복사본을 불러온 뒤 같은 내용으로 작동을 시험할 수 있어요. 복원 시험이 끝날 때까지 원래 쓰던 모델 폴더는 그대로 두세요.

같은 파일을 다시 받으려면 저장소의 main이나 태그 대신 고정된 커밋을 기록해요. 비공개 또는 접근 제한 저장소의 재다운로드에는 승인된 계정과 이용 권한이 필요해요. 이미 보관한 모델 파일은 로컬에서 바로 복원할 수 있고, 다른 사람과 공유하거나 배포할 때는 해당 라이선스 조건을 확인해요.

금속 전달함 양쪽에 장비와 서류가 든 검은 보호 케이스가 놓인 작업 공간
모델과 실행 기록을 함께 복사해 두면 새 저장장치에서도 같은 구성을 찾기 쉬워요.

무엇을 보관할지 모델 형식에서 확인해요

먼저 앱의 모델 관리 화면에서 지금 실제로 불러오는 폴더 경로를 확인해요. ‘모델’ 이름만 기억하면 비슷한 이름의 다른 양자화4 파일이나 새 버전을 다시 받을 수 있어요. 모델 저장소의 작성자/ID, 정확한 커밋 리비전, 원래 파일명, 형식과 양자화 표기를 기록하고, 실행 앱·런타임5 버전과 대화 템플릿·컨텍스트 길이6 등 바꾼 설정도 적어 둡니다.

GGUF 파일에는 가중치와 모델을 설명하는 메타데이터가 들어 있어 단일 파일로 실행되는 모델도 있어요. 해당 모델 카드와 실행기에서 지정한 파일 목록을 확인하고, 파일명이 여러 조각으로 나뉘어 있으면 모든 샤드를 한 폴더에 보관해요. 이미지·음성을 처리하는 모델은 별도 프로젝터 파일이 필요할 수 있으니 모델 카드에 적힌 구성과 파일명을 그대로 따라요.

MLX7와 safetensors 모델은 가중치를 불러올 설정, 토크나이저, 인덱스, 샤드 파일을 함께 사용할 수 있어요. 앱이 현재 읽는 저장소 폴더 전체를 복사하고, 모델 카드에 지정된 파일도 포함해요. 모델 카드와 라이선스 사본을 폴더에 두면 저장소 ID를 잊어도 모델과 이용 조건을 다시 찾을 수 있어요.

백업 기록에 포함할 항목과 쓰임
기록남기는 이유
저장소 ID와 커밋 리비전같은 모델 파일 버전을 다시 찾기 위해
형식·양자화·원래 파일명호환 실행기와 필요한 전체 샤드를 확인하기 위해
동반 파일과 라이선스설정과 사용 조건을 함께 복원하기 위해
앱·런타임 버전과 조정값모델을 불러온 조건을 재현하기 위해

모델 폴더를 통째로 복사하고 파일을 대조해요

앱에서 확인한 모델 폴더를 파일 탐색기나 Finder로 열고, 백업 저장장치에 폴더째 복사하세요. 여러 조각으로 나뉜 가중치와 설정·토크나이저 파일도 폴더 안에 함께 남겨요. 복사가 끝나면 파일 목록과 크기를 원본과 대조하고, 앞에서 기록한 버전·실행 설정과 모델 카드·라이선스도 같은 백업에 보관하세요. 원본 폴더는 복원 시험이 끝날 때까지 그대로 둡니다.

Hub의 기본 캐시에서 폴더를 복사할 때는 심볼릭 링크를 주의하세요. snapshots 안의 파일이 blobs의 데이터로 연결된 링크라면, 링크를 따라 실제 파일을 복사하거나 링크를 보존하면서 snapshots와 blobs를 함께 복사해요. 스냅샷만 옮기면 원래 컴퓨터의 캐시를 가리키던 링크가 새 위치에서 끊길 수 있어요.

복사본의 파일 목록과 크기를 원본과 대조한 뒤, 중요한 대형 파일은 SHA-256 체크섬으로 바이트가 동일한지 확인할 수 있어요. macOS에서 터미널을 열고 아래 두 경로를 실제 GGUF 원본과 복사본의 경로로 바꿔 실행해요. 출력의 파일명 앞 체크섬 문자열 두 개가 같으면 두 경로의 파일 내용이 같아요.

macOS에서 원본 GGUF와 복사본의 체크섬 비교
shasum -a 256 "$HOME/Models/Publisher/Model/model.gguf" "/Volumes/Model-Backup/Publisher/Model/model.gguf"
두 경로를 실제 파일 위치로 바꾸세요. 파일명 앞의 체크섬 문자열이 같으면 복사본의 바이트 내용이 원본과 일치해요.

GGUF 백업을 LM Studio의 별도 폴더로 가져와 실행해요

LM Studio 앱을 한 번 연 뒤, 터미널에서 lms --help를 실행해 명령 목록이 나오는지 확인하세요. 명령을 찾을 수 없다면 CLI 준비 안내를 따라 설정해요. 아래 명령은 복사해 둔 단일 텍스트 GGUF를 backup-check/restored-model이라는 시험용 모델 폴더에 가져와요. --copy로 가져올 파일도 그대로 남겨두고, --user-repo로 평소 쓰는 모델과 다른 폴더를 지정해요. 이 시험용 폴더를 이미 사용했다면 새 이름으로 바꾸고 기존 파일을 덮어쓰지 마세요.

복사본 GGUF를 원본을 남긴 채 LM Studio에 가져오기
lms import "/Volumes/Model-Backup/Publisher/Model/model.gguf" --copy --user-repo "backup-check/restored-model"
lms ls
가져오기 전에 복사본 파일 경로와 사용하지 않은 시험용 폴더 이름을 확인하세요.

가져오기가 끝나면 lms ls나 앱의 My Models 화면에서 backup-check/restored-model 아래의 시험용 모델을 선택해요. 백업 저장장치의 파일을 가져와 만든 이 모델로 시험하는 거예요. 기록해 둔 앱·런타임 버전과 설정을 맞춘 뒤, 처음의 공지문과 요약 요청을 다시 보내세요. 답변에 화요일 오후 3시와 10분 중단이 들어가는지 확인해요.

인터넷 없이도 쓸 수 있는지 확인하려면 모델과 런타임이 준비된 상태에서 네트워크를 끊고 같은 요약을 다시 시험해요. LM Studio에서는 내려받은 LLM과 대화하거나 로컬 서버를 실행할 수 있어요. 모델 검색·새 파일과 런타임 다운로드·업데이트 확인에는 연결이 필요합니다.

평소와 다른 결과가 나오면 모델 파일 경로, 빠진 샤드, 앱이 불러온 모델 ID, 템플릿과 컨텍스트 설정부터 원래 기록과 대조해요. 로딩 오류는 런타임 호환성이나 동반 파일 누락을 알려줄 수 있고, 응답 차이는 설정이나 실행기 버전이 달라 생길 수 있어요. 모델 파일을 다시 받기 전에 어떤 단계에서 달라졌는지 확인해야 원본과 복사본의 차이를 구분할 수 있습니다.

외장 드라이브와 소형 PC가 놓인 책상, 모니터에는 저장장치 아이콘과 진행 막대가 보인다
복사본을 새 위치에서 불러와야 실제 복원이 되는지 알 수 있어요.

파일을 새로 받을 때는 고정된 커밋을 지정해요

Hugging Face에서 아직 내려받지 않은 모델을 받을 때는 저장소의 커밋 기록에서 고정된 전체 커밋 ID를 복사해요. hf download에 --revision으로 넣으면 같은 버전을 지정할 수 있고, 실제 다운로드 전에 --dry-run을 붙이면 Hub가 받을 파일 목록과 용량을 보여 줘요. 전체 저장소를 내 폴더에 일반 파일로 저장하려면 --local-dir을 추가해요. 접근 제한 모델을 새로 받을 때만 승인된 계정의 인증과 사용 권한이 필요해요.

이미 모델 폴더를 백업했다면 그 파일로 복원하면 돼요. 새로 다운로드할 때 --local-dir을 지정하면 선택한 폴더에 저장소 구조대로 일반 파일을 남길 수 있어요. 다운로드를 마친 뒤에는 앞의 복사·파일 대조·복원 시험 순서로 보관 상태를 확인하세요.

모델 백업과 앱 전체 백업은 범위가 달라요

이 글의 복원 명령은 LM Studio에서 쓰는 단일 텍스트 GGUF를 대상으로 해요. MLX·safetensors는 앞에서 설명한 대로 폴더와 동반 파일을 함께 보관하고, 복원할 때는 원래 쓰던 앱의 모델 등록 절차를 따라야 해요. 해당 앱이 요구하는 폴더 구조에 복사본을 등록한 뒤, 기록한 설정으로 같은 요약 요청을 보내 시험하세요.

개인 모델 백업에는 모델 파일과 그 파일을 불러온 앱·런타임 버전 및 설정을 기록해요. 새 컴퓨터를 인터넷 연결 없이 시작하려면 운영체제, 앱 설치 파일, 필요한 런타임도 별도로 준비해요. 먼저 평소 사용하던 앱과 런타임 버전에서 복사본을 시험하고, 다른 버전으로 바꾼 경우에는 대표 문서 요약을 다시 실행해 차이를 확인해요.

사용자 한 명이 모델 하나를 옮기는 경우에는 현재 앱에서 쓰는 모델 폴더와 설정 기록을 보관하면 돼요. 여러 장비에 같은 환경을 배포하거나 보안 구역으로 검증된 설치 묶음을 반입할 때는 오프라인·에어갭 로컬 AI 배포 가이드의 조직용 절차를 참고하세요. 개인 복원은 원본을 남긴 채 복사본으로 평소 요약을 다시 해 보는 데서 마무리해요.

복원한 모델을 쓰던 앱에도 연결하려면 OpenRouter에서 로컬 LLM으로 전환하는 순서에서 로컬 프로필과 서버 주소 설정을 이어서 살펴보세요.

노트북 옆 책상과 선반에 금속 장치 두 대가 놓여 있고 케이블이 앞쪽 스위치 상자에 연결되어 있다
복원 시험이 끝날 때까지 원래 쓰던 모델 폴더를 그대로 두세요.

용어 각주

  1. 대규모 언어 모델 — 대규모 텍스트 데이터에서 언어 패턴을 학습해 문맥에 맞는 텍스트를 처리하고 생성하는 모델입니다.

    본문으로 돌아가기
  2. 백업 — 설정과 데이터를 파일로 저장해 두는 것입니다. 기기가 고장 나도 같은 설정으로 되돌릴 수 있습니다.

    본문으로 돌아가기
  3. GGUF — 모델 정보를 담는 파일 형식으로 llama.cpp 계열 도구에서 널리 사용됩니다.

    본문으로 돌아가기
  4. 양자화 — 모델의 가중치나 계산값을 더 적은 비트로 표현해 저장 공간과 메모리 사용량을 줄이는 방법입니다. 표현 단계가 거칠어져 정확도에도 영향을 줄 수 있습니다.

    본문으로 돌아가기
  5. 런타임 — 프로그램이 실행될 때 필요한 기능을 제공하는 소프트웨어 환경입니다. 로컬 AI에서는 모델을 실행하는 엔진을 가리키기도 합니다.

    본문으로 돌아가기
  6. 컨텍스트 길이 — 한 번의 모델 요청에서 처리할 수 있는 입력과 생성 내용의 토큰 범위입니다. 지원 상한과 실제 사용 메모리는 모델 및 실행 설정에 좌우됩니다.

    본문으로 돌아가기
  7. MLX — Apple이 개발하는 머신러닝 프레임워크로, Apple Silicon의 CPU와 GPU가 공유하는 메모리를 활용해 모델을 실행합니다.

    본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?
로컬 LLM 백업은 이미 쓰는 모델 폴더와 버전·실행 설정을 다른 저장장치에 보관하는 일이에요. 복원할 때는 백업 파일을 실행 앱에 등록하고 평소 작업이 되는지 시험해요. 폴더를 통째로 복사하는 방법부터 살펴보고, LM Studio에 단일 텍스트 GGUF를 가져와 요약하는 예제로 복원 과정을 따라가볼게요.
조건과 출처는 어디서 확인하나요?
같은 파일을 다시 받으려면 저장소의 `main`이나 태그 대신 고정된 커밋을 기록해요. 비공개 또는 접근 제한 저장소의 재다운로드에는 승인된 계정과 이용 권한이 필요해요. 이미 보관한 모델 파일은 로컬에서 바로 복원할 수 있고, 다른 사람과 공유하거나 배포할 때는 해당 라이선스 조건을 확인해요.