<
>

Manual

Manga Viewer 사용 매뉴얼

사이트 이동, 검색, 즐겨찾기, 이어보기, 관리자 설정까지 한 번에 볼 수 있도록 정리한 운영 매뉴얼입니다.

지원 사이트

HOME, 툰코, 늑대닷컴, 11툰, HIYOBI, K-HENTAI를 한 UI에서 이동합니다.

핵심 기능

즐겨찾기 자동 반영, 마지막 읽은 위치 복원, 뷰어 모드 저장, 회차 이동을 지원합니다.

관리 기능

사이트 주소, FlareSolverr, 프록시, 사용자 승인, DB 백업/복원을 설정 화면에서 관리합니다.

1. 빠른 시작

  1. 로그인 후 HOME 또는 상단 탭에서 원하는 사이트로 이동합니다.
  2. 최신, 완결, 랭킹, 검색 화면에서 작품을 찾습니다.
  3. 작품 상세에서 회차 목록을 열고 감상할 회차를 선택합니다.
  4. 뷰어를 닫았다가 다시 열면 마지막 읽은 위치를 이어서 복원합니다.
  5. 작품을 한 번이라도 열면 HOME 즐겨찾기 목록에 자동 반영됩니다.

2. 화면 구성

상단 탭
HOME / 툰코 / 늑대닷컴 / 11툰 / HIYOBI / K-HENTAI

왼쪽 플로팅 메뉴
매뉴얼 / 설정 / 비밀번호 변경 / 로그아웃 / 맨 위로

일반 화면 목록, 검색, 작품 상세, HOME 즐겨찾기, 설정 메뉴를 사용합니다.
뷰어 화면 이전화, 홈, 뷰어 설정, 폭 조절, 목록, 다음화 버튼으로 감상에 집중합니다.
플로팅 메뉴 뷰어에서는 숨기고, 일반 화면에서만 표시해 화면을 덜 가립니다.

3. 즐겨찾기와 이어보기

  • 작품을 열면 HOME 즐겨찾기에 자동 등록되며 최근 접근 작품 관리 용도로 쓸 수 있습니다.
  • HOME에서 개별 삭제와 일괄 삭제를 지원합니다.
  • 툰코 계열 항목은 HOME에서 바로 업데이트 여부를 확인할 수 있습니다.
  • 작품별 마지막 회차, 스크롤 위치, 뷰어 모드가 저장됩니다.

4. 뷰어 조작

  • 웹툰 모드와 만화책 모드를 작품별로 기억합니다.
  • 이미지 폭 조절로 작은 화면과 큰 화면 모두에 맞춰 읽을 수 있습니다.
  • 이전화/다음화 버튼으로 회차를 이어서 이동합니다.
  • 스크롤 위치와 페이지 위치를 함께 저장합니다.
  • HIYOBI, K-HENTAI도 재진입 시 위치 복원을 시도합니다.
팁: 작품을 넘기기 전에 현재 위치가 자동 저장되므로, 모바일과 데스크톱을 번갈아 써도 이어보기가 비교적 안정적으로 유지됩니다.

5. 계정과 권한

  • 신규 가입 계정은 기본적으로 승인 대기 상태일 수 있습니다.
  • 성인 사이트 접근은 별도 권한이 있어야 사용할 수 있습니다.
  • 비밀번호 변경은 좌측 플로팅 메뉴에서 바로 진입합니다.
  • 관리자만 설정 화면과 사용자 관리 기능을 볼 수 있습니다.

6. 관리자 설정

  • /settings에서 사이트 URL, 로고, 프록시, FlareSolverr 주소를 조정합니다.
  • 사용자 승인, 성인 권한, 관리자 권한을 관리합니다.
  • DB 백업 생성, 다운로드, 복원을 지원합니다.
  • 사이트 접속 오류가 잦으면 FlareSolverr와 프록시 설정을 먼저 확인합니다.
운영 팁: TOONKOR 계열은 Cloudflare 우회가 필요할 수 있으므로 TOON_FLARESOLVERR_URL이 올바른지 먼저 점검하는 편이 빠릅니다.

7. 로컬 실행

$env:TOON_DB_FILE_PATH = ".\lib\webtoon.db" $env:TOON_FLARESOLVERR_URL = "http://localhost:8191/v1" pip install -r requirements.txt python webtoon_server.py

8. Docker 실행

docker compose up -d --build

9. 주요 경로와 환경 변수

DB lib/webtoon.db
로그 log/
서버 진입점 webtoon_server.py
기본 포트 9997
주요 환경 변수 HOST, PORT, TOON_DB_FILE_PATH, TOON_FLARESOLVERR_URL, TOON_SECRET_KEY

10. 자주 확인할 항목

  • DB 경로가 비어 있거나 잘못되면 새 DB가 생성되어 기존 데이터가 안 보일 수 있습니다.
  • Cloudflare 차단이 심한 사이트는 FlareSolverr가 꺼져 있으면 목록/상세 로딩이 불안정할 수 있습니다.
  • 배포 환경에서는 TOON_SECRET_KEY를 기본값 대신 별도 값으로 지정하는 편이 안전합니다.
  • 복원 작업 전에는 현재 DB를 한 번 더 백업해 두는 편이 안전합니다.