Agent እና ግንኙነት

አንድ ትዕዛዝ። ሙሉ በሙሉ የተጠበቀ።

የCASTOVIA agent በ60 ሰከንድ ውስጥ ይጫናል፣ ደህንነትን በራስ-ሰር ይቆጣጠራል፣ እና ከCASTOVIA Cloud ጋር በምስጢራዊ ቻናሎች ይገናኛል። ምንም በእጅ firewall ደንቦች፣ SSH keys፣ VPN የለም።

የመጫኛ ትዕዛዝ ማብራሪያ

በLinux serverዎ ላይ አንድ-መስመር መጫኛውን ሲያስኪዱ ትክክለኛው ምን እንደሚከሰት።

ትዕዛዙ ምን ያደርጋል

ከCASTOVIA አስተዳዳሪ ዳሽቦርድ የሚቀዱት አንድ-መስመር የመጫኛ ትዕዛዝ በLinux serverዎ ላይ የሚከተሉትን እርምጃዎች ያከናውናል፦

የCASTOVIA agent binaryን (~15 MB) ከofficial CDN ያወርዳል
ተከሳሽነትን ለመከላከል binary ፊርማውን (SHA-256 + GPG) ያረጋግጣል
የተለየ system user ይፈጥራል: castovia-agent (login shell የለም፣ sudo የለም)
binaryውን ወደ /opt/castovia/agent ይጭናል
የconfiguration ማውጫውን /etc/castovia/ በተገደበ ፈቃድ (0700) ይፈጥራል
የserver tokenን (ለእያንዳንዱ node ልዩ) ወደ /etc/castovia/token.conf ይጽፋል
agentን እንደ systemd service ይመዘግባል: castovia-agent.service
serviceውን ይጀምራል እና በboot ላይ auto-start ያነቃል
nodeውን ለመመዝገብ ከCASTOVIA Cloud ጋር የመጀመሪያ handshake ያካሂዳል

ትክክለኛው ትዕዛዝ

በአስተዳዳሪ ዳሽቦርድዎ የሚያዩት ትዕዛዝ እንደዚህ ይመስላል፦

curl -sSL https://install.castovia.com/agent | sudo bash -s -- --token YOUR_SERVER_TOKEN

YOUR_SERVER_TOKEN ለእያንዳንዱ node የሚፈጠር ልዩ፣ አንድ-ጊዜ የሚጠቀሙበት token ነው። ካልተጠቀሙበት ከ24 ሰዓታት በኋላ ያበቃል።

Agent የማይያደርገው

ግልጽ ድንበሮች። Agent በእሱ ስፋት በተወሰነ መልኩ የተገደበ ነው።

በserverዎ ላይ ማንኛውንም inbound ports አይከፍትም
የfirewall ደንቦችዎን (iptables፣ nftables፣ firewalld) አይቀይርም
SSH keys አይጭንም ወይም አይቀይርም
በserverዎ ላይ ሌሎች መተግበሪያዎችን አይደርስም
የstream ይዘትን በCASTOVIA serverዎች አያስተላልፍም (streams በYOUR network ላይ ይቆያሉ)
የተመዝጋቢ የግል ውሂብ በnode ላይ አያከማችም
VPN ወይም ልዩ የnetwork ውቅር አይፈልግም
ከመጀመሪያው መጫን በኋላ እንደ root አይሰራም

ደህንነት — አብሮ የተሰራ፣ እንጂ በኋላ የተጨመረ አይደለም

ሁሉም የደህንነት እርምጃዎች በራስ-ሰር ናቸው። በእጅ ማዋቀር አያስፈልግም።

Server Token ማረጋገጫ

በራስ-ሰር

እያንዳንዱ node ልዩ፣ cryptographically random server token (256-bit) ያገኛል። ይህ token node ሲፈጠር በCASTOVIA አስተዳዳሪ ውስጥ ይፈጠራል። በመመዝገብ ወቅት አንድ ጊዜ ይጠቀማል ከዚያም በሚሽከረከር TLS client certificate ይተካል።

TLS 1.3 ምስጢራዊነት

በራስ-ሰር

በagent እና CASTOVIA Cloud መካከል ያለው ሁሉም ግንኙነት TLS 1.3 ይጠቀማል። Agent የCASTOVIA certificate chainን ከpinned root CA ጋር ያረጋግጣል — በsystem certificate store ላይ እምነት የለም። Man-in-the-middle ጥቃቶች አይቻሉም።

Firewall መስፈርቶች

በራስ-ሰር

Agent የሚፈልገው CASTOVIA Cloud ወደ ውጭ HTTPS (port 443) ብቻ ነው። ምንም inbound ports መከፈት አያስፈልግም። የserverዎ ፋየርዎል ደንቦች አልተነኩም — agent iptables፣ nftables ወይም firewalld አይቀይርም።

በruntime ወቅት root መዳረሻ አያስፈልግም

በራስ-ሰር

Agent የተለየ ያልተፈቀደለት ተጠቃሚ (castovia-agent) እንደሆነ ይሰራል። የsystemd service ለመፍጠር ብቻ በመጫን ወቅት root ያስፈልገዋል። በruntime ወቅት በትንሽ ፈቃዶች ይሰራል — የstream ምንጮችን ለማንበብ ፈቃድ፣ የራሱን cache directory ለመጻፍ ፈቃድ።

Automatic Certificate Rotation

በራስ-ሰር

Client certificates በ7 ቀን አንድ ጊዜ ይተካሉ። Agent ዳግም መታደስን በግልጽነት ይቆጣጠራል። Certificate ቢያበቃ (ለምሳሌ server ከመስመር ውጭ ከሆነ) በCASTOVIA አስተዳዳሪ ውስጥ ፈቃድ የሚፈልግ ደህንነታዊ re-enrollment flow ይጠቀማል።

የጤና ክትትል እና ራስ-መፈወስ

በራስ-ሰር

Agent የራሱን ጤና ይቆጣጠራል። ቢወድቅ systemd በ5 ሰከንድ ውስጥ ዳግም ያስነሳዋል። CASTOVIA Cloud ሊደርስበት ካልቻለ cached configuration መስጠት ይቀጥላል እና መለኪያዎችን ለኋላ ማስረከብ ወደ queue ያስገባል።

የግንኙነት ፕሮቶኮል

ውሂብ በserverዎ እና CASTOVIA Cloud መካከል እንዴት እንደሚፈስ።

CASTOVIA Cloud → Agent (Configuration Push)

Stream ውቅሮች (source URLs፣ transcoding profiles፣ recording schedules)
Nginx config fragments ለmedia serving
Catch-up እና timeshift ደንቦች
EPG ውሂብ እና channel logos
Package/bouquet መመደቢያዎች
የsubscriber entitlement ማዘመኛዎች

ቴክኒካዊ: Configuration የሚደርሰው እንደ ፊርማ ያላቸው JSON payloads ነው። Agent እያንዳንዱ payload ከመተግበሩ በፊት ያረጋግጣል። ምንም raw SQL፣ shell commands የለም — በቅጥ የተደረገ configuration ብቻ።

Agent → CASTOVIA Cloud (Telemetry)

Server ጤና፦ CPU፣ RAM፣ የdisk አጠቃቀም፣ network I/O
Stream ሁኔታ፦ active streams፣ bitrate፣ error rates
Recording ሁኔታ፦ active recordings፣ storage የተጠቀመበት፣ የመጠናቀቂያ ሁኔታ
FFmpeg ሥራ ውጤቶች፦ transcode መጠናቀቅ፣ ስህተቶች፣ የoutput file መጠኖች
የተመልካች ግንኙነት ብዛቶች (anonymous aggregate — የግል ውሂብ የለም)
Agent ስሪት እና ዝማኔ መገኘት

ቴክኒካዊ: Telemetry በእያንዳንዱ 30 ሰከንድ በHTTPS POST ይላካል። Payload ይጨመቃል (gzip) እና ይመሰጥራል። አማካይ መጠን: በእያንዳንዱ ክፍተት 2–5 KB።

የNetwork ማጠቃለያ

ገጽታዝርዝር
ፕሮቶኮልHTTPS (TLS 1.3) ከcertificate pinning ጋር
ወደ ውጭ Port443 (HTTPS ብቻ)
Inbound PortsCASTOVIA የሚፈልገው ምንም የለም
Heartbeatበእያንዳንዱ 30 ሰከንድ (2–5 KB ተጨብጦ)
ማረጋገጫRotating TLS client certificates (7 ቀን ማሽከርከር)
Bandwidth< 1 MB/ሰዓት ለአስተዳደር ትራፊክ
ከመስመር ውጭ ባህሪCached config ያቀርባል፣ telemetry ወደ queue ያስገባል፣ auto-reconnect ያደርጋል
Stream ትራፊክፈጽሞ በCASTOVIA አይመራም — በእርስዎ network ላይ ይቆያል

ንጹሕ ማስወገድ

Node ካስወገዱ agent ሙሉ በሙሉ ይጸዳል፦

sudo castovia-agent uninstall --purge
systemd serviceውን ያቆማል እና ያስወግዳል
binaryውን ከ/opt/castovia/ ይሰርዛል
ከ/etc/castovia/ ሁሉንም configuration ያስወግዳል
castovia-agent system userን ያስወግዳል
client certificateን በCASTOVIA Cloud ላይ ያጠፋል
ምንም የቀረ ፋይል፣ process ወይም cron job የለም