가이드

시놀로지 도커에 컨텐츠 뷰어 Dock마루 베타 설치하기 0.1.2-2

빨간물약

16 1월 2026 — 10 min read

0.1.2-2 업데이트 내역

PWA 기능 추가 및 텍스트 리더 버그 수정

권한 관리 오류 수정

이미지 태그 latest로 변경

sruinz/dockmaru-backend:latest
sruinz/dockmaru-frontend:latest

복사

beta -> latest 로 변경 해주세요

이번 0.1.2-1 버전까지는 beta 태그 사용도 가능합니다

서버에서 열기 - 디버그 코드 제거

0.1.1-beta 업데이트 내역

회원 가입 불가 설정 옵션 미작동 수정

컬렉션(폴더/시리즈) 기능 추가

epub pdf 서버에서 열기 오류 수정

pdf 변환 책의 썸네일 재추출 기능 누락 수정

캐시 성능 개선 및 추가

그외 버그 수정 및 개선

컬렉션 (폴더/시리즈)의 자세한 내용은 Dock마루 시리즈의 0.1.1-beta 업데이트 글을 참고 해주세요

0.0.4-beta 업데이트 내역

zip cbz용 이미지 뷰어 추가

pdf -> 이미지 변환, txt 변환 기능 추가

epub -> txt 변환 기능 추가

한글 이름순 정렬 버그 수정

그외 여러 버그 수정 및 개선

서버에서 열기로 pdf와 epub 파일을 열 때 제대로 변환이 안되는 문제가 있습니다

해결 버전이 배포 되기 전까지 pdf와 epub은 직접 업로드를 사용해주세요

0.0.3-beta 업데이트 내역

개발자 모드가 추가 됐습니다

플러그인 시스템이 개발자 모드에 추가 됐습니다

기본 태그에 연재중, 완결, 휴재 상태 태그와 웹소설 플랫폼 태그가 추가 됐습니다

그 외에 여러 버그나 레이아웃 수정이 있었습니다

자세한 내용은 시리즈 글을 확인해주세요

태그 및 Info 모달 UI 개선 완료 (v0.0.2-beta)

수정 사항:

태그 표시: 라이브러리/공개 게시판 카드에서 2개 → 3개+N으로 변경
라이브러리 Info 모달: 저자 아래에 모든 태그 표시 추가
공개 게시판 Info 버튼: hover 시 Info 아이콘 표시 (가져오기 버튼 옆)
PublicBookInfoModal: 표지, 제목, 저자, 태그, 소개글 전체, 업로더, 등록일, 파일 정보 표시
라이브러리와 공개 게시판 책 카드 UI 통일
맥에서 업로드한 파일 라이브러리 한글 검색 안되는 버그 수정

0.0.1-beta 업데이트 내역

반응형UI 버그 수정 및 모바일 최적화

토스트 메세지 보완

다국어 비동기 버그 수정

생각보다 추가 작업들이 빨리 마무리가 됐네요

아직 수정할 부분들이 있긴 하지만 베타 버전 배포 정도는 될 거 같습니다

베타 버전 피드백이나 실제 사용 테스트를 하면서 디테일을 깎는 작업만 남은 거 같네요

version: '3.8'

services:
  backend:
    image: sruinz/dockmaru-backend:latest
    container_name: dockmaru-backend
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - TZ=Asia/Seoul
    volumes:
      - ./data:/app/data                       # 디비 저장 폴더
      - ./uploads:/app/uploads           # 라이브러리에 등록 한 책 저장 폴더
      - ./books:/app/server_texts       # TXT 서버 업로드 폴더
    networks:
      - dockmaru-network

  frontend:
    image: sruinz/dockmaru-frontend:latest
    container_name: dockmaru-frontend
    restart: unless-stopped
    ports:
      - "${FRONTEND_PORT:-3700}:80"
    depends_on:
      - backend
    networks:
      - dockmaru-network

networks:
  dockmaru-network:
    driver: bridge

volumes:
  data:
  uploads:

복사

설치 방법은 간단합니다

/volume1/docker/dockmaru/ - 기본 폴더

기본 폴더에 하위 폴더 /data /uploads /books 세 개를 만들어 주시면 됩니다

# ============================================================================
# Dock마루 환경 설정
# ============================================================================
# 이 파일을 .env로 복사하고 필요한 값을 변경하세요
# cp .env.example .env
# ============================================================================

# ============================================================================
# 필수 설정 항목
# ============================================================================

# JWT 시크릿 키 (프로덕션 환경에서 반드시 변경!)
# - 권장 길이: 32-64자
JWT_SECRET=your-super-secret-jwt-key-change-me-dockmaru

# SSO 암호화 키 (SSO 사용 시 필수)
# - OAuth2 클라이언트 시크릿을 데이터베이스에 암호화하여 저장할 때 사용
# - SSO를 사용하지 않으면 설정하지 않아도 됩니다
# 
#   생성 방법 (가장 쉬움):
#   1) 애플리케이션을 먼저 실행하세요 (docker-compose up -d)
#   2) super_admin으로 로그인하세요
#   3) 설정 > SSO 탭에서 "암호화 키 생성" 버튼을 클릭하세요
#   4) 생성된 키를 복사하여 이 파일에 붙여넣으세요
#   5) docker-compose down && docker-compose up -d 로 재시작하세요
# 
# 대체 생성 방법:
#   Python: python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
# 
#- 생성된 키 예시: gAAAAABk1234567890abcdefghijklmnopqrstuvwxyz==
# ⚠️ 주의: 키를 변경하면 기존 SSO 설정을 복호화할 수 없습니다!
SSO_ENCRYPTION_KEY=

# CORS 허용 출처
# - 개발 환경: * (모든 출처 허용)
# - 프로덕션: 실제 도메인 지정 (예: https://reader.example.com)
ALLOWED_ORIGINS=*

# ============================================================================
# SSO/OAuth2 설정 (SSO 사용 시 필수)
# ============================================================================

# 백엔드 URL (OAuth2 리다이렉트 URI에 사용)
# - 시놀로지 예시: http://192.168.1.100:8000 또는 http://your-nas-domain:8000
# - NPM 리버스 프록시 사용 시: https://your-domain.com
# - 이 URL이 SSO Provider에 등록된 Redirect URI의 베이스가 됩니다
BACKEND_URL=https://내 도메인.com

# 프론트엔드 URL (인증 후 리다이렉트에 사용)
# - 시놀로지 예시: http://192.168.1.100:3700 또는 http://your-nas-domain:3700
# - NPM 리버스 프록시 사용 시: https://your-domain.com
FRONTEND_URL=https://내 도메인.com

# HTTPS 강제 사용 (OAuth2 리다이렉트에 적용)
# - 개발 환경: false
# - 프로덕션 (HTTPS/NPM 사용 시): true
FORCE_HTTPS=true

# ============================================================================
# 서버 포트 설정
# ============================================================================

BACKEND_PORT=8000
FRONTEND_PORT=3700   # 웹UI 접속 포트

# ============================================================================
# 고급 설정 (일반적으로 변경 불필요)
# ============================================================================

# 데이터베이스 경로
DATABASE_URL=sqlite:///./data/dockmaru.db

# Rate Limiting
RATE_LIMIT_PER_MINUTE=60

# 업로드 설정
UPLOAD_DIR=/app/uploads
MAX_UPLOAD_SIZE_MB=100

복사

.env 파일을 수정해서 기본 폴더에 업로드 해주시면 됩니다

VDtN을 사용해보셨으면 익숙하실 거고 처음 보시는 분들도 주석 참고하시면 별 어려움 없을 겁니다