PrivateNote CLI

Scriptlerde, boru hatlarında (pipes) ve CI süreçlerinde sıfır ayak izli sırlar — ağa ulaşmadan önce yerel olarak şifrelenir.

Kimler için

Sır zaten bir dosyada, parola yöneticisinde veya boru hattı çıktısında bulunuyorsa ve sohbet veya e-postaya yapıştırmadan paylaşılabilir bir bağlantıya ihtiyacınız varsa CLI kullanın.

Araç, stdin veya bir dosya yolundan okur, makinenizde AES-256-GCM ile şifreler, yalnızca şifreli metni yükler ve fragmanda şifre çözme anahtarını içeren bir URL yazdırır.

Bu şekilde oluşturulan notlar, analizlerde creationSource: cli olarak takip edilir.

Kurulum

Node.js 18+ gerektirir. macOS, Linux ve Windows üzerinde çalışır.

# 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

Canlı deneyin

CLI ile aynı akışı tarayıcınızda çalıştırın: yerel şifreleyin, şifreli metni yükleyin, anahtarı parçada olan bir URL yazdırın.

Canlı demo — privatenote.ai’de gerçek bir not oluşturur. Üretim kimlik bilgisi değil, atılabilir bir sır kullanın.

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

Güvenlik mimarisi

Düz metin (plaintext) makinenizden asla şifrelenmemiş olarak çıkmaz. Paylaşım URL, tarayıcıların ve HTTP istemcilerinin sunuculara göndermediği şifre çözme anahtarını #fragment içinde taşır.

stdout bir TTY olmadığında (pipe edilmiş veya yakalanmış), CLI siz --output-url-only veya --force-stdout parametrelerini geçmedikçe bir bağlantı yazdırmayı reddeder — bu, CI günlüklerine kazara sızıntıları önler.

Yerel şifrele

Cihazınızda AES-256-GCM — tarayıcı, düzenleyici, terminal veya MCP süreci.

Şifreli metni yükle

Sunucuya yalnızca şifreli baytlar ve not üst verisi (süre sonu, okuduktan sonra imha) ulaşır.

Anahtar #parçada

Çözme anahtarı URL karmasında kalır. Tarayıcılar parçaları HTTP isteklerinde göndermez.

privatenote.ai/note/…#key

Geliştirici merkezinde tam diyagram
  • Uzak API kökenleri için HTTPS gereklidir; yalnızca yerel http:// geliştirme ortamları için (örneğin :8787 üzerindeki wrangler dev) --insecure parametresini geçin.

  • PRIVATENOTE_ALLOWED_HOSTS, özel bir API taban URL kullanırken API ana bilgisayar adlarını sabitler.

  • Yükleme öncesinde yanıt yapısı doğrulaması ve ayrılmış not ID kontrolleri.

  • URL'leri ekrana yazdırmak yerine, çıktıyı chmod 600 bir dosyaya yönlendirmeyi tercih edin.

Bayraklar ve ortam değişkenleri

AdAçıklama
--expire 15m|1h|24h|7dNot ömrü (varsayılan: 24h)
--burn / --no-burnİlk görüntülemeden sonra yok et (varsayılan: burn)
--title <text>İçeriğin başına eklenen isteğe bağlı başlık
--json{ secureUrl, expiresAt, burnAfterReading } yazdır
--output-url-onlyURL-yalnızca çıktı; scriptlerde pipe edilmiş stdout için güvenlidir
--force-stdoutstdout bir terminal olmadığında çıktıya izin ver (CI'da --json ile kullanın)
--api-base-url <url>API kökenini geçersiz kıl (HTTPS; yerel http:// için --insecure ile kullanın)
--insecurehttp:// API kökenlerine izin ver — yalnızca yerel geliştirme, asla üretim ortamında değil
PRIVATENOTE_API_BASE_URLVarsayılan API taban URL
PRIVATENOTE_WEB_ORIGINPaylaşım bağlantısı kökeni (API kökenini varsayılan olarak kullanır)
PRIVATENOTE_ALLOWED_HOSTSVirgülle ayrılmış ana bilgisayar izin listesi

İlgili entegrasyonlar

PrivateNote CLI

Scriptlerde, boru hatlarında (pipes) ve CI süreçlerinde sıfır ayak izli sırlar — ağa ulaşmadan önce yerel olarak şifrelenir.

Fotoğraf: Léna Le Roy · Unsplash.