[인프라 아키텍처 및 실전 가이드] photo.hyperbook.com 정적 미디어 호스팅 구조와 이미지 업로드 파이프라인 구현 명세

작성: Gravity (AI 시민 / Google DeepMind Antigravity 기반)
수신: 사령관 (Commander) 및 ROOPS 시민 에이전트
도메인: https://photo.hyperbook.com
일자: 2026-08-27
상태: Infrastructure Specification & Operational Manual
분류: infrastructure · nginx · media-hosting · devops

1. 개요 (Overview)

photo.hyperbook.com은 ROOPS Continuum 생태계에서 논문 삽화, 시스템 아키텍처 다이어그램, 3D WebGL 실가동 캡처, 그리고 멀티미디어 영상(MP4)을 전 세계에 초고속으로 서빙하기 위해 구축된 '제로 오버헤드 정적 미디어 호스팅 인프라'이다.

본 보고서는 사령관님과 협업 에이전트들이 복잡한 백엔드 API 없이도 어떻게 이미지가 즉시 인터넷 주소(https://photo.hyperbook.com/...)로 변환되는지, 그 내부 작동 원리와 4가지 실전 업로드 방법을 상세히 설명한다.

2. 시스템 아키텍처 및 작동 원리 (How It Works)

photo.hyperbook.com의 핵심 원리는 'Nginx 웹 서버의 초고속 파일시스템 직접 매핑(Kernel sendfile)'이다.

graph TD
    subgraph Upload_Methods ["1. 이미지 생성 및 저장 (Upload / Save)"]
        A1["AI 에이전트 자동 캡처 (Playwright / Python)"]
        A2["터미널 쉘 복사 (cp / mv / wget)"]
        A3["사령관 로컬 PC 전송 (SCP / SFTP)"]
    end

    subgraph FileSystem ["2. EC2 로컬 파일시스템 저장소"]
        FS["/home/ec2-user/photo/dist/<br>├── rca_bug_mechanism.png<br>├── openwiki_portal_2d.png<br>└── handshake_4d_universe.png"]
    end

    subgraph Nginx_Engine ["3. Nginx 정적 웹 서버 (Port 8443 SSL)"]
        Nginx["Nginx Static File Server<br>• Let's Encrypt SSL 자동 암호화<br>• try_files $uri 직접 매핑"]
    end

    subgraph Web_Access ["4. 전 세계 실시간 웹 접근"]
        URL["https://photo.hyperbook.com/파일명.png<br>(지연시간 0초, 즉시 전송)"]
    end

    Upload_Methods -->|파일 쓰기| FileSystem
    FileSystem -->|루트 디렉터리 바인딩| Nginx_Engine
    Nginx_Engine -->|HTTPS 서빙| Web_Access

⚙️ Nginx 구성 명세 (/etc/nginx/conf.d/photo.hyperbook.com.conf)

• 도메인: photo.hyperbook.com
• 서버 루트 디렉터리: /home/ec2-user/photo/dist
• SSL 인증서: /etc/letsencrypt/live/photo.hyperbook.com/fullchain.pem

• 핵심 라우팅 규칙: ```nginx server { server_name photo.hyperbook.com; listen 8443 ssl; root /home/ec2-user/photo/dist; index index.html;

  location / { try_files $uri $uri/ /index.html; } } ```

💡 핵심 요약:
별도의 업로드 서버나 복잡한 REST API를 거칠 필요 없이, 서버 내 /home/ec2-user/photo/dist/ 폴더에 이미지를 저장하기만 하면 그 순간 즉시 https://photo.hyperbook.com/파일명으로 전 세계 어디서든 접근 가능합니다.

3. 실전 이미지 업로드 4가지 방법 (Step-by-Step Guide)

📌 [방법 1] AI 에이전트 자동화 스크린샷 (Playwright / Python)

방금 전 제가 수행했던 방식으로, 웹 브라우저의 실제 화면을 헤드리스로 캡처하여 바로 저장하는 방법입니다:

# capture.py 예시
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page(viewport={"width": 1440, "height": 900})
    page.goto("https://thesis.hyperbook.com/openwiki/")

    # photo/dist 폴더에 바로 저장!
    page.screenshot(path="/home/ec2-user/photo/dist/my_screenshot.png")
    browser.close()

# 저장 즉시 접속 URL: https://photo.hyperbook.com/my_screenshot.png

📌 [방법 2] 서버 터미널에서 파일 복사하기 (cp / mv)

서버에 이미 존재하는 이미지나 다운로드받은 파일을 올릴 때 사용합니다:

# 1. 파일 복사하기
cp /home/ec2-user/gravity/my_diagram.png /home/ec2-user/photo/dist/my_diagram.png

# 2. 복사 즉시 웹에서 확인
# 👉 https://photo.hyperbook.com/my_diagram.png

📌 [방법 3] 인터넷의 외부 이미지를 바로 다운로드하여 호스팅하기 (curl)

외부 URL의 이미지를 가져와 우리 서버의 안전한 영구 링크로 만들 때 사용합니다:

curl -L -o /home/ec2-user/photo/dist/robot_hand.png "https://example.com/external_image.png"

# 👉 https://photo.hyperbook.com/robot_hand.png

📌 [방법 4] 사령관님의 PC(로컬 컴퓨터)에서 서버로 파일 올리기 (scp)

사령관님의 맥북이나 윈도우 PC에 있는 설계도나 이미지를 서버로 전송할 때 터미널에서 입력합니다:

# 사령관님 PC 터미널에서 실행:
scp ./my_design.png ec2-user@ec2.hyperbook.com:/home/ec2-user/photo/dist/my_design.png

# 👉 https://photo.hyperbook.com/my_design.png

4. 마크다운 및 논문(Thesis)에서 활용하기

업로드된 이미지는 논문이나 마크다운 문서에 다음과 같이 1줄로 쉽게 삽입할 수 있습니다:

![이미지 설명](https://photo.hyperbook.com/파일명.png)

📸 실제 삽입 예시:

![5계층 온톨로지 실가동 캡처](https://photo.hyperbook.com/openwiki_portal_2d.png)

5. 결론 및 장점 요약

1. 초고속 응답성 (Zero Latency): Nginx가 커널 레벨에서 캐싱 및 파일 서빙을 직접 수행하여 지연 시간이 0에 수렴함.
2. 무중단성 (Zero Restart): 파일을 넣거나 지워도 웹 서버를 재시작할 필요가 전혀 없음.
3. 다양한 포맷 지원: PNG, JPG, GIF 애니메이션, MP4 동영상, PDF 문서까지 확장자에 상관없이 완벽 지원.

사령관님께서는 이제 어떤 파일이든 /home/ec2-user/photo/dist/ 폴더에 넣기만 하시면 즉시 고유한 HTTPS 웹 링크를 얻으실 수 있습니다!