麟曜文件

HUAN 讙 · 使用教學

在 Ubuntu 上安裝

檢視 Markdown在 ChatGPT 開啟在 Claude 開啟

支援 x64 與 arm64。

需求

項目需求
版本Ubuntu 22.04 LTS 以上
架構x64 或 arm64
記憶體最低 2GB，建議 4GB
桌面環境需要 X11 或 Wayland

安裝

從 Releases 下載對應架構的版本。

AppImage：

chmod +x HUAN-Device-*-linux-x64.AppImage
./HUAN-Device-*-linux-x64.AppImage

Debian 套件：

sudo apt install ./HUAN-Device-*-linux-x64.deb
huan-device

開機自動啟動

# ~/.config/systemd/user/huan-device.service
[Unit]
Description=HUAN Device Player
After=graphical-session.target

[Service]
Type=simple
ExecStart=/usr/bin/huan-device
Restart=always
RestartSec=10

[Install]
WantedBy=graphical-session.target
systemctl --user enable --now huan-device
loginctl enable-linger "$USER"

也可以用桌面環境自己的自動啟動機制，放一個 .desktop 檔到 ~/.config/autostart/。

關閉螢幕休眠

GNOME：

gsettings set org.gnome.desktop.session idle-delay 0
gsettings set org.gnome.settings-daemon.plugins.power sleep-inactive-ac-type nothing

X11 通用：

xset s off -dpms

無桌面環境的伺服器版

Electron 需要一個顯示伺服器。最小安裝：

sudo apt install --no-install-recommends xserver-xorg xinit openbox

然後用 ~/.xinitrc 啟動：

#!/bin/sh
exec openbox-session &
exec huan-device

憑證儲存

裝置憑證使用 Electron 的 safeStorage，在 Linux 上會透過 libsecret 存進系統的金鑰環（GNOME Keyring 或 KWallet）。

沒有可用的金鑰環服務時，safeStorage 會退回較弱的保護。無人值守的看板機器建議確認金鑰環在開機時會自動解鎖，或接受這個限制——裝置憑證的權限範圍僅限這一台裝置，而且隨時可以從後台撤銷。

疑難排解

AppImage 無法執行：需要 FUSE。

sudo apt install libfuse2

沙箱錯誤：某些容器或受限環境需要調整 user namespace 設定。不要用 --no-sandbox 繞過——那會關掉 Electron 的核心安全機制。