ثبّت جاردرينو في أربع خطوات

قبل أن تبدأ

صُمِّم جاردرينو برنامجًا صغيرًا واحدًا يعمل بوابةً بواجهة برمجية متوافقة مع OpenAI. ترسل تطبيقاتك طلباتها إلى جاردرينو بدلًا من إرسالها مباشرة إلى مزوّد النموذج، فيفحص جاردرينو كل رسالة ثم يمرّرها. تصلك الحزمة من HisnLabs مع برنامجك التجريبي، وتحمل كل ما تحتاج إليه، بما في ذلك النماذج.

الخطوة 1 · التثبيت

تحقّق من الحزمة أولًا، ثم ثبّتها. اختر الطريقة التي تناسب خادمك.

Linux

يضع المثبِّت البرنامج في /opt/guardrino، وينشئ مستخدم نظام guardrino وخدمة systemd.

sha256sum -c guardrino-<version>.sha256
tar xzf guardrino-<version>-linux-x86_64.tar.gz
cd guardrino-<version>
sudo ./install.sh

Linux، داخل حاوية

تحتوي الحزمة نفسها أيضًا على صورة حاوية، للخوادم التي تستخدم Docker.

docker load -i guardrino-<version>-image.tar
docker run -d --name guardrino --restart unless-stopped \
  -p 8080:8080 \
  -v /etc/guardrino:/etc/guardrino \
  --env-file /etc/guardrino/guardrino.env \
  guardrino:<version>

Windows

في PowerShell بصلاحيات المسؤول. يضيف المثبِّت خدمة Windows باسم Guardrino.

# PowerShell, run as Administrator
Get-FileHash .\guardrino-<version>-x64.msi -Algorithm SHA256
# Compare the hash with the value HisnLabs gives you, then:
msiexec /i guardrino-<version>-x64.msi /qn

الخطوة 2 · الإعداد

كل ما يفعله جاردرينو يُضبط في ملف سياسة واحد: /etc/guardrino/guardrino.toml على Linux، وC:\ProgramData\Guardrino\guardrino.toml على Windows. ابدأ بوضع المراقبة: يسجّل جاردرينو ما كان سيفعله ولا يغيّر شيئًا.

mode = "observe"                # watch only: nothing is blocked while you tune
port = 8080

[upstream]
url = "https://llm-provider.example/v1"   # your model provider or model server
api_key_env = "UPSTREAM_API_KEY"          # the key is read from the environment, never written here

[l1]                            # rules layer
personal_data = "mask"
secret = "block"

[l2]                            # classifier layer
action = "block"
on_error = "allow"

upstream هو المكان الذي تذهب إليه طلباتك اليوم: مزوّد النموذج أو خادم النماذج الخاص بك. يبقى مفتاحه في بيئتك أو في خزنة الأسرار الخاصة بك، ولا يُكتب أبدًا في ملف السياسة.

# Readable by the guardrino service only
sudo install -m 600 -o guardrino /dev/null /etc/guardrino/guardrino.env
echo 'UPSTREAM_API_KEY=<your provider key>' | sudo tee /etc/guardrino/guardrino.env > /dev/null

[Environment]::SetEnvironmentVariable('UPSTREAM_API_KEY', '<your provider key>', 'Machine')

الفئات والعتبات والإجراءات في مرجع المطوّرين

الخطوة 3 · التشغيل والتحقق

شغّل الخدمة واسألها عن حالتها.

sudo systemctl enable --now guardrino
curl http://localhost:8080/health

Start-Service Guardrino
Invoke-RestMethod http://localhost:8080/health

إجابة توضيحية:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "ok",
  "version": "<version>",
  "mode": "observe",
  "policy": "loaded",
  "model": "guardrino-t7-2610"
}

الخطوة 4 · ربط تطبيقك

غيّر سطرًا واحدًا: العنوان الأساسي (base URL). تبقى موجّهاتك ونماذجك وبقية الشيفرة كما هي. يرمز guardrino.internal إلى اسم خادم جاردرينو على شبكتك.

from openai import OpenAI

# The only change: the base URL points at Guardrino instead of the provider.
client = OpenAI(base_url="http://guardrino.internal:8080/v1")

reply = client.chat.completions.create(
    model="<your-model>",
    messages=[{"role": "user", "content": "Hello"}],
)

import OpenAI from 'openai'

// The only change: the base URL points at Guardrino instead of the provider.
const client = new OpenAI({ baseURL: 'http://guardrino.internal:8080/v1' })

const reply = await client.chat.completions.create({
  model: '<your-model>',
  messages: [{ role: 'user', content: 'Hello' }],
})

curl http://guardrino.internal:8080/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<your-model>", "messages": [{"role": "user", "content": "Hello"}]}'

تمرّ الرسائل المسموح بها دون تغيير، وتمرّ الرسائل المُخفاة بعد استبدال البيانات الشخصية، وتعود الرسالة المرفوضة رفضًا واضحًا يستطيع تطبيقك عرضه. حقول القرار موصوفة في مرجع المطوّرين. ومكان مفتاح المزوّد قرارك: يمكن لتطبيقاتك أن تواصل إرساله، أو أن يبقى لدى جاردرينو وحده فلا تحمله التطبيقات أبدًا.

الاستجابات في مرجع المطوّرين

تشغّل خادم نماذج خاصًا بك؟ اطّلع على vLLM وKubernetes وOpenShift AI وغيرها

راقب، ثم طبّق

دع جاردرينو يراقب الحركة الحقيقية في وضع المراقبة أولًا. يبيّن سجل التدقيق لكل رسالة ما كان سيُخفيه أو ينبّه إليه أو يحظره، فتضبط السياسة قبل أن يتأثر أحد. وحين يرضيك ما تراه، غيّر سطرًا واحدًا وأعد التشغيل.

mode = "enforce"                # was "observe"

sudo systemctl restart guardrino
# or, in a container:
docker restart guardrino

Restart-Service Guardrino

التحديثات، دون اتصال

• تصل التحديثات من HisnLabs في حزم موقّعة، بما فيها النماذج. يتحقق المثبِّت من التوقيع ويرفض أي حزمة لا تطابقه.
• تُطبَّق التحديثات بالطريقة نفسها التي ثبّتّ بها: تحقّق، ثم شغّل المثبِّت. يبقى ملف السياسة وسجل التدقيق كما هما.
• لا شيء يحتاج إلى اتصال بالإنترنت: يمكن نقل الحزم إلى شبكة معزولة.

إلغاء التثبيت

إزالة جاردرينو تُبقي ملف السياسة وسجل التدقيق، ما لم تحذفهما أيضًا.

sudo /opt/guardrino/uninstall.sh
# or, in a container:
docker rm -f guardrino

# Optional: remove the configuration and the audit log too
sudo rm -r /etc/guardrino /var/log/guardrino

msiexec /x guardrino-<version>-x64.msi /qn
# Optional: remove the configuration and the audit log too
Remove-Item -Recurse C:\ProgramData\Guardrino

ثم أعِد توجيه تطبيقاتك إلى عنوانها الأساسي السابق.