Jinsi ya kuweka seva ya NetBird VPN kwenye VPS
Jifunze hatua za kuweka NetBird VPN kwenye VPS yako. Mwongozo huu unaelezea usanidi wa DNS, TLS, matumizi ya setup keys kwa vifaa, na tofauti za kiufundi kati ya NetBird na Headscale.
Faida za kujihamishia seva ya NetBird VPN
Kujihamishia seva ya NetBird VPN kunakuwekea control plane kwenye VPS unayomiliki: hii ndiyo sehemu inayohifadhi orodha ya peer, inayoamua ni mashine ipi inaweza kufikia nyingine, na inayosaidia peer wawili kupatana wakiwa nyuma ya NAT (network address translation). Tunnels zenyewe bado ni WireGuard, zilizosimbwa kwa njia fiche moja kwa moja kati ya mashine zako. Kinachobadilika ni kwamba hakuna kampuni ya nje inayoshikilia orodha ya vifaa vyako au mtiririko wako wa kuingia (login flow). Elewa vyema faida unayopata, kwa sababu control plane inayohudumiwa na kampuni nyingine pia haishikilii funguo zinazosimba trafiki yako, na kile ambacho coordination server inaweza kufanya ikivamiwa ni orodha finyu kuliko watu wengi wanavyodhani kabla ya kuisoma.
NetBird inakaa katikati ya vitu viwili ambavyo huenda tayari unavijua. Ni mesh overlay, kwa hivyo peer huunganishwa moja kwa moja badala ya kupitisha kila kitu kupitia gateway moja. Pia inaweza kujihamishia (self-hostable) kuanzia mwanzo hadi mwisho, jambo linaloiweka dhidi ya Headscale, seva ya kudhibiti ya Tailscale inayoweza kujihamishia. Ikiwa umewahi kuendesha tunnel ya gateway moja pekee, soma tofauti kati ya WireGuard ya kawaida na mesh overlay kwanza, kwa sababu mtazamo huo ndio unaofanya sehemu iliyobaki ya ukurasa huu kuwa na manufaa.
Ikiwa unachotaka hasa ni seva moja ambayo trafiki yako yote inatokea, mesh ni mfumo mkubwa kuliko kazi yenyewe. VPN ya WireGuard ya kawaida kwenye VPS moja au Tailscale exit node hufanya hivyo kwa kazi ndogo zaidi. Na ikiwa lengo ni kufikia mtandao mmoja wa kibinafsi badala ya kuunganisha mashine kwa mashine, Tailscale subnet router kwenye VPS hutangaza masafa hayo kwenye tailnet uliyonayo tayari bila kuhitaji mfumo mzima ulio hapa chini.
Kile ambacho stack hii huendesha kwa uhalisia
Muundo huu ulibadilika hivi karibuni, na maandiko mengi ya zamani yanaelezea muundo wa kale. Baada ya kukagua mnamo Oktoba 2026 dhidi ya v0.80.0 na dhidi ya v0.76.2, toleo ambalo mwongozo huu unalipendekeza, hati ya quickstart huandika faili ya Compose yenye huduma tatu kwa chaguo-msingi.
netbird-serverhubeba API ya usimamizi, huduma ya signal, relay yenye STUN listener iliyopachikwa, na mtoa utambulisho (identity provider) aliyepachikwa. Katika matoleo ya zamani, haya yalikuwa containers tofauti na mtoa utambulisho alikuwa ni usakinishaji tofauti wa Zitadel ambao ulibidi ujenge kwanza.dashboardni console ya usimamizi ya wavuti.traefikhufanya TLS (transport layer security) termination na huomba cheti kutoka kwa Let's Encrypt wakati wa kuanza kwa mara ya kwanza.
Kuna huduma nyingine mbili ambazo zipo na hubaki zimezimwa isipokuwa ukikubali kwenye prompt. Huduma ya NetBird Proxy huchapisha huduma za ndani kwenye hostnames za umma. CrowdSec huchuja trafiki ya kihalifu. Hakuna kati ya hizi inayohitajika ili kujenga mesh inayofanya kazi, na zote mbili hutumia kumbukumbu (memory) kwenye seva ndogo.
Ikiwa unatoka kwenye wg-easy katika Docker container moja, huu ni ongezeko la idadi ya vipengele. Unachopata ni sera za ufikiaji na akaunti kwa kila mtumiaji, na peers zinazounganishwa moja kwa moja badala ya kupitia gateway moja.
Mahitaji kabla ya kuanza
Jina la kikoa (domain name) la umma ni lazima. Dashibodi, API na relay zote hutumia HTTPS kwenye port 443, na Traefik hupata cheti chake kutoka Let's Encrypt kwa kutumia changamoto ya TLS-ALPN-01, inayojibiwa kwenye port 443, ambayo inahitaji jina linaloelekeza kwenye VPS hii kutoka kwenye mtandao wa umma. Anwani ya IP pekee haitafanya kazi katika mtiririko huu.
Tengeneza rekodi moja ya A, netbird.example.com inayoelekeza kwenye anwani ya IPv4 ya umma ya VPS, na usubiri rekodi hiyo isambae kabla ya kuendesha chochote.
dig +short netbird.example.comHiyo lazima ichapishe anwani ya seva yako. Kuendesha kisakinishi kabla ya DNS kusambaa kunamaanisha ombi la cheti litafeli wakati wa kuanza, na majaribio yaliyofeli mara kwa mara yatasababisha kufikiwa kwa vikomo vya Let's Encrypt, hivyo utalazimika kusubiri kikomo hicho kiondoke kabla ya kujaribu tena.
Ni port mbili pekee zinazopaswa kufikika kutoka kwenye mtandao kwa usanidi wa kawaida: TCP 443 kwa ajili ya dashibodi, API, signal, trafiki ya relay na changamoto ya cheti, na UDP 3478 kwa ajili ya STUN. TCP 80 lazima iwe wazi ndani ya seva kwa sababu Traefik huifunga, lakini haihitaji kufikika hadharani. Kuzuia ufikiaji wa umma kwenye port 80 huzuia tu uelekezaji wa HTTP-to-HTTPS.
sudo ufw allow 443/tcp
sudo ufw allow 3478/udp
sudo ufw reload
sudo ufw statusZifungue pia kwenye firewall ya mtandao ya mtoa huduma wako. Hicho ni kidhibiti tofauti katika paneli nyingi za VPS, na ndiyo sababu seva ambayo ufw status yake inaonekana kuwa sahihi bado inakataa miunganisho.
STUN (session traversal utilities for NAT) ndiyo njia ambayo kifaa hujifunza anwani ya umma na port iliyopewa na NAT yake, ili vifaa viwili viweze kujaribu kutengeneza handaki la moja kwa moja. Zuia UDP 3478 na vifaa bado vitaunganishwa, kupitia relay kwenye TCP 443, kwa hivyo hakuna kitakachoonekana kuharibika. Vifaa ambavyo haviwezi kupata njia ya moja kwa moja vitaonyesha Connection type: Relayed, na trafiki yao itapita kwenye VPS yako badala ya kwenda moja kwa moja kati ya vifaa. Vifaa vilivyo kwenye LAN moja bado vinaweza kuunganishwa moja kwa moja kwa kutumia anwani zao za ndani.
Kwa upande wa programu, unahitaji Docker ikiwa na Compose v2 plugin, pamoja na jq na curl. Hati hiyo hukagua Docker, Compose na jq na kusimama ikiwa mojawapo haipo. Inatumia curl bila kuikagua, kwa hivyo isakinishe hiyo kwanza. Ikiwa Docker ni mpya kwenye seva hii, kwanza fanya Docker Compose ifanye kazi kwenye VPS.
Port ikiwa utaruka reverse proxy iliyojumuishwa
Bila Traefik, seva iliyounganishwa bado hubeba usimamizi, signal na relay kwenye backend moja ya HTTP, kwa hivyo orodha ya port haiongezeki sana. Faili ya Compose iliyozalishwa huchapisha:
- TCP 8080, dashibodi, iliyofungwa kwenye 127.0.0.1 kwa chaguo-msingi
- TCP 8081,
netbird-server, iliyofungwa kwenye 127.0.0.1 kwa chaguo-msingi - UDP 3478, STUN, iliyochapishwa moja kwa moja
Proxy yako mwenyewe hukomesha TLS kwenye TCP 443 na kusambaza kwenye hizo port mbili za ndani. STUN haipiti kamwe kwenye proxy, kwa hivyo UDP 3478 inabaki wazi kwenye firewall kwa vyovyote vile. Miongozo inayoorodhesha port tofauti kwa ajili ya management gRPC, signal gRPC na relay inaelezea mpangilio wa zamani wa kontena nyingi.
Chagua njia hii tu wakati seva tayari inakomesha TLS kwa kitu kingine. Vinginevyo, Traefik iliyojumuishwa ina sheria chache na makosa machache.
Sakinisha seva ya NetBird kwa kutumia script ya quickstart
Amri ya mstari mmoja iliyoandikwa kwenye nyaraka hupitisha toleo jipya zaidi moja kwa moja kwenye shell:
curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bashBadala yake, iweke kwenye toleo maalum (pin it). latest hubadilika, kwa hivyo amri hiyo hiyo ikitekelezwa baada ya wiki mbili inaleta usakinishaji tofauti, na hakuna kitu kwenye diski kinachorekodi ni toleo lipi liliandika usanidi wako. Pakua toleo lililowekewa tag, lisome, kisha uliendeshe.
mkdir -p ~/netbird
cd ~/netbird
curl -fsSL -o getting-started.sh \
https://github.com/netbirdio/netbird/releases/download/v0.76.2/getting-started.sh
less getting-started.sh
bash getting-started.shScript hiyo huuliza kwanza kikoa (domain):
Enter the domain you want to use for NetBird (e.g. netbird.my-domain.com):Kisha huuliza jinsi TLS itakavyoshughulikiwa:
Which reverse proxy will you use?
[0] Traefik (recommended - automatic TLS, included in Docker Compose)
[1] Existing Traefik (labels for external Traefik instance)
[2] Nginx (generates config template)
[3] Nginx Proxy Manager (generates config + instructions)
[4] External Caddy (generates Caddyfile snippet)
[5] Other/Manual (displays setup documentation)
Enter choice [0-5] (default: 0):Chagua [0]. Chaguzi 2 hadi 4 huandika kijisehemu cha usanidi na kukuachia wewe kazi ya kuunganisha, na chaguo 5 huandika faili ya Compose, dashboard.env na config.yaml na kuchapisha nyaraka za usanidi kwenye terminal. Hiyo ni sahihi kwenye seva ambayo tayari inaendesha proxy na si sahihi kwenye seva mpya. Chaguo 0 kisha huuliza anwani ya barua pepe, ambayo Traefik huisajili na akaunti yako ya Let's Encrypt. Prompt bado inaiita anwani ya arifa za cheti, lakini Let's Encrypt iliacha kutuma barua pepe za kuisha kwa muda wa cheti mnamo Juni 4, 2025, kwa hivyo matatizo ya kusasisha (renewal) huonekana kwenye log ya Traefik badala ya kikasha chako cha barua pepe.
Kataa huduma ya NetBird Proxy kwenye usakinishaji wa kwanza. Inahitaji rekodi moja zaidi ya DNS, wildcard *.netbird.example.com CNAME inayoelekeza kwenye netbird.example.com, na haifanyi kazi yoyote kwa mesh ya kawaida. Prompt ya CrowdSec huonekana tu wakati proxy imewezeshwa, kwa hivyo kukataa proxy kutairuka pia. Zote mbili zinaweza kuongezwa baadaye.
Script huandika kwenye saraka ya sasa: docker-compose.yml, config.yaml yenye mode 600, na dashboard.env. Pamoja na Traefik iliyojumuishwa, huongeza traefik-dynamic.yaml na proxy.env pale tu unapowezesha NetBird Proxy. Ichukulie saraka hiyo kama hali (state) unayopaswa kuhifadhi, kwa sababu config.yaml inashikilia ufunguo unaosimba data kwenye hifadhi. Kuipoteza si kitu ambacho usakinishaji upya unaweza kurekebisha.
docker compose ps
docker compose logs -f netbird-serverKila huduma inapaswa kusoma running, na log ya seva inapaswa kutulia badala ya kuanza upya mara kwa mara. Fuatilia cheti kando:
docker compose logs traefik | grep -i acmeACME (automatic certificate management environment) ni itifaki ambayo Traefik hutumia kupata cheti. Hitilafu hapa karibu kila mara husababishwa na DNS au port 443 iliyofungwa.
Unda akaunti ya kwanza ya admin
Fungua https://netbird.example.com. Kwenye usakinishaji mpya, ukurasa huu huonyesha sehemu ya usanidi badala ya fomu ya kuingia. Ingiza anwani ya barua pepe, jina, na nenosiri, kisha bofya Create Account. Akaunti hiyo inakuwa admin wa kwanza, na ukurasa utaelekezwa kwenye fomu ya kuingia.
Akaunti hiyo inakaa kwenye hifadhi ya watumiaji ya NetBird yenyewe, inayotumia identity provider iliyopachikwa ndani ya container ya netbird-server. Hakuna huduma ya nje inayohusika. Hii ndiyo mabadiliko makubwa zaidi kutoka kwa NetBird ya mwaka mmoja uliopita, ambapo usakinishaji uliokuwa ukifanya kazi ulihitaji kwanza kusimamisha Zitadel au Keycloak na kunakili thamani nne za OIDC (OpenID Connect) kwenye setup.env kabla ya kitu chochote kuanza.
Ukipata onyo la cheti cha kivinjari badala ya ukurasa wa usanidi, cheti hicho hakijatolewa. Rekebisha hilo kabla ya kuendelea, kwa sababu dashboard huwasiliana na API kupitia hostname ileile na itashindwa kwa njia zisizoeleweka ikiwa nyuma ya cheti kibovu.
Jiunge na peer yako ya kwanza
Sakinisha client kwenye mashine yoyote ya Linux, ikijumuisha VPS yenyewe ikiwa unataka iwe ndani ya mesh:
curl -fsSL https://pkgs.netbird.io/install.sh | shKwenye Debian na Ubuntu, script hiyo husanidi hazina ya vifurushi (package repository) ya NetBird na kisha kusakinisha client kupitia apt, hivyo package manager ndiyo inayomiliki usakinishaji huo. Ikiwa kuingiza script moja kwa moja kwenye shell hakukufurahishi, ihifadhi kwanza kwa kutumia curl -fsSL -o install.sh https://pkgs.netbird.io/install.sh na uisome kabla ya kuiendesha kwa sh install.sh. Vyovyote vile, thibitisha kilichosakinishwa:
apt-cache policy netbirdnetbird ndiyo client ya mstari wa amri na daemon. netbird-ui ni programu ya desktop tray, na seva isiyo na kiolesura (headless server) haina matumizi nayo.
Sasa elekeza client kwenye seva yako:
sudo netbird up --management-url https://netbird.example.comUkiondoa --management-url, client itajisajili kwenye huduma ya NetBird iliyopangishwa (hosted service), kwa sababu hiyo ndiyo chaguo-msingi iliyojengwa ndani. Amri hiyo bado itafanikiwa, mashine bado itapata anwani, na dashboard yako uliyojihudumia (self-hosted) itabaki tupu. Hili ni kosa ambalo karibu kila mtu hufanya mara moja.
Amri hiyo huchapisha URL ya kufungua kwenye kivinjari ili kukamilisha kuingia (login). Baada ya hapo:
netbird status
ip addr show wt0Soma mistari minne kutoka netbird status: Management: Connected, Signal: Connected, mstari wa Relays: unaoripoti kila relay inayopatikana, na NetBird IP: katika masafa ya overlay. wt0 ni interface ya WireGuard ambayo NetBird hutengeneza, na inapaswa kubeba anwani hiyo hiyo.
Unganisha mashine ya pili bila kuhudumiwa kwa kutumia setup key
Kuingia kupitia kivinjari hakufanyi kazi kwa mashine isiyo na kivinjari na isiyo na mtumiaji mbele yake. Setup key ni tokeni ya kabla ya uthibitishaji inayojisajili mashine bila kuhitaji hatua ya mwingiliano. Itengeneze kwenye dashibodi chini ya Settings → Setup Keys.
Kuna aina mbili. Ufunguo wa mara moja (one-off key) huthibitisha mashine moja pekee na kisha hutumika. Ufunguo unaoweza kutumika tena (reusable key) husajili mashine nyingi, na unaweza kuweka kikomo cha idadi. Zote mbili zinaweza kuwa na muda wa kuisha (expiry), na zote zinaweza kugawa peer mpya kwenye kundi (group) kiotomatiki, ili sheria za ufikiaji za kundi hilo zianze kufanya kazi mara tu mashine inapoonekana.
sudo netbird up --setup-key <SETUP-KEY> \
--management-url https://netbird.example.com \
--hostname build-runner-01--hostname huweka jina linaloonekana kwenye dashibodi. Bila hiyo, peer huchukua jina ambalo mashine inajiita, na orodha ya entries zote zilizopewa jina ubuntu haimsaidii mtu yeyote.
Kwa containers na mawakala wa ujenzi (build agents) wa muda mfupi, alama ufunguo huo kama ephemeral unapouunda. Peers zilizosajiliwa kwa ufunguo wa ephemeral huondolewa kiotomatiki pindi zinapokuwa nje ya mtandao kwa zaidi ya dakika 10, jambo linalozuia entries zilizokufa kwenye orodha ya peers.
Kikomo kimoja cha kuelewa kabla ya kupanga matumizi ya setup keys: kumaliza muda au kufuta ufunguo husimamisha usajili mpya, lakini hakukati muunganisho wa mashine zilizokwisha jisajili nao. Kuondoa ufikiaji wa mashine kunamaanisha kuondoa peer huyo.
Je, bado unahitaji mtoa huduma wa utambulisho (identity provider) tofauti?
Kwa usakinishaji mdogo, hapana. Hifadhi ya watumiaji iliyojengewa ndani inashughulikia akaunti zinazoundwa kutoka kwenye dashboard, na hiyo inatosha kwa watu wachache.
Unahitaji mtoa huduma wa utambulisho wa nje pale unapokuwa tayari unaye mmoja na hutaki kuwa na orodha ya pili ya watumiaji. NetBird inakubali mtoa huduma yeyote anayezungumza OIDC. Sajili mteja wa OIDC wa siri (confidential OIDC client) kwa mtoa huduma wako, kisha uiongeze kwenye dashboard ya NetBird ukitumia jina, client ID, client secret na, inapohitajika, issuer. NetBird inakupa URL ya kuelekeza upya (redirect URL) ili uibandike kwa mtoa huduma wako. Integrations zilizopewa majina zipo kwa ajili ya Google, Microsoft Entra ID, Okta, Zitadel, Keycloak, Authentik na Pocket ID, na nyingine yoyote inaingizwa kama OIDC ya kawaida (generic OIDC). Ikiwa tayari unaendesha Authentik kama mfumo wako wa single sign-on uliopo kwenye seva yako, hii ndiyo njia inayohifadhi orodha moja ya akaunti badala ya mbili.
Kuingia kwa akaunti ya ndani (local login) kunabaki kupatikana baada ya kuongeza mtoa huduma, na kila mtoa huduma uliyosanidi huonekana kwenye ukurasa wa kuingia. Hifadhi akaunti moja ya admin ya ndani yenye nenosiri imara. Configuration ya OIDC iliyoharibika itakuachia njia ya kuingia.
NetBird au Headscale: ni control plane ipi unapaswa kuendesha?
Zote mbili huondoa utegemezi uleule, yaani seva ya udhibiti inayomilikiwa na kampuni ambayo wateja wako wangeiwasiliana. Hizi si miradi ya aina moja.
Headscale hutekeleza upya seva ya udhibiti ya Tailscale, na unaendelea kutumia wateja rasmi wa Tailscale. Hakuna dashibodi rasmi ya wavuti. Unasimamia watumiaji na funguo za awali za uthibitishaji (pre-authentication keys) kwa kutumia amri ya headscale dhidi ya faili ya usanidi. Kuna violesura vya wavuti vilivyotengenezwa na jamii, na havijumuishwi kwenye mradi huu. Hii inawafaa watu wanaotaka hali yao (state) iwe kwenye faili na mabadiliko yao yawe kwenye version control.
NetBird hutoa bidhaa nzima: client yake yenyewe, dashboard yake yenyewe, identity provider iliyopachikwa, na access policies zinazohaririwa kwenye browser. Hii inaongeza vipengele vinavyohitaji kusimamiwa kwenye VPS yako, na ni rahisi zaidi kumkabidhi mwenzako ambaye hatawahi kufungua terminal. Ikiwa unalinganisha NetBird na Tailscale inayohudumiwa badala ya Headscale, zote hutumia WireGuard chini ya mfumo, kwa hiyo ulinganisho wa NetBird na Tailscale unaeleza zinapotofautiana: nani anaendesha control plane, access rules huandikwaje, na relays husafirisha traffic vipi.
Endesha Headscale ikiwa tayari umewekeza kwenye wateja wa Tailscale au unataka control plane ndogo iwezekanavyo. Endesha NetBird ikiwa watu kadhaa wanahitaji kusimamia peers na unataka dashibodi na SSO bila kuunganisha vipengele hivyo mwenyewe. Kabla ya kuamua yoyote kati ya hizo, angalia kile ambacho mpango wa bure wa Tailscale kinashughulikia kwa kweli, kwa sababu kikundi kisicho cha kibiashara chenye watumiaji sita au chini ya hapo hakilipi chochote kwa control plane inayomilikiwa na kampuni, kikiwa na vifaa vya watumiaji visivyo na kikomo na rasilimali 50 zilizotambulishwa (tagged resources) kuanzia mwanzo, na kinaweza kisione sababu ya kuendesha seva yake yenyewe. Baada ya kikomo hicho, gharama huongezeka kulingana na idadi ya watu badala ya idadi ya mashine, kwa hivyo kukokotoa kile ambacho Tailscale ingekutoza kikundi chako kunakupa takwimu ya kulinganisha na gharama za VPS na saa unazotumia kuendesha mfumo huu.
VPS ndogo kiasi gani inaweza kuendesha hii?
Kiwango cha chini kilichopendekezwa ni CPU 1 na kumbukumbu ya 2 GB. Nunua 2 GB.
Mambo matatu ni salama kuyaacha kwenye seva ndogo. Kataa huduma ya NetBird Proxy, ambayo ipo kwa ajili ya kuchapisha huduma za ndani kwenye hostnames za umma na haina uhusiano wowote na peers wanaounganishwa. Rukia CrowdSec, ambayo script inatoa tu pamoja na proxy na ambayo inafaa kuongezwa kwenye seva iliyo wazi baadaye badala ya siku ya kwanza. Hifadhi SQLite ya kawaida kwenye volume ya netbird_data, na hamia PostgreSQL pale tu unapogawanya deployment kwenye mashine nyingi au unapofikia concurrency halisi, jambo ambalo limeandikwa kama uhamiaji unaoweza kufanya baadaye.
Relay ni sehemu moja ambayo huwezi kuiondoa. Peers wawili ambao NAT yao inawapa port tofauti kwa kila destination hawatawahi kuanzisha tunnel ya moja kwa moja, kwa hivyo relay ndiyo njia pekee inayowafanya wafanye kazi kabisa. Kuizima huokoa kumbukumbu kidogo sana na huvunja miunganisho kwa njia ambayo ni vigumu kuifuatilia.
Seva moja ikikoma kutosheleza, relays ndizo kitu cha kwanza kuhamishwa kutoka hapo. Relay inayojitegemea huendeshwa kwa NB_LISTEN_ADDRESS, NB_EXPOSED_ADDRESS, NB_AUTH_SECRET na NB_ENABLE_STUN. Siri iliyoshirikiwa (shared secret) lazima iwe sawa kwenye relay na kwenye seva kuu, vinginevyo wateja watashindwa kujitambulisha kwake.
Njia za hitilafu, na utakachokiona
Dashibodi inaonyesha onyo la cheti. Traefik haikupata cheti. Endesha docker compose logs traefik | grep -i acme. Kuna sababu mbili. Aidha dig +short netbird.example.com haielekezi kwenye VPS hii bado, au TCP 443 imefungwa mahali fulani kati ya Let's Encrypt na container, kwa kawaida kwenye firewall ya mtandao ya mtoa huduma badala ya ufw. Changamoto hujibiwa kwenye 443, kwa hivyo port 80 iliyo wazi haisaidii hapa. Rekebisha sababu kabla ya kujaribu tena mara kwa mara, kwa sababu Let's Encrypt inaruhusu idhini tano tu zilizoshindikana kwa kila hostname kwa kila akaunti kwa saa, na kitanzi kitakufungia usijaribu tena hadi kikomo hicho kirekebishwe.
Mteja anasema ameunganishwa na dashibodi haina kitu. Mteja alijisajili na huduma ya NetBird inayopangishwa, kwa sababu --management-url haikuwepo. Endesha netbird status --detail na usome mstari wa Management:, ambao unataja seva inayozungumza nayo kwa sasa. Kuona Management: Connected to https://api.netbird.io:443 inamaanisha ilienda kwenye cloud. Endesha sudo netbird down, kisha sudo netbird up --management-url https://netbird.example.com tena.
Kila peer inaonyesha Connection type: Relayed. Hakuna tunnels za moja kwa moja zinazoundwa, kwa hivyo trafiki yote inapita kwenye VPS yako na kuongeza latency. Angalia UDP 3478 kwenye firewall ya VPS na kwenye firewall ya mtoa huduma, kwa kuwa STUN ndiyo inayomruhusu peer kujua anwani yake ya umma na port. netbird status --detail pia huchapisha Direct: false na aina za ICE (interactive connectivity establishment) candidate kwa kila peer, ambayo inaonyesha jaribio limefika wapi. Kwenye baadhi ya mitandao, relayed ndiyo matokeo pekee yanayopatikana na hakuna hitilafu yoyote.
Peer anajiunga na hawezi kufikia chochote. Kuwa kwenye mesh haimaanishi kuwa peers wawili wanaweza kuzungumza. Sera za ufikiaji ndizo zinazoamua hilo, na kikundi kisicho na sera iliyoambatanishwa hakifikii chochote. Angalia sera kwenye dashibodi kabla ya kuanza kutatua routes na firewalls.
netbird status inaripoti tatizo la daemon. Huduma haifanyi kazi. Tumia sudo netbird service status na sudo netbird service start. Kumbukumbu za mteja (logs) zipo kwenye /var/log/netbird/client.log. Kwa chochote ambacho huwezi kukipata, netbird debug bundle --anonymize --system-info hukusanya logs, hali, routes, mipangilio ya DNS na hali ya firewall kwenye kumbukumbu moja.
Hifadhi rudufu na maboresho
Vitu viwili hubeba usakinishaji mzima: saraka iliyo na docker-compose.yml na config.yaml, pamoja na Docker volume iliyo na database na funguo za usimbaji (encryption keys). Hifadhi nakala zake pamoja. config.yaml ina ufunguo unaosimba data nyeti kwenye hifadhi, kwa hivyo nakala ya database bila ufunguo huo haiwezi kurejesha funguo za usanidi zilizosimbwa na token za API.
docker volume ls
docker compose down
sudo tar czf netbird-config.tgz -C ~ netbird
docker run --rm -v netbird_netbird_data:/data -v "$PWD":/backup \
alpine tar czf /backup/netbird-data.tgz -C /data .
docker compose up -dCompose huongeza viambishi awali vya majina ya volume kwa kutumia saraka ya mradi, kwa hivyo volume iliyoandikwa kama netbird_data kwa kawaida huonekana kama netbird_netbird_data. Tekeleza docker volume ls kwanza na utumie jina linalochapishwa, au docker run hapo juu itafeli kwa kuunda kimyakimya volume tupu na kutohifadhi chochote. Weka nakala za kumbukumbu nje ya VPS. Ikiwa tayari unayo zana ya kuhifadhi nakala, restic au BorgBackup hushughulikia sehemu ya nje ya seva.
Kuboresha seva ni kuvuta (pull) na kuunda upya (recreate):
docker compose pull
docker compose up -d
docker compose psKabla ya kutegemea hilo, tekeleza docker compose config | grep image:. Tag yoyote inayosomeka latest inapaswa kufungwa (pin) kwenye toleo fulani, kwa sababu ile ile uliyofunga hati ya usakinishaji: unataka kujua nini kinafanya kazi, na unataka toleo la kurudi nyuma wakati uboreshaji unapofanya kazi vibaya. Wateja huboresha kupitia meneja wa vifurushi (package manager) yeyote aliyewasakinisha.
FAQ
Je, ninahitaji identity provider yangu mwenyewe ili ku-self-host NetBird?
Hapana. Releases za sasa zinajumuisha user store iliyojengwa ndani, kwa hivyo unatengeneza akaunti ya kwanza ya admin kwenye kivinjari katika https://netbird.example.com na kuongeza watumiaji kutoka kwenye dashboard baadaye. External OIDC provider ni ya hiari na inaweza kuongezwa baadaye kwa kutumia jina, client ID, client secret na, inapohitajika, issuer. Miongozo inayokuelekeza ku-deploy Zitadel au Keycloak kabla ya NetBird inaelezea usanidi ambao hauhitajiki tena, na kuifuata kunakugharimu huduma nzima ya ziada ya kuendesha.
Kwa nini peers zangu zote zinaonyesha Connection type: Relayed?
Muunganisho wa moja kwa moja haufanikiwi, kwa hivyo trafiki inapita kwenye relay iliyo kwenye VPS yako. Sababu ya kawaida ni UDP 3478 kuzuiwa, ambayo ni STUN port inayotumiwa na peers kugundua anwani yao ya umma na port. Ifungue kwenye firewall ya VPS na kwenye network firewall ya mtoa huduma wako, kisha endesha netbird status --detail tena na usome mstari wa Direct:. Wakati peers zote mbili ziko nyuma ya NAT inayopanga port tofauti kwa kila destination, relayed ndio matokeo yanayotarajiwa na hakuna kilichosanidiwa vibaya.
Client yangu imeunganishwa lakini dashboard haionyeshi peers. Nini kimetokea?
Client imejisajili na huduma ya NetBird iliyopangishwa (hosted service) badala ya seva yako, jambo linalotokea wakati --management-url ikiachwa. netbird status --detail huchapisha seva inayowasiliana nayo kwenye mstari wa Management:, kwa hivyo thamani kama https://api.netbird.io:443 inathibitisha hilo. Endesha sudo netbird down, kisha sudo netbird up --management-url https://netbird.example.com, na peer ataonekana kwenye dashboard yako.
NetBird ya kujihudumia (self-hosted) inatofautiana vipi na Headscale?
Zote mbili hubadilisha control server iliyopangishwa na ile unayoiendesha wewe mwenyewe. Headscale ni control plane pekee: unaisimamia kwa kutumia amri ya headscale na faili ya usanidi, hakuna official web console, na inaendesha official Tailscale clients. NetBird inakuja na client yake yenyewe, admin dashboard na ushirikiano wa identity provider katika stack moja. Headscale ni ndogo kuendesha na huhifadhi hali yake kwenye faili. NetBird ni rahisi zaidi kuwapa watu ambao hawatatumia terminal.
VPS ya ukubwa gani inahitajika kwa seva ya NetBird ya kujihudumia?
Kiwango cha chini kilichopendekezwa ni 1 CPU na 2 GB ya kumbukumbu, na 2 GB ndio namba ya kununua. Kataa huduma ya hiari ya proxy wakati wa usakinishaji, ambayo pia huruka ombi la CrowdSec, na uendelee kutumia SQLite store ya kawaida hadi utakapohitaji PostgreSQL kikweli.