🖥️ Ứng dụng máy tính
Ứng dụng máy tính Libre WebUI đặt giao diện web trong một cửa sổ native trên macOS, Windows và Linux. Ứng dụng kết nối với máy chủ Libre WebUI đang chạy trên cùng máy hoặc bất kỳ máy chủ nào bạn chỉ định.
Ứng dụng được phát triển trong repository riêng; trình cài đặt cho mọi bản phát hành được đính kèm vào các bản phát hành GitHub của repository chính.
📦 Tải xuống và cài đặt
Lấy gói dành cho nền tảng của bạn từ bản phát hành mới nhất:
- macOS (Apple Silicon):
Libre-WebUI-Desktop-{version}-mac-arm64.dmghoặc.zip, hoặcbrew install --cask libre-webui/tap/libre-webui-desktop - Windows:
Libre-WebUI-Desktop-Setup-{version}.exe(trình cài đặt) hoặcLibre-WebUI-Desktop-{version}.exe(bản di động) - Linux:
Libre-WebUI-Desktop-{version}.AppImagehoặcLibre-WebUI-Desktop-{version}-{arch}.deb
Các bản phát hành trước khi đổi tên cung cấp tài nguyên này dưới tiền tố Libre-WebUI-Frontend với gói ứng dụng tên Libre WebUI Frontend.app.
macOS chặn ứng dụng vì cho rằng bị hỏng
Libre WebUI tạm thời dùng chữ ký ad-hoc cho các bản build macOS. Điều này giữ cấu trúc gói ứng dụng hợp lệ nhưng không xác định nhà phát hành với Apple và không thể công chứng. Sau khi sao chép ứng dụng vào Applications, hãy phê duyệt trong Cài đặt hệ thống → Quyền riêng tư & Bảo mật → Vẫn mở.
Nếu macOS không hiển thị tùy chọn đó, chỉ xóa thuộc tính cách ly sau khi xác minh ứng dụng đến từ bản phát hành Libre WebUI chính thức:
xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"
Không tắt Gatekeeper trên toàn hệ thống. Việc phân phối liền mạch vẫn cần chứng chỉ Developer ID Application và công chứng của Apple.
🔌 Kết nối với máy chủ
Ứng dụng là máy khách nên cần một máy chủ Libre WebUI. Ở lần khởi chạy đầu tiên, màn hình chào cung cấp hai lựa chọn:
- Cục bộ: ứng dụng dò tìm máy chủ trên máy của bạn (cổng 3001, mặc định cho image Docker và
npx libre-webui) rồi kết nối khi kiểm tra sức khỏe phản hồi. - Từ xa: nhập URL của bất kỳ máy chủ Libre WebUI nào có thể truy cập, chẳng hạn homelab hoặc bản triển khai nhóm. Ứng dụng xác minh trước khi kết nối.
Lựa chọn của bạn được ghi nhớ. Để đổi máy chủ sau này, dùng Libre WebUI → Chuyển máy chủ… trên thanh menu. Nếu máy chủ đã nhớ ngừng phản hồi, ứng dụng quay lại màn hình chào thay vì hiển thị cửa sổ trống.
Để chạy máy chủ cục bộ, xem Bắt đầu nhanh: Docker Compose, npx libre-webui và Homebrew đều được hỗ trợ.
🧰 Work trong ứng dụng máy tính
Gói ứng dụng máy tính không đi kèm backend, Docker hay runtime container Work. Khả dụng của Work do máy chủ được kết nối quyết định:
- backend native có thể chạy
docker infocó thể tạo container Work và volume có tên theo phạm vi tác vụ; - bản triển khai Compose tiêu chuẩn của repository cung cấp Work dựa trên Docker bằng cách gắn socket Docker của máy chủ, còn bản triển khai container tùy chỉnh không có runtime khả dụng sẽ báo Work không khả dụng;
- máy chủ Kubernetes cung cấp Work dựa trên Pod/PVC khi chart Helm được cài với
work.enabled=true; và - ứng dụng vẫn hỗ trợ Trò chuyện khi Work không khả dụng.
Tệp Work nằm trên máy chủ Docker hoặc bộ nhớ Kubernetes của máy chủ, không nằm trong ứng dụng máy tính. Bản xem trước đi qua proxy cùng nguồn đã ký của Libre WebUI, nhờ đó máy khách cục bộ và từ xa đều dùng được khi reverse proxy của máy chủ giữ nguyên lưu lượng HTTP và WebSocket.
🎨 Tích hợp máy tính
- Thanh menu native với các menu ứng dụng, chỉnh sửa, xem, cửa sổ và trợ giúp
- Thanh tiêu đề macOS tùy chỉnh (
hiddenInset) với các nút đèn giao thông trong thanh bên - Chế độ tối theo tùy chọn hệ thống
- Liên kết bên ngoài mở trong trình duyệt mặc định, không bao giờ trong ứng dụng
- Trình kết xuất chạy với cách ly ngữ cảnh và không tích hợp Node
🚧 Giới hạn
- Kiến trúc macOS: các gói macOS hiện chỉ hỗ trợ Apple Silicon (
arm64) - Cần máy chủ: ứng dụng không đi kèm backend
- Work phụ thuộc vào runtime máy chủ: không kèm runtime Docker hoặc Kubernetes
- Không tự động cập nhật: cần tải gói mới để cập nhật
Xem Work: Không gian làm việc cô lập để biết chi tiết bảo mật runtime, nhà cung cấp, bộ nhớ và bản xem trước.