linuxserver/github-desktop

Github Desktop 是一个开源的Electron-based GitHub应用，使用TypeScript编写并采用React框架。本镜像由LinuxServer.io团队提供，具备定期更新、简单的用户映射(PGID, PUID)、自定义基础镜像等特点。

支持的架构

应用设置

应用可通过以下地址访问：

• [***]

严格反向代理

本镜像默认使用自签名证书，因此协议为https。如果您使用验证证书的反向代理，需要为容器禁用此检查。

安全注意事项

[!WARNING] 此容器提供对主机系统的特权访问。除非已正确安全配置，否则不要将其暴露到互联网。

完整功能需要HTTPS。现代浏览器功能（如WebCodecs）不会在不安全的HTTP连接上运行。默认情况下，此容器没有身份验证。可选的CUSTOM_USER和PASSWORD环境变量启用基本HTTP身份验证，仅适用于在受信任的本地网络上保护容器。对于互联网暴露，强烈建议将容器放在具有强大身份验证机制的反向代理后面。

语言支持 - 国际化

要以不同语言启动桌面会话，请设置LC_ALL环境变量，例如：

• -e LC_ALL=zh_CN.UTF-8 - 中文
• -e LC_ALL=ja_JP.UTF-8 - 日语
• -e LC_ALL=ko_KR.UTF-8 - 韩语
• -e LC_ALL=fr_FR.UTF-8 - 法语

DRI3 GPU加速

对于加速应用或游戏，可以将渲染设备挂载到容器中： --device /dev/dri:/dev/dri

此功能仅支持开源GPU驱动程序：Intel (i965和i915)、AMD (AMDGPU, Radeon, ATI)和NVIDIA (nouveau2)。

Docker部署方案

Docker Compose (推荐)

---
services:
  github-desktop:
    image: lscr.io/linuxserver/github-desktop:latest
    container_name: github-desktop
    cap_add:
      - IPC_LOCK
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - LC_ALL=zh_CN.UTF-8 # 可选，设置中文环境
    volumes:
      - /path/to/github-desktop/config:/config
    ports:
      - 3000:3000
      - 3001:3001
    shm_size: "1gb"
    restart: unless-stopped

Docker CLI

docker run -d \
  --name=github-desktop \
  --cap-add=IPC_LOCK \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/github-desktop/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/github-desktop:latest

参数说明

可选环境变量

用户/组标识符

当使用卷(-v标志)时，主机OS和容器之间可能出现权限问题。通过指定用户PUID和组PGID可以避免此问题。使用id your_user命令可查看当前用户的PUID和PGID。

应用管理

PRoot应用（持久化）

要在容器内安装应用并保持持久性，推荐使用proot-apps：

proot-apps install filezilla

原生应用（非持久化）

可使用universal-package-install mod从系统的原生仓库安装软件包，此方法不会持久化：

environment:
  - DOCKER_MODS=linuxserver/mods:universal-package-install
  - INSTALL_PACKAGES=libfuse2|git|gdb

更新与维护

通过Docker Compose更新

docker-compose pull github-desktop
docker-compose up -d github-desktop
docker image prune

通过Docker Run更新

docker pull lscr.io/linuxserver/github-desktop:latest
docker stop github-desktop
docker rm github-desktop
# 使用相同参数重新创建容器
docker image prune

版本历史

• 22.09.25: - 重新基于Debian Trixie构建
• 12.07.25: - 重新基于Selkies构建，现在需要HTTPS
• 10.02.24: - 更新Readme，添加新环境变量
• 03.08.23: - 重新基于Bookworm构建并支持多架构
• 01.04.23: - 初始发布