UGREEN DXP4800PLUS NAS에 Docker 설치하기 (초기 설정부터 컨테이너 실행까지)

UGREEN DXP4800 Plus NAS를 사용하면서 가장 먼저 설치한 서비스는 Docker였다. 유튜브 쇼츠 자동화 시스템, PostgreSQL 데이터베이스, FastAPI 대시보드까지 모두 Docker 컨테이너 위에서 운영하고 있기 때문이다.

여러 NAS 제품을 비교했지만 DXP4800 Plus를 선택한 이유는 Intel Pentium Gold 8505 CPU와 Docker 공식 지원 때문이었다. 단순 파일 저장이 아니라 PostgreSQL, FastAPI, n8n 같은 서비스를 함께 운영할 계획이었기 때문이다. 실제로 몇 개월 동안 사용해보니 홈서버와 자동화 플랫폼 용도로 충분한 성능을 보여주고 있다.

처음에는 NAS 앱스토어에서 설치하면 끝날 줄 알았다. 실제로는 볼륨 마운트 경로와 컨테이너 네트워크 설정까지 신경 써야 했다. 이 글에서는 UGREEN DXP4800 Plus NAS에 Docker를 설치하고 첫 번째 컨테이너를 실행하기까지의 과정을 정리한다.

왜 NAS에 Docker를 설치하는가

Docker를 사용하면 애플리케이션을 컨테이너 단위로 격리해서 관리할 수 있다. 서비스마다 별도 서버를 두는 것처럼 운영할 수 있어 유지보수가 편하다.

현재 UGREEN DXP4800PLUS에서 Docker로 운영 중인 서비스:

  • PostgreSQL (데이터베이스)
  • FastAPI Dashboard (트렌드 대시보드)
  • n8n (워크플로우 자동화)
  • Video Factory (영상 자동 생성)
  • 기타 자동화 도구

NAS 자체 성능 Intel Pentium Gold 8505 (5코어 / 8GB DDR5)으로 이 서비스들을 동시에 안정적으로 운영하고 있다.

Docker 설치하기

1. App Center 실행

UGREEN NAS 관리자 페이지에 접속한 후 App Center를 실행한다.

[App Center 화면]

2. Docker 검색 및 설치

검색창에서 Docker를 검색한 후 설치를 진행한다.

설치가 완료되면 메인 화면에 Docker 관리 아이콘이 생성된다.

3. 공유 폴더 생성

컨테이너 데이터 저장용 폴더를 미리 만들어 두는 것을 권장한다.

/volume2/docker
/volume2/docker/postgres
/volume2/docker/fastapi
/volume2/docker/n8n


[공유 폴더 구조]

볼륨을 미리 분리해두면 나중에 컨테이너를 삭제해도 데이터가 보존된다.

첫 번째 컨테이너 실행

설치가 완료됐는지 확인하기 위해 테스트용 nginx 컨테이너를 실행해본다.

NAS에 SSH로 접속한 후 아래 명령어를 실행한다.

docker run -d \
  --name nginx-test \
  -p 8080:80 \
  nginx

브라우저에서 아래 주소로 접속한다.

http://NAS_IP:8080

nginx Welcome 페이지가 보이면 Docker가 정상적으로 설치된 것이다.

테스트 후 컨테이너를 삭제한다.

docker stop nginx-test
docker rm nginx-test

실제 운영 환경 구성

현재 운영 중인 컨테이너 구조는 다음과 같다.

UGREEN DXP4800PLUS
 ├─ shorts-postgres (PostgreSQL)
 ├─ shorts-api (FastAPI)
 ├─ n8n
 ├─ video-factory
 └─ bot-panel (모니터링)

처음에는 컨테이너를 하나씩 수동으로 실행했다. 서비스가 늘어나자 어떤 옵션으로 실행했는지 기억하기 어려워졌다. 결국 Docker Compose로 전환했고, 지금은 NAS를 재부팅해도 모든 서비스가 자동으로 복구된다.

[docker ps 실행 화면]

설치 후 확인할 사항

Docker 설치 후 반드시 확인해야 할 것들이 있다.

자동 재시작 설정

컨테이너 생성 시 --restart unless-stopped 옵션을 반드시 추가한다. NAS가 재부팅되어도 컨테이너가 자동으로 다시 시작된다.

docker run -d \
  --restart unless-stopped \
  --name my-service \
  my-image

Docker Compose에서는 이렇게 설정한다.

yaml
services:
  my-service:
    image: my-image
    restart: unless-stopped

리소스 모니터링

여러 컨테이너를 동시에 운영할 경우 메모리 사용량을 주기적으로 확인한다.

docker stats

현재 DXP4800PLUS에서 5개 이상의 서비스를 동시에 운영해도 메모리 여유가 있다.

마무리

UGREEN DXP4800PLUS NAS는 Docker 기반 홈서버 구축에 충분한 성능을 제공한다. 실제로 여러 자동화 서비스를 동시에 운영해도 안정적으로 동작하고 있다.

다음 글에서는 Docker Compose를 사용해 여러 컨테이너를 한 번에 관리하는 방법을 정리할 예정이다.

관련 글

댓글

댓글 쓰기

이 블로그의 인기 게시물

UGREEN DXP4800PLUS NAS로 유튜브 쇼츠 자동화 시스템 구축기 (Docker · FastAPI · PostgreSQL · Edge-TTS)

이미지
 집에 NAS가 있다면 유튜브 쇼츠 자동화 시스템을 직접 구축할 수 있다. 이 글은 UGREEN DXP4800PLUS NAS 위에서 실제로 운영 중인 쇼츠 자동화 파이프라인 구축 과정을 기록한 실전 후기다. 현재 운영 현황 (2026년 6월 기준) 수집 영상: 676개 저장 스냅샷: 38,134개 성장률 계산 성공률: 95.1% 트렌드 클러스터: 10종 (IT_DEVICE, AI/자동화, 연예/엔터 등) 자동 영상 생성: Video Factory v2 개발 중 단순 성공 사례가 아니다. FastAPI 404 오류, 분류기 정확도 문제, 영상 생성 실패까지 실제 겪은 삽질과 해결 과정을 함께 담았다. 전체 파이프라인 구조 YouTube API 수집 (30분마다) ↓ PostgreSQL 저장 ↓ 성장률 계산 ↓ content_cluster 분류 (10종) ↓ format_type 분류 (6종) ↓ 트렌드 대시보드 ↓ AI 대본 자동 생성 ↓ Edge-TTS 음성 생성 ↓ FFmpeg 영상 합성 ↓ drafts 폴더 저장 처음에는 간단한 스크립트 몇 개면 끝날 줄 알았다. 실전은 달랐다. FastAPI app.mount("/") 사용 시 API 404 오류 해결 방법 FastAPI에서 정적 파일을 서빙할 때 이런 코드를 썼다. # 오류 코드 - API가 전부 404 app . mount ( "/" , StaticFiles ( directory = "static" , html = True ) , name = "static" ) @app . get ( "/api/trends" ) async def get_trends ( ) : . . . API 호출마다 404가 났다. 원인은 라우팅 우선순위였다. app.mount("/") 가 상단에 있으면 뒤에 선언된 모든 엔드포인트가 무시된다. # 해결 코드 - 항상 moun...
자세한 내용 보기

YouTube Data API 쿼터 초과를 피하는 방법 (700개 쇼츠 수집 사례)

이미지
  처음에는 단순히 API 몇 개 호출하면 끝날 줄 알았다. UGREEN DXP4800PLUS NAS 위에서 유튜브 쇼츠 자동화 시스템을 구축하면서 YouTube Data API를 쓰기 시작했는데, 실제로 운영해보니 쿼터 관리가 더 큰 문제였다. YouTube Data API를 사용해 쇼츠 수집기나 트렌드 분석 시스템을 만들다 보면 쿼터(Quota) 부족 오류를 한 번쯤 겪게 된다. 하루 10,000유닛이면 사실상 무제한이라고 생각했는데, 글로벌 AI 키워드를 몇 개 추가하고 나서 하루도 지나지 않아 쿼터 부족 오류가 발생했다. 로그를 확인해보니 범인은 search.list 였다. 같은 API라도 videos.list 는 1유닛인데 search.list 는 100유닛이다. 이 차이를 이해하기 전까지는 쿼터가 왜 사라지는지 전혀 감이 오지 않았다. 약 700개 영상, 4만 개 이상의 스냅샷을 수집하는 과정에서 부딪힌 쿼터 제한과 해결 방법을 정리한다. YouTube Data API 기본 제한 사항 YouTube Data API v3는 무료로 제공되지만 일일 쿼터(Quota)가 존재한다. 기본 할당량: 하루 10,000 유닛 주요 API별 소비 유닛: videos.list : 1 유닛 search.list : 100 유닛 channels.list : 1 유닛 search.list 가 videos.list 보다 100배 비싸다. 처음에 이걸 몰라서 쿼터를 빠르게 소진했다. 실제로 겪은 문제들 문제 1: search.list 남용으로 쿼터 소진 초기 수집기는 이런 구조였다. # 초기 구조 - 쿼터 낭비 search_results = search . list ( q = "쇼츠" , type = "video" ) # 100 유닛 for video in search_results : detail = videos . list ( id = video . id ) # 1 유닛씩 s...
자세한 내용 보기

FastAPI app.mount 사용 후 API가 404가 되는 이유와 해결 방법

이미지
필자는 UGREEN DXP4800PLUS NAS 환경에서 Docker 기반 유튜브 쇼츠 자동화 시스템을 운영하고 있다. FastAPI와 PostgreSQL로 트렌드 수집 대시보드를 구축하던 중 모든 API 엔드포인트가 404를 반환하는 문제를 겪었다. 처음에는 PostgreSQL 연결 문제라고 생각했다. API가 전부 404를 반환하니 DB 연결이 끊어진 줄 알았다. docker compose logs로 컨테이너 로그를 뒤졌고, curl로 직접 호출해보니 FastAPI까지 요청이 들어오지도 않았다. 결국 원인은 app.mount("/") 한 줄이었다. 수정하고 나서 허탈했다. 30분을 날렸다.  app.mount("/") 선언 위치 하나 때문이었다. 수정 후 즉시 정상 동작했다. 이 글에서는 해당 오류의 원인과 해결 방법, 그리고 FastAPI 내부 동작 원리까지 정리한다. 문제 상황 아래와 같이 코드를 작성했을 때 /api/trends 엔드포인트가 404를 반환한다. from fastapi import FastAPI from fastapi . staticfiles import StaticFiles app = FastAPI ( ) # 정적 파일 마운트 app . mount ( "/" , StaticFiles ( directory = "static" , html = True ) , name = "static" ) # API 엔드포인트 선언 @app . get ( "/api/trends" ) async def get_trends ( ) : return { "status" : "success" } 코드 자체는 문법적으로 문제가 없다. 하지만 실행하면 /api/trends 호출 시 404가 반환된다. 원인 분석 FastAPI는 라우팅 처리 시 선언 순서대로 매칭 을 시도한다....
자세한 내용 보기