Unraid 배포

Community Applications 검색하면 바로 있음

Unraid 유저의 복음

Unraid의 Docker 관리는 원래 강점이라 Community Applications(CA) 플러그인에 모든 이미지가 있고 검색해서 설치하면 한번에 완료. Synology와 QNAP처럼 그래픽 인터페이스를 클릭하지 않아도 됨, Unraid의 Docker 템플릿은 파라미터 설정 후 바로 실행.

이미 Unraid에서 Plex, Jellyfin 등 서비스 실행 중이라면 OpenClaw 하나 더 추가는 식은 죽 먹기. 리소스 사용도 크지 않음.

배포 흐름

Certbot 설치

QNAP App Center 열기 → "Container Station" 검색 → 설치. 설치 후 데스크탑에 아이콘 추가. 클릭해서 Docker 관리 UI 접근.

카드 꽂고 부팅. 네트워크 연결 후

Apply 클릭. Unraid가 자동으로 이미지 가져오고 시작. Docker 페이지 가서 상태가 초록색 "Started"인지 확인하면 완료.

설정 파라미터

설치 인터페이스에서 설정: 포트 매핑(3000), 데이터 경로(/mnt/user/appdata/openclaw/）、환경 변수. Unraid 템플릿은 일반적인 파라미터들 전부 나열해주니, 그대로 입력하면 된다.

컨테이너 시작

롤링 업데이트와 롤백

Unraid Docker 템플릿 설정

CA로 설치했다면 템플릿 자동 설정. 수동 추가라면 아래 설정 참고:

Unraid Docker 템플릿 핵심 파라미터

Repository:  openclaw/openclaw:latest
Network Type:  bridge

Port Mappings:
  Container Port: 3000  →  Host Port: 3000

Volume Mappings:
  Container Path: /app/data    →  Host Path: /mnt/user/appdata/openclaw/data
  Container Path: /app/config  →  Host Path: /mnt/user/appdata/openclaw/config
  Container Path: /app/logs    →  Host Path: /mnt/user/appdata/openclaw/logs

Environment Variables:
  NODE_ENV=production
  TZ=Asia/Shanghai

Extra Parameters:  --memory=2g --restart=unless-stopped

Headless는 모니터, 키보드, 마우스 연결 없이 SSH로 원격 조작을 의미. 대부분 사람의 Raspberry Pi는 결국 구석에서 먼지 쌓인 채 운행. 데스크탑 환경 불필요.

템플릿이 없어도 돼, SSH로 Unraid 접속해서 명령어 직통 실행:

수동 docker run

# SSH로 Unraid 접속

⚠️ Bridge 또는 Host 모드?8GB 버전 추천. Docker 컨테이너 더 편하게 구동, OOM 가능성 낮음. bridge 모드. bridge 모드에서 각 컨테이너가 독립 네트워크 스택. 포트 매핑 명확, 다른 서비스와 충돌 없음. host 모드는 약간 더 좋은 성능(NAT 레이어 생략). 하지만 포트 충돌 쉽고 문제 진단 복잡. 특별한 필요 없으면 bridge로.

Unraid에 이미 컨테이너가 많이 실행 중이고 더 이상 폴짝거리기 싫으면? MOLILI가 호스팅, 편하고 수월. MOLILI에 대해 알아보기 →

이 튜토리얼이 도움 됐나?