linuxserver/cloud9 镜像文档

废弃通知

该镜像已废弃。我们将不再为该镜像提供支持，也不会进行更新。
建议考虑使用我们的 code-server 和 openvscode-server 容器作为替代方案：

• linuxserver/code-server
• linuxserver/openvscode-server

镜像概述和主要用途

linuxserver/cloud9 是 LinuxServer.io 团队提供的 Docker 镜像，用于运行 Cloud9 核心 SDK。Cloud9 是一个完整的基于 Web 的集成开发环境（IDE），包含终端访问功能。该容器主要用于本地运行 Cloud9 核心 SDK 及开发插件。

核心功能和特性

该镜像基于 LinuxServer.io 容器构建标准，具备以下特性（注意：镜像已废弃，以下特性不再维护）：

• 定期、及时的应用更新
• 简易的用户权限映射（通过 PUID、PGID）
• 基于 s6 覆盖层的自定义基础镜像
• 每周基础操作系统更新，通过跨生态共享公共层减少空间占用、 downtime 和带宽消耗
• 定期安全更新

使用场景和适用范围

Cloud9 作为 Web 端 IDE，适用于需要通过浏览器进行代码编写、调试及终端操作的场景，尤其适合本地开发 Cloud9 插件。
由于该镜像已废弃，建议迁移至 code-server 或 openvscode-server 以获得持续支持和更新。

支持的架构

该镜像通过 Docker manifest 支持多平台，拉取 lscr.io/linuxserver/cloud9:latest 即可自动匹配对应架构。也可通过标签指定特定架构：

版本标签

镜像提供以下版本标签（已停止更新）：

应用设置

访问 Web 界面：[***]。更多信息参考 Cloud9 官方文档。

使用方法

Docker Compose（推荐）

---
version: "2.1"
services:
  cloud9:
    image: lscr.io/linuxserver/cloud9:latest  # 注意：该镜像已废弃
    container_name: cloud9
    environment:
      - PUID=1000               # 用户ID，参考下文"用户/组标识符"
      - PGID=1000               # 组ID，参考下文"用户/组标识符"
      - TZ=Europe/London        # 时区，如 Asia/Shanghai
      - GITURL=[***]  # 可选，首次启动时拉取的Git仓库
      - USERNAME=               # 可选，HTTP认证用户名
      - PASSWORD=               # 可选，HTTP认证密码（若未设置用户名和密码，则不启用HTTP认证）
    volumes:
      - /path/to/your/code:/code               # 可选，本地代码目录挂载
      - /var/run/docker.sock:/var/run/docker.sock  # 可选，如需使用Docker或Compose命令需挂载
    ports:
      - 8000:8000               # Web界面端口映射
    restart: unless-stopped

Docker CLI

docker run -d \
  --name=cloud9 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e GITURL=[***] `# 可选` \
  -e USERNAME= `# 可选` \
  -e PASSWORD= `# 可选` \
  -p 8000:8000 \
  -v /path/to/your/code:/code `# 可选` \
  -v /var/run/docker.sock:/var/run/docker.sock `# 可选` \
  --restart unless-stopped \
  lscr.io/linuxserver/cloud9:latest  # 注意：该镜像已废弃

参数说明

端口映射

环境变量

卷挂载

环境变量从文件加载（Docker Secrets）

可通过 FILE__<变量名> 格式从文件加载环境变量，例如：

-e FILE__PASSWORD=/run/secrets/mysecretpassword

此时 PASSWORD 变量的值将从 /run/secrets/mysecretpassword 文件内容读取。

用户/组标识符

使用卷挂载（-v）时，可能出现宿主机与容器的权限冲突。通过指定 PUID（用户ID）和 PGID（组ID），确保宿主机卷目录的所有者与容器内运行用户一致，可避免权限问题。

获取当前用户的PUID和PGID：

id username
# 输出示例：uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

支持信息

• 容器内Shell访问：docker exec -it cloud9 /bin/bash
• 实时查看容器日志：docker logs -f cloud9
• 查看容器版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' cloud9
• 查看镜像版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/cloud9:latest

更新信息

注意：该镜像已废弃，不再提供更新。以下为通用容器更新方法（仅作参考）：

通过Docker Compose更新

# 拉取最新镜像（若镜像未更新则无变化）
docker-compose pull cloud9
# 重启容器应用更新
docker-compose up -d cloud9
# 清理旧镜像
docker image prune

通过Docker CLI更新

# 拉取最新镜像
docker pull lscr.io/linuxserver/cloud9:latest
# 停止并删除旧容器
docker stop cloud9 && docker rm cloud9
# 用原参数重新创建容器（卷挂载正确时，配置会保留）
docker run -d [原参数] lscr.io/linuxserver/cloud9:latest
# 清理旧镜像
docker image prune

本地构建

如需本地修改镜像（不推荐，建议使用替代方案）：

git clone [***]
cd docker-cloud9
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/cloud9:latest .

构建ARM架构镜像（需在x86_64主机上配置qemu）：

# 注册qemu
docker run --rm --privileged multiarch/qemu-user-static:register --reset
# 构建指定架构（如arm64v8）
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/cloud9:arm64v8-latest .

版本历史

• 2022年06月23日：废弃镜像，不再提供支持和更新。
• 2021年06月24日：使用LinuxServer仓库的预构建Compose二进制文件。
• 2020年02月07日：添加可选HTTP认证功能。
• 2019年06月02日：初始发布。