حِزم SDK
SDK Ruby
nanoflags الأعلام محليًا وبشكل متزامن على إعداد موقّع في الذاكرة، وتُبقيه خيوطٌ في الخلفية محدّثًا، والعميل آمن مع تعدد الخيوط ومع التفرّع (fork). واستدعاء القراءة لا يُجري أي عملية إدخال/إخراج ولا يرفع استثناءً أبدًا.في هذه الصفحة
التثبيت
gem "nanoflags"
gem "nanoflags-openfeature" # optional: OpenFeature provider- منشورة على RubyGems باسم nanoflags 0.2.0 وnanoflags-openfeature 0.2.0. تتطلب Ruby 3.1 أو أحدث.
- بلا اعتماديات وقت التشغيل: Net::HTTP والمقابس (sockets) وOpenSSL (Ed25519) وJSON من المكتبة القياسية. وعميل WebSocket للتحديثات الحيّة تنفيذ صغير مدمج لمعيار RFC 6455.
- المحرك نقلٌ أصلي لمحرك NanoFlags، مختبَر على الحالات المشتركة المولَّدة من المحرك المرجعي (21,998 حالة تقييم)، فيعطي النتائج نفسها التي تعطيها كل حزم SDK الأخرى.
- برخصة Apache-2.0. والشيفرة المصدرية في nanoflags-sdk/ruby.
البدء السريع
انسخ مفتاح خادم (nf_srv_…) من الإعدادات ← مفاتيح SDK (Settings → SDK keys) في لوحة التحكم واحفظه في متغير بيئة. ومرّر on_error: إلى المُنشئ ليُسجَّل قبل بدء التحميل الأول، ثم انتظر الجاهزية.
require "nanoflags"
FLAGS = NanoFlags::Client.new(
ENV.fetch("NANOFLAGS_SDK_KEY"), # nf_srv_… (server view) or nf_pub_… (client-exposed flags only)
service: "checkout-api", # shown in "which revision is each service running"
on_error: ->(e) { warn "nanoflags #{e.code}: #{e.message}" }
)
FLAGS.wait_until_ready(5) # never raises; true once a configuration is in use
user = { key: current_user.id.to_s, plan: current_user.plan, country: "DE" }
if FLAGS.bool_variation("new-checkout", false, user)
# …
end- أنشئ عميلًا واحدًا لكل عملية وشاركه بين الخيوط. والعنوان الأساسي افتراضيًا هو الحافة المستضافة
https://edge.nanoflags.io. - السياق Hash من خصائص شبيهة بـ JSON (بمفاتيح String أو Symbol؛ وتتحول
TimeوDateإلى نصوص ISO 8601). وkeyهو الهوية الثابتة المستخدمة في الطرح بالنسب المئوية. - يتلقى المسجّل الذي تمرّره في
logger:تشخيصات العميل بمستوى debug، ويحملlast_errorدائمًا آخر خطأ.
القراءات المُنمَّطة والتفاصيل
enabled = FLAGS.bool_variation("new-checkout", false, user)
accent = FLAGS.string_variation("accent", "blue", user)
limit = FLAGS.number_variation("rate-limit", 100, user) # Integer for whole numbers, else Float
layout = FLAGS.json_variation("layout", { "cols" => 3 }, user) # Hash with String keys
every = FLAGS.all_flags(user) # no telemetry
d = FLAGS.bool_variation_detail("new-checkout", false, user)
d.value # => true
d.reason # => "rule_match"
d.rule_id # => "beta"
d.revision # => 57
d.trace # the same steps the dashboard shows| الحقل | المعنى |
|---|---|
value | القيمة المقدَّمة (قيمتك الافتراضية في حالات الاحتياط). |
reason | "rule_match"، "default" (لم تطابق قاعدة)، "off" (العلم معطّل)، "flag_not_found"، "error" (نوع خاطئ أو إعداد مشوّه) |
rule_index · rule_id | القاعدة المطابقة (فهرس يبدأ من الصفر)، أو nil. |
in_rollout · bucket | للطرح بالنسب المئوية: هل المفتاح داخل التوزيع، وشريحته (من 0 إلى 99.99). |
revision | نسخة الإعداد التي جاءت منها النتيجة. |
trace | قائمة من NanoFlags::Engine::TraceStep تشرح القرار خطوة بخطوة. |
error · json · type_name | لماذا كان reason هو "error"؛ والقيمة الخام كنص JSON واسم نوعها. |
كل دالة قراءة تأخذ مفتاح العلم والقيمة الافتراضية وسياقًا اختياريًا. وتحصل على قيمتك الافتراضية عندما لم يُحمَّل إعداد بعد، أو عندما يكون العلم مجهولًا، أو عندما يقدّم قيمة من نوع آخر. والعلم المعطّل ليس حالة احتياط: فهو يعيد قيمة off المضبوطة له. وتعيد evaluate(key, default, context) نتيجة المحرك دون فحص للنوع.
التحديثات الحيّة والمستمعات
يُبقي العميل اتصال WebSocket واحدًا بنقطة الحافة /v1/live مفتوحًا (بالبروتوكول الفرعي nanoflags.v1، وينتقل المفتاح في ترويسة Authorization، لا في العنوان أبدًا)، وهو البروتوكول نفسه الذي تستخدمه حزم JavaScript وPython وGo وJava. ترسل الحافة الحزمة الحالية عند الاتصال، ثم كل نسخة جديدة فور نشرها. ويُتحقَّق من كل حزمة مدفوعة تمامًا كالحزمة المجلوبة قبل استبدالها ذرّيًا، فيرى التقييم دائمًا نسخة واحدة كاملة؛ والحزمة المدفوعة التي لا تجتاز التحقق لا تغيّر شيئًا، وتستدعي طلبًا عاديًا بدلًا منها.
off = FLAGS.on_change { |e| puts "now on r#{e.revision} (was r#{e.previous_revision}) via #{e.transport}" }
FLAGS.on(:status) { |status| puts "nanoflags status: #{status}" } # "not-ready", "ready" or "stale"
off.call # unsubscribe| الحقل | المعنى |
|---|---|
revision · previous_revision | النسخة الجديدة والنسخة التي حلّت محلها (nil للأولى). |
checksum | المجموع الاختباري للإعداد الجديد. |
source | :network أو :store أو :bootstrap |
transport | :live (دُفعت عبر WebSocket) أو :stream (جُلبت بعد إشعار من تدفق الأحداث) أو :poll |
latency_ms | للنسخ المدفوعة التي تحمل وقت اعتمادها: المدة بالمللي ثانية من اعتماد قاعدة البيانات حتى هذا الحدث؛ وإلا فـ nil. |
- تعمل المستمعات على خيوط الخلفية التابعة للعميل: اجعلها قصيرة. والاستثناء داخل مستمع يُسجَّل ولا يعطّل العميل أبدًا. وتعيد
on(:change | :error | :status)وon_changeوon_errorدالة lambda لإلغاء الاشتراك. - يكشف
pingنصّي كل 30 ثانية تقريبًا الاتصالات الميتة، ويُستبدل المقبس بعد نحو 50 دقيقة. وتتباعد محاولات إعادة الاتصال 1 ثم 2 ثم 4 ثوانٍ وهكذا حتى 5 دقائق. وما دام المقبس سليمًا لا يعمل الاستطلاع إلا كلlive_poll_interval(300 ثانية) كشبكة أمان. ويتخطىlive: falseالمقبس. - يعني رمز الإغلاق
4004أن بيئة المفتاح حُذفت: يبقى آخر إعداد قيد الاستخدام، وتصبحstatusبقيمة"stale"، ويتلقىon_errorالرمز:environment_deleted، ويتوقف العميل عن إعادة الاتصال. - البديل. ما دام تعذّر فتح مقبس (وسيط يرفض الترقية مثلًا)، يُبقي العميل تدفق الأحداث
GET /v1/streamمفتوحًا: كل حدثrevisionيجعله يجلب/v1/bundleمعIf-None-Match، ويتحقق من الحزمة ويستبدلها. ويلتقط الاستطلاع كلpoll_interval(30 ثانية؛ و0يعطّله) ما قد يفوتهما معًا. وبعد الأعطال يعيد المحاولة بعد 1 ثم 2 ثم 4 ثوانٍ وهكذا حتى فترة الاستطلاع؛ وتتباعد محاولات إعادة اتصال التدفق حتى 30 ثانية. ويستخدمstreaming: falseالاستطلاع وحده.
الجاهزية والحالة
unless FLAGS.wait_until_ready(5)
Rails.logger.warn("flags not loaded yet (#{FLAGS.last_error&.message}); variations return their defaults")
end
FLAGS.status # "not-ready" | "ready" | "stale"
FLAGS.revision # revision in use, or nil
FLAGS.transport # :live | :stream | :poll
FLAGS.initialized? # true once a configuration is in use- تنتظر
wait_until_ready(timeout)حتى يصبح إعداد قيد الاستخدام أو تفشل محاولة التحميل الأولى، لمدةtimeoutثانية على الأكثر (وnil: بلا حد). ولا ترفع استثناءً أبدًا. "ready": الإعداد معروف أنه محدّث."stale": هناك إعداد قيد الاستخدام لكن لا يُعرف أنه محدّث."not-ready": لم يُحمَّل شيء، وكل قراءة تعيد قيمتها الافتراضية.- لا تجعل أي طلب ينتظر الجاهزية. انتظر مرة واحدة عند الإقلاع بمهلة قصيرة، ودع قيمك الافتراضية تغطي الباقي.
Puma وUnicorn والأمان عند التفرّع
العميل آمن عند التفرّع (Puma وUnicorn وPassenger وResque وSidekiq Swarm). يحتفظ العامل المتفرّع بالإعداد الذي ورثه، فيستطيع التقييم فورًا، وعند أول استدعاء يعيد تشغيل خيوط الخلفية الخاصة به ويفتح مقبسه الحي الخاص؛ ولا يُمسّ اتصال العملية الأم أبدًا. والأحداث المنتظرة قبل التفرّع لا ترسلها إلا العملية الأم، وتُورَث جلسات الاختبار المخزّنة مؤقتًا.
preload_app!
on_worker_boot { NanoFlags::Client.after_fork } # start each worker's threads right away- تعيد
NanoFlags::Client.after_forkتشغيل خيوط الخلفية لكل عميل في العملية الابنة فورًا. وهي اختيارية: من دونها يلاحظ العميل التفرّع عند أول استدعاء فيعيد التشغيل حينها. - مع
preload_app!لا بأس بإنشاء العميل في العملية الرئيسية. وإن كان يجب ألا تفتح العملية الرئيسية أي اتصال، فمرّر هناكstart: falseواستدعِFLAGS.startداخلon_worker_boot: فالعميل المنشأ بـstart: falseلا يبدأ إلا حين تُستدعىstart. - مع Unicorn: استدعِ
NanoFlags::Client.after_forkمنafter_forkفيconfig/unicorn.rb.
Rails وSidekiq
Rails.application.config.after_initialize do
NANOFLAGS = NanoFlags::Client.new(
Rails.application.credentials.nanoflags_sdk_key,
service: "web",
cache_path: Rails.root.join("tmp/nanoflags.json"), # optional: start from the last good bundle
logger: Rails.logger
)
endيستخدم Sidekiq وغيره من العمّال متعددي الخيوط العميلَ نفسه على مستوى العملية في كل مهمة؛ والتقييمات قراءات بلا أقفال للحزمة الحالية. ولا تستدعِ close عند الإيقاف إلا إن احتجت إلى إرسال القياس الأخير بشكل متزامن: فخطاف at_exit يفعل ذلك أيضًا.
جلسات الاختبار
تثبّت جلسة الاختبار المشتركة (بالإنجليزية)، التي تُنشأ في لوحة التحكم (السيناريوهات ← جلسة اختبار مشتركة، Scenarios → Shared test session)، لقطةً من الإعداد وسياقًا اصطناعيًا على رمز (nf_ts_…). والخدمة التي تتلقى الرمز في ترويسة x-nanoflags-session تقيّم على تلك اللقطة، بالسياق session.context.merge(your_context)، لذلك الطلب وحده. وتحمل الأحداث المأخوذة كعيّنة من جلسة معرّفَها. وجلسات الاختبار المشتركة جزء من خطة Scale.
# any Rack app: use NanoFlags::SessionMiddleware, FLAGS
config.middleware.use NanoFlags::SessionMiddleware, FLAGS # reads x-nanoflags-session, resolves it once per request# a controller
flags = request.env["nanoflags.flags"] # or NanoFlags.flags_for(FLAGS) where there is no request
flags.bool_variation("checkout-v2", false, { key: current_user.id }) # session-scoped while the session is active
flags.active? # false when unknown, expired, revoked or not permitted here
# downstream calls join the session ({} outside one, always safe to merge)
Faraday.get(PRICING_URL, nil, NanoFlags.session_headers)
# jobs: pass the token along and resolve it in the worker
PriceJob.perform_async(order.id, NanoFlags.current_session)
NanoFlags.with_session(token) { NanoFlags.flags_for(FLAGS).bool_variation("checkout-v2", false, { key: user_id }) }
# or directly
s = FLAGS.session(request.headers["x-nanoflags-session"], service: "checkout-api")
s.id; s.expires_at; s.revision- تسأل
FLAGS.session(token, service:)الحافة مرة واحدة لكل رمز وخدمة (GET /v1/session، والرمز فيX-NanoFlags-Session، وserviceفيX-NanoFlags-Service، وافتراضيًاserviceالخاصة بالعميل)، وتخزّن الجواب مؤقتًا حتى تنتهي الجلسة. وتُتذكَّر الرموز المجهولة 15 ثانية، وعمليات البحث الفاشلة 3 ثوانٍ (أخطاء:session). والطلبات المتزامنة بالرمز الجديد نفسه تنتظر بحثًا واحدًا. - لا ترفع استثناءً أبدًا. والرمز المجهول أو المنتهي أو الملغى أو غير المسموح به يعود إلى الإعداد العادي: يتصرّف المقيّم تمامًا كالعميل، فيخدم مسار شيفرة واحد الحركة العادية والاختبارات. وإن انتهت الجلسة أثناء الطلب تصبح
active?خاطئة وتستمر التقييمات على الإعداد المنشور. - تعيش الجلسة الحالية في تخزين الألياف (
Fiber[]، وترثها الخيوط والألياف التي تبدأ داخلها في Ruby 3.2 فأحدث؛ ومحلية للليف في 3.1). ولا يُخزَّن شيء على العميل. وتنتهي جلسة الوسيط عندما تعودcall. - تغيّر الجلسة اللقطة والسياق اللذين يستخدمهما التقييم فقط. فهي لا تمنح أي وصول إلى البيانات ولا يجوز استخدامها للتفويض. ولا تتلقى مفاتيح العميل إلا الأعلام المكشوفة للعميل، في الجلسات أيضًا. وحزم الجلسات غير موقّعة، فلا ينطبق عليها التحقق. والجلسة الملغاة تظل تعمل في عملية خزّنتها مؤقتًا حتى تنتهي.
| الواجهة | الوصف |
|---|---|
session(token, service: nil) | تعيد NanoFlags::SessionEvaluator: القراءات المُنمَّطة وتفاصيلها، وevaluate وactive? وid وexpires_at وrevision. |
NanoFlags::SessionMiddleware | وسيط Rack: يضبط env["nanoflags.flags"] ويشغّل بقية الطلب داخل الجلسة. |
NanoFlags.with_session(token) { … } | تشغّل الكتلة والرمز هو الجلسة الحالية. والرمز الغائب أو المشوّه يشغّلها خارج أي جلسة. |
NanoFlags.flags_for(client) | مقيّم الطلب الحالي، يُحلّ مرة واحدة لكل طلب وعميل؛ وخارج الجلسة يتصرّف كالعميل. |
NanoFlags.current_session · NanoFlags.session_headers | الرمز الحالي (أو nil)؛ و{ "x-nanoflags-session" => token } داخل الجلسة، وإلا {}. |
NanoFlags::SESSION_HEADER | "x-nanoflags-session" |
آخر إعداد سليم والتهيئة المسبقة
بعد التحميل يبقى آخر إعداد سليم قيد الاستخدام رغم أعطال الشبكة والحزم المرفوضة وأخطاء الحافة (فتصبح status بقيمة "stale").
FLAGS = NanoFlags::Client.new(sdk_key, cache_path: "tmp/flags.json") # keep the last good bundle
FLAGS = NanoFlags::Client.new(sdk_key, store: NanoFlags::Store::Cache.new(Rails.cache)) # share it through an ActiveSupport cache
FLAGS = NanoFlags::Client.new(sdk_key, bootstrap: File.read("flags-bootstrap.json")) # serve a bundle you ship until the edge answers- يكتب
cache_pathذرّيًا بالصلاحية0600، ويستعيد الحزمة عند البدء بحالة"stale"حتى تؤكدها الحافة. ويُتحقَّق من النسخة المستعادة مجددًا، وتُتجاهل إن لم تجتز التحقق. - يأخذ
store:أي كائن لهgetوset(text). ويأخذbootstrap:قيمة Hash أو نص JSON. - تحمل الذاكرة المؤقتة قواعد الأعلام، ولا تحمل مفتاح الـ SDK أبدًا.
التحقق من التوقيع
تُفحص كل حزمة (Ed25519 على السلسلة المعيارية، حسب معرّف المفتاح) قبل أن تحلّ محل الحالية. ومع الحافة المستضافة يكون ذلك مفعّلًا افتراضيًا بمفاتيح الإنتاج المضمّنة في الجوهرة (NanoFlags::OFFICIAL_SIGNING_KEYS)، وتُرفض الحزم غير الموقّعة. وتُجزَّأ البايتات الموقّعة الخام كما قُدّمت تمامًا.
# Self-hosted or proxied edge: pin your keys and require signatures
FLAGS = NanoFlags::Client.new(
sdk_key,
base_url: "https://flags.internal.example",
verify: { public_keys: [{ "kty" => "OKP", "crv" => "Ed25519", "x" => "…", "kid" => "k1" }], require: true }
)- الحزمة التي لا تجتاز التحقق لا تُستخدم: تبقى السابقة، ويتلقى
on_errorالرمز:signature. - الحزمة التي تذكر معرّف مفتاح مجهولًا (تدوير المفاتيح) تحمّل
GET /v1/keysمرة واحدة، وعلى الأكثر مرة في الدقيقة. ومع حافة مستضافة ذاتيًا يستخدمverify: true(أوfetch_keys: true) المسار/v1/keysلتلك الحافة؛ ويعطّلverify: falseالتحقق. - تُرفض الحزم الموقّعة لبيئة غير أول بيئة قُبلت.
- تُرفض الحزم المكتوبة لمحرك تقييم أحدث من
NanoFlags::Engine::VERSION(بالرمز:engine) ويبقى الإعداد الحالي قيد الاستخدام: حدّث الجوهرة. والسلسلة المعيارية موصوفة في التواقيع.
القياس والإخفاء
تُرسل عيّنة 10 % من التقييمات كل 10 ثوانٍ، مع بلاغ خدمة كل 60 ثانية. وافتراضيًا لا تغادر قيم السياق العملية أبدًا: لا يُرسل إلا أسماء الخصائص التي تستخدمها قواعد العلم (وأنواع قيمها)، مثل {"plan" => "string"}.
FLAGS = NanoFlags::Client.new(
sdk_key,
events: { sample_rate: 0.05, redact: ->(ctx) { { plan: ctx[:plan] } } } # what leaves the process
)
QUIET = NanoFlags::Client.new(sdk_key, events: false) # no telemetry at allتتلقى redact نسخة من السياق الذي مرّرته وتعيد قيمة Hash التي تُرسل بدل الافتراضي. ويرسل flush الأحداث المنتظرة فورًا.
مزوّد OpenFeature
gem "nanoflags-openfeature"require "nanoflags/openfeature"
nanoflags = NanoFlags::Client.new(ENV.fetch("NANOFLAGS_SDK_KEY"), service: "checkout-api")
OpenFeature::SDK.configure do |config|
config.set_provider_and_wait(NanoFlags::OpenFeature::Provider.new(nanoflags, ready_timeout: 10))
end
client = OpenFeature::SDK.build_client
ctx = OpenFeature::SDK::EvaluationContext.new(targeting_key: current_user.id.to_s, plan: current_user.plan)
client.fetch_boolean_value(flag_key: "new-checkout", default_value: false, evaluation_context: ctx)
client.fetch_string_details(flag_key: "accent", default_value: "blue", evaluation_context: ctx)- لـ
openfeature-sdk0.4 أو أحدث (والإصدار 0.6 وما بعده يتطلب Ruby 3.4). تنتظرinitمدةready_timeoutثانية على الأكثر لأول إعداد، وتفشل (حالة خطأ للمزوّد) إن تعذّر تحميل أي إعداد؛ ويواصل العميل المحاولة في الخلفية. ويغلقclose_client: trueعميل NanoFlags عندshutdown. - يصبح مفتاح الاستهداف هو
keyفي NanoFlags (ويتقدّم على خاصية اسمهاkey). الأسباب:DISABLEDوDEFAULTوTARGETING_MATCHوSPLIT(والمتغيّر هو معرّف القاعدة). والأخطاء:FLAG_NOT_FOUND(أوPROVIDER_NOT_READYما دام لم يُحمَّل شيء) وTYPE_MISMATCHوGENERAL. - جلسات الاختبار: مرّر
evaluator: -> { NanoFlags.flags_for(nanoflags) }إلىProvider.newليقيّم عبر جلسة الطلب (التي يحلّهاNanoFlags::SessionMiddlewareأوNanoFlags.with_session). وخارج الجلسة يتصرّف تمامًا كالعميل. - تحمل بيانات العلم الوصفية
revisionالمقيَّمة (مع openfeature-sdk 0.5 فأحدث). ومع إصدارات SDK التي تدعم أحداث المزوّد، تطلق النسخة الجديدةPROVIDER_CONFIGURATION_CHANGED، وتطلق تغيّرات الحالةPROVIDER_READYوPROVIDER_STALE(وPROVIDER_ERRORما دام لم يُحمَّل شيء).
الخيارات
| الخيار | الافتراضي | الوصف |
|---|---|---|
base_url: | https://edge.nanoflags.io | عنوان الحافة. |
service: | "unknown" | الاسم الذي تُبلّغ به هذه العملية. |
poll_interval: | 30 | الثواني بين عمليات الاستطلاع ما دام لا مقبس حيًّا مفتوحًا. و0 يعطّل الاستطلاع. |
streaming: | true | تلقّي النسخ الجديدة دون استطلاع (WebSocket الحي، وإلا تدفق الأحداث). وfalse يُبقي الاستطلاع وحده. |
live: | true | false يتخطى WebSocket الحي ويستخدم تدفق الأحداث والاستطلاع. |
live_poll_interval: | 300 | الثواني بين استطلاعات الأمان ما دام المقبس الحي سليمًا. |
live_url: | مشتق من base_url | عنوان WebSocket لـ /v1/live عندما لا يكون base_url مع ws(s):// (متقدّم). |
cache_path: · store: · bootstrap: | لا شيء | انظر آخر إعداد سليم. |
verify: | مفعّل للحافة المستضافة | true أو false أو { public_keys:, require:, fetch_keys: }. |
events: | عيّنة 10 % | false أو { sample_rate:, flush_interval:, report_interval:, redact: }. |
on_change: · on_error: | لا شيء | مستمعات تُسجَّل قبل التحميل الأول. |
logger: | لا شيء | كائن Logger (مثل Rails.logger). |
start: | true | false يؤجل العمل في الخلفية حتى تستدعي start. |
request_timeout: · http: | 10 · Net::HTTP | مهلة HTTP بالثواني، ومحوّل HTTP. |
رموز الأخطاء
تصل الأخطاء إلى on_error كـ NanoFlags::Error له code (وhttp_status عند الحاجة): :network و:unauthorized و:http و:invalid_bundle و:store و:config و:signature و:engine و:session و:environment_deleted. ولا يغيّر تحديثٌ فاشل الإعدادَ المستخدم أبدًا، ولا يُرفع أي شيء من استدعاء قراءة.
الإغلاق والإيقاف
- يوقف
closeخيوط الخلفية بعد محاولة أخيرة لإرسال القياس (ثانيتان على الأكثر). واستدعاؤه أكثر من مرة آمن. وخطافat_exitيغلق كل العملاء نيابةً عنك. - بعد
closeتواصل القراءات العمل على آخر إعداد، لكنه يتوقف عن التحديث فقط. ويعيدrefreshالتحقق فورًا ويعيد هل هناك إعداد قيد الاستخدام.
حل المشكلات
- كل قراءة تعيد القيمة الافتراضية. افحص
statusوlast_error. يعني:unauthorizedأن المفتاح رُفض؛ ومع مفتاح متصفح (nf_pub_…) لا تُسلَّم إلا الأعلام المكشوفة للعميل. - العمّال لا يرون النسخ الجديدة أبدًا. تأكد من أن العميل في كل عامل قد بدأ: استدعِ
NanoFlags::Client.after_forkمن خطاف إقلاع العامل في الخادم، أو قيّم مرة واحدة (فأول استدعاء يعيد تشغيل الخيوط بعد التفرّع). والعميل المنشأ بـstart: falseيحتاج إلى استدعاءstartصراحةً. - خلف وسيط أو مع سلطة شهادات مخصّصة. يحترم HTTP وWebSocket المتغيرات
HTTPS_PROXY/NO_PROXY(عبر نفق CONNECT) وSSL_CERT_FILE. وإن حُجبت ترقيات WebSocket تُظهرtransportالقيمة:stream، وإن حُجب تدفق الأحداث أيضًا فـ:poll. - أخطاء بالرمز
:signature. لم تجتز الحزمة التحقق فلم تُستخدم. وإن مرّرتbase_urlمخصّصًا فثبّت مفاتيح تلك الحافة عبرverify:. - أخطاء بالرمز
:environment_deleted. أغلقت الحافة المقبس بالرمز4004. يتوقف العميل عن إعادة الاتصال ويُبقي آخر إعداد بحالة"stale"؛ استبدل المفتاح.