PrivateNote CLI

أسرار بدون أثر في البرامج النصية، والأنابيب (pipes)، وCI — يتم تشفيرها محلياً قبل وصول أي شيء إلى الشبكة.

لمن هذه الأداة

استخدم CLI عندما يكون السر موجوداً بالفعل في ملف، أو مدير كلمات مرور، أو مخرجات خط أنابيب (pipeline) وتحتاج إلى رابط قابل للمشاركة دون اللصق في الدردشة أو البريد الإلكتروني.

تقرأ الأداة من 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 في متصفحك: شفّر محليًا، وارفع النص المشفر، ثم اطبع رابطًا بمفتاح في الجزء 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

يبقى مفتاح فك التشفير في الجزء بعد # من الرابط. لا ترسل المتصفحات أجزاء الرابط هذه في طلبات HTTP.

privatenote.ai/note/…#key

المخطط الكامل في مركز المطوّرين
  • مطلوب HTTPS لأصول API البعيدة؛ مرر --insecure فقط لبيئة التطوير المحلية http:// (مثل wrangler dev على :8787).

  • تقوم PRIVATENOTE_ALLOWED_HOSTS بتثبيت أسماء مضيفات API عند استخدام API base URL مخصص.

  • التحقق من شكل الاستجابة وفحوصات معرف الملاحظة المحجوز قبل الرفع.

  • يفضل إعادة توجيه المخرجات إلى ملف chmod 600 بدلاً من عرض الروابط.

الأعلام ومتغيرات البيئة

الاسمالوصف
--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 الافتراضي URL
PRIVATENOTE_WEB_ORIGINأصل رابط المشاركة (الافتراضي هو أصل API)
PRIVATENOTE_ALLOWED_HOSTSقائمة السماح بأسماء المضيفين مفصولة بفاصلة

تكاملات ذات صلة

PrivateNote CLI

أسرار بدون أثر في البرامج النصية، والأنابيب (pipes)، وCI — يتم تشفيرها محلياً قبل وصول أي شيء إلى الشبكة.

الصورة: Léna Le Roy · Unsplash.