Hetzner žeton

Žeton API za Hetzner Cloud je neobvezen. Nikoli ga ne potrebuješ za prijavo, za brskanje po nadzorni plošči, za ogled cen po ceniku ali za gostovan cluster samo s kontrolno ravnino. Žeton vklopi dve stvari: točne cene tvojega računa in vzpostavljanje (nabore workerjev in SSH ključe na tvojem lastnem Hetzner računu).

Brez žetona

Vseeno vidiš vse, po cenah iz cenika. Nadzorna plošča prikaže Hetznerjeve lokacije, tipe strojev in cene. kubehz jih prebere s svojim lastnim platformnim žetonom. Tvoj Hetzner račun ima lahko drugačne cene (na primer dogovorjene cene). Zato nadzorna plošča prikaže Hetznerjeve cene po ceniku in jih označi z zvezdico (*): so ocena, ne tvoj račun.

Lahko ustvariš gostovan cluster. Gostovan cluster samo s kontrolno ravnino ne potrebuje žetona, ker kubehz kontrolno ravnino poganja na svoji infrastrukturi. Žeton temu clustru omogoči workerje na tvojem računu, in to odločitev sprejmeš enkrat, ob ustvarjanju.

Cluster, ustvarjen brez povezanega žetona, pozneje ne more dobiti worker poolov. Za workerje povežeš žeton in cluster ustvariš znova (glej Worker pooli). Če boš kdaj želel workerje na clustru, poveži žeton, preden cluster ustvariš.

Z žetonom

Žeton poveži v čarovniku za ustvarjanje. Žeton lahko računu dodaš tudi pozneje, ker je poverilnica najemnika, ne posameznega clustra. A worker poole izbereš ob ustvarjanju clustra: cluster brez povezanega žetona pozneje ne more dobiti worker poolov, razen če ga ustvariš znova (glej Worker pooli). Žeton, ki ga povežeš pozneje, še vedno da cene, točne za tvoj račun. Vrsta žetona določa, kaj vklopi:

Žeton Read & Write vklopi vzpostavljanje. Nadzorna plošča preklopi s cen iz cenika na točne cene tvojega računa. Ustvarjaš in skaliraš lahko nabore workerjev: kubehz ustvari strežnike na tvojem računu, ti pa plačuješ neposredno Hetznerju, brez kubehz pribitka. Upravljaš lahko tudi SSH ključe za worker vozlišča.

Žeton samo za branje še vedno da točne cene tvojega računa. Žeton se overi, zato cene postanejo prave številke tvojega računa. Vzpostavljanje pa ostane zaklenjeno, in nadzorna plošča ti to pove. Za vzpostavljanje žeton zamenjaj z žetonom Read & Write.

Ustvarjanje žetona

V Hetzner Cloud Console izberi projekt za svoje workerje. Nato izberi Security → API tokens → Generate API token. Izberi Read & Write, če želiš vzpostavljati. Read zadošča za same cene.

Kako kubehz preveri žeton

Ko povežeš ali zamenjaš žeton, ga kubehz preveri, preden ga shrani:

• Žeton se mora overiti. kubehz zavrne žeton, ki ga Hetzner zavrne.
• Žeton mora pripadati pravemu projektu. Pri clustru, ki že ima strežnike, kubehz potrdi, da žeton pripada istemu Hetzner projektu kot ti workerji. kubehz zavrne žeton iz drugega projekta, da žeton ne osami tvojih obstoječih vozlišč. (Žeton hcloud pripada natanko enemu projektu.) Včasih preverjanje ne more teči: še ni vzpostavljenih strežnikov ali pa Hetzner ni dosegljiv. Takrat preverjanje popusti in kubehz žeton shrani.

Kako kubehz shrani žeton

Šifriran v mirovanju, nikoli več prikazan. kubehz žeton šifrira, preden žeton doseže našo bazo. kubehz žeton uporablja samo za upravljanje virov tvojega lastnega clustra. Nadzorna plošča vrednosti nikoli več ne prikaže. Prikaže samo, ali je žeton povezan, in od kdaj.

Žeton lahko zamenjaš kadar koli. Za povezavo ali zamenjavo žetona potrebuješ svežo potrditev 2FA. Žeton lahko prekličeš v Hetzner Cloud Console, kadar želiš.

Z orodjem lo (CLI)

Če vzpostavljaš z lok8s, lo provision z KUBEHZ_TOKEN prevzame cluster neposredno v tvoj tenant. KUBEHZ_TOKEN je API žeton clusters:write, ki ga ustvariš v nadzorni plošči pod Dostop → API-žetoni. Da kubehz izročiš tudi svoj HCLOUD_TOKEN za vzpostavljanje iz nadzorne plošče, se prostovoljno vključi:

# cluster.lok8s.yaml
spec:
  kubehz:
    hosting: hosted
    connectHcloudToken: true   # pošlji HCLOUD_TOKEN kubehz za vzpostavljanje

To je prostovoljno. Brez connectHcloudToken: true lo tvoj HCLOUD_TOKEN uporabi samo lokalno in ga nikoli ne pošlje v kubehz. Brez KUBEHZ_TOKEN lo v kubehz sploh nič ne pošlje.

Naslednji koraki

• Gostovana kontrolna ravnina: oblika, cena in gostovana pot na splošno.
• Nabori workerjev: nabori, skaliranje in samodejno skaliranje (potrebuje žeton Read & Write).
• Kako deluje: meja zaupanja, ki jo žeton delegira.

---

Stanje dokumentacije

Vidik	Podrobnost
Stanje	v živo: neobvezen žeton, Read & Write vklopi vzpostavljanje
Zadnji pregled	2026-10-30