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.
Trên trang này
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-onlyhttps://privatenote.ai/note/…#…
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
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ên | Mô tả |
|---|---|
| --expire 15m|1h|24h|7d | Thời hạn ghi chú (mặc định: 24h) |
| --burn / --no-burn | Hủ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 |
| --json | In { secureUrl, expiresAt, burnAfterReading } |
| --output-url-only | Chỉ xuất URL; an toàn khi dùng pipe stdout trong script |
| --force-stdout | Cho 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ộ) |
| --insecure | Cho 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_URL | Cơ sở API mặc định URL |
| PRIVATENOTE_WEB_ORIGIN | Nguồn liên kết chia sẻ (mặc định là nguồn API) |
| PRIVATENOTE_ALLOWED_HOSTS | Danh sách cho phép hostname cách nhau bởi dấu phẩy |
Tích hợp liên quan
Tiện ích mở rộng trình soạn thảo
Tạo ghi chú từ VS Code, Cursor, hoặc Codex IDE mà không cần chuyển đổi ngữ cảnh. Sử dụng thanh bên, lệnh văn bản đã chọn, hoặc hành động trên thanh tiêu đề.
Xem tài liệuMáy chủ MCP
Xem trước và xác nhận để mã hóa tệp cục bộ sau khi bạn phê duyệt.
Xem tài liệuPlugin Codex
Cài đặt plugin đi kèm cho MCP cùng các kỹ năng, hoặc thêm privatenote-mcp vào ~/.codex/config.toml. Sử dụng cùng một tiện ích mở rộng VS Code trong Codex IDE cho các thông tin bí mật mà agent không bao giờ thấy.
Xem tài liệuTiện ích Chrome
Mã hóa văn bản đã chọn từ bất kỳ tab nào thông qua menu ngữ cảnh, popup thanh công cụ, hoặc phím tắt — mà không cần mở trang web trước.
Xem tài liệuPrivateNote 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.
