PrivateNote CLI

اطلاعات حساس بدون ردپا در اسکریپت‌ها، پایپ‌ها و CI — رمزنگاری محلی قبل از ارسال به شبکه.

این ابزار برای چه کسی است

زمانی از CLI استفاده کنید که اطلاعات حساس از قبل در یک فایل، مدیریت رمز عبور یا خروجی پایپline قرار دارد و شما به یک لینک قابل اشتراک‌گذاری نیاز دارید بدون اینکه آن را در چت یا ایمیل کپی کنید.

این ابزار از stdin یا مسیر فایل می‌خواند، با استفاده از AES-256-GCM در دستگاه شما رمزنگاری می‌کند، فقط متن رمزنگاری شده را آپلود می‌کند، و یک URL به همراه کلید رمزگشایی در fragment چاپ می‌کند.

یادداشت‌های ایجاد شده به این روش در تحلیل‌ها به عنوان 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 با کلید در fragment.

نمایش زنده؛ یادداشت واقعی در 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 نباشد (پایپ شده یا کپچر شده باشد)، CLI از چاپ لینک خودداری می‌کند مگر اینکه --output-url-only یا --force-stdout را ارسال کنید — این کار از نشت تصادفی اطلاعات به لاگ‌های CI جلوگیری می‌کند.

رمزگذاری محلی

AES-256-GCM روی دستگاه شما — مرورگر، ویرایشگر، ترمینال یا فرایند MCP.

بارگذاری متن رمزگذاری‌شده

فقط بایت‌های رمزگذاری‌شده و فراداده یادداشت (انقضا، حذف پس از خواندن) به سرور می‌رسند.

کلید در #fragment

کلید رمزگشایی در بخش هش URL می‌ماند. مرورگرها بخش fragment را در درخواست‌های HTTP نمی‌فرستند.

privatenote.ai/note/…#key

نمودار کامل در مرکز توسعه‌دهندگان
  • HTTPS برای مبدأهای از راه دور API الزامی است؛ --insecure را فقط برای توسعه محلی http:// (مثلاً wrangler dev روی :8787) ارسال کنید.

  • PRIVATENOTE_ALLOWED_HOSTS نام‌های میزبان API را هنگام استفاده از یک API پایه URL سفارشی پین می‌کند.

  • اعتبارسنجی ساختار پاسخ و بررسی شناسه‌های رزرو شده یادداشت قبل از آپلود.

  • ترجیح داده می‌شود خروجی به جای چاپ URLها، به یک فایل با chmod 600 هدایت شود.

پرچم‌ها (Flags) و متغیرهای محیطی

نامتوضیح
--expire 15m|1h|24h|7dطول عمر یادداشت (پیش‌فرض: 24h)
--burn / --no-burnتخریب پس از اولین مشاهده (پیش‌فرض: burn)
--title <text>عنوان اختیاری که به ابتدای محتوا اضافه می‌شود
--jsonچاپ { secureUrl, expiresAt, burnAfterReading }
--output-url-onlyخروجی فقط URL؛ ایمن برای استفاده در stdout در اسکریپت‌ها
--force-stdoutاجازه دادن به خروجی زمانی که stdout یک ترمینال نیست (استفاده با --json در CI)
--api-base-url <url>بازنویسی منشأ API (HTTPS؛ استفاده با --insecure برای http:// محلی)
--insecureاجازه دادن به منشأهای http:// API — فقط برای توسعه محلی، هرگز در محیط عملیاتی
PRIVATENOTE_API_BASE_URLمقدار پیش‌فرض API base URL
PRIVATENOTE_WEB_ORIGINمنشأ لینک اشتراک‌گذاری (پیش‌فرض: منشأ API)
PRIVATENOTE_ALLOWED_HOSTSلیست سفید نام‌های میزبان (hostname) با جداکننده کاما

یکپارچه‌سازی‌های مرتبط

PrivateNote CLI

اطلاعات حساس بدون ردپا در اسکریپت‌ها، پایپ‌ها و CI — رمزنگاری محلی قبل از ارسال به شبکه.

عکس: Léna Le Roy · Unsplash.