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

스크린샷 2026-01-15 15.14.21.png

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)

수정 사항:

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

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을 사용해보셨으면 익숙하실 거고 처음 보시는 분들도 주석 참고하시면 별 어려움 없을 겁니다

 

스크린샷 2026-01-15 15.27.32.png

설치 후 접속을 하면 로그인 창이 보이고요

처음에는 회원 가입을 해줘야 합니다

맨 처음 가입하는 사용자가 슈퍼 애드민 권한을 갖습니다

 

스크린샷 2026-01-15 15.35.43.png

로그인 하시면 이런 화면이 보입니다

뭐 특별히 설명 해야할 정도로 복잡한 구조는 아니죠

 

image.png

프로필 메뉴에 계정 설정 메뉴, 공유 링크 관리 메뉴, 관리자 설정 메뉴 등이 있습니다

가입 승인 대기 중인 사용자가 있는 경우 배지가 표시됩니다

 

스크린샷 2026-01-15 15.37.22.png

계정 설정 메뉴에는 프로필, 보안, SSO 연동 메뉴가 있습니다

 

image.png

스크린샷 2026-01-15 15.40.26.png

image.png

공유 링크 관리 메뉴도 있습니다

공유 링크를 생성할 때 이런저런 옵션 설정이 가능합니다

 

스크린샷 2026-01-15 15.44.06.png

 공유 링크를 클릭하면 비번이 있다면 비번 입력 창이 보이고

 

image.png

스크린샷 2026-01-15 15.18.15.png

비번 입력하면 설정된 비율의 미리보기 텍스트를 표시합니다

라이브러리 추가 허용된 링크라면 로그인 후 라이브러리 추가가 가능합니다

 

스크린샷 2026-01-15 15.47.12.png

스크린샷 2026-01-15 15.47.32.png

관리자 설정 페이지에는 이런 옵션들이 있습니다

 

스크린샷 2026-01-15 15.48.07.png

역할 권한 관리는 역할 별 기본 권한 설정이 가능합니다

 

사용자 관리나 SSO 설정은 VDtN과 같은 메뉴 입니다

이전 개발일지에서도 소개를 했으니 넘어가고

 

스크린샷 2026-01-15 15.49.43.png

태그 관리 메뉴를 추가했습니다

 

스크린샷 2026-01-15 15.51.38.png

설치시 기본 태그가 설정 돼있는 상태고 별도로 추가하거나 삭제할 때 사용하면 됩니다

 

 

스크린샷 2026-01-15 15.52.13.png스크린샷 2026-01-15 15.52.26.png

그 외에는 뭐 직관적인 기능들이라 설명 할 부분이 별로 없네요

업로드는 직접 업로드와 서버 관리자가 업로드한 폴더에서 가져오는 기능이 있습니다

서버에서 열기는 권한이 있어야하고요

라이브러리에 등록 가능한 책의 수는 역할별 또는 사용자별 설정 가능합니다

 

스크린샷 2026-01-15 15.55.17.png

라이브러리 책 하단에는 정보, 편집, 공개게시판 개시/삭제, 공유링크 생성 버튼이 있습니다

 

공개 게시판 게시 버튼은 한 번 누르면 게시 다시 누르면 취소 입니다

 

스크린샷 2026-01-15 15.58.04.png

공개 게시판 권한이 있다면 다른 사용자가 올린 책을 가져오기 할 수 있습니다

슈퍼 애드민은 모든 공개 게시판 게시물 삭제가 가능합니다

 

image.png

image.png

image.png

뷰어 같은 경우 스크롤 모드, 캔버스 1분할, 캔버스 2분할 모드가 있습니다

모바일에서는 가로 해상도가 부족하면 캔버스 2분할 표시가 안됩니다

 

 

스크린샷 2026-01-15 16.00.52.png스크린샷 2026-01-15 16.00.42.png

리더 설정과 파트 정보를 확인 할 수 있습니다

3메가 넘는 파일은 파트로 분할 되서 저장 됩니다

 

OPMD 지원으로 모드간, 브라우저간 진행도 동기화가 가능합니다

 

뭐 이 외에도 이것저것 디테일을 좀 챙기긴 했는데 부족한 부분이 있을 수 있습니다

 

사용 해보실 분들은 사용 해보시고 피드백 주시면 도움이 될 거 같습니다

 

베타이기 때문에 수시로 업데이트 될 수 있습니다

 

댓글 남기기

이메일 주소는 공개되지 않습니다. 필수 항목은 *(으)로 표시합니다