Agent และการสื่อสาร

หนึ่งคำสั่ง ปลอดภัยเต็มรูปแบบ.

CASTOVIA agent ติดตั้งเสร็จภายในไม่ถึง 60 วินาที จัดการความปลอดภัยอัตโนมัติ และสื่อสารกับ CASTOVIA Cloud ผ่านช่องทางที่เข้ารหัส ไม่มีการตั้งค่า firewall ด้วยตนเอง ไม่มี SSH keys ไม่มี VPN

อธิบายคำสั่งติดตั้ง

เกิดอะไรขึ้นแบบเป๊ะๆ เมื่อคุณรันตัวติดตั้งบรรทัดเดียวบนเซิร์ฟเวอร์ Linux ของคุณ

สิ่งที่คำสั่งทำ

คำสั่งติดตั้งบรรทัดเดียวที่คุณคัดลอกจากแดชบอร์ดผู้ดูแลระบบ CASTOVIA จะดำเนินการขั้นตอนต่อไปนี้บนเซิร์ฟเวอร์ Linux ของคุณ:

ดาวน์โหลดไบนารีของ CASTOVIA agent (~15 MB) จาก CDN ทางการ
ตรวจสอบลายเซ็นของไบนารี (SHA-256 + GPG) เพื่อป้องกันการแก้ไขดัดแปลง
สร้างผู้ใช้ระบบเฉพาะ: castovia-agent (ไม่มี login shell, ไม่มี sudo)
ติดตั้งไบนารีไปที่ /opt/castovia/agent
สร้างไดเรกทอรีการกำหนดค่า /etc/castovia/ พร้อมสิทธิ์จำกัด (0700)
เขียน server token (ไม่ซ้ำต่อโหนด) ไปที่ /etc/castovia/token.conf
ลงทะเบียน agent เป็นบริการ systemd: castovia-agent.service
เริ่มบริการและเปิดใช้งานการเริ่มอัตโนมัติเมื่อบูต
ทำ handshake ครั้งแรกกับ CASTOVIA Cloud เพื่อลงทะเบียนโหนด

คำสั่งจริง

คำสั่งที่คุณเห็นในแดชบอร์ดผู้ดูแลระบบมีลักษณะดังนี้:

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

YOUR_SERVER_TOKEN คือโทเค็นแบบใช้ครั้งเดียวที่ไม่ซ้ำกันซึ่งสร้างต่อโหนดแต่ละตัว มันจะหมดอายุหลังจาก 24 ชั่วโมงหากไม่ได้ใช้งาน

Agent จะไม่ทำอะไรบ้าง

ขอบเขตชัดเจน Agent ถูกจำกัดความสามารถโดยตั้งใจ

ไม่เปิดพอร์ตขาเข้าใดๆ บนเซิร์ฟเวอร์ของคุณ
ไม่แก้ไขกฎ firewall ของคุณ (iptables, nftables, firewalld)
ไม่ติดตั้งหรือแก้ไข SSH keys
ไม่เข้าถึงแอปพลิเคชันอื่นๆ บนเซิร์ฟเวอร์ของคุณ
ไม่ส่งคอนเทนต์สตรีมผ่านเซิร์ฟเวอร์ CASTOVIA (สตรีมยังคงอยู่บนเครือข่ายของคุณ)
ไม่เก็บข้อมูลส่วนบุคคลของสมาชิกไว้บนโหนด
ไม่ต้องใช้ VPN หรือการตั้งค่าเครือข่ายพิเศษ
ไม่ทำงานเป็น root หลังการติดตั้งครั้งแรก

ความปลอดภัย — มีมาในตัว ไม่ได้ต่อเติมทีหลัง

ทุกมาตรการความปลอดภัยเป็นอัตโนมัติ ไม่ต้องตั้งค่าด้วยตนเอง

การยืนยันตัวตนด้วย Server Token

อัตโนมัติ

ทุกโหนดจะได้รับ server token แบบสุ่มเชิงคริปโตที่ไม่ซ้ำกัน (256-bit) โทเค็นนี้สร้างในแอดมิน CASTOVIA เมื่อคุณสร้างโหนด ใช้เพียงครั้งเดียวระหว่างการลงทะเบียน แล้วจะถูกแทนที่ด้วย TLS client certificate ที่หมุนเวียน

การเข้ารหัส TLS 1.3

อัตโนมัติ

การสื่อสารทั้งหมดระหว่าง agent และ CASTOVIA Cloud ใช้ TLS 1.3 Agent ตรวจสอบ chain ใบรับรองของ CASTOVIA เทียบกับ root CA ที่ pin ไว้ — ไม่เชื่อถือ certificate store ของระบบ การโจมตีแบบ man-in-the-middle ทำไม่ได้

ข้อกำหนดของ Firewall

อัตโนมัติ

agent ต้องการเพียง outbound HTTPS (พอร์ต 443) ไปยัง CASTOVIA Cloud ไม่จำเป็นต้องเปิดพอร์ตขาเข้า กฎ firewall ของเซิร์ฟเวอร์คุณจะไม่ถูกแตะต้อง — agent ไม่แก้ไข iptables, nftables หรือ firewalld

ไม่ต้องใช้สิทธิ์ root ระหว่างรันไทม์

อัตโนมัติ

agent ทำงานภายใต้ผู้ใช้ที่ไม่มีสิทธิ์เฉพาะ dedicated (castovia-agent) โดยต้องใช้ root เฉพาะระหว่างการติดตั้ง (เพื่อสร้างบริการ systemd) ระหว่างรันไทม์จะทำงานด้วยสิทธิ์ขั้นต่ำ — อ่านแหล่งสตรีมได้ และเขียนได้เฉพาะไดเรกทอรีแคชของตัวเอง

การหมุนเวียนใบรับรองอัตโนมัติ

อัตโนมัติ

client certificates จะหมุนทุก 7 วัน agent จัดการการต่ออายุอย่างโปร่งใส หากใบรับรองหมดอายุ (เช่น เซิร์ฟเวอร์ออฟไลน์) agent จะใช้กระบวนการ re-enrollment ที่ปลอดภัยซึ่งต้องได้รับการอนุมัติในแอดมิน CASTOVIA

การเฝ้าระวังสุขภาพและการกู้คืนตัวเอง

อัตโนมัติ

agent ตรวจสอบสุขภาพของตัวเอง หากขัดข้อง systemd จะรีสตาร์ตภายใน 5 วินาที หากไม่สามารถเชื่อมต่อ CASTOVIA Cloud ได้ มันจะยังคงให้บริการการกำหนดค่าแคชและจัดคิวเมตริกเพื่อส่งในภายหลัง

โปรโตคอลการสื่อสาร

ข้อมูลไหลระหว่างเซิร์ฟเวอร์ของคุณกับ CASTOVIA Cloud อย่างไร

CASTOVIA Cloud → Agent (Configuration Push)

การกำหนดค่าสตรีม (source URLs, โปรไฟล์ transcoding, ตารางเวลาการบันทึก)
ชิ้นส่วนการตั้งค่า Nginx สำหรับการให้บริการสื่อ
กฎ catch-up และ timeshift
ข้อมูล EPG และโลโก้ช่อง
การกำหนดแพ็กเกจ/บูเกต์
การอัปเดตสิทธิ์สมาชิก

เชิงเทคนิค: การกำหนดค่าถูกส่งในรูปแบบ payload JSON ที่ลงลายเซ็นแล้ว Agent ตรวจสอบ payload แต่ละชิ้นก่อนนำไปใช้ ไม่มี raw SQL ไม่มี shell commands — มีเพียงการกำหนดค่าที่มีโครงสร้าง

Agent → CASTOVIA Cloud (Telemetry)

สุขภาพเซิร์ฟเวอร์: CPU, RAM, การใช้งานดิสก์, เครือข่าย I/O
สถานะสตรีม: สตรีมที่ใช้งานอยู่, bitrate, อัตราข้อผิดพลาด
สถานะการบันทึก: การบันทึกที่กำลังทำงาน, พื้นที่เก็บข้อมูลที่ใช้, สถานะเสร็จสมบูรณ์
ผลลัพธ์งาน FFmpeg: การแปลงเสร็จสิ้น, ข้อผิดพลาด, ขนาดไฟล์ผลลัพธ์
จำนวนการเชื่อมต่อของผู้ชม (สรุปรวมแบบไม่ระบุตัวตน — ไม่มีข้อมูลส่วนบุคคล)
เวอร์ชัน agent และความพร้อมใช้งานของการอัปเดต

เชิงเทคนิค: Telemetry ถูกส่งทุก 30 วินาทีผ่าน HTTPS POST payload ถูกบีบอัด (gzip) และเข้ารหัส ขนาดเฉลี่ย: 2–5 KB ต่อรอบ

สรุปเครือข่าย

ด้านรายละเอียด
โปรโตคอลHTTPS (TLS 1.3) พร้อม certificate pinning
พอร์ตขาออก443 (เฉพาะ HTTPS)
พอร์ตขาเข้าCASTOVIA ไม่ต้องการ
Heartbeatทุก 30 วินาที (บีบอัด 2–5 KB)
การยืนยันตัวตนTLS client certificates แบบหมุนเวียน (หมุนทุก 7 วัน)
แบนด์วิดท์< 1 MB/ชั่วโมง สำหรับทราฟฟิกการจัดการ
พฤติกรรมออฟไลน์ให้บริการการกำหนดค่าที่แคชไว้ จัดคิว telemetry และเชื่อมต่อใหม่อัตโนมัติ
ทราฟฟิกสตรีมไม่ถูกส่งผ่าน CASTOVIA — อยู่บนเครือข่ายของคุณเสมอ

ถอนการติดตั้งอย่างสะอาด

หากคุณลบโหนด agent จะล้างทุกอย่างออกทั้งหมด:

sudo castovia-agent uninstall --purge
หยุดและลบบริการ systemd
ลบไบนารีออกจาก /opt/castovia/
ลบการกำหนดค่าทั้งหมดออกจาก /etc/castovia/
ลบผู้ใช้ระบบ castovia-agent
เพิกถอน client certificate บน CASTOVIA Cloud
ไม่มีไฟล์ กระบวนการ หรือ cron jobs หลงเหลืออยู่