AI200 MASTER INFRASTRUCTURE GUIDE v2.6 Ubuntu 26.04 LTS · Proxmox 12-Node

AI-Native 풀스택 인프라 101 마스터 가이드

makerskorean.kr은 30년간 임상 현장에서 의료 영상(PACS/DICOM) 무결성을 다뤄온 운영자(꼬꼬마)가 직접 12대의 Proxmox VE 홈랩 클러스터를 구축하며 검증한 오픈 엔지니어링 지식 허브입니다. 리눅스 커널 보안(001단계)부터 Python FastAPI & 로컬 Ollama LLM 마이크로서비스, Node.js 24, Docker, MariaDB, PHP 8.5 JIT, Headless WordPress(WPGraphQL), Jamstack PWA, NGINX TLS 1.3 및 SRE 자동 감사(101단계)까지 11개 섹션 · 101개 프로덕션 공정의 모든 설정 코드와 실측 데이터를 투명하게 공개합니다.

101 Steps
11개 섹션 표준화 공정
12 Nodes
Proxmox VE 홈랩 클러스터
170+ Docs
실전 기술 블로그 & 가이드
CLS 0.00
Core Web Vitals 최적화
architecture-topology
makerskorean.kr Stack
┌────────────────────────────────────────────────────────┐
│     Client Browser / Mobile PWA (Service Worker)       │
└───────────────────────────┬────────────────────────────┘
                            │ HTTPS (TLS 1.3 / HTTP/2)
                            ▼
┌────────────────────────────────────────────────────────┐
│   NGINX Main Reverse Proxy (:80 / :443, Gzip, BBR)     │
├───────────────┬───────────────────────┬────────────────┤
│ / & /ai200/   │ /blog/ (Jamstack)     │ /py-api/       │
│ Vanilla SPA   │ Astro Static Build    │ FastAPI ASGI   │
│ 101 Docs Hub  │ + WPGraphQL Fetch     │ (:8000, venv)  │
└───────┬───────┴───────────┬───────────┴───────┬────────┘
        │                   │                   │
        ▼                   ▼                   ▼
┌───────────────┐   ┌───────────────┐   ┌────────────────┐
│ Local Storage │   │ Headless WP   │   │ Ollama AI Node │
│ & Offline MD  │   │ PHP 8.5 + JIT │   │ Gemma4 12B LLM │
│ (Zero-404)    │   │ MariaDB 10.11 │   │ (:11434 LAN)   │
└───────────────┘   └───────────────┘   └────────────────┘
ENGINEERING WHITEPAPER & E-E-A-T

왜 ‘AI200 101 마스터 가이드’인가? — 설계 철학과 풀스택 아키텍처 해부

작성자: 꼬꼬마 (30년 방사선사 / 홈랩 인프라 엔지니어)

01. 임상 의료 영상(PACS)에서 배운 무결성 원칙

“검증되지 않은 설정은 완료된 것이 아니다”

병원 현장에서 30년간 방사선사로 근무하며 다뤄온 의료 영상 시스템(PACS/DICOM)은 단 1바이트의 체크섬(Checksum) 손상이나 1분의 무계획 정전도 허용하지 않습니다. 온라인상의 수많은 리눅스·웹 개발 튜토리얼이 단순한 명령어 나열에 그쳐 실제 운영 중 OOM(메모리 고갈)이나 디스크 풀(Journald/Docker 로그 폭증)로 무너지는 문제를 해결하기 위해, 모든 단계마다 사전 문법 검증(sshd -t, nginx -t, wp core verify-checksums)과 사후 무결성 체크리스트를 의무화했습니다.

02. 디커플드(Decoupled) 아키텍처 & 비용 최적화

Headless CMS + 정적 Jamstack + 로컬 LLM의 결합

클라우드 SaaS 구독료와 상용 LLM API 호출 비용은 1인 창작자와 소규모 기술 조직에 큰 부담이 됩니다. 본 플랫폼은 온프레미스 Proxmox VE 12노드 클러스터 위에서 로컬 Ollama LLM(`batiai/gemma4-12b`)을 구동하여 API 비용 0원을 달성하고, 콘텐츠 작성은 Headless WordPress에서 수행하되 대외 서비스는 사전 빌드된 Jamstack(Astro & Vanilla SPA) 정적 파일로 서빙하여 단일 저전력 노드에서도 초당 수천 건의 요청을 거뜬히 처리합니다.

03. Human-in-the-Loop (HITL) 편집 품질 관리

6단계 자율 에이전트 파이프라인과 인간 전문가 감수

단순 자동 생성 텍스트는 독자에게 실질적인 문제 해결 가치를 주지 못합니다. makerskorean.kr의 OSMU 파이프라인은 ① 원문 클리핑 수집 → ② 구조 설계 → ③ 초안 작성 → ④ WebP 미디어 생성 → ⑤ 규칙 기반 QA → ⑥ 인간 전문가(운영자) 최종 코드 검증 및 배포의 6단계를 거치며, 실제 서버에서 직접 실행하여 통과된 명령어와 벤치마크 수치만을 선별해 공개합니다.

📊 AI200 풀스택 계층별 기술 명세 및 엔지니어링 목표 요약

101개 단계가 유기적으로 맞물려 돌아가는 6개 핵심 인프라 계층의 프로덕션 설계 기준표입니다.

인프라 계층 (Layer) 관련 섹션 / 단계 핵심 채택 기술 (Production Stack) 주요 튜닝 파라미터 및 보안 정책 달성 지표 (SLA / KPI)
L1. OS & 커널 보안 섹션 01 (001~010) Ubuntu 26.04 LTS, UFW, OpenSSH, Fail2ban, Chrony Swap 4GB (swappiness=10), PermitRootLogin no, TCP bbr, Journald 500MB 상한 무차별 대입 100% 차단
L2. AI & 비동기 API 섹션 02 (011~018) Python 3.12+, pipx/venv, FastAPI, Uvicorn, Ollama PEP 668 격리, 비동기 HTTPX 타임아웃 가드, systemd 자동 재시작(3초) API 헬스 응답 < 5ms
L3. Node & 정적 빌더 섹션 03 (019~028) NVM v0.40+, Node.js 24 LTS, pnpm, PM2, Vite, Astro /usr/local/bin 심볼릭 링크, PM2 dump.pm2 부팅 복원, 정적 CSS 컴파일 TBT = 0ms 달성
L4. 컨테이너 & DB 섹션 04~05 (029~048) Docker CE, Compose v2, MariaDB 10.11+, Redis 7.4 127.0.0.1 루프백 바인딩, utf8mb4, InnoDB Buffer Pool 1GB, 일일 자동 백업 버퍼 적중률 99.8%
L5. 백엔드 & 헤드리스 CMS 섹션 06~07 (049~068) PHP 8.5 FPM, OPcache + JIT, WP-CLI, WPGraphQL Tracing JIT(1255), Unix 도메인 소켓, WP REST Cache, 테마 301 리다이렉트 GraphQL 응답 78% 단축
L6. PWA & 엣지 게이트웨이 섹션 08~11 (069~101) Vanilla JS SPA, Service Worker, NGINX, Certbot TLS 1.3 Cache-First 오프라인 폴백, Gzip Lv6, 1년 Immutable 캐시, HSTS Preload Lighthouse 99+ / CLS 0
11 SECTIONS ARCHITECTURAL DEEP-DIVE

11대 섹션별 핵심 아키텍처 심층 해설 및 프로덕션 설정 코드

전체 문서 색인(Sitemap Index) 보기 →

아래는 AI200 101 마스터 가이드를 구성하는 11개 섹션 각각의 설계 목적, 실무 엔지니어링 핵심 노하우, 대표 프로덕션 설정 코드 및 세부 단계(001~101) 직통 링크입니다. 각 단계 버튼을 클릭하면 해당 공정의 전체 스크립트와 체크리스트가 수록된 상세 문서로 이동합니다.

🛡️
SECTION 01 · STEP 001 ~ 010 10개 실전 공정

섹션 1. 기본 시스템 & 베이스라인 보안 (001 ~ 010)

섹션 01 전체 가이드 열기 (001~010) →

🎯 핵심 영역: Ubuntu 26.04 LTS 커널 튜닝, 4GB Swap, UFW 방화벽, SSH 하드닝 & Google BBR

📘 아키텍처 설계 및 공정 상세

모든 엔터프라이즈 웹 서비스와 AI 마이크로서비스의 안정성은 가장 아래에 위치한 리눅스 운영체제(OS) 베이스라인에서 결정됩니다. 섹션 1에서는 Ubuntu 26.04 LTS 서버 최초 설치 직후 수행해야 할 패키지 동기화, UFW 최소 권한 방화벽(22/80/443 포트 한정 개방), 4GB 전용 스왑 메모리(vm.swappiness=10) 구성, OpenSSH 루트 직접 접속 차단, Fail2ban 자동 침입 차단 데몬, systemd-journald 디스크 고갈 방지(500MB 상한), 로컬 호스트네임/DNS 매핑 및 Google BBR TCP 혼잡 제어 알고리즘을 단계별로 완성합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

기본 설치 상태의 리눅스 서버는 swappiness=60으로 설정되어 있어 가용 RAM이 충분함에도 디스크 스왑을 조기에 발생시켜 DB 응답 지연을 유발하며, journald 로그 무제한 증식으로 인한 디스크 Full 장애에 취약합니다. 또한 CUBIC 대신 Google BBR(net.ipv4.tcp_congestion_control=bbr)을 적용하면 무선·모바일 환경 방문자의 초기 TTFB와 LCP 지표를 20% 이상 단축할 수 있습니다.

핵심 SLA 지표: UFW Default Deny · Swap 4.0GB (Swappiness 10) · Fail2ban 1h Ban · Journald 500MB Cap · TCP BBR Active
production-config
Section 01 Core Snippet
# /etc/sysctl.d/99-makers-baseline.conf — 메모리 스왑 억제 및 Google BBR 네트워크 가속
vm.swappiness = 10
vm.vfs_cache_pressure = 50
net.core.default_qdisc = fq
net.ipv4.tcp_congestion_control = bbr
net.core.somaxconn = 65535
fs.file-max = 2097152
🐍
SECTION 02 · STEP 011 ~ 018 8개 실전 공정

섹션 2. 전역 Python 3 & AI 마이크로서비스 (011 ~ 018)

섹션 02 전체 가이드 열기 (011~018) →

🎯 핵심 영역: Python 3.12+, PEP 668 격리(pipx/venv), FastAPI + Uvicorn ASGI & 로컬 Ollama LLM 연동

📘 아키텍처 설계 및 공정 상세

Ubuntu 24.04/26.04부터 도입된 PEP 668(Externally Managed Environment) 정책은 시스템 Python 패키지와 사용자 pip 패키지의 충돌을 원천 방지합니다. 섹션 2에서는 OS 패키지 관리자를 훼손하지 않고 pipx와 전용 가상환경(/var/www/ai-service/venv)을 구축한 뒤, 비동기 ASGI 프레임워크인 FastAPI와 C-최적화 Uvicorn 워커를 배치하여 홈랩 내부의 Ollama 로컬 LLM(Gemma4 12B) 추론 서버 및 MariaDB와 비동기로 통신하는 AI 마이크로서비스(/py-api/)를 완성합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

동기(Synchronous) 방식의 WSGI 서버는 LLM 추론처럼 수 초~수십 초가 소요되는 I/O 대기 작업에서 워커 스레드가 즉시 고갈됩니다. FastAPI + Uvicorn(uvloop) + HTTPX 비동기 클라이언트를 결합하면 단일 워커에서도 수백 개의 동시 AI 요청과 헬스체크(/py-api/health)를 블로킹 없이 처리하며, systemd 유닛(Restart=always)을 통해 프로세스 비정상 종료 시 3초 이내에 자가 복구됩니다.

핵심 SLA 지표: Python 3.12+ venv · PEP 668 Compliant · FastAPI + Uvicorn uvloop · Ollama Async HTTPX · Systemd Auto-Heal
production-config
Section 02 Core Snippet
# /etc/systemd/system/py-service.service — 무중단 FastAPI AI 마이크로서비스 데몬
[Service]
User=www-data
WorkingDirectory=/var/www/ai-service
ExecStart=/var/www/ai-service/venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000 --workers 2
Restart=always
RestartSec=3
📦
SECTION 03 · STEP 019 ~ 028 10개 실전 공정

섹션 3. 전역 Node.js 24 + npm + nvm 환경 (019 ~ 028)

섹션 03 전체 가이드 열기 (019~028) →

🎯 핵심 영역: NVM v0.40+, Node.js 24 LTS, pnpm 하드링크 스토어, PM2 클러스터 & Vite/Tailwind 정적 번들링

📘 아키텍처 설계 및 공정 상세

모던 Jamstack 웹 프론트엔드(Astro, Vite, Tailwind CSS)와 Node.js 유틸리티를 안정적으로 구동하기 위해 NVM(Node Version Manager) 기반의 Node.js 24 LTS 런타임 환경을 구축합니다. 비대화형 쉘(cron, systemd, sudo)에서도 버전 불일치가 없도록 /usr/local/bin 전역 심볼릭 링크를 고정하고, 디스크 용량을 절약하는 pnpm 패키지 매니저와 PM2 무중단 클러스터 매니저, 그리고 런타임 스크립트 오버헤드(TBT)가 전혀 없는 정적 Tailwind CSS 번들링 파이프라인을 완성합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

브라우저에서 PlayCDN(cdn.tailwindcss.com)을 실시간 실행하면 수십 밀리초의 메인 스레드 블로킹(TBT)과 스타일 깜빡임(FOUC/CLS)이 발생하여 Lighthouse 점수가 하락합니다. 빌드 타임에 Vite와 Tailwind CLI로 사용된 유틸리티 클래스만 추출·압축(Minify)하여 인라인 또는 불변 정적 CSS로 서빙하면 TBT=0ms와 즉각적인 첫 화면 렌더링(FCP)을 달성할 수 있습니다.

핵심 SLA 지표: Node.js 24 LTS · Global Symlinks · pnpm Content-Addressable Store · PM2 Systemd Startup · Zero-TBT CSS Bundle
production-config
Section 03 Core Snippet
# 비대화형 Cron/Systemd 호환을 위한 Node.js 24 전역 심볼릭 링크 및 PM2 부팅 자동화
NODE_BIN="$(dirname $(which node))"
sudo ln -sf "$NODE_BIN/node" /usr/local/bin/node
sudo ln -sf "$NODE_BIN/npm"  /usr/local/bin/npm
pm2 startup systemd -u $USER --hp $HOME && pm2 save
🗄️
SECTION 04 · STEP 029 ~ 038 10개 실전 공정

섹션 4. Docker Engine & 컨테이너 가상화 (029 ~ 038)

섹션 04 전체 가이드 열기 (029~038) →

🎯 핵심 영역: Docker CE & Compose v2, 비-루트 보안 그룹, 영구 볼륨 마운트, 커스텀 브리지 DNS & 로그 로테이션

📘 아키텍처 설계 및 공정 상세

호스트 운영체제를 오염시키지 않고 Headless WordPress, Redis 캐시, 보조 웹 도구들을 독립된 환경에서 구동하기 위해 Docker 공식 GPG 저장소에서 Docker CE와 Compose v2 플러그인을 설치합니다. 컨테이너 재배포 시에도 업로드 미디어와 DB 데이터가 유실되지 않도록 영구 볼륨(Named Volumes & Bind Mounts)을 설계하고, 루프백(127.0.0.1) 포트 바인딩, 격리 브리지 네트워크 내장 DNS, 그리고 json-file 로그 로테이션(20MB×3개)을 적용합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

Docker의 기본 포트 매핑(-p 8080:80)은 iptables의 DOCKER 체인을 직접 조작하여 UFW 방화벽 규칙을 우회하고 내부 컨테이너 포트를 외부 인터넷에 그대로 노출하는 치명적 보안 허점을 만듭니다. 반드시 127.0.0.1:8088:80 형태로 로컬 루프백 인터페이스에만 바인딩하고 앞단 NGINX 리버스 프록시를 통해서만 외부 트래픽을 수용해야 합니다.

핵심 SLA 지표: Docker CE + Compose v2 · 127.0.0.1 Loopback Port Binding · Isolated Bridge DNS · JSON Log Rotate (20m×3)
⚡
SECTION 05 · STEP 039 ~ 048 10개 실전 공정

섹션 5. MariaDB 최적화 & 보안 구성 (039 ~ 048)

섹션 05 전체 가이드 열기 (039~048) →

🎯 핵심 영역: MariaDB 10.11+ LTS 보안 초기화, utf8mb4_unicode_520_ci, InnoDB 1GB 튜닝 & 일일 무중단 백업

📘 아키텍처 설계 및 공정 상세

콘텐츠 메타데이터와 트랜잭션을 담당하는 MariaDB 서버를 프로덕션 규격으로 구축합니다. 익명 계정 및 원격 root 접속을 제거하는 보안 초기화를 거친 후, 한글과 4바이트 이모지를 완벽히 지원하는 utf8mb4_unicode_520_ci 캐릭터셋 DB와 최소 권한 전용 계정을 생성합니다. 이어서 디스크 I/O를 최소화하는 InnoDB Buffer Pool(1GB) 메모리 튜닝, Slow Query Log(1.0초 기준), 127.0.0.1 루프백 바인딩 및 매일 새벽 --single-transaction 기반 Gzip 자동 백업 크론을 완성합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

기본 MariaDB 설정은 InnoDB 버퍼 풀이 128MB에 불과하여 포스트와 메타데이터가 늘어날수록 빈번한 디스크 랜덤 읽기가 발생합니다. innodb_buffer_pool_size=1G 및 innodb_flush_log_at_trx_commit=2 튜닝을 적용하면 읽기 작업의 99.8% 이상이 RAM에서 즉시 처리되어 GraphQL 쿼리 응답 속도가 비약적으로 향상됩니다.

핵심 SLA 지표: MariaDB 10.11+ LTS · utf8mb4_unicode_520_ci · InnoDB Pool 1GB · Slow Query Log · Daily Single-Transaction Backup
production-config
Section 05 Core Snippet
# /etc/mysql/mariadb.conf.d/60-makers-innodb.cnf — 프로덕션 InnoDB 메모리 및 I/O 최적화
[mysqld]
bind-address = 127.0.0.1
innodb_buffer_pool_size = 1G
innodb_log_file_size = 256M
innodb_flush_log_at_trx_commit = 2
innodb_flush_method = O_DIRECT
🐘
SECTION 06 · STEP 049 ~ 058 10개 실전 공정

섹션 6. 전역 PHP 8.5 & 고성능 FPM (049 ~ 058)

섹션 06 전체 가이드 열기 (049~058) →

🎯 핵심 영역: Ondřej PPA, PHP 8.5 FPM, OPcache + Tracing JIT(1255), 동적 프로세스 풀 & WP-CLI 전역 자동화

📘 아키텍처 설계 및 공정 상세

워드프레스 코어와 GraphQL 스키마 리졸버의 실행 속도를 극대화하기 위해 최신 PHP 8.x/8.5 FPM 런타임과 필수 확장 모듈 12종(mysql, curl, gd, imagick, mbstring, xml, zip, intl, redis, opcache 등)을 구성합니다. 매 요청마다 PHP 스크립트를 파싱하는 오버헤드를 없애기 위해 OPcache(256MB)와 Tracing JIT(opcache.jit=1255) 컴파일러를 활성화하고, TCP 소켓 대신 커널 메모리에서 직접 교환되는 Unix 도메인 소켓(/run/php/php-fpm.sock) 및 WP-CLI 자동화 도구를 완비합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

PHP-FPM의 프로세스 풀(pm.max_children)을 서버 물리 메모리 계산 없이 방치하면 트래픽 스파이크 시 메모리 부족(OOM)이나 502 Bad Gateway 오류가 발생합니다. 워커당 평균 메모리 점유량(약 40~60MB)을 기준으로 pm.max_children=30, pm.max_requests=1000을 지정하면 메모리 누수를 자동 예방하며 안정적인 동시 처리량을 보장합니다.

핵심 SLA 지표: PHP 8.5 FPM · OPcache 256MB + Tracing JIT (1255) · Unix Domain Socket · Composer & WP-CLI Global
production-config
Section 06 Core Snippet
# /etc/php/8.x/fpm/conf.d/99-makers-opcache-jit.ini — OPcache 바이트코드 캐싱 및 JIT 가속
opcache.enable=1
opcache.memory_consumption=256
opcache.max_accelerated_files=20000
opcache.jit=1255
opcache.jit_buffer_size=128M
🌐
SECTION 07 · STEP 059 ~ 068 10개 실전 공정

섹션 7. Headless WordPress & GraphQL (059 ~ 068)

섹션 07 전체 가이드 열기 (059~068) →

🎯 핵심 영역: Headless WordPress 코어 무결성 검증, WPGraphQL 스키마, REST Cache & 프론트엔드 분리(Decoupled CMS)

📘 아키텍처 설계 및 공정 상세

워드프레스의 강력한 에디터와 미디어 관리 기능은 그대로 활용하면서, 무겁고 보안에 취약한 프론트엔드 테마 렌더링 계층을 완전히 분리하는 Headless(Decoupled) CMS 아키텍처를 구축합니다. WP-CLI로 한국어 코어를 다운로드하고 체크섬(verify-checksums)을 검증한 뒤, WPGraphQL과 WP REST Cache 플러그인을 활성화하여 Jamstack(Astro) 정적 빌더와 AI 출판 에이전트(publisher.py)가 표준화된 GraphQL/REST API로 콘텐츠를 주고받도록 구성합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

전통적인 모놀리식 워드프레스는 방문자가 글을 읽을 때마다 수십 개의 PHP 플러그인 훅과 SQL 쿼리를 실행합니다. 반면 Headless 아키텍처에서는 글이 작성·수정될 때만 Astro 정적 빌더가 동작하여 순수 HTML/CSS 파일을 생성하므로, 일반 방문자는 DB나 PHP를 전혀 거치지 않고 NGINX에서 1ms 만에 페이지를 응답받습니다.

핵심 SLA 지표: WP-CLI Core Checksum 100% · WPGraphQL Active · WP REST Cache · 301 Frontend Redirect · Direct Uploads Proxy
production-config
Section 07 Core Snippet
# WP-CLI를 이용한 무결성 검증 및 WPGraphQL / REST 캐시 플러그인 즉시 활성화
sudo -u www-data wp core verify-checksums --path=/var/www/headless-wp
sudo -u www-data wp plugin install wp-graphql wp-rest-cache --activate
sudo -u www-data wp rewrite structure '/%category%/%postname%/' --hard
📱
SECTION 08 · STEP 069 ~ 078 10개 실전 공정

섹션 8. SPA + Jamstack + PWA 구현 (069 ~ 078)

섹션 08 전체 가이드 열기 (069~078) →

🎯 핵심 영역: Vanilla JS 라우터 & 반응형 스토어, PWA manifest.json, Service Worker(sw.js) & 7색 레인보우 테마

📘 아키텍처 설계 및 공정 상세

무거운 외부 프론트엔드 프레임워크 런타임 없이 순수 표준 JavaScript(Vanilla JS)만으로 동작하는 초경량 SPA 라우터와 반응형 상태 스토어를 구현합니다. 모바일 및 데스크톱 홈 화면에 네이티브 앱처럼 설치할 수 있는 PWA 규격(manifest.json)과 Stale-While-Revalidate / Cache-First 전략의 Service Worker(sw.js), 내장 문서 폴백 캐시(default-docs.js), 그리고 레이아웃 밀림(CLS=0) 없는 7색 레인보우 컬러 & 다크/라이트 테마 스위처를 완성합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

외부 CDN 장애나 일시적인 모바일 네트워크 단절 상황에서도 사용자가 문서를 끊김 없이 탐색할 수 있도록 설계하는 것이 Offline-First 엔지니어링의 핵심입니다. AI200 허브는 Service Worker 캐시와 101개 전체 문서 내장 번들(default-docs.js)을 이중화하여 Zero-404 무결성을 보장합니다.

핵심 SLA 지표: Zero-Framework Vanilla JS SPA · PWA Manifest & Install Prompt · Service Worker Offline Cache · 7-Color Rainbow UI
production-config
Section 08 Core Snippet
// Stale-While-Revalidate 전략으로 오프라인 가용성과 최신성을 동시에 확보하는 Service Worker 패턴
self.addEventListener('fetch', (event) => {
  if (event.request.method !== 'GET') return;
  event.respondWith(
    caches.match(event.request).then((cached) => cached || fetch(event.request))
  );
});
🚦
SECTION 09 · STEP 079 ~ 088 10개 실전 공정

섹션 9. NGINX 메인 웹서버 라우팅 (079 ~ 088)

섹션 09 전체 가이드 열기 (079~088) →

🎯 핵심 영역: NGINX epoll/Gzip 튜닝, 다중 경로 라우팅(/, /ai200/, /blog/, /py-api/), Real-IP 복원 & 1년 불변 캐싱

📘 아키텍처 설계 및 공정 상세

단일 공인 진입점(Single Entrypoint) 역할을 수행하는 NGINX 메인 웹서버를 정밀하게 구성합니다. epoll 이벤트 구동 모델과 Gzip 레벨 6 압축을 활성화하고, 루트 도메인(/)은 본 AI200 메인 랜딩페이지로, /ai200/은 101 마스터 가이드 SPA 허브로, /blog/는 Astro 정적 기술 블로그로, /wp-content/uploads/는 Headless WP 미디어 서버로, /py-api/는 FastAPI 마이크로서비스로 충돌 없이 분기 라우팅합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

정적 이미지(WebP), 스타일시트, 스크립트 및 마크다운 문서에 Cache-Control: public, max-age=31536000, immutable 헤더를 부여하면 재방문 브라우저가 네트워크 요청조차 보내지 않고 디스크 캐시에서 0ms 만에 자산을 로드합니다. 반면 서비스 워커(sw.js)에는 no-cache 헤더를 지정하여 신규 버전 배포 시 즉시 업데이트가 반영되도록 정교하게 분리합니다.

핵심 SLA 지표: NGINX epoll + Gzip Lv6 · Multi-App Location Routing · X-Real-IP Restoration · 1-Year Immutable Asset Cache
production-config
Section 09 Core Snippet
# /etc/nginx/sites-available/default — 멀티 서비스 무중단 분기 라우팅 핵심 구조
location ^~ /blog/  { alias /var/www/html/jamstack/dist/; try_files $uri $uri/ /blog/index.html; }
location ^~ /ai200  { root /var/www/html; index index.html; try_files $uri $uri/ /ai200/index.html; }
location ^~ /py-api/ { proxy_pass http://127.0.0.1:8000/py-api/; }
🔒
SECTION 10 · STEP 089 ~ 095 7개 실전 공정

섹션 10. SSL/TLS 보안 인증서 및 HTTPS 최적화 (089 ~ 095)

섹션 10 전체 가이드 열기 (089~095) →

🎯 핵심 영역: Let's Encrypt Certbot 자동 갱신, TLS 1.3 암호화, HTTP/2 멀티플렉싱 & OWASP 웹 보안 헤더

📘 아키텍처 설계 및 공정 상세

Let's Encrypt Certbot과 systemd 타이머를 연동하여 SSL/TLS 인증서의 발급과 90일 주기 무중단 자동 갱신 체계를 구축합니다. 취약한 구버전 프로토콜을 배제하고 최신 TLS 1.2/1.3 암호화 스위트와 HTTP/2 다중 스트림(Multiplexing) 전송을 활성화하며, HSTS(Strict-Transport-Security), X-Content-Type-Options(nosniff), X-Frame-Options(SAMEORIGIN), Referrer-Policy 등 OWASP 권장 보안 헤더를 전면 적용합니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

HTTPS 암호화와 웹 보안 헤더는 단순한 데이터 도청 방지를 넘어 Google 검색 엔진 랭킹 시그널, 브라우저 PWA(Service Worker) 작동 필수 요건, 그리고 Google AdSense 광고 스크립트의 안전한 로드를 위한 핵심 전제 조건입니다.

핵심 SLA 지표: Let's Encrypt Auto-Renew · TLS 1.3 1-RTT/0-RTT · HTTP/2 Multiplexing · HSTS Preload & OWASP Headers
production-config
Section 10 Core Snippet
# OWASP 표준 보안 헤더 및 HSTS 2년 강제 적용 설정
add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
🎯
SECTION 11 · STEP 096 ~ 101 6개 실전 공정

섹션 11. 최종 검증 & 복구 모니터링 (096 ~ 101)

섹션 11 전체 가이드 열기 (096~101) →

🎯 핵심 영역: DNS/포트포워딩 검증, Lighthouse Core Web Vitals 99+, 콜드 리부트 자가 치유 & CI/CD 런칭 감사

📘 아키텍처 설계 및 공정 상세

101단계 대장정의 마지막 섹션에서는 프로덕션 런칭 전 수행해야 할 SRE(Site Reliability Engineering) 종합 검증을 다룹니다. 공인 DNS A 레코드와 라우터 포트포워딩 점검, Lighthouse 성능·접근성·모범사례·SEO 99+ 달성 검증, 전원 차단 후 재부팅(Cold Reboot) 시 모든 데몬(NGINX, MariaDB, Docker, FastAPI, Fail2ban, Cron)이 사람의 개입 없이 100% 자동 복구되는지 확인하는 시뮬레이션, 그리고 Astro 자동 재빌드 파이프라인 및 makers-101-audit 최종 런칭 선언으로 마무리됩니다.

💡 실무 엔지니어링 핵심 포인트 (Why It Matters)

진정한 프로덕션 인프라는 '관리자가 터미널에 로그인해 있을 때만 돌아가는 서버'가 아니라, 정전이나 커널 재부팅 이후에도 systemd 의존성 그래프와 상태 감시 크론에 의해 스스로 모든 서비스를 정상 궤도에 올리는 자가 치유(Self-Healing) 시스템이어야 합니다.

핵심 SLA 지표: Lighthouse Performance 99+ · CLS = 0.00 · Cold Reboot Self-Healing 100% · Cron Astro Auto-Rebuild · 101/101 PASS
production-config
Section 11 Core Snippet
# 콜드 리부트 이후 전 계층 핵심 데몬 자동 기동(enabled & active) 감사 원라이너
for svc in ufw fail2ban mariadb docker nginx cron; do
  printf "%-12s : enabled=%-8s active=%s\n" "$svc" "$(systemctl is-enabled $svc)" "$(systemctl is-active $svc)"
done
PRODUCTION BENCHMARKS & TROUBLESHOOTING

실전 홈랩 운영에서 해결한 4대 병목 현상 & 성능 개선 사례

실측 환경: Proxmox VE 12-Node · Ubuntu 26.04 LTS
CASE STUDY 01 · 백엔드 가속 응답시간 142ms → 31ms (-78%)

PHP 8.5 Tracing JIT + Unix 도메인 소켓 + WPGraphQL 캐시 최적화

문제 상황: Astro 정적 빌더가 170개 이상의 포스트 데이터를 WPGraphQL로 한 번에 페칭할 때, 기본 TCP 루프백(127.0.0.1:9000)과 OPcache 미설정 상태에서는 스키마 리졸빙에 평균 142ms가 소요되며 CPU 사용률이 급증했습니다.

해결 방안 (052~054, 064~065단계): PHP 8.5의 opcache.jit=1255(Tracing JIT)와 256MB 바이트코드 버퍼를 활성화하고, NGINX와 PHP-FPM 구간을 커널 메모리 기반 Unix 소켓(/run/php/php8.5-fpm.sock)으로 전환한 뒤 WP REST/GraphQL 캐시를 적용하여 평균 응답 시간을 31ms로 단축했습니다.

CASE STUDY 02 · 메모리 & DB 안정화 OOM 크래시 0건 / 버퍼 적중률 99.8%

Swappiness 10 커널 튜닝과 MariaDB InnoDB Buffer Pool 1GB 고정

문제 상황: 새벽 시간대 DB 백업과 Node.js 정적 빌드, AI 에이전트 작업이 겹칠 때 리눅스 기본 vm.swappiness=60 정책으로 인해 MariaDB 메모리가 디스크 스왑으로 밀려나면서 I/O Wait가 40%를 넘고 간헐적 커넥션 타임아웃이 발생했습니다.

해결 방안 (003, 043~044단계): 4GB 전용 /swapfile을 확보하되 vm.swappiness=10으로 억제하여 물리 RAM을 최우선 사용하게 강제하고, innodb_buffer_pool_size=1G 및 O_DIRECT 플러시 방식을 적용해 디스크 이중 캐싱을 제거함으로써 6개월 무중단 가동을 달성했습니다.

CASE STUDY 03 · 로컬 AI 추론 게이트웨이 워커 블로킹 0건 / 자동 복구 3초

로컬 Ollama LLM 콜드 스타트 지연 방어를 위한 FastAPI 비동기 파이프라인

문제 상황: 로컬 GPU/NPU 노드의 Ollama 모델(gemma4-12b:iq3)이 VRAM에서 언로드된 직후 첫 추론 요청이 들어오면 모델 로딩에 8~15초가 소요되어 일반 동기식 웹 서버 워커가 멈추는 현상이 발생했습니다.

해결 방안 (014~018, 085단계): FastAPI와 httpx.AsyncClient(timeout=120.0) 비동기 코루틴으로 추론 요청을 분리하고, NGINX의 /py-api/ 프록시에서 proxy_read_timeout 120s를 부여하여 장시간 추론 중에도 헬스체크(/py-api/health)와 타 API 요청이 지연 없이 즉시 응답되도록 격리했습니다.

CASE STUDY 04 · 웹 바이탈 & 오프라인 복원력 LCP 0.8s · CLS 0.00 · Zero-404

Pre-rendered 정적 콘텐츠 + 내장 폴백 캐시(default-docs.js) 이중화

문제 상황: 순수 클라이언트 사이드 SPA 문서 뷰어는 초기 HTML이 비어 있어 검색 엔진 및 애드센스 크롤러가 본문을 인식하지 못하고, 오프라인 상태에서 개별 마크다운(.md) 페칭이 실패하는 한계가 있었습니다.

해결 방안 (069~078, 086단계): 초기 HTML 내부에 풍부한 정적 아키텍처 본문과 101단계 전체 색인을 사전 렌더링(Pre-render)하고, 107개 전체 마크다운 전문을 내장 캐시 및 Service Worker와 동기화하여 크롤러 가시성 100%와 오프라인 무결성을 동시에 확보했습니다.

COMPLETE 101-STEP CURRICULUM DIRECTORY

AI200 101단계 전체 공정 탐색기 (001 ~ 101)

STEP 001 UFW

001. Ubuntu 26.04 패키지 최신화 및 UFW 방화벽

🛡️ 섹션 01 가이드 열람 →
STEP 002 Build Tools

002. 필수 컴파일 빌드 도구 & 시간대(KST) 동기화

🛡️ 섹션 01 가이드 열람 →
STEP 003 Swap

003. 4GB 가상 메모리(Swap) 영구 구성

🛡️ 섹션 01 가이드 열람 →
STEP 004 Security

004. SSH 포트 및 root 원격 로그인 보안 강화

🛡️ 섹션 01 가이드 열람 →
STEP 005 Fail2ban

005. Fail2ban 설치 및 무차별 대입 공격 차단

🛡️ 섹션 01 가이드 열람 →
STEP 006 Systemd

006. 시스템 로깅 데몬 journald 용량 제한

🛡️ 섹션 01 가이드 열람 →
STEP 007 DNS

007. 호스트네임 및 홈랩 로컬 DNS(/etc/hosts) 지정

🛡️ 섹션 01 가이드 열람 →
STEP 008 Auto-Update

008. 자동 보안 업데이트(unattended-upgrades) 설정

🛡️ 섹션 01 가이드 열람 →
STEP 009 Sysctl

009. 커널 파라미터 sysctl 네트워크 성능 최적화

🛡️ 섹션 01 가이드 열람 →
STEP 010 Audit

010. 시스템 헬스체크 및 베이스라인 감사 완료

🛡️ 섹션 01 가이드 열람 →
STEP 011 Python3

011. 전역 Python 3.12+ 및 dev 컴파일 헤더 설치

🐍 섹션 02 가이드 열람 →
STEP 012 pipx

012. PEP 668 표준 준수 전역 CLI pipx 환경 구축

🐍 섹션 02 가이드 열람 →
STEP 013 venv

013. AI 서비스 전용 디렉토리 및 venv 가상환경 생성

🐍 섹션 02 가이드 열람 →
STEP 014 FastAPI

014. FastAPI 및 고성능 Uvicorn 엔진 설치

🐍 섹션 02 가이드 열람 →
STEP 015 PyMySQL

015. MariaDB & 비동기 네트워크 라이브러리 연동

🐍 섹션 02 가이드 열람 →
STEP 016 AI/LLM

016. 로컬 Ollama LLM API 연동 파이프라인 작성

🐍 섹션 02 가이드 열람 →
STEP 017 HealthCheck

017. FastAPI 헬스체크 엔드포인트(/py-api/health) 구성

🐍 섹션 02 가이드 열람 →
STEP 018 Systemd

018. Systemd 무중단 서비스(py-service) 데몬 등록

🐍 섹션 02 가이드 열람 →
STEP 019 NVM

019. NVM(Node Version Manager) 최신 v0.40+ 설치

📦 섹션 03 가이드 열람 →
STEP 020 Node24

020. Node.js 24 LTS 전역 설치 및 기본 버전 alias

📦 섹션 03 가이드 열람 →
STEP 021 Global Symlink

021. /usr/local/bin 전역 실행 심볼릭 링크 등록

📦 섹션 03 가이드 열람 →
STEP 022 pnpm

022. 고속 패키지 매니저 pnpm & yarn 전역 설치

📦 섹션 03 가이드 열람 →
STEP 023 PM2

023. Node 무중단 프로세스 관리자 PM2 전역 구성

📦 섹션 03 가이드 열람 →
STEP 024 Startup

024. PM2 systemd 부팅 자동 시작 스크립트 활성화

📦 섹션 03 가이드 열람 →
STEP 025 Vite

025. Vite 기반 Jamstack SPA 빌드 파이프라인 구성

📦 섹션 03 가이드 열람 →
STEP 026 Tailwind

026. Tailwind CSS 컴파일러 및 자동 정적 번들링

📦 섹션 03 가이드 열람 →
STEP 027 Directory

027. 프론트엔드 작업 디렉토리 권한 및 환경변수 설정

📦 섹션 03 가이드 열람 →
STEP 028 Benchmark

028. Node.js 24 런타임 벤치마크 및 무결성 검증

📦 섹션 03 가이드 열람 →
STEP 029 Docker

029. 기존 충돌 패키지 정리 및 Docker GPG 키 등록

🗄️ 섹션 04 가이드 열람 →
STEP 030 Docker CE

030. Docker CE & Compose Plugin 공식 설치

🗄️ 섹션 04 가이드 열람 →
STEP 031 User Group

031. 비-루트(Non-root) 사용자 docker 그룹 바인딩

🗄️ 섹션 04 가이드 열람 →
STEP 032 Volumes

032. Docker 영구 볼륨 및 바인드 마운트 생성

🗄️ 섹션 04 가이드 열람 →
STEP 033 Compose

033. Docker Compose 기반 멀티 컨테이너 서비스 기동

🗄️ 섹션 04 가이드 열람 →
STEP 034 Firewall

034. 컨테이너 포트 바인딩 및 방화벽 접근 제어

🗄️ 섹션 04 가이드 열람 →
STEP 035 Network

035. Docker 브리지 네트워크 및 DNS 격리 정책

🗄️ 섹션 04 가이드 열람 →
STEP 036 Log Rotate

036. Docker 로그 자동 로테이션(json-file) 설정

🗄️ 섹션 04 가이드 열람 →
STEP 037 Monitoring

037. Docker CLI 및 컨테이너 상태 모니터링 체계 구축

🗄️ 섹션 04 가이드 열람 →
STEP 038 Auto-Restart

038. 컨테이너 자동 재시작(restart: always) 점검

🗄️ 섹션 04 가이드 열람 →
STEP 039 MariaDB

039. MariaDB Server & Client 설치 및 서비스 가동

⚡ 섹션 05 가이드 열람 →
STEP 040 Security

040. mariadb-secure-installation 보안 초기화 실행

⚡ 섹션 05 가이드 열람 →
STEP 041 Database

041. Headless WP 전용 DB(utf8mb4) 생성

⚡ 섹션 05 가이드 열람 →
STEP 042 User Grant

042. 전용 사용자 생성 및 최소 권한(GRANT) 부여

⚡ 섹션 05 가이드 열람 →
STEP 043 InnoDB Tuning

043. InnoDB Buffer Pool 1GB 메모리 튜닝

⚡ 섹션 05 가이드 열람 →
STEP 044 Connection

044. 최대 동시 접속자(max_connections) 최적화

⚡ 섹션 05 가이드 열람 →
STEP 045 Slow Query

045. 슬로우 쿼리 로그(Slow Query Log) 활성화

⚡ 섹션 05 가이드 열람 →
STEP 046 Binding

046. 외부 노출 방지(bind-address 127.0.0.1) 고정

⚡ 섹션 05 가이드 열람 →
STEP 047 Backup

047. 자동 일일 백업 스크립트 및 cron 등록

⚡ 섹션 05 가이드 열람 →
STEP 048 Verification

048. MariaDB 트랜잭션 및 인덱스 성능 검증

⚡ 섹션 05 가이드 열람 →
STEP 049 PPA

049. ppa:ondrej/php PPA 리포지토리 등록

🐘 섹션 06 가이드 열람 →
STEP 050 PHP 8.5

050. PHP 8.5 코어 및 WP 필수 모듈 12종 설치

🐘 섹션 06 가이드 열람 →
STEP 051 php.ini

051. php.ini 업로드 용량(128M) 및 타임아웃 조정

🐘 섹션 06 가이드 열람 →
STEP 052 OPcache

052. OPcache 활성화 및 JIT 컴파일러 가속

🐘 섹션 06 가이드 열람 →
STEP 053 PHP-FPM

053. PHP-FPM 풀(www.conf) 동적 프로세스 최적화

🐘 섹션 06 가이드 열람 →
STEP 054 Sock

054. Unix 소켓(/run/php/php8.5-fpm.sock) 권한 부여

🐘 섹션 06 가이드 열람 →
STEP 055 Composer

055. 전역 Composer 최신 버전 설치

🐘 섹션 06 가이드 열람 →
STEP 056 WP-CLI

056. WP-CLI 전역 설치 (/usr/local/bin/wp)

🐘 섹션 06 가이드 열람 →
STEP 057 Memory

057. PHP CLI 메모리 한도 무제한 셋팅

🐘 섹션 06 가이드 열람 →
STEP 058 Benchmark

058. PHP-FPM 벤치마크 및 로드 테스트

🐘 섹션 06 가이드 열람 →
STEP 059 WP Dir

059. 웹 루트(/var/www/headless-wp) 및 권한 설정

🌐 섹션 07 가이드 열람 →
STEP 060 Core Download

060. WP-CLI 이용 한국어 워드프레스 코어 다운로드

🌐 섹션 07 가이드 열람 →
STEP 061 wp-config

061. wp-config.php 자동 생성 및 DB 바인딩

🌐 섹션 07 가이드 열람 →
STEP 062 Install

062. 헤드리스 모드 워드프레스 자동 인스톨

🌐 섹션 07 가이드 열람 →
STEP 063 Permalink

063. 고유주소(Permalink) REST 표준 재작성

🌐 섹션 07 가이드 열람 →
STEP 064 WPGraphQL

064. WPGraphQL 플러그인 설치 및 스키마 활성화

🌐 섹션 07 가이드 열람 →
STEP 065 REST Cache

065. WP REST Cache 플러그인 캐싱 가속

🌐 섹션 07 가이드 열람 →
STEP 066 Headless

066. 프론트엔드 테마 비활성화 및 리다이렉트

🌐 섹션 07 가이드 열람 →
STEP 067 Uploads

067. 미디어 업로드 디렉토리 NGINX 권한 부여

🌐 섹션 07 가이드 열람 →
STEP 068 Verification

068. GraphQL 엔드포인트 쿼리 정상 작동 검증

🌐 섹션 07 가이드 열람 →
STEP 069 Vanilla Core

069. Vanilla JS Router & Reactive Store 코어 구성

📱 섹션 08 가이드 열람 →
STEP 070 Manifest

070. PWA manifest.json 및 아이콘 규격 생성

📱 섹션 08 가이드 열람 →
STEP 071 ServiceWorker

071. Service Worker(sw.js) Cache-First 오프라인 구현

📱 섹션 08 가이드 열람 →
STEP 072 PWA Install

072. beforeinstallprompt PWA 설치 버튼 핸들러

📱 섹션 08 가이드 열람 →
STEP 073 GraphQL Fetch

073. WPGraphQL 클라이언트 페칭 모듈 작성

📱 섹션 08 가이드 열람 →
STEP 074 FastAPI Connect

074. FastAPI 비동기 호출 및 반응형 렌더링

📱 섹션 08 가이드 열람 →
STEP 075 Theme

075. 반응형 다크/라이트 테마 토글 스위처

📱 섹션 08 가이드 열람 →
STEP 076 Cache Hash

076. 정적 자산 브라우저 캐싱 해시 정책

📱 섹션 08 가이드 열람 →
STEP 077 Offline

077. 오프라인 폴백(Fallback) 화면 구성

📱 섹션 08 가이드 열람 →
STEP 078 Lighthouse

078. Lighthouse PWA 검사 및 PWA 뱃지 획득

📱 섹션 08 가이드 열람 →
STEP 079 Gzip

079. NGINX 코어 최적화 및 Gzip 압축 활성화

🚦 섹션 09 가이드 열람 →
STEP 080 Vhost

080. makerskorean.conf 가상호스트 작성

🚦 섹션 09 가이드 열람 →
STEP 081 Real IP

081. NGINX 클라이언트 real_ip 헤더 복원 설정

🚦 섹션 09 가이드 열람 →
STEP 082 try_files

082. SPA History API 지원 try_files 라우팅

🚦 섹션 09 가이드 열람 →
STEP 083 PWA Header

083. PWA sw.js no-cache 강제 헤더 지정

🚦 섹션 09 가이드 열람 →
STEP 084 FastCGI

084. Headless WP FastCGI 소켓 프록시 라우팅

🚦 섹션 09 가이드 열람 →
STEP 085 Python Proxy

085. Python FastAPI (/py-api/) 리버스 프록시

🚦 섹션 09 가이드 열람 →
STEP 086 Static Cache

086. 정적 이미지 WebP/Avif 캐시 만료 정책

🚦 섹션 09 가이드 열람 →
STEP 087 Reload

087. NGINX 설정 문법 검사(nginx -t) 및 리로드

🚦 섹션 09 가이드 열람 →
STEP 088 Verification

088. 내부 HTTP 80번 포트 루프백 응답 검증

🚦 섹션 09 가이드 열람 →
STEP 089 Certbot

089. Let's Encrypt Certbot SSL 자동 갱신 구성

🔒 섹션 10 가이드 열람 →
STEP 090 SSL/TLS

090. SSL 인증서 발급 및 TLS 1.3 암호화 적용

🔒 섹션 10 가이드 열람 →
STEP 091 HTTP/2

091. HTTP/2 및 Gzip/Brotli 압축 전송 최적화

🔒 섹션 10 가이드 열람 →
STEP 092 Reverse Proxy

092. NGINX HTTPS 443 포트 리버스 프록시 연동

🔒 섹션 10 가이드 열람 →
STEP 093 HSTS

093. 보안 헤더(HSTS, nosniff, SAMEORIGIN) 추가

🔒 섹션 10 가이드 열람 →
STEP 094 Reload

094. SSL 인증서 체인 무결성 검증 및 NGINX 리로드

🔒 섹션 10 가이드 열람 →
STEP 095 Verification

095. 외부 HTTPS 접속 및 인증서 체인 검증

🔒 섹션 10 가이드 열람 →
STEP 096 DNS/Port

096. 도메인 DNS A 레코드 및 포트포워딩 검증

🎯 섹션 11 가이드 열람 →
STEP 097 Lighthouse 99

097. Lighthouse 종합 성능 99점 점검

🎯 섹션 11 가이드 열람 →
STEP 098 Reboot Test

098. 서버 재부팅 시뮬레이션 및 전 서비스 자동 기동

🎯 섹션 11 가이드 열람 →
STEP 099 Monitoring

099. 시스템 리소스 및 서비스 모니터링 체계 구축

🎯 섹션 11 가이드 열람 →
STEP 100 CI/CD

100. GitHub Webhook 기반 Jamstack 자동 배포

🎯 섹션 11 가이드 열람 →
STEP 101 Launch 🚀

101. 101단계 완성 선언 및 Makers Korean 런칭

🎯 섹션 11 가이드 열람 →
ASTRO JAMSTACK TECH BLOG

📝 makerskorean.kr 기술 블로그 아카이브 (170+ 실전 포스트)

AI200 101 마스터 가이드 외에도, 실제 12대 Proxmox 홈랩 운영 기록, 멀티에이전트 시스템 설계, Vanilla JS 심화 기법, 웹 표준 및 리눅스 트러블슈팅을 다룬 170여 편의 심층 기술 아티클을 카테고리별로 열람하실 수 있습니다.

기술 블로그 전체 글 보러가기 (/blog/) →
12-NODE HOMELAB & MULTI-AGENT MAP

🖥️ 12대 Proxmox 클러스터 & 12인 AI 에이전트 토폴로지

단일 서버를 넘어 12대의 물리/가상 Proxmox VE 노드와 ZFS/Ceph 스토리지, Obsidian 세컨드 브레인 볼트, 그리고 12명의 역할 기반 AI 에이전트가 어떻게 협업하여 OSMU 콘텐츠 파이프라인을 가동하는지 인터랙티브 아키텍처 맵에서 확인하세요.

12노드 인프라 아키텍처 맵 열기 (/kkokk.html) →
FREQUENTLY ASKED TECHNICAL QUESTIONS

자주 묻는 기술 질문 (FAQ) & 트러블슈팅 Q&A

Q1. AI200 101 마스터 가이드는 어떤 순서로 학습하고 적용해야 하나요?

반드시 섹션 1(001~010단계)의 Ubuntu 26.04 LTS 기본 보안 및 커널 베이스라인부터 순서대로 적용하시는 것을 권장합니다. 4GB Swap 메모리(swappiness=10), UFW 방화벽, 타임존 동기화, TCP BBR 설정이 먼저 완료되어야 상위 계층인 Python FastAPI(섹션 2), Node.js 24(섹션 3), Docker(섹션 4), MariaDB(섹션 5) 구축 시 포트 차단이나 메모리 부족 오류가 발생하지 않습니다.

Q2. 일반 워드프레스 대신 Headless WordPress + Jamstack 구조를 채택한 이유는?

전통적인 워드프레스는 방문자마다 PHP와 DB 쿼리를 매번 실행하여 트래픽 급증 시 응답 지연과 보안 플러그인 취약점에 노출됩니다. 워드프레스를 내부 루프백 포트(127.0.0.1:8088)에서 콘텐츠 편집 및 GraphQL API 엔진으로만 쓰고, 대외 방문자에게는 사전 빌드된 정적 HTML을 NGINX로 서빙하면 보안 위협을 원천 격리하면서 초기 로딩 속도를 10배 이상 높일 수 있습니다.

Q3. Ubuntu 26.04에서 pip install 시 PEP 668(externally-managed-environment) 오류가 납니다.

데비안/우분투 최신 버전은 APT 시스템 패키지와 Python pip 패키지의 충돌로 인한 OS 손상을 막기 위해 전역 pip install을 차단합니다. --break-system-packages를 쓰는 대신, 012단계(pipx)와 013단계(venv 가상환경) 가이드에 따라 서비스별 독립 가상환경을 만들어 운영하는 것이 표준 해법입니다.

Q4. 로컬 Ollama LLM 추론 서버와 웹 애플리케이션은 어떻게 안전하게 연결하나요?

Ollama 기본 포트(11434)를 공인 인터넷에 직접 노출하면 외부 봇에 의해 GPU 자원이 무단 점유됩니다. 016단계 및 085단계와 같이 Ollama는 내부 사설망에만 바인딩하고, NGINX 리버스 프록시 뒤의 FastAPI(/py-api/)가 요청 검증과 타임아웃 제어를 수행하도록 중계 계층을 두어야 합니다.

Q5. 101단계 문서를 인터넷이 없는 폐쇄망/오프라인 환경에서도 볼 수 있나요?

네, 가능합니다. AI200 문서 허브(/ai200/)는 PWA Service Worker(sw.js)와 전체 101개 문서 내장 캐시(default-docs.js)를 결합하여 최초 1회 접속 이후에는 네트워크가 단절된 데이터센터나 서버실에서도 모든 단계의 코드와 체크리스트를 열람하고 복사할 수 있습니다.

Q6. 문서의 코드나 스크립트를 사내 프로젝트에 상업적으로 활용해도 되나요?

본 사이트에 공개된 모든 쉘 스크립트, NGINX/MariaDB/PHP 설정 코드, Python 및 JavaScript 스니펫은 학습 및 실무 인프라 구축에 자유롭게 참조·수정하여 활용하실 수 있습니다. 아티클 본문 인용 시에는 CC BY 4.0 라이선스에 따라 출처(https://makerskorean.kr)를 표기해 주시면 됩니다.

OPERATOR & EDITORIAL TRANSPARENCY (E-E-A-T)

운영자 정보 및 콘텐츠 품질 보증 정책

makerskorean.kr은 운영자 꼬꼬마(kkokkmakn)가 직접 관리·집필하는 기술 플랫폼입니다. 모든 인프라 가이드는 실제 Ubuntu 26.04 LTS 및 Proxmox VE 테스트베드에서 검증된 후 게시되며, 독자 제보 및 보안 패치에 따라 상시 업데이트됩니다. 기술 문의, 오류 제보 또는 정책 관련 연락은 공식 이메일(koreawelcome@gmail.com) 또는 문의 페이지를 이용해 주시기 바랍니다.