Selkies 基础镜像 (LinuxServer)

镜像概述和主要用途

这些镜像旨在为任何Linux应用程序或桌面环境提供全功能的Web原生Linux桌面体验。它们替代了我们旧版的KasmVNC基础镜像，显著提升了性能、保真度和功能集。镜像内置密码less sudo，便于软件包安装、测试和自定义。默认情况下，除用户主目录外不挂载其他内容，因此镜像更新时/config目录外的所有内容将丢失。

注意：

• 基于合理努力原则为您自己项目中使用这些基础镜像提供支持，详情请参见我们的支持政策。
• 所有基础镜像均无latest标签，因为我们常在版本间进行破坏性变更，且不像下游镜像那样发布发行说明。
• 若计划分发使用这些基础镜像构建的镜像，请先阅读容器品牌文档。
• 镜像支持期限与所基于的上游发行版一致，之后将停止为该版本构建新基础镜像。

核心功能和特性

核心服务

镜像包含以下服务：

• Selkies：用于从Web浏览器与容器化桌面交互的核心技术。
• pixelflux：核心视频/图像渲染管道。
• pcmflux：轻量级底层Web原生opus音频编码器。
• NGINX：用于提供Selkies服务，处理路径和基本身份验证。
• Docker：可通过挂载Docker套接字或特权模式运行时启动DinD环境。
• PulseAudio：用于捕获桌面会话音频并发送到浏览器的声音子系统。

使用场景和适用范围

适用于需要通过Web浏览器访问Linux桌面环境或应用程序的场景，包括：

• 远程应用访问（如浏览器、办公软件、开发工具）
• 云桌面服务部署
• 应用演示和测试环境
• 多用户共享Linux应用场景
• 开发环境快速搭建

使用方法和配置说明

环境变量配置

基本配置变量

WATERMARK_LOCATION选项：

• 1：左上角
• 2：右上角
• 3：左下角
• 4：右下角
• 5：居中
• 6：动画

强化选项（Hardening）

用于锁定桌面环境以适应单应用场景或限制用户功能。

元变量（Meta Variables）

预设变量，可同时启用多个强化选项，单独设置可覆盖预设。

单个强化变量

Selkies应用设置

可通过环境变量配置应用的各个方面，包括UI定制、功能开关等。

设置类型与UI定制

部分设置类型支持高级UI控制：

• 布尔值与锁定：接受true/false，追加|locked可隐藏UI切换（用户无法修改）。
  示例：强制启用CPU编码并锁定：-e SELKIES_USE_CPU="true|locked"
• 枚举与列表：接受逗号分隔值，多值时第一个为默认并显示下拉菜单；单值时隐藏下拉菜单（锁定选择）。
  示例：强制使用jpeg编码器：-e SELKIES_ENCODER="jpeg"
• 范围：使用min-max格式定义范围（显示滑块）；单值时隐藏滑块（锁定值）。
  示例：锁定帧率为60 FPS：-e SELKIES_FRAMERATE="60"
• 手动分辨率模式：设置SELKIES_MANUAL_WIDTH、SELKIES_MANUAL_HEIGHT或SELKIES_IS_MANUAL_RESOLUTION_MODE=true时激活，禁用客户端分辨率UI。未指定宽高时默认1024x768。

详细配置变量

语言支持 - 国际化

通过LC_ALL环境变量可启动非英语版本，例如启动法语桌面会话：LC_ALL=fr_FR.UTF-8。

Web界面设置中的“IME输入模式”允许客户端非en_US键盘输入非英文字符，启用后效果与本地Linux安装的区域设置一致。

可用发行版

所有基础镜像支持x86_64和aarch64平台，当前可用发行版及标签如下：

部署与使用示例

基本运行命令

docker run -d \
  --name=selkies-base \
  -p 3001:3001 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TITLE="My Selkies Desktop" \
  -e PASSWORD=mysecret \
  -v /path/to/config:/config \
  --shm-size=1gb \
  ghcr.io/linuxserver/baseimage-selkies:debianbookworm

Docker Compose示例

version: "3"
services:
  selkies-base:
    image: ghcr.io/linuxserver/baseimage-selkies:debianbookworm
    container_name: selkies-base
    ports:
      - "3001:3001"
    environment:
      - PUID=1000
      - PGID=100