# notParsec 배포 전용 sudo 권한 2026-09-24 · E02 Ubuntu 자체 서버 운영 · F78. 최초 관리자 설정 완료. 배포 전용 명령으로 UI·직접 UDP 통합 앱 빌드 1790274520과 문서를 비밀번호 없이 게시하고 확인했다. Parsec 150-104a 원본 서버의 배포 구현을 복원했다는 뜻이 아니다. ## 한 번만 필요한 설정 이 서버에서 `ahn`은 일반 sudo 실행 때 비밀번호가 필요하다. notParsec 배포에는 등록된 전용 명령의 비밀번호 없는 권한을 사용한다. 아래 초기 설정은 이미 완료했으며, 다른 서버에 처음 설치할 때만 관리자 인증이 필요하다. 초기 설정의 `--apply`는 현재 `dist/deploy-ready`에 준비된 앱·서버·문서 중 포함된 항목을 게시한다. ```bash sudo python3 /home/ahn/notparsec/deploy/ubuntu/enable-auto-deploy.py --apply ``` 설정 이후에는 에이전트가 다음 명령을 비밀번호 입력 없이 실행할 수 있다. ```bash sudo -n /usr/local/sbin/notparsec-deploy ``` Linux 서버 바이너리가 포함된 배포만 notParsec 서버를 재시작한다. 앱·문서만 게시할 때는 서버를 재시작하지 않는다. 기존 DB·서명 키·기기 승인은 보존하고 서버 교체 전 기존 백업 절차를 실행한다. 실패한 배포를 성공으로 표시하지 않으며, 단계 사이 장애가 나면 일부만 게시될 수 있다. 2026-10-01 사용자 요청으로 [새 빌드 게시·최신 파일 보관 정책](LATEST_BUILD_PUBLICATION.ko.md)을 적용한다. 새 다운로드 검증·교체 후 현재 플랫폼 묶음 하나를 유지하고, 새 서버의 readiness 성공 후 이전 관리 바이너리를 정리한다. 실패한 서버 배포의 복구 사본과 DB·키 백업은 보존한다. **운영 반영에는 갱신한 고정 설치 코드를 관리자 명령으로 한 번 설치해야 한다.** 로컬 Ubuntu Windows 릴리스 빌드는 게시 단계를 기본으로 실행하고, 보호된 CI 태그의 검증 완료 앱은 데이터 전용 인계 폴더를 통해 고정 게시 서비스가 처리한다. 일반 소스 변경이나 `cargo test` 결과를 감시해서 게시하지 않는다. ## 허용되는 범위 - `/usr/local/sbin/notparsec-deploy`는 root가 소유하며 **명령 인수를 받지 않는다**. `ahn`의 sudoers 규칙도 이 경로와 빈 인수만 허용한다. - root가 소유하는 `/usr/local/libexec/notparsec-deploy/trusted/`에 설치·백업·systemd·Nginx 문서 설정 코드를 보관한다. 일반 배포는 작업 디렉터리의 `apply.sh`, Python, shell, service unit을 root로 실행하지 않는다. - 일반 계정은 `dist/deploy-ready`에 Windows 앱·Linux 서버 바이너리·정적 문서와 SHA-256 manifest만 준비한다. 명시된 파일 종류, 파일 수/크기, 소유자, hash를 검증하고 root의 임시 디렉터리에 복사한 뒤 게시한다. - 경로 이탈·심볼릭 링크·하드 링크·FIFO·중복 manifest key를 거부한다. Python은 격리 모드로 시작하고 하위 명령의 환경과 실행 경로를 고정한다. - Linux 서버는 기존 systemd의 `User=notparsec`로 실행한다. 새 바이너리를 root로 시험 실행하지 않는다. Windows 앱과 문서는 배포 데이터다. - 권한 대상은 서버 교체/백업/서비스 재시작, 관리자 앱 다운로드 게시, 문서 게시와 기존 관리 Nginx 문서 구역 반영이다. privileged installer·서비스 설정 자체를 바꾸려면 최초 설정 스크립트를 관리자 권한으로 다시 실행한다. ## 다음 배포 준비 빌드·검사·체크섬이 끝난 bundle을 사용한다. 문서는 기존 생성기에서 만든다. ```bash python3 /home/ahn/notparsec/deploy/ubuntu/install-document.py --prepare python3 /home/ahn/notparsec/scripts/prepare-auto-deploy.py \ --bundle /home/ahn/notparsec/dist/ui-recovery-preview --documents sudo -n /usr/local/sbin/notparsec-deploy ``` `--bundle`만 쓰면 바이너리, `--documents`만 쓰면 문서만 게시한다. 문서만 게시할 때 앱 서버는 재시작하지 않는다. 이 명령들은 초기 권한 설정 후 에이전트가 실행할 작업이다. 새 앱 빌드를 만들면 게시와 설치 파일 해시 검증까지 같은 작업에서 완료한다. ## 검증과 해제 [권한 경계 시험](../deploy/ubuntu/test_auto_deploy.py)은 임시 파일에서 정상 게시 준비, 파일 위조/경로 이탈/링크/FIFO 거부, 고정 명령과 환경, 인수 제한, `visudo` 문법을 검사한다. 실제 root 설치·sudo 정책 등록과 비밀번호 없는 앱·문서 게시는 확인했다. 이 배포에는 Linux 서버 바이너리가 없어 서버 교체·재시작은 수행하지 않았다. [검증 기록](evidence/auto-deploy-validation.json). 허용을 해제하려면 관리자 권한으로 `/etc/sudoers.d/notparsec-deploy` 파일만 삭제한다. 기존 다른 sudo 규칙·서비스·데이터는 유지된다. sudo의 `NOPASSWD`와 빈 명령 인수 지정은 설치된 `sudoers(5)` 설명과 `visudo -cf`로 확인한다.