Tự lưu trữ: hướng dẫn từng bước

01 Cài đặt inferenced CLI

Tải xuống gói CLI cho hệ điều hành của bạn (v0.2.16 trở lên) từ GitHub releases.

# Tải và cài đặt 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 Tạo khóa ví lạnh

Ví lạnh được dùng để quản lý node và nhận phần thưởng.

inferenced keys add cold-wallet

Lưu cụm từ ghi nhớ ở nơi an toàn!

03 Clone repository và cấu hình

git clone https://github.com/gonka-ai/gonka.git -b main
cd gonka/deploy/join
cp config.env.template config.env
# Chỉnh sửa config.env — nhập các thông số của bạn

04 Tải trọng số mô hình

Các mô hình mạng đang hoạt động — MoE FP8 (hiện tại là MiniMax M2.7, DeepSeek V4 Flash và GLM-5.3 Flash; tập hợp được xác định bởi governance). Tải trọng số qua HuggingFace CLI. Tìm hiểu thêm →

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 Khởi động dịch vụ 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 Đăng ký on-chain

Trên máy chủ, hãy tạo khóa vận hành (warm key) và đăng ký host, sau đó trên máy cục bộ nơi lưu khóa lạnh, cấp cho khóa warm quyền thực hiện các giao dịch dịch vụ.

# Trên máy chủ, trong container api: tạo khóa vận hành (warm key)
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

# Cùng chỗ: đăng ký host lên mạng lưới
inferenced register-new-participant \
    $DAPI_API__PUBLIC_URL \
    $ACCOUNT_PUBKEY \
    --node-address $DAPI_CHAIN_NODE__SEED_API_URL

# Trên máy cục bộ: cấp quyền cho khóa warm (phí 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/

Từ tháng 10 năm 2026 (bản cập nhật mạng v0.2.16), việc cấp quyền có tính phí: nếu không có --gas-prices, mạng sẽ từ chối giao dịch với lỗi insufficient fee. Với --gas 2000000 và mức giá 1 ngonka mỗi gas, phí là 0.002 GNK. Hãy giữ một khoản dự trữ GNK trong ví lạnh: phí của khóa warm cũng được trừ từ ví này — hướng dẫn chính thức khuyến nghị bắt đầu với 10 GNK.

07 Cấu hình SSL và khởi động

Cấu hình DNS (Cloudflare/AWS/GCP/Azure/DO/Hetzner), lấy chứng chỉ SSL, khởi động toàn bộ mạng và kiểm tra đăng ký.

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

# Kiểm tra trạng thái node
curl http://<PUBLIC_IP>:8000/chain-rpc/status

# Kiểm tra đăng ký
curl http://node2.gonka.ai:8000/v2/participants/<cold-wallet-address>