PrivateNote CLI

Dữ liệu bí mật không để lại dấu vết trong các script, pipe và CI — được mã hóa cục bộ trước khi bất kỳ thứ gì được gửi lên mạng.

Công cụ này dành cho ai

Sử dụng CLI khi dữ liệu bí mật đã có sẵn trong một tệp, trình quản lý mật khẩu, hoặc đầu ra của pipeline và bạn cần một liên kết có thể chia sẻ mà không cần dán vào chat hoặc email.

Công cụ đọc từ stdin hoặc đường dẫn tệp, mã hóa bằng AES-256-GCM trên máy của bạn, chỉ tải lên bản mã (ciphertext), và in ra một URL với khóa giải mã nằm trong phần fragment.

Các ghi chú được tạo theo cách này sẽ được theo dõi là creationSource: cli trong phần phân tích.

Cài đặt

Yêu cầu Node.js 18+. Hoạt động trên macOS, Linux và 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

Thử trực tiếp

Chạy cùng quy trình CLI trong trình duyệt: mã hóa cục bộ, tải bản mã lên, in URL chứa khóa trong fragment.

Demo trực tiếp — tạo ghi chú thật trên privatenote.ai. Dùng bí mật dùng một lần, không dùng thông tin xác thực sản xuất.

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

Kiến trúc bảo mật

Văn bản thuần không bao giờ rời khỏi máy của bạn khi chưa được mã hóa. Liên kết chia sẻ URL mang theo khóa giải mã trong #fragment của nó, thứ mà các trình duyệt và client HTTP không gửi đến máy chủ.

Khi stdout không phải là TTY (được pipe hoặc capture), CLI sẽ từ chối in liên kết trừ khi bạn truyền --output-url-only hoặc --force-stdout — điều này ngăn chặn việc rò rỉ vô ý vào nhật ký CI.

Mã hóa cục bộ

AES-256-GCM trên thiết bị — trình duyệt, trình soạn thảo, thiết bị đầu cuối hoặc tiến trình MCP.

Tải lên bản mã

Chỉ các byte đã mã hóa và siêu dữ liệu ghi chú (hết hạn, xóa sau khi đọc) đến máy chủ.

Khóa trong #fragment

Khóa giải mã nằm trong phần sau dấu # của URL. Trình duyệt không gửi phần này trong yêu cầu HTTP.

privatenote.ai/note/…#key

Sơ đồ đầy đủ trên trung tâm nhà phát triển
  • HTTPS là bắt buộc cho các nguồn API từ xa; chỉ truyền --insecure cho môi trường phát triển http:// cục bộ (ví dụ: wrangler dev trên :8787).

  • PRIVATENOTE_ALLOWED_HOSTS ghim các hostname API khi sử dụng một API base URL tùy chỉnh.

  • Kiểm tra cấu trúc phản hồi và ID ghi chú đã được bảo lưu trước khi tải lên.

  • Ưu tiên chuyển hướng đầu ra sang tệp chmod 600 thay vì hiển thị URL.

Các cờ và biến môi trường

TênMô tả
--expire 15m|1h|24h|7dThời hạn ghi chú (mặc định: 24h)
--burn / --no-burnHủy sau lần xem đầu tiên (mặc định: burn)
--title <text>Tiêu đề tùy chọn được chèn vào trước nội dung
--jsonIn { secureUrl, expiresAt, burnAfterReading }
--output-url-onlyChỉ xuất URL; an toàn khi dùng pipe stdout trong script
--force-stdoutCho phép xuất đầu ra khi stdout không phải là terminal (sử dụng với --json trong CI)
--api-base-url <url>Ghi đè nguồn API (HTTPS; sử dụng với --insecure cho http:// cục bộ)
--insecureCho phép các nguồn API http:// — chỉ dùng cho phát triển cục bộ, không bao giờ dùng trong môi trường production
PRIVATENOTE_API_BASE_URLCơ sở API mặc định URL
PRIVATENOTE_WEB_ORIGINNguồn liên kết chia sẻ (mặc định là nguồn API)
PRIVATENOTE_ALLOWED_HOSTSDanh sách cho phép hostname cách nhau bởi dấu phẩy

Tích hợp liên quan

PrivateNote CLI

Dữ liệu bí mật không để lại dấu vết trong các script, pipe và CI — được mã hóa cục bộ trước khi bất kỳ thứ gì được gửi lên mạng.

Ảnh: Léna Le Roy · Unsplash.