notParsec / 문서전체 문서

설명·설계 문서

Windows·Mac 앱 다운로드 명령어와 설치 방법

design/APP_DOWNLOAD_AND_INSTALL.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

2026-09-26 · progress-30 · F61 / F82 · 자체 관리 웹 E02, Mac 패키지 E05

앱 다운로드에 로그인한 뒤 macOS·Windows·Linux 중 운영체제를 선택한다. 좌측 앱 다운로드는 기기 목록과 분리된 화면이다. 다운로드 탭에서는 파일을 받고, 명령어 탭에서는 한 줄 명령어와 명령어 복사 버튼을 사용한다. 준비 중인 아키텍처에는 실행할 수 없는 명령어를 표시하지 않는다. Linux 공개 다운로드는 아직 미연결이며 게시 준비 상태를 보여준다. 화면 구성·구현·검증.

Mac에서 이미 받은 파일 설치하기

  1. 받은 notparsec-darwin-arm64.dmg를 더블클릭한다.
  2. 기존 notParsec을 종료한다. 설치 창에서 notParsec.app을 옆의 Applications 폴더로 드래그한다. 이미 설치돼 있다면 대치를 선택한다.
  3. 복사가 끝나면 설치 디스크를 추출하고, Finder의 응용 프로그램에서 notParsec을 실행한다. FFmpeg는 포함돼 있다.
  4. 이 Mac에 원격 접속하려면 개인정보 보호 및 보안 → 손쉬운 사용 / 화면 및 시스템 오디오 녹음에서 현재 앱을 허용하고 재실행한다. 이미 켜져 있는데 오류가 나면 이전 손쉬운 사용 항목을 제거하고 응용 프로그램의 현재 앱을 다시 추가한다.
  5. 예전에 받은 .tar.gz는 압축을 풀어 앱 전체를 응용 프로그램으로 옮기면 된다. 이전 ~/Applications 설치본과 중복 실행하지 않도록 정리하되 사용자 설정 폴더는 삭제하지 않는다.

DMG 전환 이유·SSH 처리·권한 개념·구현과 검증

인터넷에서 받은 앱의 설치는 Apple의 앱 설치 안내를 참고한다. 현재 Apple Silicon 패키지는 고정 개인용 인증서로 서명되며 Apple 공증 전이다. 출처를 확인했는데 개발자 확인 때문에 열기가 차단된 경우 앱 열기를 시도한 뒤 시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기 절차를 따른다. OS 보안 설정 전체를 끄는 명령은 제공하지 않는다. Apple의 앱 열기 안내.

Windows에서 받은 파일 설치하기

새 notparsec.exe를 더블클릭하면 설치 화면이 열린다. 기존 앱을 종료하고 설치 위치(기본 %LOCALAPPDATA%\Programs\notParsec)와 로그인 시 자동 시작을 확인한 뒤 설치 후 실행을 누른다. 시작 메뉴와 Windows 설치된 앱 목록에 등록된다. 기기 등록·비밀번호·설정은 보존하며 이후 업데이트는 앱에서 확인한다. 창의 X는 접속 대기를 트레이에 남기고, 완전 종료는 트레이의 Quit을 사용한다. 접속받는 중에는 종료를 보류한다.

설치·트레이·커서·업데이트 정리의 구현과 한계. 자동 시작은 로그인 후 실행이며 로그인 전/UAC 서비스 구현과 구별한다.

명령어 사용 순서

  1. Mac은 ⌘+스페이스 → 터미널, Windows는 시작 메뉴 → PowerShell을 연다. Windows 명령을 명령 프롬프트(cmd)에 붙이지 않는다.
  2. 웹에서 해당 파일의 명령어를 복사해 붙여넣는다. 명령어는 줄바꿈으로 나누지 않아도 되는 한 줄이다.
  3. 비밀번호 질문이 나오면 웹 관리자 비밀번호를 입력한다. Mac 로그인 비밀번호나 원격 PC 연결 비밀번호가 아니다. 입력 문자가 보이지 않는 것은 정상이다.
  4. Downloads/notparsec.… 또는 Downloads/notparsec-…의 새 폴더에 다운로드하고 SHA-256을 검사한 뒤 Finder/탐색기에서 폴더를 연다. 앱을 자동 실행하거나 기존 앱을 덮어쓰지 않으며 설치는 위 안내를 따른다.
  5. 목록을 본 뒤 서버 파일이 교체돼 해시가 달라졌다면 다운로드를 실패 처리하고 .part를 지운다. 웹을 새로고침하고 새 명령을 복사한다.

Windows의 PowerShell curl 별칭과 충돌하지 않게 curl.exe를 사용한다. Mac에서는 기본 curl, shasum, mktemp, open을 사용하며 Homebrew/Python 설치가 필요 없다. 명령어에는 비밀번호나 웹 관리자 Bearer token이 들어 있지 않다. curl --user admin이 비밀번호를 별도로 묻는다. curl의 사용자 인증 설명.

서버 처리와 원본 대조

기존 /notparsec-admin/api/downloads/{id}의 고정 파일 GET에서만 HTTP Basic 인증을 추가했다. HTTPS 공개 주소에서 기존 관리자 비밀번호를 검증하고 파일을 스트리밍한다. 로그인과 동일한 1분 5회 비밀번호 시도 제한을 공유한다. 다운로드로 관리자 세션을 새로 만들지 않으며 비밀번호를 변경하면 이전 비밀번호는 즉시 거부한다. 다른 관리 API는 여전히 Bearer 인증만 받는다. WWW-Authenticate를 보내 브라우저에 기본 인증 정보를 자동 저장시키지 않는다. URL에 인증 정보를 넣지 않으며 캐시는 금지한다.

이 기능은 사용자가 요청한 자체 관리 웹(E02)과 Mac 설치 안내(E05)다. Parsec 원본 다운로드 UI/내부 프로토콜을 복원했다고 표시하지 않는다. 기준 Windows Parsec 150-104a 코어 SHA-256은 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f이며 기존 앱/관리 UI 대조와 패키지·게시 근거에 연결한다. F61/F82의 기존 미완료 기능과 parity different는 유지한다.

progress-29 검증: 관리자 인증 시험 8개, native release 빌드·Clippy, 실제 브라우저의 OS 전환·준비 중 파일·복사·모바일 배치·로그아웃을 확인했다. 표시한 Mac 쉘 명령은 Linux Bash와 실제 격리 서버에서 다운로드·해시 일치·파일 변경 시 거부·부분 파일 정리를 실행했다. 시험용 파일은 실행 불가능한 합성 파일이며 앱 설치를 수행하지 않았다. 실제 macOS Terminal·Windows PowerShell에서의 명령 실행과 Gatekeeper 설치 승인은 미검증이다. 이 웹 작업은 게시된 Windows/Mac 앱 바이너리를 바꾸지 않는다.

검증 기록

progress-30: Mac 다운로드는 DMG로 전환했다. 앱 실행파일은 유지했으며 실제 Mac DMG 생성·마운트·복사·서명을 검증했다. 관리자 회귀 시험 9개와 DMG/예전 tar 웹·명령어 다운로드를 확인했다. 상세 근거와 미검증 범위는 DMG 설치 기록에 있다.

progress-32 권한 문제 해결: 허용 스위치가 켜져 있어도 이전 ad-hoc 빌드의 서명에 승인 기록이 묶여 있으면 현재 앱이 거부될 수 있다. 실제 로그로 이를 확인하고 notParsec 권한만 정상 초기화·재승인한 뒤 실제 화면 인코딩/디코딩에 성공했다. 원인·조치·검증 결과의 progress-32 후속을 참고한다.

Windows 부팅 호스팅 서비스

로그인 전·잠금·UAC 접근과 GUI 업데이트 중 호스팅 유지는 Settings → Host → Windows Hosting Service → 호스팅 서비스 설치에서 설정한다. 기기 승인·비밀번호 설정 후 Windows 관리자 승인이 필요하다. 기존 기기 정보는 유지한다. 서비스 코드 갱신은 현재 작업을 보존하고 다음 재부팅부터 적용한다. 실제 Windows 부팅/UAC/업데이트 유지 검증은 아직 대기 상태다. 구조·설치·권한·검증 범위를 참고한다.