ข้ามไปยังเนื้อหาหลัก

🖥️ แอปเดสก์ท็อป

แอปเดสก์ท็อป Libre WebUI แสดงอินเทอร์เฟซเว็บในหน้าต่าง native บน macOS, Windows และ Linux โดยเชื่อมต่อกับเซิร์ฟเวอร์ Libre WebUI ที่ทำงานบนเครื่องเดียวกันหรือเซิร์ฟเวอร์ใดก็ตามที่คุณระบุ

แอปพัฒนาอยู่ใน repository แยก และตัวติดตั้งของทุกรุ่นแนบอยู่ใน GitHub releases ของ repository หลัก

📦 ดาวน์โหลดและติดตั้ง​

ดาวน์โหลดแพ็กเกจสำหรับแพลตฟอร์มของคุณจาก รุ่นล่าสุด:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg หรือ .zip หรือ brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe (ตัวติดตั้ง) หรือ Libre-WebUI-Desktop-{version}.exe (พกพา)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage หรือ Libre-WebUI-Desktop-{version}-{arch}.deb

รุ่นก่อนเปลี่ยนชื่อเผยแพร่ไฟล์เหล่านี้ด้วยคำนำหน้า Libre-WebUI-Frontend และชุดแอปชื่อ Libre WebUI Frontend.app

macOS บล็อกแอปเนื่องจากเห็นว่าเสียหาย​

Libre WebUI ใช้ลายเซ็น ad-hoc ชั่วคราวสำหรับ build macOS ซึ่งทำให้โครงสร้างชุดแอปถูกต้อง แต่ไม่ยืนยันผู้เผยแพร่กับ Apple และไม่สามารถรับรองได้ หลังคัดลอกแอปไปยัง Applications ให้อนุมัติใน การตั้งค่าระบบ → ความเป็นส่วนตัวและความปลอดภัย → เปิดต่อไป

หาก macOS ไม่มีตัวเลือกดังกล่าว ให้ลบแอตทริบิวต์ quarantine หลังยืนยันว่าแอปมาจากรุ่นทางการของ Libre WebUI เท่านั้น:

xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"

อย่าปิด Gatekeeper ทั้งระบบ การเผยแพร่โดยไร้อุปสรรคยังต้องใช้ใบรับรอง Developer ID Application และการรับรองจาก Apple

🔌 การเชื่อมต่อเซิร์ฟเวอร์​

แอปเป็นไคลเอนต์และต้องมีเซิร์ฟเวอร์ Libre WebUI เมื่อเปิดครั้งแรก หน้าต้อนรับมีสองทางเลือก:

  • ในเครื่อง: แอปตรวจหาเซิร์ฟเวอร์บนเครื่อง (พอร์ต 3001 ซึ่งเป็นค่าเริ่มต้นของ image Docker และ npx libre-webui) แล้วเชื่อมต่อเมื่อการตรวจสุขภาพตอบกลับ
  • ระยะไกล: ป้อน URL ของเซิร์ฟเวอร์ Libre WebUI ที่เข้าถึงได้ เช่น homelab หรือการติดตั้งแบบทีม แอปจะตรวจสอบก่อนเชื่อมต่อ

ระบบจะจำตัวเลือก หากต้องการเปลี่ยนเซิร์ฟเวอร์ภายหลัง ให้ใช้ Libre WebUI → เปลี่ยนเซิร์ฟเวอร์… ในแถบเมนู หากเซิร์ฟเวอร์ที่จำไว้หยุดตอบ แอปจะกลับไปหน้าต้อนรับแทนหน้าต่างว่าง

การรันเซิร์ฟเวอร์ในเครื่องดูได้ที่ เริ่มต้นอย่างรวดเร็ว: รองรับทั้ง Docker Compose, npx libre-webui และ Homebrew

🧰 Work ในแอปเดสก์ท็อป​

แพ็กเกจเดสก์ท็อปไม่มี backend, Docker หรือ runtime คอนเทนเนอร์ Work ความพร้อมของ Work ขึ้นกับเซิร์ฟเวอร์ที่เชื่อมต่อ:

  • backend native ที่รัน docker info ได้จะสร้างคอนเทนเนอร์ Work และ volume แบบมีชื่อตามขอบเขตงาน
  • การติดตั้ง Compose มาตรฐานของ repository มี Work ที่ใช้ Docker โดยเมานต์ socket Docker ของโฮสต์ ส่วนการติดตั้งคอนเทนเนอร์แบบกำหนดเองที่เข้าถึง runtime ไม่ได้จะรายงานว่า Work ไม่พร้อมใช้
  • เซิร์ฟเวอร์ Kubernetes มี Work ที่ใช้ Pod/PVC เมื่อ chart Helm ติดตั้งด้วย work.enabled=true; และ
  • แอปยังรองรับแชตเมื่อ Work ไม่พร้อมใช้

ไฟล์ Work อยู่บนโฮสต์ Docker หรือพื้นที่เก็บ Kubernetes ของเซิร์ฟเวอร์ ไม่ได้อยู่ในแอปเดสก์ท็อป ตัวอย่างเดินทางผ่าน proxy same-origin ที่ลงนามของ Libre WebUI ดังนั้นไคลเอนต์เดสก์ท็อปทั้งในเครื่องและระยะไกลจึงใช้ได้เมื่อ reverse proxy ของเซิร์ฟเวอร์รักษาทราฟฟิก HTTP และ WebSocket

🎨 การผสานกับเดสก์ท็อป​

  • แถบเมนู native พร้อมเมนูแอป แก้ไข มุมมอง หน้าต่าง และช่วยเหลือ
  • แถบชื่อ macOS แบบกำหนดเอง (hiddenInset) พร้อมปุ่มไฟจราจรในแถบด้านข้าง
  • โหมดมืดตามการตั้งค่าระบบ
  • ลิงก์ภายนอกเปิดในเบราว์เซอร์เริ่มต้น ไม่เปิดในแอป
  • renderer ทำงานโดยแยกบริบทและไม่ผสาน Node

🚧 ข้อจำกัด​

  • สถาปัตยกรรม macOS: แพ็กเกจ macOS ปัจจุบันรองรับเฉพาะ Apple Silicon (arm64)
  • ต้องมีเซิร์ฟเวอร์: แอปไม่มี backend รวมมา
  • Work ขึ้นกับ runtime เซิร์ฟเวอร์: ไม่มี runtime Docker หรือ Kubernetes รวมมา
  • ไม่อัปเดตอัตโนมัติ: ต้องดาวน์โหลดแพ็กเกจใหม่เพื่ออัปเดต

ดูรายละเอียดความปลอดภัยของ runtime ผู้ให้บริการ พื้นที่เก็บข้อมูล และตัวอย่างได้ที่ Work: พื้นที่ทำงานแบบแยก