PrivateNote CLI

스크립트, 파이프 및 CI에서 흔적을 남기지 않는 비밀 정보 관리 — 네트워크에 전달되기 전 로컬에서 암호화됩니다.

대상 사용자

비밀 정보가 이미 파일, 비밀번호 관리자 또는 파이프라인 출력에 있고, 채팅이나 이메일에 붙여넣지 않고 공유 가능한 링크가 필요한 경우 CLI를 사용하세요.

이 도구는 stdin 또는 파일 경로를 읽어 사용자의 기기에서 AES-256-GCM로 암호화한 후, 암호문만 업로드하고 프래그먼트에 복호화 키가 포함된 URL을 출력합니다.

이 방식으로 생성된 노트는 분석 데이터에 creationSource: cli로 기록됩니다.

설치

Node.js 18 이상이 필요합니다. macOS, Linux 및 Windows에서 작동합니다.

# Run once without installing
npx privatenote-cli --expire 1h --output-url-only

# Or install globally (adds the `privatenote` command)
npm install -g privatenote-cli

# Pipe a secret in scripts
cat secret.txt | privatenote --expire 1h --output-url-only

# Local self-host / wrangler dev (HTTP API — dev only)
echo "secret" | privatenote --insecure --api-base-url http://localhost:8787 --output-url-only

직접 사용해 보기

브라우저에서 CLI와 같은 흐름을 실행합니다. 로컬 암호화 후 암호문을 업로드하고 프래그먼트에 키가 포함된 URL을 출력합니다.

실시간 데모로 privatenote.ai에 실제 노트를 만듭니다. 운영 자격 증명 대신 일회용 비밀을 사용하세요.

echo 'sk-live-demo-replace-me' | npx privatenote-cli --expire 1h --output-url-only
https://privatenote.ai/note/…#…
# secret
--expire

보안 아키텍처

평문은 암호화되지 않은 상태로 기기를 절대 떠나지 않습니다. 공유 URL는 #fragment에 복호화 키를 포함하며, 브라우저와 HTTP 클라이언트는 이를 서버로 전송하지 않습니다.

stdout이 TTY가 아닌 경우(파이프 또는 캡처됨), --output-url-only 또는 --force-stdout을 전달하지 않으면 CLI가 링크 출력을 거부합니다. 이는 CI 로그로의 실수로 인한 유출을 방지합니다.

로컬 암호화

브라우저, 편집기, 터미널 또는 MCP 프로세스에서 기기의 AES-256-GCM을 사용합니다.

암호문 업로드

암호화된 바이트와 노트 메타데이터(만료, 읽은 후 삭제)만 서버에 전송됩니다.

키는 #fragment에 위치

복호화 키는 URL 해시에 유지됩니다. 브라우저는 HTTP 요청에 프래그먼트를 보내지 않습니다.

privatenote.ai/note/…#key

개발자 허브의 전체 다이어그램
  • 원격 API 오리진에는 HTTPS가 필요합니다. 로컬 http:// 개발 환경(예: :8787의 wrangler dev)에서만 --insecure를 사용하세요.

  • PRIVATENOTE_ALLOWED_HOSTS는 커스텀 API base URL를 사용할 때 API 호스트네임을 고정합니다.

  • 업로드 전 응답 형태 검증 및 예약된 노트 ID 확인.

  • URL을 출력하는 대신 출력을 chmod 600 파일로 리다이렉션하는 것을 권장합니다.

플래그 및 환경 변수

이름설명
--expire 15m|1h|24h|7d노트 수명 (기본값: 24h)
--burn / --no-burn첫 조회 후 파기 (기본값: burn)
--title <text>콘텐츠 앞에 추가할 선택적 제목
--json{ secureUrl, expiresAt, burnAfterReading } 출력
--output-url-onlyURL 전용 출력; 스크립트의 파이프 stdout에 안전함
--force-stdoutstdout이 터미널이 아닌 경우 출력 허용 (CI에서 --json과 함께 사용)
--api-base-url <url>API 오리진 재정의 (HTTPS; 로컬 http://의 경우 --insecure와 함께 사용)
--insecurehttp:// API 오리진 허용 — 로컬 개발 전용, 프로덕션에서는 절대 사용 금지
PRIVATENOTE_API_BASE_URL기본 API base URL
PRIVATENOTE_WEB_ORIGIN공유 링크 오리진 (API 오리진이 기본값)
PRIVATENOTE_ALLOWED_HOSTS쉼표로 구분된 호스트네임 허용 목록

관련 통합

PrivateNote CLI

스크립트, 파이프 및 CI에서 흔적을 남기지 않는 비밀 정보 관리 — 네트워크에 전달되기 전 로컬에서 암호화됩니다.

사진: Léna Le Roy · Unsplash.