SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor · อัปเดตเมื่อ 2026-10-20

เปลี่ยน Jellyfin เป็นร้านวิดีโอ 90s ด้วย Halcyon

เปลี่ยนคลังสื่อ Jellyfin ให้เป็นร้านเช่าวิดีโอในยุค 90 เดินเลือกชมได้ผ่านเบราว์เซอร์ พร้อมวิธีตั้งค่าผ่าน Docker การทำ Reverse Proxy และข้อควรระวังก่อนใช้งานจริง

สิ่งที่ Halcyon ทำกับคลังสื่อ Jellyfin ของคุณ

Halcyon Video จะเปลี่ยนหน้าตาคลังสื่อ Jellyfin ของคุณให้กลายเป็นร้านเช่าวิดีโอในยุค 1990 ที่คุณสามารถเดินเลือกชมได้ผ่านเว็บเบราว์เซอร์ ภาพยนตร์ทุกเรื่องที่คุณมีจะถูกแสดงเป็นกล่องวิดีโอวางอยู่บนชั้นวาง คุณสามารถเดินไปตามทางเดินใต้แสงไฟนีออน หยิบกล่องวิดีโอลงมา พลิกดูรายละเอียดที่ด้านหลัง และนำไปที่เคาน์เตอร์เพื่อเริ่มเล่นวิดีโอ ระบบจะรายงานสถานะการเริ่มเล่น ความคืบหน้า และการหยุดเล่นกลับไปยัง Jellyfin เพื่อให้จุดที่รับชมค้างไว้และประวัติการรับชมมีความถูกต้อง

Halcyon อ่านข้อมูลจากเซิร์ฟเวอร์ Jellyfin ที่มีอยู่ผ่านทาง Jellyfin API โดยไม่ได้สร้างคลังสื่อของตนเองขึ้นมาใหม่ คู่มือนี้ตั้งสมมติฐานว่า Jellyfin กำลังทำงานและสแกนข้อมูลได้อย่างถูกต้อง หากยังไม่เป็นเช่นนั้น ให้ตั้งค่า Jellyfin ในฐานะมีเดียเซิร์ฟเวอร์บน VPS ให้เรียบร้อยก่อน แล้วจึงกลับมาดำเนินการต่อเมื่อคลังสื่อของคุณแสดงผลในเว็บไคลเอนต์ปกติได้อย่างถูกต้อง นี่คือซอฟต์แวร์ประเภทที่คุณติดตั้งเพราะคุณมีคลังสื่ออยู่แล้ว ไม่ใช่เพราะคุณต้องการบริการเพิ่มใน รายการบริการที่คุณโฮสต์เอง

โครงการนี้อยู่ภายใต้สัญญาอนุญาต GPL-3.0 และพัฒนาโดยบุคคลเพียงคนเดียว โดยในไฟล์ README ระบุไว้อย่างชัดเจนว่าไม่รับการส่ง Pull Request การพัฒนาดำเนินไปอย่างรวดเร็วและไม่มีผู้ดูแลคนอื่นคอยตรวจสอบข้อผิดพลาดที่อาจเกิดขึ้นใหม่ (regression) ดังนั้นควรระบุเวอร์ชันของอิมเมจ (pin version) ให้ชัดเจนก่อนที่จะนำร้านวิดีโอนี้ไปเปิดให้ผู้อื่นใช้งาน โดยเนื้อหาในส่วนสุดท้ายจะอธิบายวิธีการดำเนินการดังกล่าว

การเรนเดอร์เกิดขึ้นที่ไหน?

เกิดขึ้นในเบราว์เซอร์ Halcyon เป็นแอปพลิเคชันที่สร้างด้วย Vite และ TypeScript โดยใช้ three.js ซึ่งเป็นไลบรารี JavaScript สำหรับวาดกราฟิก 3D ผ่าน WebGL (Web Graphics Library ซึ่งเป็นอินเทอร์เฟซของเบราว์เซอร์ที่เชื่อมต่อกับ GPU) รูปทรงของร้านค้าและภาพหน้าปกจะถูกนำมาประกอบกันโดยเครื่องที่แสดงผลหน้าจอนั้น

คอนเทนเนอร์ทำหน้าที่เพียงเล็กน้อยเท่านั้น มันรัน npm run serve ซึ่งก็คือ vite preview --port 1420 --strictPort --host และทำหน้าที่ให้บริการไฟล์ที่ build แล้ว รวมถึง middleware route ขนาดเล็กอีกจำนวนหนึ่ง Halcyon ไม่มีการทำ transcoding และไม่รัน engine ใดๆ บนเซิร์ฟเวอร์

ดังนั้นคำถามเรื่อง GPU จึงเป็นเรื่องของฝั่งไคลเอนต์ VPS ขนาดเล็กสามารถให้บริการส่วนนี้ได้อย่างราบรื่น เพราะการให้บริการหมายถึงการส่งไฟล์แบบ static และ route ที่เบาบางผ่าน HTTP แล็ปท็อป แท็บเล็ต หรือโทรทัศน์ที่รันเบราว์เซอร์จะเป็นตัวตัดสินว่าร้านค้าจะแสดงผลได้อย่างลื่นไหลหรือกระตุก

มีฟีเจอร์หนึ่งที่ขัดกับกฎนี้ คือ Remote Play ซึ่งจะสร้าง instance ของ Chromium แบบ headless บนเซิร์ฟเวอร์แยกตามผู้เข้าชมแต่ละคน และสตรีมร้านค้าที่เรนเดอร์แล้วไปยังโทรศัพท์หรือ set-top box ผ่าน WebRTC (Web Real Time Communication) เส้นทางนั้นจะเรนเดอร์บนเซิร์ฟเวอร์ โดยจำกัดไว้ที่ 2 instance ตามค่าเริ่มต้นและสามารถปรับเปลี่ยนได้ด้วย REMOTE_PLAY_MAX_INSTANCES ฟีเจอร์นี้จำเป็นต้องใช้ GPU บนเซิร์ฟเวอร์ด้วย อิมเมจที่เผยแพร่ออกมาไม่ได้มาพร้อมกับ software renderer ดังนั้นหากไม่มีการแมป /dev/dri render node เซิร์ฟเวอร์จะปฏิเสธการเริ่มทำงานของร้านค้าส่วนตัวและตอบกลับด้วย This store server has no GPU available, so it can’t render a private store.

สิ่งที่ร้านค้าอ่านจากคลังข้อมูลของคุณ

ชั้นวางสินค้ามาจากโครงสร้างของ Jellyfin โดยตรง Halcyon จะจัดวางส่วนต่างๆ ตามคลังข้อมูลและประเภทสื่อของคุณ และจัดกลุ่มภาคต่อจาก BoxSets ของคุณ ข้อมูลจำเพาะที่พิมพ์อยู่ด้านหลังกล่องแต่ละกล่องมาจาก metadata ของ MediaStreams ที่ Jellyfin จัดเก็บไว้อยู่แล้ว ซึ่งหมายความว่าหากข้อมูลใดขาดหายไปใน Jellyfin ข้อมูลนั้นก็จะขาดหายไปบนชั้นวางด้วยเช่นกัน

สิ่งนี้ทำให้ร้านค้าเป็นภาพสะท้อนที่แม่นยำของ metadata ของคุณ คลังข้อมูลที่จัดการผ่าน an arr stack ใน Docker Compose ซึ่งมีการใส่ภาพปกและประเภทสื่อไว้ครบถ้วนแล้ว จะดูดีกว่าโฟลเดอร์ที่มีไฟล์กระจัดกระจายและตั้งชื่อแบบทั่วไปมาก คลังรูปภาพก็มีความขึ้นตรงต่อสิ่งที่ทำดัชนีข้อมูลเหล่านั้นเช่นเดียวกัน ซึ่งเป็นสิ่งที่ควรคำนึงถึงเมื่อคุณเปรียบเทียบ PhotoPrism กับ Immich สำหรับภาพนิ่งที่เก็บอยู่บนเซิร์ฟเวอร์เดียวกัน

ทดลองใช้งานเดโมร้านวิดีโอก่อนทำการติดตั้ง

โปรเจกต์นี้มี เดโม ให้ใช้งานโดยไม่ต้องติดตั้งเซิร์ฟเวอร์และไม่ต้องเข้าสู่ระบบ ในซอร์สโค้ดปัจจุบัน บิลด์ที่โฮสต์ไว้นี้จะแสดงรายการภาพยนตร์แบบสตรีมมิ่ง ไม่ใช่คลังข้อมูลในรูปแบบของคุณ ดังนั้นให้มองว่าเป็นการดูตัวอย่างร้านค้าเท่านั้น การเพิ่ม ?demo=1 ต่อท้าย URL ของการติดตั้งของคุณเองจะเป็นการโหลดคลังข้อมูลจำลองขึ้นมาแทน

คลังข้อมูลจำลองนี้คือการทดสอบฮาร์ดแวร์ โดยมีข้อควรทราบคือ ระบบจะปรับขนาดตามอุปกรณ์ เบราว์เซอร์ที่มี GPU เหลือเฟือจะแสดงรายการสินค้าเต็มจำนวนประมาณ 2,000 รายการ GPU ระดับกลางจะแสดงประมาณ 800 รายการ ส่วนโทรศัพท์หรือเบราว์เซอร์ใดก็ตามที่รายงานว่ามีหน่วยความจำอุปกรณ์ 4 GB หรือน้อยกว่า จะแสดงประมาณ 300 รายการ เดโมที่ทำงานได้อย่างราบรื่นบนอุปกรณ์ประสิทธิภาพต่ำนั้นได้ลดขนาดตัวเองลงแล้ว จึงไม่ได้บ่งบอกว่าคลังข้อมูลฉบับเต็มของคุณจะทำงานบนอุปกรณ์นั้นได้อย่างไร การทดสอบที่มีประโยชน์คือการใช้อุปกรณ์ที่สามารถโหลดรายการสินค้าได้เต็มจำนวน หากการแสดงผลกระตุก คลังข้อมูลของคุณที่มีขนาดใกล้เคียงกันก็จะกระตุกเช่นกัน และวิธีแก้ไขคือการใช้โหมด 2.5D ตามที่อธิบายไว้ด้านล่าง แทนการขยายขนาด VPS

การรันด้วย Docker

นี่คือคำสั่งที่เอกสารต้นฉบับระบุไว้

docker run -d --name halcyon --network host --restart unless-stopped \
  ghcr.io/halcyon-video/halcyon-video

จากนั้นตรวจสอบว่าบริการเริ่มทำงานแล้ว

docker logs halcyon
curl -I http://127.0.0.1:1420

Log ควรแสดงว่า preview server กำลังฟังอยู่ที่พอร์ต 1420 และ curl ควรตอบสนองต่อ HTTP/1.1 200 OK หากคอนเทนเนอร์หยุดทำงานภายในเวลาไม่กี่วินาที มักเกิดจากปัญหาพอร์ตใช้งานอยู่ --strictPort หมายความว่าเซิร์ฟเวอร์ปฏิเสธที่จะเปลี่ยนไปใช้พอร์ต 1421 เมื่อพอร์ต 1420 ถูกใช้งานอยู่ จึงหยุดทำงานแทน

--network host มีไว้สำหรับ Remote Play ไม่ใช่สำหรับหน้าร้านค้า WebRTC จำเป็นต้องประกาศที่อยู่จริงของเครื่องให้กับอุปกรณ์ที่ต้องการรับสตรีม ภายใต้ Docker bridge เริ่มต้น คอนเทนเนอร์จะรู้จักเพียงที่อยู่ 172.x ของตัวเองเท่านั้น ซึ่งโทรศัพท์ในเครือข่ายของคุณไม่สามารถเข้าถึงได้ ทำให้สตรีมไม่สามารถเชื่อมต่อได้ หากคุณต้องการเพียงแค่เข้าถึงหน้าร้านค้าผ่านเบราว์เซอร์ ให้ใช้วิธี publish พอร์ตแทน

docker run -d --name halcyon -p 1420:1420 --restart unless-stopped \
  ghcr.io/halcyon-video/halcyon-video

นั่นเป็นค่าเริ่มต้นที่ดีกว่าบน VPS เพราะ host networking จะนำคอนเทนเนอร์ไปวางบนทุกอินเทอร์เฟซที่เครื่องมี รวมถึงอินเทอร์เฟซสาธารณะ การรัน Docker บน VPS ครอบคลุมรายละเอียดส่วนที่เหลือของประเด็นนี้ --restart unless-stopped คือสิ่งที่ทำให้หน้าร้านค้ากลับมาทำงานหลังจากการรีบูต ซึ่งเป็นแนวคิดเดียวกับ การตั้งค่า Compose services ให้เริ่มทำงานตอนบูต

การโคลน repository และรัน docker compose up -d จะเป็นการ build image ในเครื่องแทน ไฟล์ Compose ที่ให้มาจะ build จากซอร์สโค้ดเป็นค่าเริ่มต้น และมีบรรทัด image: ที่ถูกคอมเมนต์ไว้ ดังนั้นให้เอาคอมเมนต์ออกหากคุณต้องการใช้ image ที่เผยแพร่อยู่แล้วภายใต้ Compose

Image ที่เผยแพร่ครอบคลุมทั้ง linux/amd64 และ linux/arm64 จากการตรวจสอบเมื่อวันที่ 11 ตุลาคม 2026 รุ่น 0.25.0 ปัจจุบันระบุ digest แยกต่างหากสำหรับแต่ละแพลตฟอร์ม ดังนั้น VPS แบบ arm64 จึงดึง image ด้วยคำสั่งเดียวกับโฮสต์อื่น ช่วงเวลาที่รองรับเฉพาะ amd64 นั้นสั้นมาก โดย changelog ได้ตัด image arm64 ออกใน v0.2.1 เมื่อวันที่ 8 สิงหาคม 2026 และนำกลับมาอีกครั้งโดย build บน native runners ใน v0.4.0 เมื่อวันที่ 11 สิงหาคม 2026 เฉพาะโฮสต์ที่ล็อกเวอร์ชันไว้กับ tag ในช่วงเวลาดังกล่าวเท่านั้นที่จำเป็นต้อง build จากการโคลน repository

ชี้เป้าไปยังเซิร์ฟเวอร์ Jellyfin ของคุณ

เปิด http://<host>:1420 แล้วเข้าสู่ระบบด้วยที่อยู่เซิร์ฟเวอร์ Jellyfin ชื่อผู้ใช้ และรหัสผ่านของคุณ ไฟล์ .env.local.example ใน repository มีไว้สำหรับการพัฒนาในเครื่องเท่านั้น Vite จะเปิดเผยตัวแปรที่มีคำนำหน้าว่า VITE_ ให้กับโค้ดฝั่งไคลเอ็นต์ ดังนั้นรหัสผ่าน Jellyfin ที่เขียนไว้ในนั้นจะถูกคอมไพล์รวมเข้าไปใน JavaScript bundle ที่ผู้เข้าชมทุกคนดาวน์โหลดไป หากเป็นเซิร์ฟเวอร์ที่ผู้อื่นเข้าถึงได้ ให้เข้าสู่ระบบผ่านอินเทอร์เฟซแทน

เบราว์เซอร์จะสื่อสารกับ Jellyfin โดยตรง คอนเทนเนอร์ของ Halcyon ไม่ได้ทำหน้าที่เป็นพร็อกซีให้กับ Jellyfin API ซึ่งมีผลลัพธ์สองประการที่ควรทราบก่อนเริ่มการดีบั๊ก

ประการแรก Jellyfin ต้องสามารถเข้าถึงได้จากเบราว์เซอร์ ไม่ใช่แค่จาก VPS ที่ให้บริการ Halcyon เท่านั้น การผูก Jellyfin ไว้กับ 127.0.0.1:8096 นั้นใช้ได้สำหรับการทดสอบในเครื่อง แต่จะทำให้ชั้นวางข้อมูลว่างเปล่าสำหรับผู้ใช้คนอื่น

ประการที่สอง การเรียกใช้งานเป็นการข้ามแหล่งที่มา (cross origin) จากที่อยู่ของ Halcyon ไปยังที่อยู่ของ Jellyfin โดยปกติแล้ว Jellyfin จะตอบกลับคำขอ API ด้วย Access-Control-Allow-Origin: * เป็นค่าเริ่มต้น จึงสามารถทำงานได้โดยไม่ต้องตั้งค่าเพิ่มเติม หากคุณจำกัดการตั้งค่านั้นไว้ หรือวาง authentication proxy ไว้หน้า Jellyfin API คอนโซลของเบราว์เซอร์จะรายงาน blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource และหน้าจอร้านค้าจะโหลดขึ้นมาโดยไม่มีข้อมูลแสดงผล

วางไว้หลัง reverse proxy พร้อมการยืนยันตัวตนที่ด้านหน้า

vite preview เป็นเซิร์ฟเวอร์สำหรับดูตัวอย่าง มันไม่ได้ทำ TLS (transport layer security) termination และไม่มีระบบควบคุมการเข้าถึงในตัว ดังนั้นจึงควรวางไว้หลัง nginx หรือ Caddy หากต้องเปิดใช้งานบนเครือข่ายสาธารณะ

server {
  listen 443 ssl;
  server_name halcyon.example.com;

  location / {
    proxy_pass http://127.0.0.1:1420;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

ชื่อโดเมนที่อยู่หน้าคอนเทนเนอร์จำเป็นต้องมีการตั้งค่าเพิ่มเติมอีกหนึ่งอย่าง Halcyon จะตอบสนองต่อ localhost, IP address โดยตรง และชื่อของเครื่องที่มันรันอยู่ เพื่อป้องกันการทำ DNS rebinding เมื่ออยู่ในคอนเทนเนอร์ เครื่องที่มันรันอยู่คือตัวคอนเทนเนอร์เอง ดังนั้น hostname ของมันจึงไม่ใช่ของคุณ คำขอที่เข้ามาในชื่อ halcyon.example.com จะถูกปฏิเสธ และการตอบกลับจะระบุชื่อโฮสต์ที่ถูกปฏิเสธ ให้เพิ่มชื่อนั้นเข้าไป

docker run -d --name halcyon -p 127.0.0.1:1420:1420 --restart unless-stopped \
  -e HALCYON_ALLOWED_HOSTS=halcyon.example.com \
  ghcr.io/halcyon-video/halcyon-video

ค่านี้คั่นด้วยเครื่องหมายจุลภาค การใส่จุดนำหน้าเช่น .example.com จะครอบคลุมถึง subdomain ทั้งหมด และ all จะเป็นการปิดการตรวจสอบนี้ ให้เลือกใช้ all เฉพาะบนเครื่องที่ไม่มีใครจากภายนอกเข้าถึงได้เท่านั้น

เมื่อ store ถูกให้บริการผ่าน https:// แล้ว ที่อยู่ของ Jellyfin ที่คุณพิมพ์ตอนล็อกอินจะต้องเป็น https:// ด้วยเช่นกัน เบราว์เซอร์จะบล็อกการเรียกใช้ API แบบ plain http:// ที่มาจากหน้า HTTPS และคอนโซลจะแสดงข้อความ Mixed Content: The page at 'https://halcyon.example.com/' was loaded over HTTPS, but requested an insecure resource การล็อกอินจะล้มเหลวโดยไม่มีคำอธิบายใดๆ ภายใน Halcyon ดังนั้นควรให้บริการทั้งคู่ผ่าน TLS หรือคงไว้เป็น plain HTTP ทั้งคู่ภายในเครือข่ายส่วนตัว

จากนั้นคือเรื่องการยืนยันตัวตน store จะถามหาข้อมูลประจำตัวของ Jellyfin ดังนั้นคนแปลกหน้าที่พบ URL นี้จะพบกับหน้าล็อกอิน แต่มีฟีเจอร์หนึ่งที่เปลี่ยนเรื่องนี้ การเปิดใช้งาน Remote Play ในเมนู Settings แล้วไปที่ Connection จะเป็นการส่งมอบเซสชัน Jellyfin ของคุณให้กับเซิร์ฟเวอร์ เพื่อให้ผู้ที่เข้ามาที่ /remote.html ได้ใช้งาน instance ของคลังสื่อจริงของคุณ นี่คือจุดประสงค์ของฟีเจอร์นี้ ซึ่งหมายความว่าความลับของ URL คือสิ่งที่กั้นระหว่างอินเทอร์เน็ตกับภาพยนตร์ของคุณ หากคุณเปิดใช้งาน Remote Play ให้ติดตั้ง single sign on ไว้หน้าเว็บไซต์ทั้งหมดด้วย Authentik ในฐานะเกตเวย์ SSO แบบ self-hosted หรือเลิกใช้ชื่อโฮสต์สาธารณะแล้วเข้าถึง store ผ่าน WireGuard tunnel ที่จัดการด้วย wg-easy

มีรายละเอียดสองประการที่ต้องทำควบคู่กันไป reverse proxy จะนำพาเฉพาะข้อมูลของ store เท่านั้น: สตรีมของ Remote Play เป็น WebRTC ผ่าน UDP ซึ่งไม่ผ่าน HTTP proxy ดังนั้นจึงต้องเปิดเส้นทางของตัวเองที่พอร์ต 3478/udp และช่วง 49200 ถึง 49260/udp เมื่อมีการใช้งาน TURN relay ที่มาพร้อมกัน และค่า docker run แบบ plain ด้านบนนั้นไม่ได้เก็บ volume ไว้ ดังนั้น seed ของ Remote Play จะไม่คงอยู่หลังจากการทำ docker rm ไฟล์ Compose จึงต้อง mount volume halcyon-data ไว้ที่ /data และตั้งค่า REMOTE_PLAY_SEED เป็น /data/remote-play-seed.json ด้วยเหตุผลนี้โดยเฉพาะ

สิ่งที่ควรทำเมื่อร้านค้าทำงานได้ไม่ดี

Halcyon จะแสดงผลตามความต้องการ ร้านค้าที่ไม่ได้ใช้งานจะไม่มีการประกอบเฟรม และการสูญเสียโฟกัสของหน้าต่างจะหยุดลูปการแสดงภาพเคลื่อนไหว ซึ่งเป็นเหตุผลว่าทำไมการเปิดแท็บทิ้งไว้จึงไม่ทำให้แบตเตอรี่แล็ปท็อปหมด สิ่งนี้ช่วยเครื่องที่มีประสิทธิภาพจำกัดได้บ้าง แต่ไม่มีผลกับเครื่องที่ไม่สามารถวาดภาพร้านค้าได้เลย

สำหรับไคลเอนต์เหล่านั้นจะมีโหมด 2.5D ซึ่งเป็น HTML และ CSS แบบปกติที่ไม่มี WebGL โดยมีไว้สำหรับฮาร์ดแวร์ขนาดเล็กอย่าง Raspberry Pi คุณสามารถสลับระหว่าง 3D และ 2.5D ได้จากเมนูการตั้งค่าหรือเมนูพลังงานโดยไม่ต้องโหลดหน้าเว็บใหม่ ดังนั้นการทดสอบทั้งสองโหมดบนอุปกรณ์เดียวกันจึงใช้เวลาเพียงไม่กี่วินาที โปรดมองความเป็นจริงเกี่ยวกับสิ่งที่คุณจะได้รับ: ในเดือนสิงหาคม 2026 ผู้เขียนเรียกโหมดแบนนี้ว่ายังไม่สมบูรณ์และกล่าวว่าโปรเจกต์นี้เพิ่งเริ่มต้นเท่านั้น ให้ถือว่าโหมดนี้เป็นทางเลือกสำรองสำหรับไคลเอนต์ที่มีประสิทธิภาพต่ำ

เมื่อไคลเอนต์มีขนาดเล็กเกินไปสำหรับร้านค้าแบบ 3D ความล้มเหลวจะเกิดขึ้นอย่างชัดเจน แท็บจะโหลดตัวเองใหม่ หรือเบราว์เซอร์จะรายงานว่า WebGL context สูญหาย ซึ่งมักเกิดขึ้นในขณะที่ชั้นวางกำลังโหลดข้อมูล ให้ย้ายอุปกรณ์นั้นไปใช้โหมด 2.5D แทนการลดขนาดคลังข้อมูลของคุณ

ตรึงเวอร์ชันอิมเมจและตรวจสอบก่อนดึงข้อมูล

โปรดให้ความสำคัญกับส่วนนี้เป็นพิเศษ แท็ก v0.1.0 ถึง v0.3.1 ถูกปล่อยออกมาห่างกันเพียงไม่กี่วัน และ v0.2.1 เกิดขึ้นเพียงเพราะการ push อิมเมจสำหรับ v0.2.0 ล้มเหลว อัตราการปล่อยอัปเดตยังคงรวดเร็วอย่างต่อเนื่อง โดย v0.25.0 ถูกเผยแพร่เมื่อวันที่ 7 ตุลาคม 2026 ซึ่งเป็นเวลา 3 วันหลังจาก v0.23.0 แม้จะยินดีรับรายงานบั๊กจากผู้ใช้ แต่ทางต้นทางไม่รับ patch ดังนั้น release stream นี้จึงเป็นเพียงสถานะการทำงานของบุคคลเพียงคนเดียวเท่านั้น

การรัน latest โดยติดนิสัยใช้ docker pull หมายความว่า store อาจเปลี่ยนแปลงไปจากเดิมได้ทุกเมื่อในวันอังคารทั่วไป ให้ตรึงเวอร์ชันด้วย digest ซึ่งเป็นข้อมูลอ้างอิงเพียงอย่างเดียวที่ไม่สามารถเปลี่ยนแปลงได้

docker buildx imagetools inspect ghcr.io/halcyon-video/halcyon-video:0.25.0

คำสั่งนี้จะแสดงค่า digest ที่อยู่เบื้องหลังแท็กนั้น ให้ใช้ค่านี้แทนการใช้แท็ก

docker run -d --name halcyon -p 1420:1420 --restart unless-stopped \
  ghcr.io/halcyon-video/halcyon-video@sha256:7fc00e619a30004d275faa79ad36d810e5a8530757132603065ba4e848dd67de

เมื่อวันที่ 11 ตุลาคม 2026 นั่นคือค่า digest ที่อยู่เบื้องหลังแท็ก 0.25.0 โปรดตรวจสอบค่าปัจจุบันด้วยตนเองแทนการคัดลอก และอ่านบันทึกการเปลี่ยนแปลง (release notes) ก่อนดำเนินการอัปเดต เนื่องจาก patch release ในที่นี้อาจมีการเปลี่ยนแปลงโครงสร้างของ store นอกเหนือไปจากการแก้ไขข้อผิดพลาดทั่วไป

FAQ

Halcyon จำเป็นต้องใช้ GPU บน VPS ของฉันหรือไม่?

ไม่จำเป็นสำหรับการใช้งานทั่วไป หน้าร้านจะถูกเรนเดอร์ด้วย three.js ในเบราว์เซอร์ ดังนั้นเครื่องไคลเอนต์จะเป็นผู้ประมวลผลการเรนเดอร์ ส่วนคอนเทนเนอร์จะทำหน้าที่ให้บริการไฟล์ที่ build แล้วและเส้นทางเซิร์ฟเวอร์ขนาดเล็กบางส่วนบนพอร์ต 1420 ข้อยกเว้นคือการใช้งาน Remote Play แบบ private instance ซึ่งจะรัน Chromium แบบ headless บนเซิร์ฟเวอร์และสตรีมผลลัพธ์ออกมา สำหรับอิมเมจที่เผยแพร่ เส้นทางดังกล่าวจำเป็นต้องมีการแมป /dev/dri เข้าไปในคอนเทนเนอร์ หากไม่มี GPU เซิร์ฟเวอร์จะปฏิเสธการเริ่มทำงานของ private store

ฉันสามารถนำ Halcyon ไปวางบนอินเทอร์เน็ตสาธารณะได้หรือไม่?

ทำได้ต่อเมื่อมีการป้องกันด้วยการยืนยันตัวตนเท่านั้น หน้าร้านจะร้องขอข้อมูลประจำตัวของ Jellyfin แต่การเปิดใช้งาน Remote Play จะเป็นการส่งมอบเซสชัน Jellyfin ของคุณให้กับเซิร์ฟเวอร์ ดังนั้นใครก็ตามที่โหลด /remote.html จะได้รับสิทธิ์เข้าถึงไลบรารีจริงของคุณโดยไม่ต้องล็อกอิน คุณควรติดตั้ง reverse proxy ที่มีระบบ single sign on ไว้ด้านหน้า หรือเก็บชื่อโฮสต์ไว้เป็นความลับไม่ให้ปรากฏบน public DNS และเข้าถึงหน้าร้านผ่าน VPN แทน

ทำไมชั้นวางสินค้าถึงว่างเปล่าหลังจากที่ฉันล็อกอิน?

เบราว์เซอร์จะเรียกใช้ Jellyfin API โดยตรง ดังนั้น Jellyfin จะต้องสามารถเข้าถึงได้จากเบราว์เซอร์ ไม่ใช่แค่จาก VPS เท่านั้น ให้เปิดคอนโซลของเบราว์เซอร์ดู หากพบ blocked by CORS policy หมายความว่า Jellyfin ไม่ยอมรับคำขอจากที่อยู่ของ Halcyon หากพบข้อความ Mixed Content หมายความว่าหน้าเว็บกำลังใช้งาน HTTPS ในขณะที่ที่อยู่ Jellyfin ที่คุณระบุเป็น HTTP ธรรมดา

ฉันจำเป็นต้องใช้ --network host หรือไม่?

จำเป็นเฉพาะสำหรับการใช้งาน Remote Play เท่านั้น WebRTC จำเป็นต้องประกาศที่อยู่จริงของเครื่อง และเมื่ออยู่หลัง Docker bridge คอนเทนเนอร์จะสามารถเสนอได้เพียงที่อยู่ 172.x ซึ่งโทรศัพท์ในเครือข่ายของคุณไม่สามารถเข้าถึงได้ สำหรับการเรียกดูหน้าร้านในเบราว์เซอร์ การใช้ -p 1420:1420 ก็เพียงพอแล้วและช่วยลดการเปิดเผยข้อมูลของโฮสต์ได้มากกว่า

ฉันควรใช้ image tag ใด?

ควรระบุเจาะจงที่ digest แทนการใช้ latest ให้ตรวจสอบ digest สำหรับเวอร์ชันที่มี docker buildx imagetools inspect ghcr.io/halcyon-video/halcyon-video:0.25.0 แล้วจึงรัน digest นั้น และย้ายเวอร์ชันต่อเมื่อได้อ่านบันทึกการเปลี่ยนแปลง (release notes) แล้วเท่านั้น ณ วันที่ 11 ตุลาคม 2026 อิมเมจที่เผยแพร่ได้รวมทั้ง linux/amd64 และ linux/arm64 ไว้แล้ว ดังนั้นโฮสต์ที่เป็น arm64 สามารถดึงอิมเมจไปใช้งานได้เหมือนปกติโดยไม่จำเป็นต้อง build จาก clone

บทความนี้มีประโยชน์หรือไม่