Selkies WebUI 操控方案 | 部署适用于 ArchLinux KDE 桌面环境的 Selkies 与 KasmVNC

Selkies, 全称 Selkies-GStreamer, 是一个开源的低延迟高性能 Linux 原生 GPU/CPU 加速 WebRTC HTML5 远程桌面流媒体平台, 适用于自托管容器 Kubernetes 或云/HPC 平台, 其原型由 Google 工程师开发¹

Selkies 设计上就是为了高性能游戏或远程桌面串流设计的, 可以直接调用 GPU 硬件编解码, 相较于 noVNC 等传统 VNC 解决方案, 配置更简单.

同时, Selkies 支持免配置音频传输, 仅需保证后端兼容 PulseAudio (例如 PulseAudio 与 PipeWire-Pulse)

NOTE
Selkies 暂未支持 Wayland

安装并配置基于 X11 的 KDE 桌面环境#

https://wiki.archlinux.org/title/KDE
https://archlinux.org/news/plasma-640-will-need-manual-intervention-if-you-are-on-x11/

使用如下指令安装基于 X11 的 KDE 桌面环境及其相关组件

1
sudo pacman -S plasma-meta plasma-x11-session konsole dolphin pipewire pipewire-pulse xorg-server xorg-xinit xf86-video-dummy polkit-kde-agent

配置 KDE 的 X11 启动脚本#

在如下路径写入如下内容

1
~/.xinitrc

1
#!/usr/bin/sh
2

3
unset DBUS_SESSION_BUS_ADDRESS
4
unset DBUS_SESSION_BUS_PID
5

6
export DESKTOP_SESSION=plasma
7
export XDG_CURRENT_DESKTOP=KDE
8
export XDG_SESSION_TYPE=x11
9

10
if [ -x /usr/bin/dbus-run-session ]; then
11
  exec dbus-run-session -- startplasma-x11
12
else
13
  exec dbus-launch --exit-with-session startplasma-x11
14
fi

若需调整系统音量, 请参阅故障排除 > KDE 显示无音频设备导致无法调节系统音量

并配置可执行权限

1
chmod +x ~/.xinitrc

配置 X11 虚拟显示器#

在 X11 配置目录写入如下配置文件

1
/etc/X11/xorg.conf.d/20-dummy.conf

1
Section "Device"
2
    Identifier  "DummyDevice"
3
    Driver      "dummy"
4
    VideoRam    512000
5
EndSection
6

7
Section "Monitor"
8
    Identifier  "DummyMonitor"
9
    Modeline    "1920x1080_60.00"  173.00  1920 2048 2248 2576  1080 1083 1088 1120 -hsync +vsync
10
    HorizSync   28.0-110.0
11
    VertRefresh 43.0-90.0
12
EndSection
13

14
Section "Screen"
15
    Identifier  "DummyScreen"
16
    Device      "DummyDevice"
17
    Monitor     "DummyMonitor"
18
    DefaultDepth 24
19
    SubSection "Display"
20
        Depth 24
21
        Modes "1920x1080_60.00"
22
    EndSubSection
23
EndSection

配置 X11 启动服务#

为了保证 X11 Server 可以随系统自启动, 我们需要使用自定义 Systemd Unit

1
~/.config/systemd/user/headless-x11-kde.service

1
[Unit]
2
Description=Headless KDE Plasma X11 Session on :0
3
After=network.target
4

5
[Service]
6
Environment=DISPLAY=:0
7
Environment=XDG_SESSION_TYPE=x11
8
Environment=XAUTHORITY=%h/.Xauthority
9

10
ExecStart=/usr/bin/startx %h/.xinitrc -- :0 -config 20-dummy.conf
11

12
Restart=always
13
RestartSec=5s
14

15
StandardOutput=journal
16
StandardError=journal
17

18
[Install]
19
WantedBy=default.target

加载并启用服务

1
systemctl --user daemon-reload
2
systemctl --user enable --now headless-x11-kde.service

启动 KDE 所需的 Pipewire 服务系列#

1
systemctl --user enable --now pipewire.service pipewire-pulse.service wireplumber.service

安装 Selkies#

从 Selkies Releases 下载便携版压缩包并解压, 该版本自带 Python 与 GStreamer 运行环境, 不依赖系统 Python

1
curl -LO https://github.com/selkies-project/selkies/releases/download/v<version>/selkies-gstreamer-portable-v<version>_amd64.tar.gz
2
tar -xzf selkies-gstreamer-portable-v<version>_amd64.tar.gz -C ~

默认安装路径位于 ~/selkies-gstreamer

配置 Selkies 的 Systemd Unit#

在如下路径新建 Env 文件

1
~/selkies-gstreamer/selkies.env

修改必要配置, 诸如端口号, 用户, 密码与编码器配置

1
SELKIES_ADDR=0.0.0.0
2
SELKIES_PORT=<port>
3
SELKIES_USER=<user>
4
SELKIES_PASS=<password>
5
SELKIES_ENCODER=x264enc
6
SELKIES_RESIZE=false

NOTE
编码器名称必须在 selkies-gstreamer-run --help 输出的可选值列表中. 本机使用 vah264enc (VA-API 硬件编码) 时, 便携包自带的 VA-API 插件与系统 intel-media-driver 不兼容, 构建视频管线时报 'NoneType' object has no attribute 'set_property', 故改用软件编码 x264enc

NOTE
对于无法使用 GPU 的虚拟机或者 GPU 性能较弱设备 (如我使用的 Intel UHD Graphics P630²), 使用 x264enc 可能出现跳帧问题, 可尝试 svtav1enc 或 av1enc 编码方式

在如下文件写入 Unit

1
~/.config/systemd/user/selkies.service

1
[Unit]
2
Description=Selkies GStreamer Service
3
# 必须和上面定义的 KDE Unit 名称对应, `Wants` 同理
4
After=headless-x11-kde.service
5
Wants=headless-x11-kde.service
6

7
[Service]
8
Type=simple
9
# 设置默认环境变量, 参考官方文档
10
Environment=DISPLAY=:0
11
Environment=PIPEWIRE_LATENCY=128/48000
12
Environment=XDG_RUNTIME_DIR=%t
13
Environment=PIPEWIRE_RUNTIME_DIR=%t
14
Environment=PULSE_RUNTIME_PATH=%t/pulse
15
Environment=PULSE_SERVER=unix:%t/pulse/native
16

17
EnvironmentFile=%h/selkies-gstreamer/selkies.env
18

19
ExecStart=%h/selkies-gstreamer/selkies-gstreamer-run \
20
    --addr=${SELKIES_ADDR} \
21
    --port=${SELKIES_PORT} \
22
    --enable_https=false \
23
    --basic_auth_user=${SELKIES_USER} \
24
    --basic_auth_password=${SELKIES_PASS} \
25
    --encoder=${SELKIES_ENCODER} \
26
    --enable_resize=${SELKIES_RESIZE}
27

28
Restart=always
29
RestartSec=5s
30

31
StandardOutput=journal
32
StandardError=journal
33

34
[Install]
35
WantedBy=default.target

加载并启用服务

1
systemctl --user daemon-reload
2
systemctl --user enable --now selkies.service

配置 TURN 服务器以支持公网访问#

截至 v1.6.2, Selkies 的媒体传输仅支持 WebRTC, WebSocket 传输模式尚未发布

WebRTC 优先尝试 P2P 直连, 当客户端与服务器之间无法建立直连时 (例如服务器位于 NAT 后, 公网出口为代理, 或客户端网路封禁 UDP), 必须通过 TURN 服务器中继媒体流. Selkies 默认使用公共 TURN 服务, 可用性无法保证, 公网访问场景推荐自建

安装并配置 coturn#

1
sudo pacman -S coturn

coturn 的静态用户库为 SQLite 数据库, 无法直接写入明文文件, 需要使用 turnadmin 生成

1
sudo -u turnserver turnadmin -a -u <user> -r <realm> -p <password> -b /etc/turnserver/turnuserdb.conf

在如下路径写入配置

1
/etc/turnserver/turnserver.conf

1
listening-port=3478
2
min-port=49152
3
max-port=65535
4
realm=<realm>
5
userdb=/etc/turnserver/turnuserdb.conf
6
lt-cred-mech
7
fingerprint

WARNING
Arch 的 coturn 服务读取的配置文件为 /etc/turnserver/turnserver.conf, 而非 /etc/turnserver.conf, 配置写错位置时所有配置会静默失效, 包括鉴权, 使 TURN 退化为任意人可用的开放中继

NOTE
若客户端直接连接 TURN 服务器且服务器位于 NAT 后, 需增加 external-ip=<内网地址>/<公网地址>, 否则下发的 TURN 中继地址不可达; 若客户端经由反向代理接入, 则不需要该配置

启动服务

1
sudo systemctl enable --now turnserver

NOTE
验证是否生效可查看 coturn 日志, 客户端连接后出现的会话记录中应带有 realm 与 username 字段

配置 Selkies 使用自建 TURN#

打开

1
~/selkies-gstreamer/selkies.env

添加

1
SELKIES_TURN_HOST=<turn-host>
2
SELKIES_TURN_PORT=<turn-port>
3
SELKIES_TURN_PROTOCOL=tcp
4
SELKIES_TURN_TLS=false
5
SELKIES_TURN_USERNAME=<user>
6
SELKIES_TURN_PASSWORD=<password>

NOTE
若 TURN 端口无法直接暴露, 或者想要统一使用 Caddy 管理 TLS 证书, 可使用 L4 反向代理转发, 由代理终结 TLS 后以明文转发至 coturn 的 3478 端口. 此时 SELKIES_TURN_TLS=true, SELKIES_TURN_PORT 填写代理的监听端口, coturn 侧无需配置证书
对于带有 https://github.com/mholt/caddy-l4 插件的 Caddy, 可以直接参考如下 Caddyfile
1
# 全局配置
2
{
3
layer4 {
4
      :5349 {
5
          @my-domain {
6
              tls sni <sni>
7
          }
8

9
          route @my-domain {
10
              tls
11
              proxy <internal-ip>:3478
12
          }
13
      }
14
  }
15
}

故障排除#

Selkies 画面有显示但仍在画面中间显示 `Waiting for stream.`#

发生该情况可能存在多种原因:

由于 Selkies 只接收到了视频画面, 无法获取到音频. 尝试检查 Pipewire 和 PulseAudio 等服务的状态.
客户端不支持该编解码格式, 导致解码时出现错误 (多数情况是客户端不支持 Opus 音频格式)

DBus 进程在 SSH 结束后退出#

请确保开启了后台进程常驻

1
sudo loginctl enable-linger $USER

KDE 显示无音频设备导致无法调节系统音量#

我们可以使用 pactl 加载虚拟音频模块, 并将其设为系统默认输出

为了自动化地设置虚拟音频输出, 请在 ~/.xinitrc 的 exec 前添加如下内容

1
VIRTUAL_SINK_NAME="default"
2

3
if ! pactl list sinks short | awk '{print $2}' | grep -Fxq "$VIRTUAL_SINK_NAME"; then
4
  pactl load-module module-null-sink sink_name="$VIRTUAL_SINK_NAME" sink_properties=device.description="$VIRTUAL_SINK_NAME" >/dev/null 2>&1
5
fi
6

7
pactl set-default-sink "$VIRTUAL_SINK_NAME" >/dev/null 2>&1

NOTE
无实体音频输入设备的机器还需要将默认录音源指向虚拟输出的 Monitor, 否则 Selkies 的音频管线会因找不到默认源而失败 (报 Failed to connect stream: No such entity)

1
pactl set-default-source "$VIRTUAL_SINK_NAME.monitor" >/dev/null 2>&1

Selkies 客户端网路环境无法访问 TURN/STUN Server 或者 443 端口, 导致无法建立连接#

由于 Selkies 默认开启了 TURN/STUN Server, 无法访问的客户端会尝试连接并失败造成无法成功传输画面. 出现类似于如下日志

Status Log

1
[14:56:31] [webrtc] [ERROR] attempt to send data channel message before channel was open

Debug Log

1
[14:44:12] [app] using TURN servers: turn:staticauth.openrelay.metered.ca:443?transport=udp

若客户端与服务器之间可以建立直连 (如同处一个内网), 可以禁用 Selkies 的全部 TURN/STUN Server; 若需要公网访问, 请参阅配置 TURN 服务器以支持公网访问

在 Env 文件中写入如下内容

打开

1
~/selkies-gstreamer/selkies.env

写入

1
SELKIES_TURN_HOST=

NOTE
若仍然无法加载, 请检查网路环境 UDP 连通性

KDE 部分界面文本不是中文#

若 /etc/locale.gen 中的 zh_CN.UTF-8 处于注释状态, 系统实际上并未生成该 Locale, 依赖 glibc Locale 的程序会回退到英文

取消注释并生成

1
sudo sed -i 's/^#zh_CN.UTF-8 UTF-8/zh_CN.UTF-8 UTF-8/' /etc/locale.gen
2
sudo locale-gen

重启后 KDE 壁纸被重置#

若同时存在 SDDM 自动登录会话与本方案的 headless 会话, 两个 Plasma 实例会同时读写同一份桌面配置, 导致壁纸等设置被反复覆盖; 配置文件中残留的空 Containment 也会导致启动时绑定到错误的桌面

禁用 SDDM

1
sudo systemctl disable --now sddm

并检查 ~/.config/plasma-org.kde.plasma.desktop-appletsrc 中是否残留了无内容的 [Containments][n] 段

针对 UDP 不佳网路环境的共存部署 KasmVNC#

https://kasmweb.com/kasmvnc/docs/1.3.4/index.html

由于 WebRTC 很大程度上依赖 UDP, 并且在受限网路工况中表现不佳, 我们可以使用 KasmVNC 与 Selkies 同时部署的方式, 使得客户端可以选择一个合适的 WebUI 操控方案

安装 KasmVNC#

安装 KasmVNC Server

1
yay -S kasmvncserver-bin openssl-1.1

WARNING
kasmvncserver-bin 1.5.0 存在启动崩溃问题 (Xvnc 在编码器探测阶段段错误, 导致服务无限重启), 请使用 1.4.0

1
git clone https://aur.archlinux.org/kasmvncserver-bin.git
2
cd kasmvncserver-bin
3
git checkout 63d4b2c  # 1.4.0-2
4
makepkg -si

并在 /etc/pacman.conf 中阻止其被升级

1
IgnorePkg = kasmvncserver-bin

配置 WebUI 用户名密码#

1
kasmvncpasswd -u <USER>

若要配置与当前用户名称一样的用户名, 请使用
Terminal window
1
kasmvncpasswd -u $USER

创建证书文件#

由于 KasmVNC 强制要求配置 TLS 证书 (无论是否启用 HTTPS), 我们需要使用 OpenSSL 创建证书

1
openssl req -x509 -nodes -days 90 -newkey rsa:4096 \
2
  -keyout ~/ssl-cert-snakeoil.key \
3
  -out ~/ssl-cert-snakeoil.pem \
4
  -subj "/C=CN/ST=Default/L=Default/O=KasmVNC/CN=${HOST:-default-host}"
5

6
chmod 644 ~/ssl-cert-snakeoil.pem
7
chmod 600 ~/ssl-cert-snakeoil.key

编辑 KasmVNC 配置文件#

1
~/.vnc/kasmvnc.yaml

写入

1
network:
2
  protocol: http
3
  interface: 0.0.0.0
4
  websocket_port: <port>  # edit
5
  use_ipv4: true
6
  use_ipv6: true
7
  udp:
8
    public_ip: auto
9
    port: auto
10
    payload_size: auto
11
    stun_server: auto
12
  ssl:
13
    pem_certificate: /home/<USER>/ssl-cert-snakeoil.pem  # edit
14
    pem_key: /home/<USER>/ssl-cert-snakeoil.key  # edit
15
    require_ssl: false

若服务启动耗时较长, 或显示 Failed to get public IP, please specify it with -publicIP 字样, 请修改配置文件的 network.udp.public_ip 字段, 或在启动 kasmvncserver 时使用 -publicIP <public-ipaddr> 指定公网 IP 地址 (没有者尝试填写内网地址)

[可选] 启用 GPU 加速#

GPU 加速请按需启用

找到设备上的 Render 设备, 对于拥有单个 GPU 的设备一般来说为 /dev/dri/renderD128, 同时拥有核显与独显的设备一般来说编号较大者为独显, 常见于 /dev/dri/renderD129

1
~/.vnc/kasmvnc.yaml

添加

1
desktop:
2
  gpu:
3
    hw3d: true
4
    drinode: /dev/dri/renderD<id>
5
  resolution:
6
    width: 1920
7
    height: 1080

hw3d 开启后, KasmVNC 的 X Server 会提供 DRI3 扩展, 应用可自行分配 GPU 缓冲并直接渲染, 即使 Xvnc 不提供 GLX 也能获得硬件加速

NOTE
分辨率必须通过 desktop.resolution 指定, vncserver -geometry 参数在新版本中不会生效

NOTE
Xvnc 不提供 GLX 扩展, Chrome 的 ANGLE GL 后端会因此回退到软件渲染, 需要添加启动参数强制使用 EGL

打开

1
~/.config/chrome-flags.conf

写入

1
--use-angle=gl-egl

在会话内运行 eglinfo 确认渲染器为 iris (Intel) 等硬件驱动名称即配置成功

使用不同方法共存部署#

目前, 将 Selkies 与 KasmVNC 共存部署共有两种方法 (任选其一即可):

使用 KasmVNC 作为 X11 Session 启动者 (推荐, 配合 hw3d 可获得 GPU 加速)
使用 kasmxproxy 转发现有 X11 Display (应用运行在 dummy 驱动的 Xorg 上, 只能获得软件渲染)

1.1 禁用 KDE 启动程序#

由于 KasmVNC Server 会自己启动一个 X11 Session, 我们需要禁用先前定义的 headless-x11-kde.service

1
systemctl --user disable --now headless-x11-kde.service

1.2 启动 DE#

vncserver 默认在第一个客户端连接时才执行 ~/.vnc/xstartup 启动 DE, 这会导致没有客户端连接时 Selkies 无画面可采集

因此我们使用 -noxstartup 创建空白 X11 Session, 并在 Systemd Unit 中等待 X Server 就绪后直接启动先前写好的 ~/.xinitrc

1.3 配置 KasmVNC 为 Systemd Unit#

1
~/.config/systemd/user/kasmvnc.service

写入

1
[Unit]
2
Description=KasmVNC Service (KDE session on :0)
3
After=network.target
4

5
[Service]
6
Type=simple
7
Environment=XAUTHORITY=%h/.Xauthority
8
# 先等待 X Server 可以接受连接再启动 DE, 否则 Plasma 会因连接被拒而立即退出
9
ExecStart=/usr/bin/sh -c '/usr/bin/vncserver -kill :0 >/dev/null 2>&1; /usr/bin/vncserver :0 -noxstartup && { i=0; until DISPLAY=:0 XAUTHORITY=%h/.Xauthority /usr/bin/xset q >/dev/null 2>&1; do i=$((i+1)); [ $i -ge 150 ] && exit 1; sleep 0.2; done; }; export DISPLAY=:0; exec %h/.xinitrc'
10
ExecStop=/usr/bin/sh -c '/usr/bin/vncserver -kill :0 || true'
11

12
Restart=on-failure
13
RestartSec=5
14

15
StandardOutput=journal
16
StandardError=journal
17

18
[Install]
19
WantedBy=default.target

由于我们禁用了 headless-x11-kde.service, 需要将 Selkies Systemd Unit 的等待服务设置为 kasmvnc.service

1
~/.config/systemd/user/selkies.service

修改

1
After=headless-x11-kde.service
2
Wants=headless-x11-kde.service

为

1
After=kasmvnc.service
2
Wants=kasmvnc.service

重载并启用服务

1
systemctl --user daemon-reload
2
systemctl --user restart selkies.service
3
systemctl --user enable --now kasmvnc.service

2.1 使用 kasmxproxy 转发现有 X11 Display#

WARNING
该方法中应用运行在 xf86-video-dummy 驱动的 Xorg 上, 只能获得软件渲染, 且多一层屏幕拷贝开销, 仅在无法使用方法 1 时使用

先前的 headless-x11-kde.service 我们已经在 Display :0 启动了一个 X11 Session, 我们需要使用 kasmxproxy 转发这个 Display

2.2 配置 KasmVNC 与 kasmxproxy 为 Systemd Unit#

对 vncserver 使用 -noxstartup 选项以创建空白的 X11 Session, 不启动 DE

1
~/.config/systemd/user/kasmvnc.service

写入

1
[Unit]
2
Description=KasmVNC Service
3
After=network.target
4

5
[Service]
6
Type=simple
7
# 不能使用 ExecStartPre, 因为 vncserver 启动不是立即的
8
ExecStart=/usr/bin/sh -c '/usr/bin/vncserver :99 -noxstartup && /usr/bin/kasmxproxy -a :0 -v :99 -r -f ${KASM_FPS:-60}'
9
ExecStop=/usr/bin/vncserver -kill :99
10

11
Restart=on-failure
12
RestartSec=5
13

14
[Install]
15
WantedBy=default.target

如果需要自动修改远程显示器大小, 请携带 -r 参数
参数配置请参阅 https://kasmweb.com/kasmvnc/docs/1.3.4/man/kasmxproxy.html#options

2.3 配置剪切板同步#

由于我们使用 kasmxproxy 转发了 Display 的内容, 使得 KasmVNC 读取屏幕以及写入剪切板的目标并不是实际上 X11 Session 所在屏幕, 我们需要使用 xclip 工具并编写脚本轮询同步剪切板

安装

1
yay -S xclip

1
~/.config/systemd/user/kasmvnc-clipboard.sh

写入

1
#!/bin/bash
2
export XAUTHORITY="${XAUTHORITY:-$HOME/.Xauthority}"
3

4
LAST_0=""
5
LAST_99=""
6

7
echo "[$(date '+%Y-%m-%d %H:%M:%S')] Clipboard Sync Service Started..."
8
echo "Monitoring :0 (KDE) <-> :99 (KasmVNC)"
9

10
while true; do
11
    CUR_0=$(/usr/bin/xclip -display :0 -o -selection clipboard 2>/dev/null)
12
    CUR_99=$(/usr/bin/xclip -display :99 -o -selection clipboard 2>/dev/null)
13

14
    if [[ "$CUR_0" != "$LAST_0" && -n "$CUR_0" ]]; then
15
        echo -n "$CUR_0" | /usr/bin/xclip -display :99 -i -selection clipboard
16
        LAST_0="$CUR_0"
17
        LAST_99="$CUR_0"
18
        echo "[$(date '+%H:%M:%S')] Sync: :0 -> :99"
19

20
    elif [[ "$CUR_99" != "$LAST_99" && -n "$CUR_99" ]]; then
21
        echo -n "$CUR_99" | /usr/bin/xclip -display :0 -i -selection clipboard
22
        LAST_99="$CUR_99"
23
        LAST_0="$CUR_99"
24
        echo "[$(date '+%H:%M:%S')] Sync: :99 -> :0"
25
    fi
26

27
    sleep 0.25
28
done

配置为 Systemd Unit

1
~/.config/systemd/user/kasmvnc-clipboard.service

写入

1
[Unit]
2
Description=KasmVNC Clipboard Sync
3
After=headless-x11-kde.service kasmvnc.service
4
Requires=headless-x11-kde.service kasmvnc.service
5

6
[Service]
7
ExecStart=/usr/bin/bash "%h/.config/systemd/user/kasmvnc-clipboard.sh"
8

9
StandardOutput=journal
10
StandardError=journal
11

12
Restart=on-failure
13
RestartSec=5
14

15
[Install]
16
WantedBy=default.target

重载并启用服务

1
systemctl --user daemon-reload
2
systemctl --user enable --now kasmvnc-clipboard.service

重载并启用服务#

1
systemctl --user daemon-reload
2
systemctl --user enable --now kasmvnc.service

[可选] 反向代理配置#

KasmVNC 使用 Websocket 作为长连接, 所以可以直接使用一般的现代化反向代理软件. 这里以 Caddy 为例

要使 Caddy 反向代理忽略 TLS 证书有效性, 请使用如下配置

1
host:port {
2
  reverse_proxy https://<url> {
3
      transport http {
4
          tls_insecure_skip_verify
5
      }
6
  }
7
}

NOTE
在实际访问页面时, 可能会在弹出 HTTP Basic Auth 时显示 “不安全” (没有 TLS 证书或 TLS 握手失败) 的提示, 这其实是因为浏览器弹窗阻塞了主窗口, 导致握手成功后一瞬间的小🔒图标 (代表 HTTPS 握手成功) 没有被正确显示
本人使用 Wireshark 抓包, 发现 Basic Auth 的讯息是使用 QUIC 发送的, 故不必担心隐私泄露问题

安装并配置基于 X11 的 KDE 桌面环境#

配置 KDE 的 X11 启动脚本#

配置 X11 虚拟显示器#

配置 X11 启动服务#

启动 KDE 所需的 Pipewire 服务系列#

安装 Selkies#

配置 Selkies 的 Systemd Unit#

配置 TURN 服务器以支持公网访问#

安装并配置 coturn#

配置 Selkies 使用自建 TURN#

故障排除#

Selkies 画面有显示但仍在画面中间显示 Waiting for stream.#

DBus 进程在 SSH 结束后退出#

KDE 显示无音频设备导致无法调节系统音量#

Selkies 客户端网路环境无法访问 TURN/STUN Server 或者 443 端口, 导致无法建立连接#

KDE 部分界面文本不是中文#

重启后 KDE 壁纸被重置#

针对 UDP 不佳网路环境的共存部署 KasmVNC#

安装 KasmVNC#

配置 WebUI 用户名密码#

创建证书文件#

编辑 KasmVNC 配置文件#

[可选] 启用 GPU 加速#

使用不同方法共存部署#

1.1 禁用 KDE 启动程序#

1.2 启动 DE#

1.3 配置 KasmVNC 为 Systemd Unit#

2.1 使用 kasmxproxy 转发现有 X11 Display#

2.2 配置 KasmVNC 与 kasmxproxy 为 Systemd Unit#

2.3 配置剪切板同步#

重载并启用服务#

[可选] 反向代理配置#

Footnotes#

Selkies 画面有显示但仍在画面中间显示 `Waiting for stream.`#