SHYNI 관리자 매뉴얼
관리자용 · 공개 열람매뉴얼 편집 로그인
시작하기 / 01

관리자 매뉴얼 시작하기

Shyni 서버 관리자를 위한 매뉴얼입니다. 관리자 Web에서 라이브러리·저장소·사용자 권한을 설정하고 운영 상태를 점검하는 방법을 설명합니다.

화면 위치이 매뉴얼 → 왼쪽 목차

대상과 화면 범위

일반 사용자는 별도의 Shyni 클라이언트로 접속합니다. 클라이언트는 관리자 Web과 화면·메뉴·조작 방식이 다르며, 이 문서는 클라이언트 사용 설명서가 아닙니다. 다만 음악 재생목록 항목은 일반 사용자가 Web 설정에서 본인 목록을 직접 가져오는 방법도 함께 안내합니다.

탐색·영상·음악·도서 항목도 관리자가 Web에서 스캔 결과, 메타데이터와 재생 상태를 점검하는 절차입니다. 관리자 화면에서 정상인 것과 일반 사용자 클라이언트에서 정상인 것은 별도로 확인해야 합니다.

매뉴얼을 공개 링크로 읽는 것과 Shyni 서버 접근·관리 권한은 별개입니다. 음악 재생목록 가져오기는 일반 계정도 사용할 수 있지만, 서버 설정과 시스템 프리셋은 관리자 전용입니다.

서버를 처음 설치한다면

목차의 “설치와 메일 설정”에서 설치 준비와 GHCR 토큰 → Linux 또는 Windows 설치 → 필요하면 Gmail 초대 메일 설정 순서로 진행합니다. 명령·Compose 예시는 복사 버튼으로 들여쓰기를 유지할 수 있으며 관리자 편집 화면에서도 수정할 수 있습니다.

이 매뉴얼을 사용하는 방법

  1. 왼쪽 목차에서 필요한 화면을 선택합니다. 휴대폰에서는 오른쪽 위 목차 버튼을 누릅니다.
  2. 화면 사진을 누르면 크게 볼 수 있습니다. 설명은 기능의 목적 → 작업 순서 → 입력값 → 확인할 점 순으로 읽습니다.
  3. 항목 제목 옆 링크 버튼으로 해당 항목의 주소를 복사해 공유합니다. 방문자는 로그인 없이 읽을 수 있습니다.

처음 설정한다면

  1. Shyni 관리자 계정으로 로그인하고 서버에서 읽을 미디어 경로를 확인합니다.
  2. 클라우드를 사용한다면 마운트 관리에서 저장소 연결을 등록합니다.
  3. 원본 라이브러리를 만들고 폴더를 연결한 뒤 스캔합니다.
  4. 제공 라이브러리에서 사용자에게 보여 줄 콘텐츠를 구성합니다.
  5. 친구를 초대하고 제공 라이브러리 접근 및 재생 권한을 설정합니다.
  6. 마지막으로 일반 사용자 계정의 클라이언트에서 제공 목록과 재생 권한을 확인합니다. 관리자 Web 화면과 동일한 배치를 기대하지 않습니다.

화면과 예시의 기준

2026년 10월 26일 작업 폴더의 관리자 Web 코드, API 명세와 서버 계약을 다시 대조했습니다. 사진은 실제 Shyni 관리자 Web의 HTML·CSS·화면 로직을 로컬에서 실행한 캡처입니다. 계정, 주소, 경로, 작품 및 상태는 설명용 예시 데이터이며 운영 서버 캡처가 아닙니다. 사진 촬영 뒤 추가된 기능은 현재 코드의 입력값과 동작을 본문에 설명합니다.

입력 예시의 example.com 주소, media 리모트와 /mnt/media 경로는 자신의 서버 환경에 맞게 바꾸세요. 비밀번호, API 키, 초대 링크의 실제 값은 이 공개 매뉴얼에 넣지 않습니다.

클라이언트 앱 화면은 이 매뉴얼의 설명 범위에 포함하지 않습니다. TV QR 항목은 관리자가 장애 원인을 구분하는 데 필요한 서버 계약만 다루며 앱의 버튼 위치나 조작법은 안내하지 않습니다.

Shyni 운영과 문서 편집의 구분

항목기능 · 필요한 이유입력하거나 선택할 값확인할 점
Shyni 관리자관리자 Web에서 원본·제공 라이브러리, 저장소, 친구와 서버를 관리합니다.Shyni 서버의 관리자 계정이 매뉴얼의 대상입니다. Web 로그인은 ChatGPT 로그인과 별개입니다.
일반 사용자별도 클라이언트에서 허용된 콘텐츠를 이용합니다.관리자가 허용한 Shyni 계정과 클라이언트Web 설정 → 음악 재생목록에서 본인 목록을 가져올 수 있습니다. 그 외 관리자 전용 메뉴는 제공하지 않습니다.
매뉴얼 편집 담당 관리자이 문서의 설명과 사진을 수정합니다.상단 매뉴얼 편집 로그인 → 지정된 ChatGPT 계정문서를 수정해도 Shyni 서버 설정이나 사용자 권한은 바뀌지 않습니다.
코드 · 서버 계약 확인 근거

작성 시 작업 폴더의 코드와 서버 계약을 대조했습니다. 설치·Gmail 안내는 2026년 9월 21일 추가 확인했습니다. 운영 버전이나 이후 관리자 수정 내용은 실제 동작과 함께 확인하세요.

  • server/app/static/index.html:1
  • server/app/static/js/settings.js:56
  • contracts/openapi.json — 411개 경로 대조
  • server/app/static/js/library.js:61
  • contracts/CLIENT_CORE_CONTRACT_v1.md:39