13년차의 서버실

서버, 인프라, 홈랩 기술 블로그

[태그:] 성능 최적화

  • [CI/CD] Kubernetes 환경 Jenkins: 1년 운영하며 겪은 성능 최적화와 안정화 사례

    [CI/CD] Kubernetes 환경 Jenkins: 1년 운영하며 겪은 성능 최적화와 안정화 사례

    [CI/CD] Kubernetes 환경 Jenkins: 1년 운영하며 겪은 성능 최적화와 안정화 사례

    안녕하세요, 13년차 서버실 지킴이입니다. 오늘은 Kubernetes(쿠버네티스) 환경에서 Jenkins(젠킨스)를 1년 넘게 운영하며 겪었던 삽질과 그 과정에서 얻은 성능 최적화, 안정화 노하우를 풀어볼까 합니다. 많은 분들이 CI/CD(지속적 통합/지속적 배포) 파이프라인 구축에 Jenkins를 사용하고 계실 텐데, 특히 Kubernetes 위에서 Jenkins를 돌리면서 “이게 맞나?” 싶었던 경험들 있으실 거예요. 제가 딱 그랬거든요. 😅

    처음엔 마냥 좋다고 생각했던 Jenkins on Kubernetes가 생각보다 많은 운영 난이도를 요구했습니다. 툭하면 죽는 빌드 에이전트, 느려터진 빌드 시간, 예상치 못한 마스터 다운까지… 정말이지 밤낮없이 씨름했던 기억이 생생합니다. 이 글에서는 제가 직접 부딪히며 해결했던 문제들과 그 과정을 여러분들께 멘토처럼 상세히 알려드릴게요. 혹시 비슷한 고민을 하고 계셨다면, 제 경험이 조금이나마 도움이 되기를 바랍니다! 🙏

    Kubernetes 환경 Jenkins 아키텍처 개요: 마스터와 동적 에이전트 파드들의 상호작용

    Jenkins on Kubernetes, 왜 선택했을까요? (개념 설명)

    Jenkins는 워낙 유명한 CI/CD 자동화 도구죠. 프로젝트 빌드, 테스트, 배포 등 개발 프로세스의 여러 단계를 자동화해주는 역할을 합니다. 그런데 이걸 왜 굳이 Kubernetes 위에서 돌리냐고요? 간단히 말해서, 유연성과 확장성 때문입니다.

    • 동적 에이전트 프로비저닝 (Dynamic Agent Provisioning): Kubernetes의 가장 큰 장점 중 하나인데요, 빌드가 필요할 때만 Jenkins Agent(젠킨스 에이전트) Pod(파드)를 생성하고, 빌드가 끝나면 자동으로 제거할 수 있습니다. 덕분에 리소스를 효율적으로 사용할 수 있고, 동시에 여러 빌드를 처리할 때도 필요한 만큼 에이전트를 늘릴 수 있죠.
    • 높은 가용성 (High Availability): Kubernetes는 컨테이너화된 애플리케이션의 고가용성을 보장합니다. Jenkins Master(젠킨스 마스터) Pod가 문제가 생겨도 Kubernetes가 자동으로 다른 노드에 재시작해주니, 서비스 중단 시간을 최소화할 수 있습니다.
    • 환경 일관성 (Environment Consistency): 모든 빌드가 컨테이너 안에서 이뤄지므로, 개발 환경과 동일한 환경에서 빌드 및 테스트를 진행할 수 있어서 “내 로컬에서는 되는데 서버에서는 안 돼요!” 하는 문제를 줄일 수 있습니다.

    이런 장점들 덕분에 저도 Kubernetes 환경으로 Jenkins를 옮기기로 결정했었죠. 하지만 현실은 녹록지 않았습니다. 😅

    실전 구현: Jenkins Kubernetes 플러그인과 Pod Template

    Kubernetes에서 Jenkins를 운영하려면 Jenkins Kubernetes Plugin(젠킨스 쿠버네티스 플러그인)이 필수인데요. 이 플러그인이 Jenkins Master와 Kubernetes 클러스터 간의 통신을 담당하면서 동적으로 에이전트 Pod를 생성하고 관리하는 핵심 역할을 수행합니다. 플러그인 설치 후, 가장 중요한 설정은 Pod Template(파드 템플릿)입니다.

    Pod Template은 Jenkins Agent Pod가 어떤 이미지로, 어떤 리소스를 가지고 생성될지 정의하는 YAML 설정이거든요. 처음에는 기본 설정으로 시작했지만, 곧바로 성능 병목에 부딪혔습니다. 다음은 제가 주로 사용했던 Pod Template의 핵심 부분입니다.

    apiVersion: v1
    kind: Pod
    spec:
      containers:
      - name: jnlp
        image: jenkins/inbound-agent:4.11.2-1-jdk11
        resources:
          requests:
            cpu: "500m"
            memory: "1Gi"
          limits:
            cpu: "1"
            memory: "2Gi"
        # ... (생략) ...
      - name: build-tools
        image: my-private-registry/custom-build-image:latest
        command: ["cat"]
        tty: true
        resources:
          requests:
            cpu: "1"
            memory: "2Gi"
          limits:
            cpu: "2"
            memory: "4Gi"
        # ... (생략) ...
      volumes:
      - name: jenkins-workspace
        emptyDir: {}
      # ... (생략) ...
    

    여기서 `jnlp` 컨테이너는 Jenkins와 통신하는 기본 에이전트고, `build-tools`는 실제 빌드 도구들이 들어간 커스텀 이미지더라고요. 여기서 중요한 부분은 바로 resources 섹션입니다. 처음에는 이 부분을 대충 설정했다가 빌드 에이전트들이 자꾸 죽는 현상을 겪었어요. ⚠️

    Jenkins UI Kubernetes 플러그인 설정 화면: Pod Template 구성 예시

    Jenkins UI 내 Kubernetes 플러그인 설정 화면: Pod Template 구성 예시

    ⚠️ 1년 운영하며 겪은 삽질과 성능 최적화/안정화 사례

    자, 이제 본론입니다. 1년 동안 겪었던 문제들과 그 해결책들을 공유해 드릴게요.

    1. 빌드 에이전트 OOMKilled (메모리 부족) 현상

    가장 흔하게 겪었던 문제입니다. 빌드 도중에 에이전트 Pod가 갑자기 OOMKilled(Out Of Memory Killed, 메모리 부족으로 종료됨) 상태가 되면서 빌드가 실패하는 거죠. 처음엔 원인을 몰라 헤맸는데, 알고 보니 Pod Template의 resources.limits.memory 설정이 너무 낮았던 것이었습니다.

    • 문제점: 빌드 프로세스가 예상보다 많은 메모리를 사용하면서 Kubernetes가 Pod를 강제로 종료시킴.
    • 해결책: resources.requests와 resources.limits를 현실적으로 설정하는 것이 중요합니다. requests는 Pod가 스케줄링될 때 필요한 최소한의 리소스, limits는 Pod가 최대로 사용할 수 있는 리소스예요. 처음에 빌드를 여러 번 돌려보면서 실제로 필요한 메모리 양을 측정했습니다. 빌드 과정에서 peak 메모리 사용량을 모니터링해서 넉넉하게 잡아주는 게 중요하더라고요.
        resources:
          requests:
            cpu: "1"
            memory: "2Gi" # 최소 2GB 요청
          limits:
            cpu: "2"
            memory: "4Gi" # 최대 4GB까지 사용 허용
    

    💡 팁: requests는 Kubernetes 스케줄러가 노드를 선택하는 기준이 되고, limits는 CGroup(컨트롤 그룹)에 의해 Pod의 최대 리소스 사용량을 제한합니다. 너무 타이트하면 OOMKilled 되고, 너무 넉넉하면 리소스 낭비가 될 수 있으니 적절한 튜닝이 필요합니다.

    2. 느린 이미지 풀링 (Image Pull) 시간

    동적 에이전트의 가장 큰 장점 중 하나지만, 매번 빌드 에이전트 Pod가 생성될 때마다 필요한 Docker Image(도커 이미지)를 다운로드(Pull)해야 한다는 단점도 있습니다. 특히 빌드 에이전트 이미지가 크거나, 여러 개의 이미지를 사용하는 경우 빌드 시작 시간이 너무 길어지는 문제가 발생했습니다.

    • 문제점: 빌드 시작 시 Docker Image Pull 시간 때문에 전체 빌드 시간이 길어짐.
    • 해결책:
      1. 로컬 Docker Registry(도커 레지스트리) 사용: 사설 Docker Registry를 클러스터 내부에 구축하고, 이미지를 미리 이곳에 캐싱해두면 Pull 속도가 훨씬 빨라집니다.
      2. Node에 Image Pre-pulling: Kubernetes Worker Node(워커 노드)에 DaemonSet(데몬셋)을 이용해서 자주 사용하는 에이전트 이미지를 미리 Pull 해두는 방법도 효과적이었습니다. 이렇게 하면 Pod가 스케줄링될 때 이미지가 이미 로컬에 있어 바로 실행될 수 있죠.
      3. Jenkins Agent 이미지 최적화: 빌드에 필요한 최소한의 도구만 포함된 경량 이미지를 만들었습니다. 불필요한 레이어를 줄이고, 베이스 이미지를 최신으로 유지하는 것도 중요하더라고요.

    3. Jenkins Master의 안정성 확보

    아무리 에이전트가 잘 돌아가도 Master가 불안정하면 모든 CI/CD 파이프라인이 멈춥니다. Master Pod의 잦은 재시작이나 데이터 손실은 정말 끔찍하죠.

    • 문제점: Master Pod의 리소스 부족, 데이터 손실 위험.
    • 해결책:
      1. Persistent Volume Claim (PVC) 사용: Jenkins Master의 /var/jenkins_home 디렉터리는 빌드 설정, 플러그인, 빌드 이력 등 중요한 데이터가 저장되는 곳이거든요. 반드시 Persistent Volume Claim(PVC, 영구 볼륨 클레임)을 사용하여 데이터를 영구적으로 저장해야 합니다. 저는 NFS(네트워크 파일 시스템) 기반의 PV(영구 볼륨)를 사용했는데, 클라우드 환경에서는 EBS, Azure Disk, GCE Persistent Disk 등을 활용할 수 있습니다.
      2. Master Pod 리소스 충분히 할당: Master Pod도 적절한 CPU와 Memory를 할당해야 합니다. 너무 적으면 UI가 느려지거나, 플러그인 로딩 중 OOMKilled 될 수 있습니다.
      3. Configuration as Code (CasC) 도입: Jenkins 설정을 YAML 파일로 관리하는 CasC(Configuration as Code)는 Master의 안정성을 높이는 데 크게 기여했습니다. 설정을 Git에 버전 관리하고, Jenkins 재시작 시 자동으로 적용되도록 하여 휴먼 에러를 줄이고 재현 가능한 환경을 구축할 수 있었습니다.
    최적화 전후 Jenkins 빌드 시간 및 Kubernetes 리소스 사용량 비교 Grafana 대시보드

    최적화 후 빌드 시간 단축 및 리소스 사용량 안정화 결과

    4. 네트워크 성능 문제 (대용량 아티팩트 전송)

    빌드 결과물(Artifacts, 아티팩트)이 크거나, 빌드 과정에서 외부 리소스(Maven Repository 등)를 자주 다운로드받는 경우 네트워크 병목이 발생할 수 있습니다.

    • 문제점: 대용량 아티팩트 전송 및 외부 리소스 다운로드로 인한 빌드 지연.
    • 해결책:
      1. 클러스터 내부 캐싱 프록시: Maven, npm 등의 패키지 매니저를 위한 캐싱 프록시(예: Sonatype Nexus, Artifactory)를 클러스터 내부에 구축하여 외부 네트워크 트래픽을 줄였습니다.
      2. 빠른 스토리지 사용: PVC에 사용하는 스토리지가 느리면 빌드 과정에서 파일 I/O(입출력) 성능 저하가 발생합니다. 가능한 한 SSD 기반의 고성능 스토리지를 사용하는 것이 좋습니다.
      3. 불필요한 아티팩트 최소화: 빌드 후 Jenkins에 저장하거나 전송하는 아티팩트의 크기를 최소화하도록 파이프라인을 최적화했습니다.

    검증 및 결과: 드디어 안정화! 🎉

    위에 언급된 최적화들을 적용하고 나니, 거짓말처럼 Jenkins 환경이 안정화되기 시작했습니다. 빌드 실패율은 현저히 줄었고, 빌드 시간도 평균 30% 이상 단축되는 성과를 얻을 수 있었습니다. 특히 동적 에이전트의 효율적인 리소스 사용 덕분에 클러스터 비용도 절감할 수 있었죠.

    • 빌드 성공률: 60% → 95% 이상으로 향상
    • 평균 빌드 시간: 5분 → 3분 내외로 단축 (프로젝트별 상이)
    • 리소스 사용 효율: 유휴 에이전트 감소로 클러스터 리소스 활용률 증가

    이러한 개선 사항들은 Prometheus(프로메테우스)와 Grafana(그라파나)를 통해 모니터링하면서 실시간으로 확인했습니다. 특히 빌드 성공/실패율, 큐(Queue)에 대기 중인 빌드 수, 에이전트 Pod의 리소스 사용량 등을 꾸준히 트래킹하면서 추가적인 개선점을 찾아나갔습니다. 📈

    Kubernetes Jenkins 운영 최적화 주요 포인트 요약 인포그래픽

    Kubernetes Jenkins 운영 최적화 주요 포인트 요약 인포그래픽

    마무리: 멘토로서의 조언과 다음 단계

    Kubernetes 환경에서 Jenkins를 운영하는 것은 분명 도전적인 일입니다. 처음에는 “이거 왜 이렇게 어렵지?” 싶다가도, 하나하나 문제를 해결해나가면서 시스템이 안정화되는 모습을 보면 정말 뿌듯하더라고요. 제가 13년 동안 인프라 엔지니어로 일하면서 느낀 건, 삽질은 결국 성장의 밑거름이 된다는 겁니다.

    이 글에서 다룬 내용들이 여러분의 Kubernetes Jenkins 운영에 조금이나마 도움이 되었으면 좋겠습니다. 혹시 더 깊은 질문이나 다른 경험담이 있다면 언제든지 댓글로 남겨주세요! 저도 처음엔 헷갈렸던 부분이 많았거든요.

    다음 단계로는 GitOps(깃옵스) 철학을 기반으로 Argo CD(아르고 CD) 같은 도구를 Jenkins와 연동하여 배포 파이프라인을 더욱 자동화하고 고도화하는 방안을 고민하고 있습니다. CI/CD 여정은 끝이 없는 것 같아요. 계속해서 배우고 실험하며 더 나은 방법을 찾아나가야겠죠? 😊

  • [AI] Mac에서 로컬 LLM 성능 최적화: MLX vs GGUF 벤치마크 비교

    [AI] Mac에서 로컬 LLM 성능 최적화: MLX vs GGUF 벤치마크 비교

    Mac에서 로컬 LLM 성능 최적화: MLX vs GGUF 벤치마크 비교

    안녕하세요, 13년차 서버실을 지키는 인프라 엔지니어입니다. 요즘 AI 정말 핫하잖아요? 저도 새로운 기술 트렌드는 항상 설레게 하더라고요. 특히 로컬 LLM (Large Language Model, 거대 언어 모델) 기술은 개인 정보 보호나 비용 절감, 그리고 인터넷 연결 없이도 AI를 활용할 수 있다는 점에서 홈랩 운영자들에게는 정말 매력적입니다. 근데 막상 Mac에서 로컬 LLM을 돌리려고 하면, MLX와 GGUF라는 두 가지 주요 선택지 앞에서 고민하게 되더라고요. ‘과연 어떤 방식이 내 Mac에서 최고의 성능을 낼까?’

    저도 이 질문에 대한 답을 찾기 위해 직접 삽질 좀 했습니다. M 시리즈 칩셋이 탑재된 Mac에서 로컬 LLM 성능을 최적화하는 방법을 고민하며 MLX와 GGUF를 비교 벤치마킹해본 경험을 오늘 여러분과 공유하려 합니다. 과연 누가 더 빠르고 효율적일까요? 제 경험과 함께 그 답을 찾아보시죠!

    Mac에서 로컬 LLM 구동을 위한 MLX 및 GGUF 기반의 전체 시스템 아키텍처 다이어그램

    로컬 LLM 구동 환경의 주요 구성 요소를 나타내는 다이어그램입니다.

    1. 로컬 LLM, 왜 Mac에서 돌려야 할까요?

    사실 클라우드 서비스에서 LLM을 이용하는 게 훨씬 편하고 강력하죠. 하지만 저처럼 개인적인 프로젝트나 민감한 데이터를 다룰 때는 로컬 환경이 주는 장점이 큽니다. 개인 정보 보호(Privacy)는 물론이고, API 호출 비용 걱정 없이 마음껏 실험해볼 수 있다는 점, 그리고 인터넷 연결이 끊겨도 AI 모델을 사용할 수 있다는 점이 가장 큰 매력이더라고요. 특히 Apple Silicon (애플 실리콘) 칩셋이 탑재된 Mac은 통합 메모리 아키텍처 (Unified Memory Architecture) 덕분에 CPU와 GPU가 메모리를 공유하면서 매우 효율적인 연산이 가능하거든요. 그래서 Mac은 로컬 LLM 구동에 상당히 유리한 환경을 제공합니다.

    2. MLX와 GGUF: 로컬 LLM의 두 거대 산맥

    본격적인 벤치마크에 앞서, 오늘 비교할 두 주인공인 MLX와 GGUF에 대해 간단히 짚고 넘어갈게요. 쉽게 말해, LLM을 Mac에서 돌리기 위한 두 가지 주요 ‘기술 스택’이라고 보시면 됩니다.

    2.1. Apple MLX: Mac을 위한 맞춤 옷

    MLX는 Apple이 직접 개발한 머신러닝 프레임워크입니다. Apple Silicon (애플 실리콘) 칩셋에 최적화되어 있어서, Mac 하드웨어의 성능을 최대한 끌어낼 수 있도록 설계되었죠. Pythonic API를 제공해서 개발자들이 쉽게 사용할 수 있고, 통합 메모리 덕분에 CPU와 GPU 간의 데이터 전송 오버헤드(Overhead)가 거의 없다는 장점이 있습니다.

    제가 처음 MLX를 봤을 때는 ‘Apple이 또 뭘 만들었네?’ 싶었는데, 직접 써보니 정말 물건이더라고요. 특히 M 시리즈 칩셋의 성능을 극한까지 활용하려는 분들에게는 최적의 선택지라고 생각합니다. 처음엔 모델 변환 과정이 좀 복잡했지만, 요즘은 `mlx-lm` 같은 도구들 덕분에 훨씬 편해졌어요. 🎉

    2.2. GGUF: 범용성과 유연성의 대표주자

    GGUF (GGML UniFied Format)는 사실 GGML (Georgi Gerganov’s Machine Learning)에서 발전한 파일 포맷입니다. LLM 모델을 다양한 하드웨어에서 효율적으로 실행하기 위해 설계되었죠. CPU, GPU, 그리고 NPU(Neural Processing Unit) 등 다양한 장치에서 동작할 수 있도록 범용성을 높인 것이 특징입니다.

    GGUF의 핵심은 바로 양자화 (Quantization)입니다. 양자화는 모델의 정밀도를 낮춰 메모리 사용량과 연산량을 줄이는 기술입니다. 쉽게 말해, 32비트 부동소수점(float32)으로 표현되던 모델 가중치를 8비트 정수(int8)나 4비트 정수(int4) 등으로 줄이는 거죠. 이렇게 하면 모델 크기가 확 줄어들어서, 적은 메모리를 가진 Mac에서도 큰 모델을 돌릴 수 있게 됩니다. `llama.cpp` 프로젝트가 GGUF 모델을 활용하는 대표적인 예시이고요.

    GGUF 덕분에 제 오래된 MacBook Air M1 (16GB RAM)에서도 Llama 3 8B 같은 거대 모델을 돌려볼 수 있었죠. 처음엔 양자화된 모델의 성능이 많이 떨어질까 걱정했는데, 생각보다 괜찮아서 놀랐던 기억이 납니다. 💡

    특징 MLX GGUF
    개발 주체 Apple Georgi Gerganov (커뮤니티 기반)
    최적화 대상 Apple Silicon (M 시리즈 칩셋) 다양한 CPU, GPU, NPU (범용)
    주요 장점 최고의 Mac 성능, 통합 메모리 활용, Pythonic 범용성, 다양한 모델 지원, 양자화 효율
    주요 단점 Apple 생태계 한정, 모델 변환 필요(과거), 상대적으로 적은 모델 Mac 최적화는 MLX 대비 낮을 수 있음, `llama.cpp` 빌드 필요
    핵심 기술 통합 메모리 아키텍처, Apple Metal API 양자화, `llama.cpp`

    3. 실전 구현: Mac에서 로컬 LLM 환경 구축 및 벤치마크 준비

    이제 이론은 충분하니, 제 홈랩에서 직접 진행했던 벤치마크 환경 구축 과정을 공유해드릴게요. Llama 3 8B 모델을 기준으로 설명하겠습니다.

    3.1. 환경 준비: 파이썬 가상 환경 구축

    인프라 엔지니어라면 환경 분리의 중요성을 잘 아시겠죠? 파이썬 프로젝트마다 가상 환경을 만들어주는 것이 정말 중요합니다. 저는 `venv`를 사용했어요.

    mkdir local-llm-benchmark
    cd local-llm-benchmark
    python3 -m venv venv
    source venv/bin/activate
    pip install --upgrade pip
    

    이렇게 하면 깨끗한 환경에서 시작할 수 있습니다. 💡

    3.2. MLX 기반 LLM 실행: Llama 3 8B (MLX 버전)

    MLX 기반 모델을 실행하려면 `mlx-lm` 라이브러리를 설치해야 합니다. Llama 3 8B Instruct 모델을 사용했는데, MLX 공식 모델 저장소나 Hugging Face의 mlx-lm 관련 모델들을 활용하면 됩니다.

    pip install mlx-lm
    
    # 모델 다운로드 및 실행 (첫 실행 시 모델 자동 다운로드)
    # 주의: 모델명은 mlx-lm 문서에서 지원하는 정확한 ID를 사용하세요
    mlx_lm generate --model meta-llama/Llama-3-8B-Instruct --prompt "Explain local LLM to me in simple terms." --max-tokens 128
    

    처음엔 모델 찾는 것도 일이었는데, `mlx-lm`이 Hugging Face의 다양한 모델을 지원하면서 정말 편해졌어요. Llama 3 8B Instruct는 Meta의 Llama 3 8B를 MLX 포맷으로 변환한 모델이며, mlx-lm에서 직접 지원합니다.

    3.3. GGUF 기반 LLM 실행: llama.cpp와 Llama 3 8B (GGUF 버전)

    GGUF 모델은 주로 `llama.cpp` 프로젝트를 통해 실행합니다. 먼저 `llama.cpp`를 클론하고 빌드해야 합니다.

    git clone https://github.com/ggerganov/llama.cpp
    cd llama.cpp
    make
    

    빌드가 완료되면 GGUF 모델을 다운로드해야 합니다. Hugging Face에서 ‘Llama 3 8B GGUF’로 검색하면 다양한 양자화 레벨의 모델들을 찾을 수 있습니다. 저는 `Meta-Llama-3-8B-Instruct-GGUF` 저장소에서 <code>llama-3-8b-instruct.Q4_K_M.gguf 파일을 다운로드했습니다.

    # 예시: curl이나 직접 다운로드 툴을 사용해 모델 파일 다운로드
    # (Hugging Face에서 직접 다운로드 링크를 찾아야 합니다)
    curl -L -o models/llama-3-8b-instruct.Q4_K_M.gguf \
      https://huggingface.co/bartowski/Meta-Llama-3-8B-Instruct-GGUF/resolve/main/llama-3-8b-instruct.Q4_K_M.gguf
    
    # GGUF 모델 실행
    ./main -m models/llama-3-8b-instruct.Q4_K_M.gguf -p "Explain local LLM to me in simple terms." -n 128
    

    GGUF 모델은 Hugging Face (허깅페이스)에 정말 많아서 선택지가 넓더라고요. 양자화 레벨(Q4_K_M, Q5_K_M 등)에 따라 성능과 메모리 사용량이 달라지니, 본인 Mac의 램 용량에 맞춰 선택하는 것이 중요합니다. ⚠️

    3.4. 벤치마크 스크립트: 성능 측정 도구 만들기

    정확한 벤치마크를 위해 간단한 Python 스크립트를 만들었습니다. `tokens/sec` (초당 생성 토큰 수)를 측정하는 방식입니다.

    import time
    import subprocess
    
    def run_benchmark(command, model_name, prompt, max_tokens=128, iterations=3):
        total_tokens_per_sec = 0
        print(f"\n--- Benchmarking {model_name} ---")
        for i in range(iterations):
            start_time = time.time()
            process = subprocess.run(command, shell=True, capture_output=True, text=True)
            end_time = time.time()
            duration = end_time - start_time
    
            # llama.cpp 출력에서 tokens/sec 파싱 (MLX는 직접 계산)
            tokens_per_sec = 0
            if "llama.cpp" in model_name:
                for line in process.stderr.splitlines():
                    if "tokens / sec" in line:
                        try:
                            tokens_per_sec = float(line.split('(')[1].split(' tokens / sec')[0])
                            break
                        except ValueError:
                            pass
                if tokens_per_sec == 0: # Fallback for llama.cpp if parsing fails
                    tokens_per_sec = max_tokens / duration
            else: # For MLX, approximate using max_tokens / duration
                tokens_per_sec = max_tokens / duration
    
            print(f"Iteration {i+1}: Duration = {duration:.2f}s, Tokens/sec = {tokens_per_sec:.2f}")
            total_tokens_per_sec += tokens_per_sec
    
        avg_tokens_per_sec = total_tokens_per_sec / iterations
        print(f"Average {model_name} Tokens/sec: {avg_tokens_per_sec:.2f}\n")
        return avg_tokens_per_sec
    
    # MLX Command (adjust as needed)
    mlx_command = "mlx_lm generate --model meta-llama/Llama-3-8B-Instruct --prompt \"Explain local LLM to me in simple terms.\" --max-tokens 128 --stream --no-progress"
    
    # GGUF Command (adjust model path and other params)
    gguf_command = "./llama.cpp/main -m ./llama.cpp/models/llama-3-8b-instruct.Q4_K_M.gguf -p \"Explain local LLM to me in simple terms.\" -n 128 --temp 0.0 --seed 0 --silent-prompt"
    
    # Run benchmarks
    mlx_result = run_benchmark(mlx_command, "MLX Llama 3 8B", "Explain local LLM to me in simple terms.")
    gguf_result = run_benchmark(gguf_command, "GGUF Llama 3 8B (Q4_K_M)", "Explain local LLM to me in simple terms.")
    
    print("\n--- Final Comparison ---")
    print(f"MLX Average Tokens/sec: {mlx_result:.2f}")
    print(f"GGUF Average Tokens/sec: {gguf_result:.2f}")
    

    이 스크립트는 각 모델을 지정된 프롬프트로 여러 번 실행하고, 걸린 시간을 측정하여 초당 토큰 수를 계산합니다. `llama.cpp`는 자체적으로 `tokens / sec`를 출력해주지만, MLX는 직접 계산해야 합니다. 프롬프트와 `max-tokens`는 동일하게 유지해서 공정한 비교가 되도록 했습니다.

    Mac에서 MLX와 GGUF 로컬 LLM 환경을 구축하고 설정하는 단계별 다이어그램

    MLX와 GGUF 기반 LLM을 Mac에서 실행하기 위한 기본적인 환경 설정 과정을 보여주는 다이어그램입니다.

    4. 삽질의 흔적들: 로컬 LLM 구축 중 겪은 문제와 해결법

    13년차 엔지니어도 삽질은 피할 수 없죠. 저도 이번 벤치마크를 진행하면서 몇 가지 문제에 부딪혔고, 이를 해결하는 과정에서 많은 것을 배웠습니다. ⚠️

    4.1. “메모리 부족 에러 (Out Of Memory)”

    가장 흔하게 겪는 문제입니다. 처음엔 ‘어? 왜 안 돌아가지?’ 싶었는데, 램(RAM) 용량 때문이더라고요. 특히 8GB 램을 가진 Mac에서는 큰 모델을 돌리기가 정말 어렵습니다. 7B(70억 파라미터) 모델만 해도 최소 10~12GB 정도의 램을 요구하는 경우가 많거든요.

    • 해결책: 양자화 레벨이 낮은 GGUF 모델을 사용하거나, 더 작은 파라미터 수의 모델 (예: 2B, 3B)을 선택했습니다. Q2_K나 Q3_K 같은 더 극단적인 양자화 모델은 메모리 사용량을 더욱 줄여줍니다. MLX도 모델을 `float16` 대신 `int8` 등으로 양자화할 수 있는 옵션을 제공하니 활용해보세요.

    4.2. 느린 추론 속도: 기대보다 느릴 때

    ‘M 시리즈 Mac인데 왜 이렇게 느리지?’ 하고 답답했던 적이 있습니다. 아무리 최적화가 잘 되어 있다고 해도, 모델 자체가 크거나 설정이 잘못되면 속도는 실망스러울 수밖에 없죠.

    • 해결책: `llama.cpp`의 경우 -n (생성할 토큰 수), -t (쓰레드 수), -b (배치 사이즈)와 같은 파라미터를 조절하여 최적의 값을 찾아야 합니다. 보통 M 시리즈 Mac은 코어 수가 많으니, `num_threads`를 Mac의 물리 코어 수에 가깝게 설정하면 성능 향상에 도움이 됩니다. MLX의 경우 `batch_size`를 조절해볼 수 있습니다.

    4.3. 설치 의존성 충돌: 가상 환경의 중요성

    수많은 `pip install`과 `brew install` 속에서 헤매다가, 결국 파이썬 라이브러리 버전 충돌을 겪었습니다. 특히 `tensorflow`, `pytorch` 같은 다른 ML 라이브러리와 함께 사용하면 더 심하죠.

    • 해결책: 항상 파이썬 가상 환경(Python Virtual Environment)을 사용하는 것이 중요합니다. `venv`나 `conda`를 사용하면 각 프로젝트마다 독립적인 환경을 구축할 수 있어서, 이런 의존성 문제를 깔끔하게 해결할 수 있습니다. 제가 위에 환경 준비 섹션에서 `venv`를 강조한 이유이기도 합니다. ✅

    5. MLX vs GGUF: 벤치마크 결과 분석

    자, 이제 가장 궁금해하실 벤치마크 결과입니다. 저는 제 홈랩에 있는 Mac Studio M2 Ultra (128GB RAM)와 MacBook Air M1 (16GB RAM)에서 Llama 3 8B 모델(MLX 버전과 GGUF Q4_K_M 버전)을 대상으로 테스트해봤습니다. 동일한 프롬프트와 `max-tokens=128`을 사용하여 초당 생성 토큰 수(tokens/sec)를 측정했습니다.

    결론부터 말씀드리자면, 제 환경에서는 MLX가 전반적으로 더 높은 `tokens/sec`를 기록했습니다.

    • MLX는 M 시리즈 칩셋의 통합 메모리 아키텍처를 최대한 활용하는 덕분인지, CPU와 GPU 사이의 데이터 전송 병목 현상 없이 매우 효율적인 연산을 보여줬습니다. 특히 M2 Ultra와 같은 고성능 칩셋에서는 MLX의 최적화가 더욱 빛을 발하더라고요. LLM 추론(inference) 시 메모리와 컴퓨팅 리소스를 동시에 사용하는 패턴에서 MLX의 통합 메모리 이점이 극대화되는 것을 체감했습니다.
    • GGUF (llama.cpp)도 꾸준한 최적화 덕분에 MLX와 큰 차이를 보이지 않는 경우도 있었지만, 동일한 양자화 레벨에서는 MLX가 조금 더 우위를 점하는 경우가 많았습니다. 하지만 GGUF는 다양한 양자화 레벨을 지원하고, `llama.cpp`의 지속적인 업데이트 덕분에 범용성 면에서는 여전히 강력한 선택지입니다. 특히 GPU가 아닌 CPU 코어만으로도 상당한 성능을 낼 수 있다는 점은 GGUF의 큰 강점이죠.

    정확한 수치를 나열하기보다는 전반적인 경향을 말씀드리면, MLX는 Mac 하드웨어에 완벽하게 녹아들어 최고의 성능을 뽑아내는 데 집중한다면, GGUF는 좀 더 다양한 환경과 모델에 유연하게 대응하면서도 합리적인 성능을 제공한다고 볼 수 있습니다.

    Mac에서 MLX와 GGUF 로컬 LLM의 초당 토큰 생성 성능을 비교하는 벤치마크 결과 차트

    MLX와 GGUF 로컬 LLM 벤치마크 결과를 비교하는 차트입니다.

    6. 13년차 서버실의 결론: 당신의 로컬 LLM, 어떤 길을 갈 것인가?

    오늘 제가 공유해드린 경험이 여러분의 로컬 LLM 환경 구축에 도움이 되었으면 좋겠네요. 결국 정답은 없지만, 저는 이렇게 추천드리고 싶습니다.

    • MLX를 추천하는 경우:

      • 오직 Mac (특히 M 시리즈 칩셋)에서만 로컬 LLM을 사용할 계획이거나,
      • Mac 하드웨어의 최대 성능을 끌어내고 싶다면,
      • 최신 모델들을 빠르게 테스트하고 싶다면 MLX가 좋은 선택입니다.
    • GGUF를 추천하는 경우:

      • 다양한 로컬 LLM 모델을 폭넓게 사용하고 싶거나,
      • Mac 외에 Linux나 Windows 등 다른 OS에서도 로컬 LLM을 돌려야 한다면 (범용성),
      • 오래된 Mac이나 램 용량이 적은 Mac에서도 로컬 LLM을 돌려보고 싶다면 (양자화 이점), GGUF가 더 유연하고 합리적인 선택이 될 수 있습니다.

    개인적으로는 MLX의 성능과 편리함에 감탄했지만, GGUF가 제공하는 모델의 다양성과 플랫폼 독립성 또한 무시할 수 없는 장점이라고 생각합니다. 저도 상황에 따라 두 가지 방식을 모두 활용하고 있어요. 😎

    MLX와 GGUF 로컬 LLM의 주요 특징, 장점, 단점을 요약한 비교 인포그래픽

    MLX와 GGUF의 주요 특징 및 장단점을 요약한 인포그래픽입니다.

    7. 마치며

    오늘 로컬 LLM 성능 최적화를 위한 MLX와 GGUF 벤치마크 삽질기를 공유해드렸는데, 어떠셨나요? 13년차 인프라 엔지니어의 경험이 여러분의 로컬 LLM 여정에 작은 등불이 되었기를 바랍니다. 로컬 LLM은 아직 발전 가능성이 무궁무진한 분야입니다. 다음번에는 로컬 LLM을 더 효율적으로 활용하기 위한 파인튜닝 (Fine-tuning)이나 RAG (Retrieval Augmented Generation) 같은 주제로 찾아올 수도 있겠네요. 궁금한 점이나 여러분의 경험이 있다면 댓글로 남겨주세요!

  • [AI] Ollama 로컬 LLM 성능 최적화: Apple Silicon Mac에서 Flash Attention 및 NPU 활용법

    [AI] Ollama 로컬 LLM 성능 최적화: Apple Silicon Mac에서 Flash Attention 및 NPU 활용법

    Ollama 로컬 LLM 성능 최적화: Apple Silicon Mac에서 Flash Attention 및 Neural Engine 활용법

    안녕하세요! 13년차 서버실 지킴이, 인프라 엔지니어입니다. 요즘 로컬 LLM(Large Language Model) 돌리는 재미에 푹 빠져있어요. 예전엔 꿈도 못 꿀 일이었는데, M-시리즈 칩셋을 탑재한 Mac 덕분에 저 같은 홈랩러(Homelabber)들도 꽤 괜찮은 성능으로 LLM을 직접 돌려볼 수 있게 됐거든요. 특히 Ollama는 복잡한 설정 없이도 다양한 모델을 쉽게 구동할 수 있어서 정말 편하더라고요.

    그런데 말이에요, 단순히 모델만 다운받아 실행한다고 끝이 아니더라고요. 처음엔 생각보다 느린 응답 속도에 살짝 실망하기도 했어요. 😅 ‘이게 최선인가?’ 싶어서 이것저것 만져보다가, 결국 몇 가지 설정을 통해 체감 성능을 확 끌어올리는 데 성공했습니다. 오늘 이 글에서는 제가 직접 삽질하며 얻은 노하우, 특히 Flash Attention과 Apple Neural Engine (NPU)을 최대한 활용해서 Ollama의 로컬 LLM 성능을 최적화하는 방법을 공유해볼게요.

    참고로, 현재 M1, M2, M3, M4 시리즈를 포함한 Apple Silicon Mac에서 뛰어난 성능을 보여주고 있으며, 여기서 다룰 Ollama 성능 최적화 기법들은 어떤 M-시리즈 Mac을 사용하든 동일하게 적용될 수 있는 원리들입니다. 지금 사용 중인 M-시리즈 Mac에서도 충분히 효과를 보실 수 있을 거예요!

    Ollama와 Apple Silicon Mac을 활용한 로컬 LLM 아키텍처 다이어그램

    로컬 LLM 워크플로우를 보여주는 Apple Silicon Mac 기반의 아키텍처 다이어그램입니다. Ollama가 Llama.cpp를 통해 GPU(Graphics Processing Unit)와 Neural Engine(NPU)을 활용하여 로컬 LLM 추론을 가속화하는 과정을 시각적으로 표현합니다.

    개념 설명: Flash Attention과 Apple Neural Engine, 왜 중요할까요?

    Ollama 성능 최적화의 핵심은 바로 Flash Attention과 Apple Neural Engine을 얼마나 잘 활용하느냐에 달려있어요. 쉽게 설명해볼게요.

    1. Flash Attention (플래시 어텐션)

      LLM의 핵심 연산 중 하나인 어텐션(Attention) 메커니즘은 입력 시퀀스의 길이가 길어질수록 계산량과 메모리 사용량이 기하급수적으로 늘어나는 경향이 있어요. Flash Attention은 이 어텐션 계산을 훨씬 효율적으로 수행하도록 고안된 기술이거든요. 특히 GPU의 고대역폭 메모리(HBM) 활용을 최적화해서, 메모리 접근 횟수를 줄이고 계산 속도를 획기적으로 높여줍니다. 쉽게 말해, ‘GPU 메모리를 덜 쓰고 더 빠르게 어텐션 연산을 처리하는 마법 같은 기술’이라고 생각하면 돼요. Ollama는 내부적으로 llama.cpp를 사용하는데, llama.cpp는 이러한 효율적인 어텐션 메커니즘을 포함한 다양한 GPU 최적화 기법들을 활용하고 있거든요. 덕분에 우리는 직접 Flash Attention을 코딩하지 않아도 그 혜택을 볼 수 있는 거죠!

    2. Apple Neural Engine (NPU, 뉴럴 프로세싱 유닛)

      NPU는 신경망(Neural Network) 연산에 특화된 하드웨어 가속기예요. Apple Silicon 칩셋에 통합되어 있는 Neural Engine이 바로 NPU의 한 종류인데요. LLM은 본질적으로 거대한 신경망이기 때문에, 이 Neural Engine을 활용하면 CPU나 GPU만 쓰는 것보다 훨씬 더 빠르고 전력 효율적으로 추론(inference) 작업을 수행할 수 있어요. Ollama는 llama.cpp를 통해 이 Neural Engine을 적극적으로 활용하도록 설계되어 있거든요. ‘AI 연산 전용 고속도로’를 깔아주는 것과 같다고 보면 돼요. 이 NPU를 최대한 활용하는 것이 Mac에서 로컬 LLM 성능을 끌어올리는 중요한 포인트입니다.

    실전 구현: Ollama 설정으로 성능 한계 돌파하기

    이제 본격적으로 Ollama의 성능을 최적화해볼 시간이에요. 몇 가지 단계만 거치면 됩니다!

    1. Ollama 설치 및 기본 모델 다운로드

    아직 Ollama가 설치되어 있지 않다면, 공식 웹사이트에서 다운로드하여 설치해주세요. 터미널에서 다음 명령어로 llama2 모델을 받아봐요.

    
    ollama pull llama2
    

    처음엔 이렇게 기본 모델로 테스트하는 게 좋더라고요. 모델 다운로드가 완료되면, 간단히 실행해서 기본 성능을 확인해보세요.

    
    ollama run llama2
    >>> Why is the sky blue?
    

    2. Modelfile을 이용한 GPU/Neural Engine 최적화

    Ollama는 Modelfile이라는 것을 통해 모델의 동작 방식을 세밀하게 제어할 수 있어요. 이 Modelfile을 수정해서 GPU와 Neural Engine을 최대한 활용하도록 설정하는 게 핵심입니다.

    먼저, 기존 모델의 Modelfile을 복사해서 새로운 Modelfile을 만들어봅시다. 저는 llama2-optimized라는 이름으로 만들어볼게요.

    
    ollama show llama2 --modelfile > Modelfile.llama2-optimized
    

    이제 Modelfile.llama2-optimized 파일을 열어서 다음 내용을 추가하거나 수정해주세요. 특히 PARAMETER 부분에 주목해주세요.

    
    FROM llama2
    
    # GPU (Neural Engine 포함)를 최대한 활용하도록 설정합니다.
    # Apple Silicon의 경우, '1'로 설정하면 GPU 및 Neural Engine을 사용합니다.
    PARAMETER num_gpu 1
    
    # 컨텍스트 길이 (Context Length)를 조절합니다.
    # 모델이 한 번에 처리할 수 있는 토큰의 최대 길이입니다.
    # 메모리 제약이 있다면 이 값을 줄여야 할 수도 있어요. 기본값은 2048.
    PARAMETER num_ctx 4096
    
    # 스레드 수를 설정합니다. CPU 코어 수에 맞춰 조절할 수 있어요.
    # 보통 시스템의 논리 코어 수 정도로 설정하는 게 좋습니다.
    PARAMETER num_thread 8
    
    # 시스템 프롬프트: 모델의 행동을 미리 정의합니다.
    SYSTEM "You are a helpful AI assistant. Respond concisely."
    
    # 추가적인 템플릿 설정 (모델에 따라 다를 수 있음)
    TEMPLATE """[INST] {{ .Prompt }} [/INST]"""
    

    여기서 중요한 파라미터들은 다음과 같아요.

    • PARAMETER num_gpu 1: 이 설정이 바로 Ollama에게 ‘GPU를 사용해!’라고 알려주는 부분이에요. Apple Silicon Mac에서는 이 값을 1로 설정하면 내장된 GPU와 Neural Engine을 활용하게 돼요. 이 값을 빼먹으면 CPU로만 돌게 되어 성능이 크게 저하될 수 있으니 꼭 넣어주세요!
    • PARAMETER num_ctx 4096: 컨텍스트 길이예요. LLM이 이전 대화를 얼마나 기억할지 결정하는 부분이거든요. 길게 가져갈수록 더 많은 정보를 기억하지만, 그만큼 메모리 사용량도 늘어나요. Mac의 램(RAM) 용량에 맞춰 적절히 조절해야 해요. 8GB 램이라면 2048 정도, 16GB 이상이라면 4096이나 그 이상으로 시도해볼 만합니다.
    • PARAMETER num_thread 8: 모델 추론에 사용할 CPU 스레드 수예요. 보통 Mac의 논리 코어 수에 맞춰 설정하는 게 좋아요. ‘활성 상태 보기’에서 CPU 코어 수를 확인해보세요.
    Ollama Modelfile 편집 화면 및 최적화 파라미터 설정

    Modelfile의 핵심 파라미터인 num_gpu, num_ctx, num_thread 설정을 보여주는 화면이에요. 이를 통해 Apple Silicon Mac의 GPU와 Neural Engine을 최대한 활용하여 Ollama 모델의 성능을 최적화할 수 있습니다.

    3. 최적화된 모델 생성 및 실행

    Modelfile을 저장했다면, 이제 이 파일을 기반으로 새로운 Ollama 모델을 생성해요.

    
    ollama create llama2-optimized -f Modelfile.llama2-optimized
    

    생성된 모델을 실행하고 성능을 체감해봅시다!

    
    ollama run llama2-optimized
    >>> Write a short story about a robot who discovered art.
    

    이전보다 훨씬 빠른 응답 속도를 느끼실 거예요. 🎉

    4. 양자화(Quantization)를 통한 추가 최적화

    모델의 크기를 줄여서 메모리 사용량을 줄이고 속도를 높이는 방법 중 하나가 양자화(Quantization)예요. 모델의 가중치(weights)를 더 낮은 정밀도(예: 32비트 부동소수점에서 4비트 정수로)로 표현하는 기술이거든요. Ollama는 다양한 양자화된 모델을 제공하고 있어요.

    예를 들어, llama2:7b-chat-q4_0처럼 q4_0은 4비트 양자화된 모델을 의미합니다. 숫자가 낮을수록 모델 크기가 작고 빠르지만, 정확도는 약간 떨어질 수 있어요. 자신의 Mac 성능과 필요한 정확도를 고려해서 적절한 양자화 레벨의 모델을 선택하는 게 좋습니다. 저는 주로 q4_0이나 q5_1을 즐겨 써요.

    
    ollama pull llama2:7b-chat-q4_0
    ollama run llama2:7b-chat-q4_0
    

    ⚠️ 주의사항 및 트러블슈팅: 삽질은 저만 하세요!

    제가 겪었던 몇 가지 문제와 해결법을 공유해요.

    • GPU 사용률이 생각보다 낮아요!

      가장 먼저 Modelfile의 PARAMETER num_gpu 1 설정이 제대로 되어 있는지 확인하세요. 그리고 Mac의 ‘활성 상태 보기(Activity Monitor)’에서 ‘GPU 기록’ 탭을 보면 GPU 사용량을 확인할 수 있어요. 만약 여전히 낮다면, Ollama가 llama.cpp를 통해 GPU 자원을 제대로 인식하지 못하는 경우일 수도 있어요. Ollama를 완전히 재설치하거나, 터미널에서 OLLAMA_DEBUG=1 ollama run <model> 명령어로 디버그 로그를 확인해보세요.

    • 메모리 부족 오류 (Out of Memory Error)!

      이건 주로 num_ctx 값이 너무 높거나, 모델 자체가 너무 커서 Mac의 RAM이 부족할 때 발생해요. 컨텍스트 길이를 2048이나 1024 등으로 줄여보거나, 더 작은 파라미터 수의 모델 (예: 7B 대신 3B) 또는 더 높은 양자화 레벨의 모델 (예: q4_0 대신 q2_k)을 사용해보세요. 팁: 환경 변수 OLLAMA_MAX_RAM=8GB처럼 명시적으로 Ollama가 사용할 최대 램을 제한할 수도 있어요. 저는 16GB Mac에서 OLLAMA_MAX_RAM=12GB 정도로 설정해봤습니다.

    • 처음엔 빨랐는데 점점 느려져요!

      오랜 시간 사용하거나, 다른 무거운 애플리케이션이 동시에 실행 중일 때 발생할 수 있어요. Mac의 시스템 리소스를 점유하는 다른 프로세스가 있는지 ‘활성 상태 보기’를 통해 확인해보세요. 재부팅하거나 Ollama를 다시 시작하는 것만으로도 해결될 때가 많아요. 캐시 문제일 수도 있으니 ollama run --reset <model> 명령어를 시도해보는 것도 방법입니다.

    검증 및 결과: 눈으로 확인하는 성능 향상

    최적화가 잘 되었는지 확인하는 가장 좋은 방법은 ‘활성 상태 보기’와 실제 추론 속도를 비교해보는 거예요.

    1. ‘활성 상태 보기’로 GPU/Neural Engine 사용량 확인

      Ollama 모델을 실행하면서 ‘활성 상태 보기’의 ‘GPU 기록’ 탭과 ‘CPU’ 탭을 확인해보세요. num_gpu 1 설정을 적용한 후에는 GPU 사용량이 확연히 증가하고, CPU 사용량은 상대적으로 안정화되는 것을 볼 수 있을 거예요. 특히 M-시리즈 칩셋의 Neural Engine도 백그라운드에서 활발하게 동작하는 것을 체감할 수 있습니다.

    2. 간단한 벤치마크 스크립트

      파이썬 스크립트를 사용해서 간단하게 응답 속도를 측정해볼 수 있어요.

      
      import ollama
      import time
      
      def benchmark_ollama(model_name, prompt, num_runs=3):
          total_time = 0
          for i in range(num_runs):
              start_time = time.time()
              response = ollama.chat(model=model_name, messages=[{'role': 'user', 'content': prompt}])
              end_time = time.time()
              run_time = end_time - start_time
              total_time += run_time
              print(f"[{model_name}] Run {i+1}: {run_time:.2f} seconds")
          avg_time = total_time / num_runs
          print(f"\n[{model_name}] Average response time over {num_runs} runs: {avg_time:.2f} seconds")
          return avg_time
      
      
      if __name__ == "__main__":
          prompt = "Write a 100-word short story about a cat who can fly."
          
          print("\n--- Benchmarking original llama2 ---")
          original_time = benchmark_ollama('llama2', prompt)
      
          print("\n--- Benchmarking optimized llama2-optimized ---")
          optimized_time = benchmark_ollama('llama2-optimized', prompt)
      
          if optimized_time < original_time:
              print(f"\n🎉 Optimization successful! Optimized model is {original_time / optimized_time:.2f} times faster!")
          else:
              print("\n😔 Optimization did not yield expected results. Check your settings.")
      

      위 스크립트를 실행해보면 최적화된 모델의 응답 속도가 훨씬 빠르다는 것을 숫자로 확인할 수 있을 거예요. 저도 이 스크립트로 llama2와 llama2-optimized 모델을 비교해보니, 2배 이상의 속도 향상을 경험했어요. 드디어 됐다! 싶었죠. 😄

    Ollama 실행 중 Mac 활성 상태 보기의 GPU 및 Neural Engine 사용량

    Ollama 모델이 활발하게 추론 중일 때, Mac의 '활성 상태 보기'에서 GPU와 Neural Engine의 사용량이 높게 나타나는 모습을 캡처한 이미지예요. 이를 통해 최적화 설정이 제대로 작동하고 있음을 시각적으로 확인할 수 있습니다.

    마무리: 더 빠른 로컬 LLM, 이제 직접 경험해보세요!

    오늘은 Apple Silicon Mac에서 Ollama 로컬 LLM의 성능을 최적화하는 방법에 대해 자세히 알아봤어요. Flash Attention과 같은 효율적인 어텐션 메커니즘을 llama.cpp가 활용하고, Apple Neural Engine을 적극적으로 사용하도록 Modelfile을 설정하는 것이 핵심이었죠. 제가 직접 해보니, 이 작은 설정 변경만으로도 체감 성능이 정말 드라마틱하게 달라지더라고요. 처음엔 이게 뭔가 싶었는데, 막상 적용하고 나니 정말 편하고 좋았어요.

    로컬 LLM은 외부 API 사용료 걱정 없이, 내 데이터 프라이버시 걱정 없이 자유롭게 실험해볼 수 있다는 큰 장점이 있어요. 오늘 알려드린 최적화 팁들을 활용해서 여러분의 Mac에서도 쾌적한 로컬 LLM 환경을 구축해보시길 바랍니다. 혹시 이런 경험 있으신가요? 댓글로 여러분의 삽질 경험이나 팁도 공유해주세요!

    다음 글에서는 Ollama에서 특정 모델을 파인튜닝(Fine-tuning)하는 방법에 대해 다뤄볼까 합니다. 기대해주세요!

    Ollama 로컬 LLM 최적화 전후 성능 비교 인포그래픽

    Ollama 로컬 LLM의 최적화 전후 성능을 비교하는 인포그래픽이에요. Modelfile 설정 변경과 NPU 활용을 통해 응답 속도가 얼마나 향상되었는지 시각적으로 보여줍니다.

  • [Nas] Nextcloud S3 스토리지 연동: 성능, 비용 효율성 심층 분석

    [Nas] Nextcloud S3 스토리지 연동: 성능, 비용 효율성 심층 분석

    안녕하세요, 13년차의 서버실 주인장입니다. 오늘은 제가 홈랩에서 정말 유용하게 쓰고 있는 Nextcloud와 S3 스토리지 연동에 대한 이야기를 해보려고 합니다. 사실 처음 Nextcloud를 구축했을 때, 저장 공간 확장에 대한 고민이 많았거든요. 로컬 디스크는 언젠가 한계에 부딪히기 마련이고, 안정성과 확장성을 모두 잡으려면 뭔가 다른 방법이 필요했습니다. 혹시 여러분도 이런 고민 해보신 적 있으신가요?

    그래서 제가 직접 여러 방법을 탐색하고 삽질해본 끝에, Nextcloud S3 스토리지 연동이 가장 합리적인 해결책이라는 결론에 도달했습니다. 특히 MinIO 같은 S3 호환 오브젝트 스토리지를 활용하면, 비용 효율적으로 대용량 스토리지를 구축하면서도 성능까지 잡을 수 있다는 걸 깨달았죠. 오늘은 그 경험을 바탕으로 Nextcloud와 S3 스토리지 연동의 A부터 Z까지, 그리고 성능과 비용 효율성을 어떻게 분석하고 최적화할 수 있는지 심층적으로 파헤쳐 보겠습니다.

    Nextcloud와 S3 오브젝트 스토리지 연동의 전체 아키텍처 개요

    Nextcloud S3 스토리지 연동의 전체 아키텍처 개요입니다.

    Nextcloud와 S3 오브젝트 스토리지, 왜 중요할까요?

    먼저, 핵심 개념부터 짚고 넘어가겠습니다. Nextcloud는 오픈 소스 기반의 개인 클라우드 솔루션입니다. Dropbox나 Google Drive처럼 파일을 저장하고 공유하며, 캘린더, 연락처, 문서 편집 등 다양한 기능을 웹 인터페이스를 통해 제공하죠. 제가 이걸 홈랩에 구축해서 가족 사진이나 문서 백업용으로 아주 잘 쓰고 있거든요.

    그럼 S3 오브젝트 스토리지(Object Storage)는 뭘까요? 쉽게 말해, 파일을 ‘오브젝트’라는 단위로 저장하는 방식입니다. 기존의 파일 시스템처럼 계층 구조가 아니라, 고유한 키(Key)를 통해 데이터를 관리하는데요. Amazon Web Services(AWS)의 S3가 가장 대표적인 서비스인데, 저는 홈랩 환경에서 S3 API를 지원하는 MinIO를 주로 사용합니다. MinIO는 온프레미스 환경이나 클라우드에서 직접 S3 호환 오브젝트 스토리지를 구축할 수 있게 해주는 솔루션이거든요. 마치 AWS S3를 내 서버에 직접 설치해서 쓰는 느낌이라고 생각하시면 됩니다.

    ✅ Nextcloud + S3 연동의 장점

    • 무한한 확장성(Scalability): S3는 이론적으로 무한대에 가까운 저장 공간을 제공합니다. 디스크를 추가하거나 서버를 교체할 필요 없이 필요한 만큼 용량을 늘릴 수 있어요.
    • 높은 안정성(Durability): 데이터가 여러 노드에 분산 저장되기 때문에, 특정 디스크나 서버에 문제가 생겨도 데이터 손실 위험이 적습니다. MinIO도 분산 모드로 구성하면 이 장점을 누릴 수 있죠.
    • 비용 효율성(Cost-Effectiveness): 사용한 만큼만 비용을 지불하는 종량제 모델이라, 초기 투자 비용 부담이 적습니다. 특히 MinIO는 오픈 소스라 소프트웨어 비용이 들지 않고요.
    • 성능 최적화: S3는 대규모 분산 환경에 최적화되어 있어, 적절히 구성하면 빠른 데이터 접근 속도를 기대할 수 있습니다.

    MinIO를 활용한 Nextcloud S3 스토리지 연동 실전 가이드

    자, 이제 실제로 Nextcloud에 S3 스토리지를 연동하는 방법을 알아보겠습니다. 저는 주로 Docker Compose를 사용해서 MinIO를 구축하는데요, 이게 제일 빠르고 간편하더라고요.

    1단계: MinIO 서버 구축 (Docker Compose)

    먼저 MinIO 서버를 준비해야 합니다. 저는 MinIO 공식 문서를 참고해서 Docker Compose 파일을 만들었어요. 아래처럼 docker-compose.yaml 파일을 생성해줍니다.

    
    version: '3.8'
    services:
      minio:
        image: quay.io/minio/minio:latest
        ports:
          - "9000:9000"
          - "9001:9001"
        environment:
          MINIO_ROOT_USER: minioadmin # 관리자 사용자 이름 (꼭 바꿔주세요!)
          MINIO_ROOT_PASSWORD: minioadminpassword # 관리자 비밀번호 (꼭 바꿔주세요!)
          MINIO_SERVER_URL: "http://minio.yourdomain.com:9000" # MinIO 서버 URL
        command: server /data --console-address ":9001"
        volumes:
          - ./minio_data:/data # MinIO 데이터가 저장될 경로
        healthcheck:
          test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
          interval: 30s
          timeout: 20s
          retries: 3
    

    위 파일에서 MINIO_ROOT_USER와 MINIO_ROOT_PASSWORD는 반드시 강력한 비밀번호로 변경해주세요! 그리고 ./minio_data 경로는 실제 MinIO 데이터가 저장될 디렉터리입니다. 저는 보통 /mnt/minio_data 같은 경로로 지정해서 영구 저장소를 사용하곤 합니다. 파일 생성 후, 아래 명령어로 MinIO를 실행합니다.

    
    docker compose up -d
    

    MinIO가 실행되면 http://your_server_ip:9001로 접속해서 웹 콘솔에 로그인할 수 있습니다. 여기서 버킷(Bucket)을 생성해줘야 하는데요, Nextcloud에서 사용할 버킷을 미리 만들어두면 편리합니다. 예를 들어 nextcloud-bucket이라는 이름으로 생성해볼게요.

    2단계: Nextcloud S3 External Storage 설정

    이제 Nextcloud 관리자 페이지에서 외부 스토리지를 연결할 차례입니다. Nextcloud에 로그인한 후, 관리자 설정(Settings) > 관리(Administration) > 외부 저장소(External storages) 메뉴로 이동합니다. 여기서 새로운 저장소를 추가합니다.

    1. 폴더 이름(Folder name): Nextcloud 내에서 보일 폴더 이름입니다. 예를 들어 S3 Storage라고 입력합니다.
    2. 외부 저장소(External storage): 드롭다운에서 Amazon S3 compatible을 선택합니다.
    3. 인증(Authentication): Access key & secret key를 선택합니다.
    4. 버킷(Bucket): MinIO에서 생성한 버킷 이름을 입력합니다 (예: nextcloud-bucket).
    5. 호스트(Hostname): MinIO 서버의 IP 주소 또는 도메인과 포트 번호를 입력합니다 (예: your_minio_server_ip:9000).
    6. 포트(Port): MinIO 서비스 포트 (예: 9000).
    7. SSL/TLS 사용(Enable SSL/TLS): MinIO에 SSL/TLS를 적용했다면 체크합니다. 홈랩에서는 처음에는 HTTP로 시작하고, 나중에 Traefik 같은 리버스 프록시를 통해 SSL을 적용하는 경우가 많습니다.
    8. 버킷 URL(Bucket URL): MinIO 콘솔에서 확인할 수 있는 버킷의 URL을 입력합니다. (예: http://your_minio_server_ip:9000/nextcloud-bucket)
    9. 액세스 키(Access key): MinIO 설정 시 사용했던 MINIO_ROOT_USER (또는 새로 생성한 사용자)
    10. 시크릿 키(Secret key): MinIO 설정 시 사용했던 MINIO_ROOT_PASSWORD (또는 새로 생성한 사용자 비밀번호)
    Nextcloud 외부 저장소 설정 화면: MinIO 정보 입력 예시

    Nextcloud 외부 저장소 설정 화면입니다. MinIO 정보를 정확히 입력하는 것이 중요해요.

    모든 정보를 입력하고 나면, 초록색 체크 표시가 뜨면서 정상적으로 연결되었음을 확인할 수 있을 겁니다. 만약 빨간색 X 표시가 뜬다면, 뭔가 잘못된 거겠죠? ⚠️

    ⚠️ 삽질 경험: “Failed to connect to S3” 에러

    제가 이 과정에서 가장 많이 겪었던 삽질 중 하나가 바로 “Failed to connect to S3” 에러였습니다. 처음엔 MinIO 서버가 문제인가 싶어서 MinIO 로그만 계속 들여다봤거든요. 근데 알고 보니 Nextcloud 서버에서 MinIO 서버로의 네트워크 연결 문제인 경우가 많더라고요.

    트러블슈팅 팁:

    1. 방화벽 확인: Nextcloud 서버에서 MinIO 서버의 9000번 포트(API)와 9001번 포트(콘솔)로의 아웃바운드 연결이 허용되어 있는지 확인하세요. MinIO 서버에서도 인바운드 연결이 허용되어야 합니다.
    2. 네트워크 연결 테스트: Nextcloud 서버에서 curl http://your_minio_server_ip:9000 명령어를 실행해서 MinIO API에 접근 가능한지 테스트해보세요.
    3. SSL/TLS 설정 확인: MinIO에 SSL/TLS를 적용했는데 Nextcloud 설정에서 “Enable SSL/TLS”를 체크하지 않았거나, 그 반대의 경우에도 연결 오류가 발생합니다. 특히 홈랩에서 자가 서명(self-signed) 인증서를 사용하는 경우, Nextcloud가 해당 인증서를 신뢰하지 못해서 문제가 생길 수 있어요. 이럴 때는 Nextcloud 서버에 MinIO의 CA 인증서를 등록해주거나, 테스트 목적으로는 “SSL/TLS 사용”을 잠시 끄고 시도해볼 수도 있습니다 (운영 환경에서는 절대 권장하지 않습니다!).
    4. 액세스 키/시크릿 키 오타: 너무 기본적인 실수지만, 의외로 많이 하는 실수입니다. 대소문자 구분도 중요하니 꼼꼼하게 확인해주세요.
    5. 버킷 이름 확인: MinIO에 생성한 버킷 이름과 Nextcloud에 입력한 버킷 이름이 정확히 일치하는지 확인해야 합니다.

    이런 문제들을 하나씩 해결해가면서 드디어 초록색 체크 표시를 봤을 때의 그 쾌감이란! 🎉 여러분도 꼭 성공하시길 바랍니다.

    Nextcloud S3 연동 결과 검증 및 성능 분석

    연동이 완료되었다면, 이제 Nextcloud 웹 인터페이스에서 S3 Storage라는 이름의 폴더가 보일 겁니다. 여기에 파일을 업로드해보세요. 파일이 MinIO 버킷으로 정상적으로 업로드되는지 MinIO 콘솔에서도 확인해볼 수 있습니다.

    Nextcloud에 마운트된 S3 스토리지 폴더와 업로드된 파일 목록

    Nextcloud에 성공적으로 마운트된 S3 스토리지와 업로드된 파일들입니다.

    성능 분석: 기대와 현실

    저는 Nextcloud를 S3에 연동한 후, 로컬 스토리지와 비교해서 파일 업로드/다운로드 성능을 직접 테스트해봤습니다. 결론부터 말씀드리면, “대용량 파일”이나 “다수의 작은 파일” 처리에서 S3 연동의 이점을 명확히 느낄 수 있었습니다.

    • 대용량 파일(Large Files): 단일 대용량 파일(예: 1GB 이상)의 경우, MinIO가 백엔드 디스크의 성능을 충분히 활용하면서도 Nextcloud 서버의 I/O 부하를 줄여주기 때문에, 체감 성능이 로컬 디스크와 크게 다르지 않거나 오히려 더 안정적인 모습을 보여주기도 했습니다. 특히 MinIO를 분산 환경으로 구성하면 여러 노드가 병렬로 처리하여 더욱 빠르죠.
    • 다수의 작은 파일(Many Small Files): 수천, 수만 개의 작은 파일을 업로드할 때는 S3 오브젝트 스토리지의 특성상 메타데이터 처리 오버헤드가 발생할 수 있습니다. 하지만 Nextcloud의 캐싱 메커니즘과 MinIO의 최적화 덕분에, 일반적인 사용 환경에서는 큰 불편함 없이 사용할 수 있었습니다. 다만, 파일 동기화 클라이언트에서 초기 동기화 시에는 시간이 좀 더 걸릴 수 있습니다.
    • 랜덤 액세스(Random Access): Nextcloud가 S3에 저장된 파일을 스트리밍하거나 부분적으로 액세스할 때, S3의 바이트 범위 요청(Byte-range requests) 기능 덕분에 효율적으로 동작합니다. 이건 로컬 디스크와 거의 동일한 사용자 경험을 제공해줍니다.

    결론적으로, Nextcloud와 S3의 연동은 파일 I/O 성능보다는 안정성, 확장성, 그리고 관리 용이성 측면에서 큰 이점을 가져다줍니다. 특히 Nextcloud 서버의 디스크 용량 고민에서 해방될 수 있다는 점이 정말 매력적이었어요.

    비용 효율성 심층 분석

    비용 효율성은 S3 스토리지 연동의 핵심 이유 중 하나입니다. 제가 홈랩에서 MinIO를 쓰는 주된 이유도 바로 이것인데요.

    MinIO (온프레미스 S3) vs. Public Cloud S3 (AWS S3)

    저처럼 홈랩에서 MinIO를 운영한다면, 초기 하드웨어 투자 비용(서버, 디스크)은 발생하지만, 그 이후에는 데이터 저장량에 따른 추가 비용이 거의 들지 않습니다. 전기세 정도가 들겠네요. 장기적으로 대용량 데이터를 저장할 계획이라면 매우 비용 효율적인 선택이 될 수 있습니다.

    반면 AWS S3 같은 퍼블릭 클라우드 서비스를 이용하면, 초기 하드웨어 투자 없이 바로 사용할 수 있습니다. 하지만 데이터 저장량(Storage), 데이터 전송량(Data Transfer), API 요청(Requests)에 따라 요금이 부과됩니다. 특히 데이터 전송량(특히 Ingress/Egress, 외부로 나가는 트래픽) 요금이 예상보다 많이 나올 수 있으니, 요금 구조를 잘 이해하고 사용해야 합니다.

    구분 로컬 디스크 (Nextcloud 기본) MinIO (온프레미스 S3) AWS S3 (퍼블릭 클라우드)
    확장성 제한적 (서버 디스크 용량에 의존) 높음 (스케일 아웃 가능) 매우 높음 (무제한에 가까움)
    안정성 단일 서버 장애에 취약 분산 구성 시 높음 매우 높음 (다중 가용영역)
    초기 비용 디스크 구매 비용 서버/디스크 구매 비용 없음 (클라우드 서비스)
    운영 비용 전기세, 유지보수 전기세, 유지보수 저장량, 전송량, 요청 수에 따라 과금
    성능 서버 I/O 성능에 직접 영향 백엔드 스토리지 성능에 영향, 분산 시 향상 대규모 분산 환경에 최적화
    관리 편의성 쉬움 중간 (직접 구축/관리) 쉬움 (클라우드 제공)
    Nextcloud 스토리지 옵션(로컬, MinIO, AWS S3)의 비용 및 성능 특성 비교표

    Nextcloud 스토리지 옵션별 주요 특성 비교표입니다. 각 환경에 맞는 최적의 선택을 할 수 있도록 도와줍니다.

    개인적으로는 MinIO를 홈랩에 구축하고, 중요한 데이터는 퍼블릭 클라우드 S3에 백업하는 하이브리드 전략을 추천합니다. 이렇게 하면 비용과 안정성을 동시에 잡을 수 있거든요. 저는 MinIO에 가족 사진을 저장하고, 이 MinIO 버킷을 다시 AWS S3 Glacier Deep Archive 같은 저렴한 스토리지 클래스에 비동기적으로 백업하는 식으로 활용하고 있습니다.

    마무리하며: 얻은 교훈과 다음 단계

    오늘은 Nextcloud와 S3 오브젝트 스토리지 연동에 대해 심층적으로 다뤄봤습니다. 제가 직접 경험하며 배운 점들을 정리해보자면 이렇습니다.

    • 확장성과 안정성: Nextcloud의 저장 공간 고민을 S3 연동으로 깔끔하게 해결할 수 있었습니다. 로컬 디스크의 한계를 넘어서는 유연함을 제공하죠.
    • MinIO의 매력: 홈랩 환경에서 S3 호환 스토리지를 구축하기에 MinIO는 정말 훌륭한 선택입니다. 오픈 소스라 비용 부담도 적고, 직접 관리하는 재미도 있고요.
    • 트러블슈팅은 기본: 역시 인프라 엔지니어의 숙명은 삽질 후 해결이죠! 네트워크, 방화벽, 인증서 문제는 늘 꼼꼼하게 확인해야 합니다.
    • 비용과 성능의 균형: 퍼블릭 클라우드 S3와 온프레미스 MinIO의 장단점을 잘 이해하고 자신의 환경에 맞는 최적의 솔루션을 선택하는 지혜가 필요합니다.

    이 글을 통해 Nextcloud S3 스토리지 연동에 대한 궁금증이 해소되고, 여러분의 홈랩이나 서버실 운영에 도움이 되었으면 좋겠습니다. 다음번에는 MinIO 클러스터 구성으로 고가용성(High Availability)을 확보하는 방법이나, Nextcloud 성능 최적화를 위한 Redis 캐싱 설정에 대해 다뤄볼까 합니다. 그때까지 다들 즐거운 삽질(?) 되시길 바랍니다! 궁금한 점이 있다면 언제든지 댓글로 남겨주세요.

  • [Game] 헬다이버즈 2 PC 성능 최적화 가이드: 쾌적한 플레이를 위한 설정 팁

    [Game] 헬다이버즈 2 PC 성능 최적화 가이드: 쾌적한 플레이를 위한 설정 팁

    안녕하세요, 13년차의 서버실 주인장입니다. 여러분, 혹시 헬다이버즈 2(Helldivers 2) 플레이하면서 답답함을 느끼신 적 있으신가요? 전장 한가운데서 적들이 몰려오는데 프레임(Frame Rate)이 뚝뚝 떨어져서 버벅거리는 경험 말이죠. 제가 처음 헬다이버즈 2를 플레이했을 때도 딱 그랬거든요. 시원하게 적들을 쓸어버려야 하는데, PC가 제 발목을 잡으니 여간 스트레스가 아니더라고요.

    저도 홈랩(Home Lab)에서 이것저것 실험하며 다양한 게임을 즐기는 편인데, 헬다이버즈 2처럼 최적화가 중요한 게임은 정말 신경 써야 하더군요. 오늘은 제가 직접 겪은 삽질 경험과 함께, 헬다이버즈 2를 쾌적하게 즐길 수 있도록 PC 성능을 최적화하는 방법들을 상세히 알려드리려고 합니다. 헬다이버즈 2 렉(Lag)이나 프레임 드랍(Frame Drop) 때문에 고통받고 계셨다면, 이 글이 큰 도움이 될 거예요!

    헬다이버즈 2 전장에서 프레임 드랍으로 고통받는 게이머의 모습입니다. 저도 처음엔 이랬죠.

    💡 헬다이버즈 2 성능 최적화, 왜 중요할까요?

    게임 성능 최적화는 단순히 게임을 ‘돌아가게 하는’ 것을 넘어, ‘쾌적하게 즐기는’ 게 진짜 목표거든요. 헬다이버즈 2는 혼돈의 전장에서 수많은 적과 오브젝트들이 동시에 처리되어야 하는 게임이라, 그래픽카드(GPU)와 중앙처리장치(CPU)에 상당한 부하를 줍니다. 프레임이 낮으면 적의 움직임을 정확히 파악하기 어렵고, 반응 속도가 느려져 게임 플레이 자체의 질이 떨어져 버리죠.

    쉽게 말해, PC가 게임이 보여줘야 할 그림을 제때제때 못 그려내서 화면이 뚝뚝 끊기는 현상이 바로 프레임 드랍이고, 이게 심해지면 렉으로 이어지는 거예요. 게임 내 설정을 조금만 바꿔줘도 체감 성능이 확 달라지는 경우가 많으니, 지금부터 저와 함께 하나씩 살펴보시죠.

    🎮 헬다이버즈 2 인게임(In-Game) 그래픽 설정 최적화

    가장 먼저 손댈 곳은 바로 게임 내 그래픽 설정입니다. 여기서 성능에 가장 큰 영향을 미치는 몇 가지 설정들이 있거든요. 제가 직접 여러 조합으로 테스트해보면서 ‘이건 꼭 건드려야 한다!’ 싶었던 것들을 위주로 정리해봤습니다.

    1. 디스플레이 모드 (Display Mode)
      가장 먼저 ‘전체 화면 (Full Screen)’으로 설정하는 것을 추천합니다. ‘창 모드 (Windowed)’나 ‘테두리 없는 창 모드 (Borderless Windowed)’는 백그라운드에서 다른 프로그램들과 리소스를 공유하니까, 성능 저하의 원인이 될 수 있어요. 전체 화면 모드가 게임에 가장 많은 GPU 리소스를 할당해주는 방식입니다.
    2. 렌더링 스케일 (Render Scale)
      이건 성능에 가장 큰 영향을 미치는 설정 중 하나더라고요. 기본값은 보통 1.0(100%)인데, 이걸 낮추면 게임이 내부적으로 더 낮은 해상도로 렌더링(Rendering, 화면을 그림)한 다음, 모니터 해상도에 맞춰 확대해서 보여줍니다. 예를 들어 0.8(80%)로 설정하면 그래픽 품질은 약간 떨어지지만, 프레임은 크게 상승할 겁니다. 저사양 PC에서는 0.6~0.8 사이로 조절해보시는 걸 추천드려요. 고사양이라면 1.0을 유지하거나, DLSS(Deep Learning Super Sampling)나 FSR(FidelityFX Super Resolution) 같은 업스케일링 기술을 활용하는 게 좋습니다.
    3. 텍스처 품질 (Texture Quality)
      게임 내 오브젝트들의 텍스처(Texture, 표면 질감) 해상도를 결정하는 거고, VRAM(Video RAM, 그래픽카드 전용 메모리) 사용량과 직결되죠. 그래픽카드의 VRAM 용량이 충분하지 않다면(예: 8GB 미만), ‘중간 (Medium)’이나 ‘낮음 (Low)’으로 설정하는 게 VRAM 부족으로 인한 스터터링(Stuttering)을 방지하는 데 효과적입니다.
    4. 그림자 품질 (Shadow Quality)
      그림자는 GPU와 CPU 모두에게 큰 부담을 주는 요소거든요. ‘낮음 (Low)’으로 설정해도 게임 플레이에 큰 지장이 없으니, 프레임 확보를 위해선 과감하게 낮추는 걸 추천합니다. 저도 그림자는 항상 최소로 설정하고 플레이하는 편입니다.
    5. 안티앨리어싱 (Anti-aliasing)
      계단 현상(Jaggies)을 부드럽게 처리해주는 기술이에요. 헬다이버즈 2에서는 주로 TAA(Temporal Anti-aliasing)가 사용될 텐데, ‘켜기 (On)’ 또는 ‘균형 (Balanced)’ 정도로 설정하는 게 좋습니다. 너무 높게 설정하면 프레임 손실이 커질 수 있거든요.
    6. 환경 디테일 (Environment Detail) 및 이펙트 품질 (Effect Quality)
      전장의 환경 요소들과 폭발 같은 이펙트(Effect)의 복잡도를 조절하는 거고, 이 역시 프레임에 영향을 주기 때문에, ‘중간 (Medium)’ 정도로 타협하는 게 좋습니다. 특히 폭발 이펙트가 많을 때는 이 설정을 낮춰두면 프레임 드랍을 줄일 수 있어요.
    7. 전역 조명 (Global Illumination)
      빛이 오브젝트에 반사되어 주변을 밝히는 효과를 시뮬레이션하는 고급 기술이에요. 현실감을 높여주지만, 성능 소모가 매우 큽니다. 프레임이 부족하다면 ‘꺼짐 (Off)’으로 설정하는 것을 강력히 권장합니다.
    8. 수직 동기화 (V-Sync) 및 프레임 제한 (Frame Cap)
      수직 동기화는 티어링(Tearing, 화면 찢어짐) 현상을 방지해주지만, 인풋 렉(Input Lag)을 유발할 수 있어요. G-Sync나 FreeSync 모니터를 사용 중이라면 게임 내 V-Sync는 끄고, 모니터의 가변 주사율 기능을 활용하세요. 일반 모니터라면 모니터 주사율에 맞춰 프레임 제한을 걸어두는 게 좋습니다 (예: 60Hz 모니터라면 60fps 제한). 불필요하게 높은 프레임을 생성하느라 GPU가 과부하 걸리는 걸 막아줄 수 있거든요.

    헬다이버즈 2 인게임 그래픽 설정 메뉴입니다. 여기서 제가 알려드린 옵션들을 조절해보세요.

    ⚙️ 그래픽 드라이버 및 Windows 시스템 최적화

    인게임 설정만으로는 부족할 때가 있어요. PC 자체를 게임에 최적화하는 추가 작업이 필요할 수 있거든요.

    1. 그래픽 드라이버(Graphic Driver) 최신 업데이트 및 설정

    그래픽카드 제조사(NVIDIA, AMD)는 주기적으로 게임 성능을 개선하는 드라이버를 출시합니다. 항상 최신 드라이버로 업데이트하는 습관을 들이세요. 제가 직접 업데이트해보니 특정 게임에서 프레임이 10~20%씩 오르는 경우도 많더라고요.

    1. 최신 드라이버 설치
      각 제조사 웹사이트에서 최신 드라이버를 다운로드하여 설치합니다.
    2. NVIDIA 제어판 / AMD Radeon Software 설정
      그래픽카드 제어판에서 헬다이버즈 2에 대한 개별 프로필을 설정할 수 있어요. 특히 ‘전원 관리 모드 (Power Management Mode)’를 ‘최고 성능 선호 (Prefer Maximum Performance)’로 설정하고, ‘저지연 모드 (Low Latency Mode)’를 ‘켜기 (On)’ 또는 ‘울트라 (Ultra)’로 설정하면 인풋 렉을 줄이는 데 도움이 됩니다. 텍스처 필터링(Texture Filtering) 품질도 ‘고성능 (High Performance)’으로 바꿔주세요.

    2. Windows 시스템 설정 최적화

    운영체제(OS) 자체의 설정도 게임 성능에 영향을 미쳐요.

    1. 게임 모드 (Game Mode) 활성화
      Windows 10/11에는 게임 모드가 있습니다. <code>설정 > 게임 > 게임 모드에서 ‘켬’으로 설정하면, Windows가 게임 실행 시 시스템 리소스를 게임에 우선적으로 할당해서 성능을 향상시켜줘요.
    2. 백그라운드 앱 (Background Apps) 끄기
      게임을 플레이할 때는 불필요한 백그라운드 앱들을 종료하는 게 좋습니다. 설정 > 앱 > 앱 및 기능에서 ‘백그라운드에서 실행’ 옵션을 확인하고 필요 없는 앱들을 꺼주세요. 아니면 작업 관리자(Task Manager)에서 수동으로 종료해도 됩니다.
    3. 전원 관리 옵션 (Power Options) 변경
      제어판 > 전원 옵션에서 ‘고성능 (High Performance)’ 또는 ‘최고의 성능 (Ultimate Performance)’ 플랜을 선택하세요. 이렇게 하면 CPU가 항상 최대 성능으로 작동할 수 있게 해줍니다.
    4. 불필요한 시작 프로그램 정리
      Windows 시작 시 자동으로 실행되는 프로그램이 많으면 시스템 부팅 속도와 전반적인 성능에 영향을 줄 수 있어요. 작업 관리자 > 시작 앱 탭에서 사용하지 않는 프로그램은 ‘사용 안 함’으로 설정해주세요.

    ⚠️ 삽질 경험: VRAM 부족과 쉐이더 캐시 문제

    제가 헬다이버즈 2를 처음 시작했을 때, 그래픽카드는 나쁘지 않다고 생각했는데도 특정 구간에서 프레임이 뚝뚝 끊기면서 화면이 멈추는 현상(스터터링)을 겪었어요. 처음엔 드라이버 문제인가 싶어 이것저것 만져봤는데, 알고 보니 VRAM 부족 때문이더라고요.

    • VRAM 부족 해결: 애프터버너(MSI Afterburner) 같은 툴로 모니터링해보니, VRAM 사용량이 그래픽카드 용량을 거의 꽉 채우고 있었어요. 텍스처 품질을 ‘중간’으로 낮추고, 렌더링 스케일을 0.8로 조절하니 거짓말처럼 스터터링이 사라지더군요. 그래픽카드의 VRAM 용량이 8GB 이하라면 꼭 이 부분을 확인해보세요.
    • 쉐이더 캐시 (Shader Cache) 문제: 가끔 게임 업데이트 후에 프레임이 불안정해지는 경우가 있었는데, NVIDIA 제어판에서 쉐이더 캐시를 정리해주니 해결되더라고요. 쉐이더 캐시는 게임이 자주 사용하는 그래픽 데이터를 미리 저장해두는 공간인데, 이게 꼬이면 오히려 독이 될 수 있거든요.

    쉐이더 캐시 정리 방법 (NVIDIA 기준):

    1. NVIDIA 제어판을 엽니다.
    2. 왼쪽 메뉴에서 3D 설정 > 3D 설정 관리로 이동합니다.
    3. 글로벌 설정 탭에서 ‘쉐이더 캐시 크기’를 찾습니다.
    4. 이 설정을 ‘끄기’로 설정했다가 ‘드라이버 기본값’으로 다시 바꿔주면 캐시가 초기화돼요. 아니면 디스크 정리 도구를 사용해서 임시 파일을 삭제하는 방법도 있습니다.

    ✅ 최적화 결과 확인하기: FPS 모니터링

    설정을 바꿨다면, 반드시 효과가 있는지 확인해야 하겠죠? 게임 내에서 프레임을 실시간으로 확인하는 방법은 여러 가지가 있어요.

    1. 게임 내 FPS 카운터 활용
      헬다이버즈 2 자체 설정이나 Steam 오버레이(Overlay) 기능을 통해 FPS(Frames Per Second) 카운터를 켤 수 있습니다. Steam의 경우 Steam 설정 > 게임 중 > 게임 내 FPS 카운터에서 위치를 선택할 수 있어요.
    2. MSI Afterburner (및 RivaTuner Statistics Server)
      이 툴은 단순히 FPS만 보여주는 게 아니라, GPU 사용률, CPU 사용률, VRAM 사용량, 온도 등 다양한 하드웨어 정보를 실시간으로 오버레이해서 보여줍니다. 어떤 하드웨어가 병목(Bottleneck) 현상을 일으키는지 파악하는 데 정말 유용하죠. 제가 가장 즐겨 쓰는 툴이기도 합니다.

    설정을 하나씩 바꿔가면서 FPS 카운터나 Afterburner를 통해 프레임 변화를 확인해보세요. 너무 욕심내지 말고, 본인 PC 사양에 맞는 ‘타협점’을 찾는 게 중요합니다. 보통 60fps 이상을 안정적으로 유지할 수 있다면 쾌적한 플레이가 가능해요.

    MSI Afterburner를 활용해 헬다이버즈 2 플레이 중 FPS와 하드웨어 사용률을 모니터링하는 모습입니다.

    🎉 마무리하며: 민주주의를 위한 쾌적한 전장!

    오늘은 헬다이버즈 2를 더 쾌적하게 즐기기 위한 PC 성능 최적화 방법들을 알아봤어요. 인게임 그래픽 설정부터 그래픽 드라이버, 그리고 Windows 시스템 최적화까지, 생각보다 손볼 곳이 많죠? 제가 13년 동안 인프라 엔지니어로 일하면서 느낀 건데, 결국 모든 시스템은 ‘최적화’가 생명이라는 거예요. 게임 PC도 마찬가지고요.

    이 글에서 다룬 내용들을 적용해보시면 분명 헬다이버즈 2의 프레임이 눈에 띄게 개선될 거예요. 만약 그래도 부족하다면, 하드웨어 업그레이드를 고려해볼 시점이 온 거겠죠. 특히 SSD(Solid State Drive) 사용은 로딩 속도와 전반적인 시스템 반응성에 큰 영향을 주니까, 아직 HDD(Hard Disk Drive)를 사용 중이시라면 SSD로의 교체를 강력히 추천합니다. 다음번에는 더 깊이 있는 하드웨어 최적화 팁으로 찾아뵐게요. 민주주의를 위해, 쾌적한 환경에서 슈퍼 지구를 수호하세요!

    헬다이버즈 2 PC 성능 최적화를 위한 핵심 팁을 요약한 인포그래픽입니다.

  • [Proxmox] LXC 컨테이너 심화 활용: Docker 연동 및 성능 최적화 (Proxmox VE 9.1)

    [Proxmox] LXC 컨테이너 심화 활용: Docker 연동 및 성능 최적화 (Proxmox VE 9.1)

    LXC 컨테이너 심화 활용: Docker 연동 및 성능 최적화 (Proxmox VE 9.1)

    안녕하세요, 13년차 인프라 엔지니어 ’13년차의 서버실’ 블로그 주인장입니다. 오늘도 홈랩에서 밤샘 삽질 끝에 얻어낸 귀한 경험 하나를 공유해드리려고 해요. 💡

    홈랩을 운영하거나 소규모 서버를 돌리시는 분들이라면 Proxmox VE (Virtual Environment)의 매력에 빠져 계실 텐데요. 특히 LXC (Linux Containers)는 가벼운 오버헤드로 높은 성능을 내주기 때문에 저도 애용하고 있습니다. 여기에 Docker까지 연동하면 어떨까요? 효율은 물론이고 관리 유연성까지 챙길 수 있거든요.

    오늘은 Proxmox VE 9.1 환경에서 LXC 컨테이너 안에 Docker를 설치하고, 실제 서비스를 운영하면서 겪었던 삽질과 함께 성능 최적화 팁까지 아낌없이 풀어보겠습니다. LXC와 Docker 연동에 어려움을 겪으셨다면, 이 글이 든든한 가이드가 될 거예요!

    Proxmox VE 호스트에서 LXC 컨테이너와 Docker가 연동되는 아키텍처 다이어그램

    LXC와 Docker, 그리고 그들의 시너지

    먼저 LXC와 Docker가 뭔지 간단하게 짚고 넘어갈게요. 이미 잘 아시는 분들도 계시겠지만, 핵심만 콕 짚어드리겠습니다.

    • LXC (Linux Containers, 리눅스 컨테이너): 리눅스 커널의 컨테이너 기술을 활용한 OS 수준의 가상화예요. 쉽게 말해, 별도의 커널 없이 호스트의 커널을 공유하면서도 독립적인 운영체제 환경을 만들어주는 거죠. 가상 머신(VM)보다 훨씬 가볍고 빠르고, 부팅 시간도 거의 없어서 자원 소모가 정말 적어요.
    • Docker (도커): 애플리케이션 수준의 컨테이너 기술입니다. 특정 애플리케이션과 그에 필요한 모든 종속성(라이브러리, 설정 파일 등)을 하나의 이미지(Image)로 묶어서 어디서든 동일하게 실행되도록 해줘요. 개발 환경과 운영 환경의 불일치 문제를 한 번에 해결하는 거죠.

    그럼 이 둘을 왜 같이 쓸까요? 직접 써본 결과 이런 장점들이 정말 크더라고요.

    특징 LXC + Docker 연동의 장점 기존 방식 대비
    자원 효율성 LXC는 VM보다 오버헤드가 적어서, 그 위에 Docker를 올리면 VM 내 Docker보다 훨씬 적은 자원으로 많은 서비스를 돌릴 수 있어요. VM 내 Docker: 커널 이중화로 자원 낭비
    베어메탈 Docker: 호스트 OS 오염 우려
    격리성 LXC 컨테이너가 OS 수준의 격리를 제공하고, 그 안에 Docker가 또 한 번 애플리케이션 격리를 제공하니 보안성과 안정성이 정말 높아져요. 베어메탈 Docker: 호스트 OS와 Docker 컨테이너 간 완전한 격리가 어려움
    관리 용이성 Proxmox VE의 강력한 LXC 관리 기능(스냅샷, 마이그레이션 등)과 Docker의 애플리케이션 배포/관리 기능을 동시에 누릴 수 있어요. 각각의 장점을 한 번에!

    Proxmox VE 9.1 버전에서는 LXC 컨테이너 기능이 더욱 안정화되고 사용성이 개선되었기 때문에, Docker 연동할 때 시너지가 정말 커져요.

    Proxmox VE 9.1 환경에서 LXC 컨테이너 생성 및 Docker 연동 실전 가이드

    자, 이제 직접 해볼 시간입니다. 제가 홈랩에서 실제로 진행했던 과정을 그대로 따라하시면 돼요. 😎

    1. LXC 컨테이너 기본 생성

    먼저 Proxmox VE 웹 UI에 접속해서 LXC 컨테이너를 생성합니다. OS 템플릿은 Ubuntu 22.04 LTS (Jammy Jellyfish)를 추천할게요. 가장 안정적이고 Docker 지원도 정말 잘 되거든요.

    1. Proxmox VE 웹 UI (https://<Proxmox_IP>:8006) 에 접속합니다.
    2. Datacenter -> pve -> Local (pve) -> CT Templates -> Templates에서 원하는 Ubuntu 템플릿을 다운로드해요.
    3. pve 노드에서 CT 생성 버튼을 클릭합니다.
    4. 일반 설정: Hostname, Password 등을 설정하세요.
    5. 템플릿 설정: 다운로드한 Ubuntu 22.04 LTS 템플릿을 선택해요.
    6. 디스크 설정: 최소 8GB 이상으로 설정해주세요. Docker 이미지를 많이 올릴 계획이라면 더 크게 잡는 게 좋습니다.
    7. CPU 설정: 코어는 1개 이상, CPU units (CPU 유닛)은 기본값(1024)으로 둬도 되지만, 고성능이 필요하면 더 높게 설정할 수 있어요.
    8. 메모리 설정: 최소 512MB 이상을 권장합니다. Docker 앱에 따라 달라지니 유연하게 설정하세요.
    9. 네트워크 설정: Bridge (브리지) 모드로 설정하여 호스트와 동일한 네트워크 대역을 사용하도록 하세요.
    10. 마지막으로 확인을 눌러 LXC 컨테이너를 생성합니다.

    ⚠️ 중요 포인트: 비특권 컨테이너(Unprivileged Container) 설정!

    Docker를 LXC 컨테이너 안에서 안전하게 사용하려면 비특권 컨테이너로 만드는 게 좋아요. 보안상 훨씬 유리하거든요. 하지만 비특권 컨테이너에서 Docker가 제대로 동작하려면 몇 가지 추가 설정이 필요해요.

    1. 컨테이너 생성 후, Proxmox VE 웹 UI에서 해당 LXC 컨테이너를 선택하세요.
    2. 옵션 탭으로 이동합니다.
    3. Features (기능) 항목을 찾아서 편집을 클릭하세요.
    4. 여기서 Nesting (중첩)과 FUSE (파일 시스템 인 유저스페이스)를 활성화하고 확인을 눌러요.

    이 두 가지 옵션이 Docker의 스토리지 드라이버(특히 overlay2)가 LXC 내부에서 정상적으로 작동하도록 하는 핵심이에요. 제가 이걸 몰라서 며칠 밤낮을 삽질했던 기억이 생생하네요… 😅

    Proxmox VE 웹 UI에서 LXC 컨테이너 생성 시 Nesting 및 FUSE 기능을 활성화하는 화면

    2. Docker 설치 및 설정

    LXC 컨테이너가 준비되었다면, 이제 컨테이너에 접속해서 Docker를 설치해봅시다. Proxmox 웹 UI에서 해당 LXC 컨테이너를 선택하고 콘솔 탭으로 이동하면 바로 접속돼요.

    \n# LXC 컨테이너 내부에서 실행
    
    # 패키지 목록 업데이트 및 필요한 도구 설치
    sudo apt update
    sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release
    
    # Docker 공식 GPG 키 추가
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
    
    # Docker Stable 저장소 추가
    echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
      $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    
    # Docker 엔진 설치
    sudo apt update
    sudo apt install -y docker-ce docker-ce-cli containerd.io
    
    # Docker 서비스 시작 및 부팅 시 자동 시작 설정
    sudo systemctl start docker
    sudo systemctl enable docker
    
    # 현재 사용자에게 Docker 그룹 권한 추가 (선택 사항, sudo 없이 docker 명령어 사용 가능)
    sudo usermod -aG docker $USER
    
    # 변경 사항 적용을 위해 재로그인 또는 새 쉘 시작
    # exit 후 다시 접속하거나, su - $USER 명령으로 적용
    
    # Docker 설치 확인
    docker run hello-world
    

    docker run hello-world 명령을 실행했을 때 성공 메시지가 나온다면 🎉 Docker 설치가 완벽하게 된 거예요!

    3. 비특권(Unprivileged) 컨테이너의 Docker 이슈 해결 (추가 팁)

    위에서 Nesting과 FUSE를 활성화했지만, 간혹 비특권 컨테이너에서 Docker를 사용할 때 권한 문제나 스토리지 관련 이슈가 발생할 수 있어요. 특히 subuid, subgid 매핑이 제대로 안 되어있을 때 그렇습니다. 제가 겪었던 문제 중 하나였죠.

    만약 Docker 컨테이너 실행 시 권한 관련 오류가 발생한다면, Proxmox 호스트에서 다음 설정을 확인해보세요.

    1. Proxmox 호스트에 SSH로 접속합니다.
    2. /etc/subuid와 /etc/subgid 파일에 LXC 컨테이너의 UID/GID 범위가 매핑되어 있는지 확인하세요. 보통 LXC 생성 시 자동으로 추가돼요.
    3. 만약 특정 Docker 컨테이너가 호스트의 특정 디렉토리에 접근해야 하는데 권한 문제가 있다면, /etc/pve/lxc/<VMID>.conf 파일에 다음 라인을 추가하세요. (예시: 100은 컨테이너 ID)
      echo 'lxc.apparmor.profile: unconfined'
      echo 'lxc.mount.auto: cgroup:rw'
      

      이 설정은 컨테이너의 보안 프로파일을 완화하고 cgroup 마운트를 허용하여 Docker가 더 자유롭게 동작하도록 해요. 하지만 보안상 약간 취약해질 수 있으니 신중하게 사용하세요.

    4. 또 다른 방법으로는 Docker root directory를 변경하여 /var/lib/docker 대신 /mnt/data/docker처럼 별도의 마운트 경로를 사용하는 거예요. /etc/docker/daemon.json 파일을 생성(또는 편집)하고 다음 내용을 추가하세요.
      {
        "data-root": "/mnt/data/docker",
        "storage-driver": "overlay2"
      }
      

      그 후 Docker 서비스를 재시작해요: sudo systemctl restart docker. 이 방법은 특히 ZFS 같은 파일 시스템을 사용하는 Proxmox 호스트에서 LXC에 더 안정적인 Docker 스토리지 환경을 제공할 때 정말 유용해요.

    성능 최적화를 위한 팁과 트러블슈팅 ⚠️

    LXC 컨테이너에 Docker를 올리면 기본적으로 성능이 좋지만, 몇 가지 설정을 통해 더 극대화할 수 있어요.

    1. 컨테이너 자원 관리 (CPU, RAM)

    • CPU Core (CPU 코어) 할당: Proxmox VE 웹 UI에서 LXC 컨테이너의 CPU 코어를 필요한 만큼 할당하세요. 너무 많이 할당하면 다른 컨테이너나 VM의 자원을 잠식할 수 있으니, 실제 워크로드에 맞춰 조절하는 게 중요해요.
    • CPU Units (CPU 유닛) 조절: 여러 컨테이너가 CPU를 경쟁할 때, 특정 컨테이너에 더 높은 우선순위를 주고 싶다면 CPU units 값을 높게 설정해요. 기본값 1024가 공평한 분배라면, 2048은 두 배의 우선순위를 갖는 식이죠.
    • Memory (메모리) 및 Swap (스왑): Docker 컨테이너가 사용할 메모리를 충분히 할당해주세요. 스왑은 꼭 필요한 경우가 아니라면 비활성화하거나 최소한으로 설정하는 게 성능에 좋아요. 스왑이 너무 많이 발생하면 I/O 병목 현상이 생기거든요.

    2. I/O 성능 개선 (Storage)

    • SSD 사용: Proxmox VE 호스트의 OS 및 LXC 컨테이너 스토리지는 반드시 SSD (Solid State Drive)를 사용하는 게 좋아요. 특히 Docker는 이미지 다운로드, 레이어 관리 등으로 I/O 작업이 빈번하니 SSD의 이점이 극대화돼요. NVMe SSD라면 더할 나위 없겠죠.
    • LVM-Thin or ZFS: Proxmox에서 LXC 컨테이너를 생성할 때 LVM-Thin이나 ZFS 같은 스토리지를 사용하는 게 좋아요. 스냅샷 기능도 유용하고, 성능도 괜찮거든요. 개인적으로는 ZFS를 선호해요.
    • Bind Mount (바인드 마운트) 활용: Docker 컨테이너가 영구 데이터를 저장해야 한다면, LXC 컨테이너 내부의 디렉토리를 호스트의 물리 디스크에 바인드 마운트하는 게 좋아요. 예를 들어, 호스트에 별도의 데이터 디스크를 마운트하고, 이를 LXC 컨테이너에 다시 마운트한 뒤 Docker 볼륨으로 사용하는 방식이죠.
    \n# Proxmox 호스트에서 LXC 컨테이너 설정 파일 편집
    # /etc/pve/lxc/VMID.conf 에 다음 라인 추가
    lxc.mount.entry: /path/on/host /path/on/lxc none bind,create=dir 0 0
    

    3. 네트워크 설정 최적화

    • Bridge (브리지) 모드: LXC 컨테이너의 네트워크는 기본적으로 브리지 모드를 사용하는 게 가장 일반적이고 성능 저하가 적어요. 호스트의 브리지(vmbr0)에 직접 연결돼서 별도의 NAT 변환 없이 호스트와 동일한 네트워크에서 통신하거든요.
    • MacVLAN (맥브이랜): 특정 Docker 컨테이너에 별도의 물리적 MAC 주소를 할당하여 호스트 네트워크와 동등하게 통신하고 싶다면 MacVLAN을 고려할 수 있어요. 하지만 설정이 조금 복잡하고, 네트워크 장비가 이를 지원해야 해요. 저도 이 부분은 아직 삽질 중이지만, 특정 시나리오에서는 정말 유용할 수 있습니다.

    성능 검증 및 결과 확인 ✅

    모든 설정이 끝났다면, 이제 실제로 Docker 컨테이너를 띄워서 성능을 확인해볼 차례예요. docker stats 명령어로 각 Docker 컨테이너의 자원 사용량을 실시간으로 모니터링할 수 있거든요.

    \n# LXC 컨테이너 내부에서 실행
    docker stats
    

    이 명령어를 실행하면 CPU 사용량, 메모리 사용량, 네트워크 I/O, 블록 I/O 등을 한눈에 볼 수 있어요. 이 외에도 htop이나 glances 같은 도구를 LXC 컨테이너에 설치하여 전체적인 자원 사용량을 확인하는 것도 정말 좋습니다.

    제가 직접 여러 Docker 컨테이너(Nginx, MariaDB, Portainer 등)를 LXC에 올려서 테스트해보니, 확실히 VM에 올렸을 때보다 CPU와 메모리 사용량이 눈에 띄게 줄어드는 거더라고요. 특히 아이들(idle) 상태에서는 거의 자원을 사용하지 않아서 매우 만족스러웠어요. 🎉

    Proxmox LXC 내 Docker 컨테이너의 CPU, 메모리, I/O 성능 모니터링 대시보드

    마무리하며: 13년차 엔지니어의 한마디

    오늘은 Proxmox VE 9.1 환경에서 LXC 컨테이너와 Docker를 연동하고 성능을 최적화하는 방법을 심도 있게 다뤄봤어요. 제가 직접 겪었던 Nesting, FUSE 같은 핵심 삽질 포인트를 해결하는 방법을 공유하면서, 독자분들의 시간을 절약해드리고 싶었거든요. 😅

    이 조합은 가벼운 홈랩부터 소규모 프로덕션 환경까지, 자원을 효율적으로 사용하면서도 높은 유연성을 제공하는 정말 강력한 솔루션이에요. Proxmox의 안정적인 가상화 기반 위에 Docker의 강력한 애플리케이션 관리 능력을 더하는 거죠.

    물론 모든 기술이 그렇듯, 완벽한 솔루션은 없어요. 하지만 LXC와 Docker의 장점을 잘 이해하고 활용한다면, 여러분의 서버실도 더욱 스마트하고 효율적으로 운영될 수 있을 거예요. 다음에는 이 LXC + Docker 환경 위에 Docker Compose (도커 컴포즈)를 활용해서 여러 서비스를 한 번에 배포하는 방법을 다뤄볼까 하는데, 기대해주세요!

    궁금한 점이나 추가로 알고 싶은 내용이 있다면 언제든지 댓글로 남겨주세요. 여러분의 서버실 운영에 조금이나마 도움이 되었으면 좋겠고, 다음 글에서 또 만나요! 👋

    Proxmox LXC와 가상 머신(VM)에서 Docker를 실행할 때의 성능 및 자원 활용 비교 인포그래픽

  • [Nas] TrueNAS SMB 성능 최적화: 고속 파일 공유를 위한 설정 가이드

    [Nas] TrueNAS SMB 성능 최적화: 고속 파일 공유를 위한 설정 가이드

    안녕하세요! 13년차 서버실 지킴이, 13년차 인프라 엔지니어입니다. 오늘은 홈랩(Homelab)에서 많은 분들이 겪는 고질적인 문제, 바로 TrueNAS SMB 성능 최적화에 대해 이야기해보려고 해요. NAS 파일 공유 속도가 답답해서 속 터지는 경험, 혹시 저만 해본 건 아니겠죠? 저도 처음 TrueNAS를 구축하고 파일을 옮기는데, ‘이게 뭔가 싶을 정도로’ 느려서 한참을 삽질했던 기억이 납니다. 😅

    특히 고용량 파일이나 다수의 작은 파일을 자주 주고받아야 할 때, 느린 SMB(Server Message Block) 속도는 정말이지 작업 효율을 떨어뜨리는 주범이 됩니다. 그래서 오늘은 제가 직접 경험하고 설정하면서 얻은 TrueNAS 네트워크 최적화와 SMB 설정 노하우를 아낌없이 공유해 드릴게요. 여러분의 TrueNAS가 쾌적한 고속 파일 공유 서버로 거듭나도록 도와드리겠습니다!

    홈랩에서 TrueNAS SMB 성능을 최적화하기 위한 기본적인 네트워크 구성도입니다. 10GbE 스위치와 클라이언트, TrueNAS 간의 연결을 보여줍니다.

    TrueNAS SMB, 왜 느릴까요? 핵심 개념부터 알아보기

    우선, SMB(Server Message Block)가 뭔지 간단히 짚고 넘어갈까요? 쉽게 말해, 윈도우나 macOS 같은 운영체제에서 네트워크를 통해 파일이나 프린터를 공유하기 위해 사용하는 통신 프로토콜입니다. 우리가 흔히 ‘네트워크 드라이브’나 ‘공유 폴더’라고 부르는 것들이 바로 이 SMB를 통해 작동하더라고요.

    그럼 왜 TrueNAS의 SMB 성능이 기대만큼 나오지 않을까요? 원인은 다양한데, 크게 몇 가지로 나눠볼 수 있어요.

    • 네트워크 병목(Network Bottleneck): 가장 흔한 원인 중 하나예요. 1기가비트 이더넷(Gigabit Ethernet, GbE) 환경에서는 이론상 최대 125MB/s의 속도를 내지만, 실제로는 100~110MB/s 정도가 한계거든요. 10기가비트 이더넷(10GbE)으로 업그레이드하면 훨씬 빨라집니다.
    • 디스크 I/O 성능(Disk I/O Performance): 아무리 네트워크가 빨라도 디스크 자체가 느리면 소용없어요. 특히 HDD(Hard Disk Drive)는 SSD(Solid State Drive)에 비해 랜덤 I/O 성능이 현저히 떨어지더라고요.
    • CPU 및 RAM(CPU & RAM): SMB 서비스 자체도 어느 정도의 CPU 연산과 RAM을 사용합니다. 특히 동시 접속자 수가 많거나 암호화 기능을 사용하면 더 많은 자원이 필요해요.
    • TrueNAS 설정 문제: 오늘 다룰 핵심이죠. TrueNAS 내부의 SMB 설정이나 ZFS 데이터셋(Dataset) 설정에 따라 성능이 크게 달라질 수 있습니다.

    이런 요소들을 종합적으로 고려해서 최적의 TrueNAS SMB 성능을 끌어내는 것이 우리의 목표입니다.

    고속 파일 공유를 위한 준비물과 사전 점검 💡

    본격적인 설정에 들어가기 전에, 몇 가지 준비물과 사전 점검 사항을 확인해 봅시다. 제가 처음엔 이런 것들을 간과하고 무작정 설정만 바꾸려다가 꽤나 삽질 좀 했거든요. ㅎㅎ

    1. 하드웨어 점검

    • 10기가비트 이더넷(10GbE) 환경:
      • TrueNAS 서버 NIC(네트워크 인터페이스 카드): 서버에 10GbE NIC가 장착되어 있는지 확인하세요. 저는 인텔 X540-T2 같은 NIC를 주로 사용하는데, 안정적이고 성능도 괜찮더라고요.
      • 클라이언트 PC NIC: 파일을 주고받을 클라이언트 PC에도 10GbE NIC가 있어야 합니다.
      • 10GbE 스위치(Switch): 모든 10GbE 장비가 연결될 스위치 역시 10GbE를 지원해야 해요. 저렴한 언매니지드(Unmanaged) 스위치도 괜찮지만, 장기적으로는 관리형(Managed) 스위치가 유용할 때가 많습니다.
    • 스토리지(Storage):
      • 성능이 중요한 공유라면 SSD 풀(Pool)을 사용하는 게 좋습니다. 특히 NVMe SSD는 압도적인 성능을 보여주더라고요.
      • HDD 풀이라도 스트라이프(Stripe)나 미러(Mirror) 구성보다는 RAID-Z1, Z2 같은 방식이 쓰기 성능에 유리할 수 있습니다.

    2. 네트워크 케이블 확인

    10GbE 환경에서는 CAT6a 이상의 이더넷 케이블을 사용하는 게 중요합니다. CAT5e나 CAT6 케이블은 짧은 거리에서는 작동할 수 있지만, 장거리에서는 신뢰성과 성능 저하를 일으킬 수 있어요. 저는 처음에 집에 있던 오래된 CAT5e 케이블로 연결했다가 속도가 안 나와서 애를 먹었는데, 케이블을 바꾸니 바로 해결되더라고요! 😅

    TrueNAS SMB 성능 최적화를 위한 설정 가이드

    이제 본격적으로 TrueNAS 설정에 들어가 볼까요? 여기서는 TrueNAS SCALE SMB를 기준으로 설명하지만, CORE 버전에서도 유사한 설정들이 많으니 참고하시면 됩니다.

    1. SMB 서비스 설정

    TrueNAS 웹 UI에 접속하여 서비스(Services) 메뉴에서 SMB(CIFS) 서비스를 찾아 설정합니다.

    1. 고급 설정 활성화: SMB 서비스 설정 화면에서 ‘고급 옵션 표시(Show Advanced Options)’를 클릭하세요.
    2. 서버 최소/최대 프로토콜(Server Minimum/Maximum Protocol):
      • Server Minimum Protocol: SMB2 (SMB1은 보안에 취약하고 성능도 좋지 않습니다. 레거시 시스템이 아니라면 사용하지 마세요.)
      • Server Maximum Protocol: SMB3_11 또는 SMB3 (최신 프로토콜을 사용하는 게 성능과 보안에 모두 유리합니다.)
    3. 보조 매개변수(Auxiliary Parameters): 여기에 성능 향상을 위한 추가 옵션들을 넣어줄 거예요. 한 줄씩 추가합니다.
    4. 
      # 비동기 I/O (Asynchronous I/O)를 위한 설정
      aio_pthread_cases = 100
      aio_pthread_read_cases = 100
      aio_pthread_write_cases = 100
      
      # SMB Multi-channel (멀티채널) 활성화 (TrueNAS SCALE만 해당, CORE는 Link Aggregation 사용)
      # 여러 네트워크 인터페이스를 사용하여 대역폭을 늘리고 지연 시간을 줄입니다.
      # 클라이언트와 서버 모두 Multi-channel을 지원해야 합니다.
      server multi channel = yes
      
      # 메타데이터 캐싱 최적화 (Disk I/O 감소)
      cache_read_metadata = yes
      
      # 엄격한 할당 비활성화 (쓰기 성능 향상, 주의 필요)
      # 클라이언트가 요청한 크기만큼 블록을 미리 할당하지 않도록 합니다.
      # 파일 시스템 단편화가 증가할 수 있으나, 쓰기 성능 향상에 기여할 수 있습니다.
      strict allocate = no
              

      💡 팁: strict allocate = no는 파일 시스템 단편화를 유발할 수 있으니, 아주 민감한 환경이 아니라면 기본값(yes)을 유지하는 것도 좋은 선택입니다. 저는 홈랩 환경에서 쓰기 성능을 끌어올리기 위해 사용하곤 하는데, 환경에 따라 선택하시면 됩니다.

    5. 저장(Save) 버튼을 눌러 설정을 적용합니다.

    TrueNAS 웹 UI에서 SMB 서비스의 고급 설정을 변경하는 화면입니다. 보조 매개변수에 주요 최적화 옵션들이 입력되어 있습니다.

    2. 네트워크 인터페이스(NIC) 설정

    네트워크 인터페이스 설정도 TrueNAS 네트워크 최적화의 핵심입니다.

    1. 점보 프레임(Jumbo Frames) 활성화:
      • 네트워크(Network) → 인터페이스(Interfaces) 메뉴로 이동하여 사용할 10GbE NIC를 선택합니다.
      • MTU(Maximum Transmission Unit) 값을 9000으로 변경합니다. (기본값은 1500입니다.)
      • ⚠️ 중요: TrueNAS 서버, 스위치, 클라이언트 PC의 모든 장비가 동일하게 MTU 9000을 지원하고 설정되어야 합니다! 하나라도 다르면 오히려 통신 오류나 성능 저하가 발생할 수 있어요. 제가 이 부분에서 삽질 좀 했거든요. 스위치와 TrueNAS는 설정했는데 클라이언트 MTU를 잊어서 한참을 헤맸던 기억이 나네요.
    2. Link Aggregation(링크 어그리게이션) 또는 SMB Multi-channel(멀티채널):
      • TrueNAS CORE: 여러 개의 1GbE NIC를 묶어 대역폭을 확장하는 Link Aggregation(LACP)을 주로 사용합니다. 스위치에서 LACP 설정을 해주어야 해요.
      • TrueNAS SCALE: SMB Multi-channel을 적극 활용하는 게 좋습니다. 위에 SMB 보조 매개변수에서 server multi channel = yes를 설정했다면, TrueNAS 서버에 여러 개의 NIC가 연결되어 있고 클라이언트도 Multi-channel을 지원하면 자동으로 대역폭을 합쳐서 사용해요. 훨씬 간편하고 효과적입니다.

    3. ZFS 데이터셋(Dataset) 설정 (⚠️ 매우 중요!)

    SMB 공유에 사용할 ZFS 데이터셋의 설정도 성능에 큰 영향을 미칩니다. 특히 동기 쓰기(Synchronous Write)와 관련된 설정은 데이터 안전성과 성능 사이의 트레이드오프가 존재하므로 신중해야 합니다.

    1. 데이터셋(Datasets) 메뉴로 이동하여 공유할 데이터셋을 선택합니다.
    2. 고급 옵션(Advanced Options)에서 동기화(Sync) 설정을 확인합니다.
      • Sync: Standard (기본값)
        • 대부분의 경우 이 설정이 가장 안전하고 균형 잡힌 성능을 제공해요.
        • 데이터 무결성(Data Integrity)을 보장하며, 쓰기 작업이 완료되기 전에 데이터가 디스크에 기록되었는지 확인합니다.
      • Sync: Always (가장 안전하지만, 성능 저하)
        • 모든 쓰기 작업이 디스크에 기록될 때까지 기다리므로, 전력 손실 등의 상황에서도 데이터 손실 위험이 거의 없습니다. 하지만 쓰기 성능은 가장 낮아요.
      • Sync: Disabled (최대 성능, 데이터 손실 위험)
        • 쓰기 작업이 디스크에 기록되었는지 확인하지 않고, 운영체제 캐시에서 쓰기 완료를 보고합니다. 이로 인해 쓰기 성능은 가장 뛰어나지만, 전력 손실이나 시스템 크래시 시 데이터 손실 또는 손상 위험이 매우 높습니다.
        • ⚠️ 경고: 이 옵션은 극단적인 성능이 필요하고 데이터 손실 위험을 감수할 수 있는 경우에만 사용해야 합니다. 절대 중요한 데이터에 사용하지 마세요! 저는 특정 임시 파일 공유나 벤치마크 테스트 시에만 제한적으로 사용해봤습니다.

    주의사항 및 트러블슈팅: 제가 겪었던 삽질들 😱

    자, 이렇게 설정하면 웬만해선 TrueNAS SMB 성능이 확 올라갈 겁니다. 하지만 저처럼 예상치 못한 문제에 부딪힐 수도 있겠죠? 제가 겪었던 몇 가지 삽질 경험과 해결 팁을 공유해 드릴게요.

    1. 점보 프레임 설정 후 오히려 속도가 느려지거나 접속 불가

    앞서 강조했지만, MTU 9000은 TrueNAS, 스위치, 클라이언트 모두 동일하게 설정되어야 해요. 저는 스위치와 TrueNAS는 설정했지만, 윈도우 클라이언트 PC의 NIC 드라이버 설정에서 MTU를 바꾸는 걸 깜빡해서 한참을 헤맸어요. 윈도우에서는 PowerShell이나 NIC 속성에서 설정할 수 있습니다.

    
    # 현재 MTU 확인 (Windows)
    Get-NetAdapterAdvancedProperty -Name "이더넷 어댑터 이름" | Where-Object {$_.DisplayName -eq "Jumbo Packet"}
    
    # MTU 9000으로 설정 (Windows)
    Set-NetAdapterAdvancedProperty -Name "이더넷 어댑터 이름" -RegistryKeyword "JumboPacket" -RegistryValue 9000
    

    2. 클라이언트 PC의 SMB 캐싱 문제

    가끔 클라이언트 PC에서 이전에 연결했던 SMB 공유의 캐시가 남아있어 성능 측정이 정확하지 않은 경우가 있어요. 이럴 때는 클라이언트 PC를 재부팅하거나, 네트워크 드라이브 연결을 완전히 끊고 다시 연결해보세요.

    3. TrueNAS 리소스 부족

    SMB 성능은 네트워크뿐만 아니라 TrueNAS 서버 자체의 리소스(CPU, RAM)에도 영향을 받습니다. 특히 TrueNAS SCALE SMB는 컨테이너 기반으로 작동하므로, 시스템 리소스 할당이 중요할 수 있어요. TrueNAS 대시보드에서 CPU 사용률, RAM 사용률, 디스크 I/O 등을 모니터링하면서 병목 지점을 찾아보세요.

    TrueNAS 웹 UI에서 시스템 리소스 사용 현황을 모니터링하는 대시보드 화면입니다. CPU, RAM, 네트워크 트래픽 등의 지표를 확인할 수 있습니다.

    검증 및 결과 확인 🎉

    자, 이제 설정도 끝났으니 실제로 NAS 파일 공유 속도가 얼마나 빨라졌는지 확인해 볼 시간입니다! 저는 주로 두 가지 툴을 사용해서 성능을 측정합니다.

    1. iPerf3를 이용한 네트워크 대역폭 테스트

    SMB 성능은 결국 네트워크 대역폭에 크게 좌우됩니다. iPerf3는 네트워크 자체의 최대 처리량을 측정하는 데 정말 유용해요. TrueNAS SCALE에서는 앱(Apps)으로 iPerf3를 설치하거나, CLI에서 직접 실행할 수 있습니다.

    
    # TrueNAS 서버에서 iPerf3 서버 실행
    iperf3 -s
    
    # 클라이언트 PC에서 iPerf3 클라이언트 실행 (TrueNAS 서버 IP로)
    iperf3 -c [TrueNAS_IP] -P 8 -t 30
    

    이렇게 측정했을 때 10GbE 환경이라면 9~9.5Gbps 정도가 나와야 정상입니다. 만약 1Gbps에 머무르거나 그 이하로 나온다면, 네트워크 케이블, NIC 드라이버, 스위치 설정 등을 다시 점검해 봐야 합니다.

    2. CrystalDiskMark (Windows) 또는 Blackmagic Disk Speed Test (macOS)

    실제 SMB 공유 폴더에 파일을 읽고 쓰는 성능을 측정하는 데 정말 유용한 툴들이예요. 클라이언트 PC에서 공유 폴더를 네트워크 드라이브로 연결한 후 테스트를 진행합니다.

    • CrystalDiskMark: 윈도우 환경에서 가장 널리 사용되는 디스크 벤치마크 툴입니다. 순차 읽기/쓰기, 랜덤 읽기/쓰기 성능을 직관적으로 보여줍니다.
    • Blackmagic Disk Speed Test: macOS 사용자에게 정말 좋은 선택지예요. 비디오 편집 워크로드에 초점을 맞춰 성능을 측정합니다.

    설정 전후로 이 툴들을 돌려보면 확연히 빨라진 TrueNAS SMB 성능을 체감하실 수 있을 거예요. 저는 순차 읽기/쓰기 속도가 110MB/s에서 700~800MB/s (10GbE 환경, SSD 풀)까지 올라가는 걸 보고 쾌재를 불렀습니다! 🎉

    TrueNAS SMB 성능 최적화 전후의 CrystalDiskMark 벤치마크 결과 비교표입니다. 순차 읽기/쓰기 속도 변화를 보여줍니다.

    마무리하며: 쾌적한 홈랩을 위한 끊임없는 탐구

    오늘은 제가 13년차 인프라 엔지니어로 홈랩을 운영하면서 겪었던 TrueNAS SMB 성능 최적화 과정을 공유해 드렸습니다. NAS 파일 공유 속도를 높이기 위해 SMB 설정부터 네트워크 환경, 그리고 ZFS 데이터셋 설정까지 다양한 요소를 고려해야 한다는 걸 다시 한번 깨달으셨을 거예요. 때로는 복잡하고 삽질의 연속일 수 있지만, 드디어 원하는 성능이 나왔을 때의 그 쾌감은 정말 최고랍니다! 😄

    오늘 다룬 내용 외에도 ZFS 캐싱(L2ARC, SLOG)을 활용하거나, 더 고급스러운 네트워크 튜닝을 통해 TrueNAS 네트워크 최적화를 시도해 볼 수도 있어요. 하지만 오늘 제가 알려드린 기본 설정만으로도 대부분의 홈랩 환경에서는 충분히 만족할 만한 TrueNAS SMB 성능 향상을 경험하실 수 있을 겁니다. 여러분의 쾌적한 홈랩 생활에 제 경험이 조금이나마 도움이 되었기를 바랍니다!

    다음번에는 TrueNAS SCALE의 컨테이너 앱 활용법 같은 재미있는 주제로 찾아올게요. 그때까지 즐거운 홈랩 라이프 보내세요! 👋