lsiobase/selkies

Selkies 基础镜像 (LinuxServer)

镜像概述和主要用途

这些镜像旨在为任何Linux应用程序或桌面环境提供全功能的Web原生Linux桌面体验。它们替代了我们旧版的https://github.com/linuxserver/docker-baseimage-kasmvnc%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E6%98%BE%E8%91%97%E6%8F%90%E5%8D%87%E4%BA%86%E6%80%A7%E8%83%BD%E3%80%81%E4%BF%9D%E7%9C%9F%E5%BA%A6%E5%92%8C%E5%8A%9F%E8%83%BD%E9%9B%86%E3%80%82%E9%95%9C%E5%83%8F%E5%86%85%E7%BD%AE%E5%AF%86%E7%A0%81less sudo，便于软件包安装、测试和自定义。默认情况下，除用户主目录外不挂载其他内容，因此镜像更新时/config目录外的所有内容将丢失。

注意：

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

核心功能和特性

核心服务

镜像包含以下服务：

• https://github.com/selkies-project%EF%BC%9A%E7%94%A8%E4%BA%8E%E4%BB%8EWeb%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%8E%E5%AE%B9%E5%99%A8%E5%8C%96%E6%A1%8C%E9%9D%A2%E4%BA%A4%E4%BA%92%E7%9A%84%E6%A0%B8%E5%BF%83%E6%8A%80%E6%9C%AF%E3%80%82
• https://github.com/linuxserver/pixelflux/%EF%BC%9A%E6%A0%B8%E5%BF%83%E8%A7%86%E9%A2%91/%E5%9B%BE%E5%83%8F%E6%B8%B2%E6%9F%93%E7%AE%A1%E9%81%93%E3%80%82
• https://github.com/linuxserver/pcmflux%EF%BC%9A%E8%BD%BB%E9%87%8F%E7%BA%A7%E5%BA%95%E5%B1%82Web%E5%8E%9F%E7%94%9Fopus%E9%9F%B3%E9%A2%91%E7%BC%96%E7%A0%81%E5%99%A8%E3%80%82
• 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平台，当前可用发行版及标签如下：

部署与使用示例

基本运行命令

bash
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示例

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