notParsec / 문서전체 문서

설명·설계 문서

Mac용 다운로드: 웹 표시·패키지·게시 경로

design/MAC_DOWNLOADS.ko.md

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

이 문서의 목차

2026-09-26 · progress-35 · F01 / F61 / F82 · E02 / E05

현재: 실제 Apple Silicon Mac에서 빌드한 0.1.0 / 1790451741를 remote.n3m.kr에 게시했다. 관리 웹에서 macOS → Apple Silicon을 선택해 다운로드한다. FFmpeg를 포함하므로 해당 패키지는 Homebrew를 따로 설치할 필요가 없다. 사용자는 Mac 권한 승인 후 Windows에서 Mac 원격 화면을 확인했다. 이번 빌드는 Mac H.264 저지연 설정 수정을 포함한다. 수정 후 실제 Decode 개선 폭, Intel 빌드, Apple 공증, OS 간 전체 기능과 Mac 자동 업데이트는 아직 미검증·미완료다. 기존 Windows 앱과 업데이트 파일은 그대로 유지했다.

실제 Mac 빌드·SSH 문제 해결·영상 검증 과정 · 검증 기록

progress-29: 관리 웹에 터미널/PowerShell 다운로드 명령어·복사 버튼과 설치 순서를 추가했다. 이미 받은 파일 설치·명령어 사용·인증 설명을 참고한다.

progress-30: 웹 다운로드는 DMG → Applications 드래그 설치로 변경했다. 아래 표는 사용자가 받는 파일이며, 서버 게시 운반 파일은 기존 .tar.gz를 유지한다. DMG·권한·SSH 처리 설명.

progress-33: Mac 이중 커서 수정에서 캡처 영상의 Mac 포인터 중복을 제거했다. Mac에 설치할 새 앱의 권한 재승인 여부를 확인했다.

progress-35: 고정 인증서 서명을 적용했다. 최초 전환 승인 후 다음 빌드로 교체해도 손쉬운 사용·화면 녹화 권한이 유지됐고 실제 캡처가 성공했다.

1. 왜 Mac에서도 Windows만 보였나

기존 관리 HTML의 제목은 Windows x64로 고정되어 있었고, 브라우저 코드는 desktop 한 항목만 만들었다. 서버 다운로드 허용 목록과 게시기도 notparsec.exe 하나만 처리했다. Mac용 Rust 모듈이 존재하는 것과 Mac에서 실행할 앱 패키지를 만드는 것은 별개다.

변경 전 공개 사이트에 Mac Safari와 Windows 브라우저 식별값으로 요청했을 때 동일한 Windows 전용 HTML을 받았다. 설치된 다운로드 디렉터리에도 EXE·체크섬·Windows 업데이트 메타데이터만 있었다.

2. 웹에서 보이는 동작

대상 다운로드 ID 게시 파일
Windows x64 desktop notparsec.exe
Mac Apple Silicon desktop-macos-arm64 notparsec-darwin-arm64.dmg
Mac Intel desktop-macos-x86_64 notparsec-darwin-x86_64.dmg (준비 중)

3. Mac에서 앱 빌드하기

Mac에 이 작업이 반영된 소스, Rust 1.93.1, Xcode Command Line Tools, Python 3가 필요하다. 게시된 Apple Silicon 패키지는 FFmpeg를 포함한다. 아래의 기본 소스 빌드는 외부 FFmpeg를 사용하며, 포함하려면 --ffmpeg-bundle을 지정한다. scripts/build-portable.py는 Linux에서 Mac 빌드를 성공한 것처럼 처리하지 않고 명확히 중단한다.

Mac의 터미널에서 저장소 디렉터리로 이동한 뒤 실행한다.

# 빌드용 Mac 최초 한 번: 고정 인증서 등록 및 현지 승인
python3 scripts/init-macos-signing.py --authorize-trust

# Apple Silicon
rustup target add aarch64-apple-darwin
python3 scripts/build-portable.py --target aarch64-apple-darwin

# Intel — Mac의 Apple SDK로 해당 아키텍처 빌드
rustup target add x86_64-apple-darwin
python3 scripts/build-portable.py --target x86_64-apple-darwin

대상을 생략하면 실행 중인 Mac의 아키텍처를 사용한다. 빌드 결과는 동일한 연결·호스팅 앱을 포함하는 notParsec.app이다. Windows 호스트와 Mac 뷰어를 서로 다른 제품으로 분리하지 않는다.

패키징은 실행파일 내부의 version/build/commit을 읽어 기록하고, Info.plist에 버전을 반영한다. Mac release는 고정 개인용 인증서를 재사용하고 codesign --verify --deep --strict·인증서 조건·lipo -verify_arch 검사를 수행한다. 인증서가 없거나 달라지면 중단한다. 개인용 고정 서명은 Developer ID 배포 서명·Apple 공증과 다르다. 권한·서명 검사를 우회하는 절차를 제공하지 않는다. 현재 서명 방식의 다운로드본이 각 Mac의 Gatekeeper에서 어떻게 처리되는지는 실제 시험이 필요하다.

결과물:

dist/notparsec-darwin-arm64/notparsec-darwin-arm64.dmg
dist/notparsec-darwin-arm64.tar.gz
dist/notparsec-darwin-arm64.json
dist/notparsec-darwin-arm64.sha256
dist/notparsec-darwin-arm64-publish/
  notparsec-darwin-arm64.tar.gz
  SHA256SUMS

Intel은 파일명의 arm64 대신 x86_64를 사용한다. Mac runner가 등록되어 있고 NOTPARSEC_MACOS_RUNNER=1을 지정하면 GitLab의 두 대상 matrix가 패키지를 생성하도록 연결했다. 이 작업에서는 Mac runner 실행 결과가 없다.

4. Ubuntu에 게시하기

실제 Mac에서 빌드한 *-publish 디렉터리를 Ubuntu 작업 폴더의 dist/로 가져온 뒤 다음을 실행한다. 실제 앱이 들어 있는 패키지만 사용한다. 테스트의 가짜 Mach-O/아카이브는 공개 게시하지 않는다.

python3 scripts/prepare-auto-deploy.py --bundle dist/notparsec-darwin-arm64-publish
sudo -n /usr/local/sbin/notparsec-deploy

progress-26 당시에는 고정 게시기의 Mac 허용 목록 갱신이 관리자 인증을 기다렸다. 이후 갱신이 적용됐으며, progress-27에서는 sudo -n /usr/local/sbin/notparsec-deploy로 실제 Apple Silicon 패키지를 게시하는 데 성공했다. 이미 설정된 서버에서 최초 등록 명령을 반복할 필요가 없다.

게시기는 체크섬·64 MiB 크기 상한을 먼저 검사한다. Mac tar.gz는 압축을 풀어 실행하지 않고 내용만 순회해 경로 이탈, 링크, 중복 이름, 과도한 압축 해제 크기, Mach-O CPU 종류, 앱 식별자와 실행파일 체크섬을 검사한다. 이는 정적 패키지 검증이며 코드 서명·공증 또는 실제 앱 실행 검증을 대신하지 않는다.

플랫폼 한 종류만 게시하면 기존의 다른 플랫폼 파일과 Windows update.json을 보존한다. 모든 검증이 끝난 새 디렉터리를 원자적으로 current에 연결하므로 실패한 Mac 게시로 Windows 다운로드를 지우지 않는다. 원장의 Mac 구현 상태는 계속 부분 구현이다.

5. 설치 후 확인할 내용

압축을 풀고 notParsec.app을 응용 프로그램 폴더로 옮긴다. Apple Silicon 게시본은 FFmpeg가 포함되어 있으며 호스팅 시 화면 기록·손쉬운 사용 권한을 확인한다. 현재 캡처가 외부 FFmpeg를 사용하므로 보조 실행파일의 화면 기록 권한도 확인해야 한다.

현재 프로토콜은 /9이며 양쪽 앱이 같은 프로토콜이어야 한다. Windows 공개 빌드 1790331224가 /9다. Mac 자동 업데이트는 이번 범위에서 구현하지 않았으며 수동 패키지 교체가 필요하다.

Mac 앱 시작과 창 표시, Apple Silicon의 합성 영상 H.264/H.265 하드웨어 인코딩→앱 CPU 디코딩은 확인했다. 남은 시험은 다운로드본 Gatekeeper/TCC 권한, Intel 실기기, Windows↔Mac 등록·인증·화면 캡처·입력·클립보드, GPU 표시와 Retina·다중 화면이다. Linux에서의 Mac 플랫폼 모듈 타입 검사를 전체 앱 시험으로 세지 않는다.

6. 원본과의 관계·검증 근거

기준은 보관한 Windows Parsec 150-104a, 코어 SHA-256 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f이다. 원본의 통합 앱 책임 구조를 유지하며 자체 관리 웹·게시 경로는 E02, Mac 포트는 E05의 범위다. Mac Parsec 바이너리·설치 화면을 같은 조건으로 비교하지 않았으므로 원본 일치 판정은 하지 않는다.

검증 결과: 서버 단위 시험 20개, 게시기·설치기 시험 20개, 문서·원장 시험 12개 통과. 별도의 실제 Chromium 시험에서 두 Mac 아키텍처 다운로드(가짜 시험 파일), 미게시 버튼 비활성화, Windows 유지, 로그아웃·체크섬·게시 중 교체·모바일 폭을 확인했다. 공개 사이트도 Mac 브라우저 식별값으로 macOS 기본 선택을 확인했다. 이전 브라우저 모의 시험과 progress-27의 실제 Mac 네이티브 시험은 구별한다.