الاستضافة الذاتية: دليل خطوة بخطوة

01 تثبيت inferenced CLI

نزّل أرشيف CLI الخاص بنظام تشغيلك (v0.2.16 أو أحدث) من GitHub releases.

# تنزيل وتثبيت inferenced CLI
wget https://github.com/gonka-ai/gonka/releases/download/release/v0.2.16-post1/inferenced-linux-amd64.zip
unzip inferenced-linux-amd64.zip
chmod +x inferenced
sudo mv inferenced /usr/local/bin/inferenced

02 إنشاء مفتاح المحفظة الباردة

تُستخدم المحفظة الباردة لإدارة النود واستلام المكافآت.

inferenced keys add cold-wallet

احفظ العبارة التذكيرية في مكان آمن!

03 استنساخ المستودع وإعداده

git clone https://github.com/gonka-ai/gonka.git -b main
cd gonka/deploy/join
cp config.env.template config.env
# تعديل config.env — أدخل معاملاتك

04 تنزيل أوزان النموذج

نماذج الشبكة النشطة — MoE FP8 (حاليًا MiniMax M2.7 و DeepSeek V4 Flash و GLM-5.3 Flash؛ يتم تحديد المجموعة بواسطة governance). تحميل الأوزان عبر HuggingFace CLI. اعرف المزيد →

pip install -U "huggingface_hub[cli]"
# use the current model id from the network config / governance (example: MiniMax M2.7)
huggingface-cli download MiniMaxAI/MiniMax-M2.7

05 تشغيل خدمات Docker

docker compose -f docker-compose.yml -f docker-compose.mlnode.yml pull
source config.env && docker compose up tmkms node -d --no-deps

06 التسجيل on-chain

على الخادم، أنشئ مفتاح تشغيل (دافئ) وسجّل المضيف، ثم على الجهاز المحلي حيث يوجد المفتاح البارد، امنح المفتاح الدافئ صلاحيات المعاملات الخدمية.

# على الخادم، داخل حاوية api: إنشاء مفتاح تشغيل (دافئ)
docker compose run --rm --no-deps -it api /bin/sh
printf '%s\n%s\n' "$KEYRING_PASSWORD" "$KEYRING_PASSWORD" | inferenced keys add "$KEY_NAME" --keyring-backend file

# في المكان نفسه: سجّل المضيف على الشبكة
inferenced register-new-participant \
    $DAPI_API__PUBLIC_URL \
    $ACCOUNT_PUBKEY \
    --node-address $DAPI_CHAIN_NODE__SEED_API_URL

# على الجهاز المحلي: منح الصلاحيات للمفتاح الدافئ (الرسوم 0.002 GNK)
inferenced tx inference grant-ml-ops-permissions \
    cold-wallet <warm-key-address> \
    --from cold-wallet \
    --gas 2000000 --gas-prices 1ngonka \
    --node <seed-api-url>/chain-rpc/

ابتداءً من أكتوبر 2026 (تحديث الشبكة v0.2.16)، أصبح منح الصلاحيات مدفوعًا: بدون --gas-prices سترفض الشبكة المعاملة بخطأ insufficient fee. مع --gas 2000000 وسعر 1 ngonka لكل gas، تبلغ الرسوم 0.002 GNK. احتفظ باحتياطي من GNK في المحفظة الباردة: فمنها تُخصم أيضًا رسوم المفتاح الدافئ — ويوصي الدليل الرسمي بالبدء بـ 10 GNK.

07 إعداد SSL والتشغيل

إعداد DNS (Cloudflare/AWS/GCP/Azure/DO/Hetzner)، الحصول على شهادة SSL، تشغيل الشبكة الكاملة والتحقق من التسجيل.

source config.env && \
docker compose -f docker-compose.yml -f docker-compose.mlnode.yml up -d

# التحقق من حالة النود
curl http://<PUBLIC_IP>:8000/chain-rpc/status

# التحقق من التسجيل
curl http://node2.gonka.ai:8000/v2/participants/<cold-wallet-address>