使用Huggingface的免费Docker空间运行Code Server

方案涵盖的功能#

支持Python，Java，C++，Rust，Go，Kotlin等常用编程语言
同时安装Android SDK
安装Codex，支持第三方中转API
预装Playwright及其MCP Server，便于Codex使用
HF Space Free提供的2H16G服务器足够日常使用

方案仍有的不足#

镜像臃肿，部署时间长
数据不可持久化保存
部分地区网络较差，HF延迟高（域名被墙）

部署教程#

1.进入Huggingface，创建Docker Space#

前置条件：1.自备魔法上网 2.拥有Huggingface账号 按照下图的方式新建一个Docker Space，选择Docker，Docker template为Blank

其他的不用修改，直接创建Space

2.进入Space，新建两个文件#

新建一个名为`Dockerfile`的文件，内容如下：#

1
FROM python:3.11-slim-bookworm
2

3
ENV DEBIAN_FRONTEND=noninteractive
4
ENV TZ=Etc/UTC
5
ENV PORT=7860
6
ENV HOME=/home/coder
7
ENV PIP_DISABLE_PIP_VERSION_CHECK=1
8
ENV PYTHONDONTWRITEBYTECODE=1
9
ENV PYTHONUNBUFFERED=1
10

11
ARG CODE_SERVER_VERSION=4.109.2
12
ARG KOTLIN_VERSION=1.9.25
13
ARG ANDROID_CMDLINE_TOOLS_VERSION=11076708
14
ARG ANDROID_PLATFORM=34
15
ARG ANDROID_BUILD_TOOLS=34.0.0
16
ARG GO_VERSION=1.26.1
17

18
ENV KOTLIN_HOME=/opt/kotlin
19
ENV ANDROID_SDK_ROOT=/opt/android-sdk
20
ENV ANDROID_HOME=/opt/android-sdk
21
ENV GOROOT=/usr/local/go
22
ENV GOPATH=/home/coder/go
23
ENV PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright
24
ENV PATH="${PATH}:${KOTLIN_HOME}/bin:${ANDROID_SDK_ROOT}/cmdline-tools/latest/bin:${ANDROID_SDK_ROOT}/platform-tools:${GOROOT}/bin:${GOPATH}/bin"
25

26
RUN apt-get update && apt-get install -y --no-install-recommends \
27
    ca-certificates curl git bash sudo tini jq procps unzip \
28
    # C/C++ toolchain + headers
29
    build-essential gcc g++ make cmake ninja-build gdb clang clangd \
30
    libc6-dev linux-libc-dev pkg-config \
31
    # Java + Node
32
    openjdk-17-jdk-headless maven \
33
    nodejs npm \
34
    # Databases
35
    default-mysql-server default-mysql-client \
36
    postgresql postgresql-client \
37
    redis-server redis-tools \
38
    # Rust + Go
39
    rustc cargo rustfmt \
40
    && rm -rf /var/lib/apt/lists/*
41

42
# Install code-server (pinned version)
43
RUN curl -fsSL "https://github.com/coder/code-server/releases/download/v${CODE_SERVER_VERSION}/code-server_${CODE_SERVER_VERSION}_amd64.deb" -o /tmp/code-server.deb \
44
    && dpkg -i /tmp/code-server.deb \
45
    && rm -f /tmp/code-server.deb
46

47
# Kotlin compiler
48
RUN curl -fsSL "https://github.com/JetBrains/kotlin/releases/download/v${KOTLIN_VERSION}/kotlin-compiler-${KOTLIN_VERSION}.zip" -o /tmp/kotlin.zip \
49
    && unzip -q /tmp/kotlin.zip -d /opt \
50
    && mv /opt/kotlinc "${KOTLIN_HOME}" \
51
    && ln -s "${KOTLIN_HOME}/bin/kotlin" /usr/local/bin/kotlin \
52
    && ln -s "${KOTLIN_HOME}/bin/kotlinc" /usr/local/bin/kotlinc \
53
    && rm -f /tmp/kotlin.zip
54

55
# Go (official tarball for newer version than Debian repos)
56
RUN curl -fsSL "https://go.dev/dl/go${GO_VERSION}.linux-amd64.tar.gz" -o /tmp/go.tgz \
57
    && rm -rf /usr/local/go \
58
    && tar -C /usr/local -xzf /tmp/go.tgz \
59
    && rm -f /tmp/go.tgz
60

61
# Android SDK command-line tools + common packages
62
RUN mkdir -p "${ANDROID_SDK_ROOT}/cmdline-tools" \
63
    && curl -fsSL "https://dl.google.com/android/repository/commandlinetools-linux-${ANDROID_CMDLINE_TOOLS_VERSION}_latest.zip" -o /tmp/android-tools.zip \
64
    && unzip -q /tmp/android-tools.zip -d "${ANDROID_SDK_ROOT}/cmdline-tools" \
65
    && mv "${ANDROID_SDK_ROOT}/cmdline-tools/cmdline-tools" "${ANDROID_SDK_ROOT}/cmdline-tools/latest" \
66
    && rm -f /tmp/android-tools.zip \
67
    && yes | "${ANDROID_SDK_ROOT}/cmdline-tools/latest/bin/sdkmanager" --sdk_root="${ANDROID_SDK_ROOT}" --licenses \
68
    && "${ANDROID_SDK_ROOT}/cmdline-tools/latest/bin/sdkmanager" --sdk_root="${ANDROID_SDK_ROOT}" \
69
      "platform-tools" "platforms;android-${ANDROID_PLATFORM}" "build-tools;${ANDROID_BUILD_TOOLS}"
70

71
# Python core deps
72
RUN pip install --no-cache-dir --upgrade pip setuptools wheel && \
73
    PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 pip install --no-cache-dir \
74
    numpy pandas scipy scikit-learn matplotlib \
75
    jupyterlab ipykernel notebook \
76
    requests httpx aiohttp pyyaml python-dotenv tqdm rich \
77
    fastapi uvicorn[standard] pydantic flask \
78
    sqlalchemy alembic psycopg2-binary redis \
79
    pytest black isort ruff mypy \
80
    playwright
81

82
# Codex CLI + Playwright + Playwright MCP
83
# Remove pip-installed playwright CLI to avoid npm binary conflict
84
RUN rm -f /usr/local/bin/playwright \
85
    && npm install -g @openai/codex playwright @playwright/mcp \
86
    && npm cache clean --force
87

88
# Playwright browsers + system deps (Chromium/Firefox/WebKit)
89
RUN mkdir -p "${PLAYWRIGHT_BROWSERS_PATH}" \
90
    && playwright install --with-deps
91

92
# Create user
93
RUN useradd -m -u 1000 -s /bin/bash coder \
94
    && echo "coder ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers \
95
    && mkdir -p /home/coder/.config/code-server /home/coder/.codex /home/coder/go \
96
    && chown -R coder:coder /home/coder /opt/kotlin /opt/android-sdk /opt/ms-playwright
97

98
# Quick C build check (build-time)
99
RUN printf '#include <stdio.h>\nint main(){puts("ok");return 0;}\n' > /tmp/t.c \
100
    && gcc /tmp/t.c -o /tmp/t \
101
    && /tmp/t | grep -q ok \
102
    && rm -f /tmp/t.c /tmp/t
103

104
COPY --chown=coder:coder start.sh /usr/local/bin/start.sh
105
RUN chmod +x /usr/local/bin/start.sh
106

107
USER coder
108
WORKDIR /home/coder
109

110
EXPOSE 7860
111
ENTRYPOINT ["/usr/bin/tini", "--"]
112
CMD ["/usr/local/bin/start.sh"]

新建一个名为`start.sh`的文件，内容如下#

本方法的Codex使用三方api，因此需要配置api_key 有关Codex的相关配置在脚本config.toml部分，可使用环境变量的方式修改API_KEY和BASE_URL config.toml的配置教程可参考上一篇文章，也可参考你自己模型提供商的教程

1
#!/usr/bin/env bash
2
set -euo pipefail
3

4
PORT="${PORT:-7860}"
5

6
if [[ -z "${PASSWORD:-}" && -z "${HASHED_PASSWORD:-}" ]]; then
7
  echo "[ERROR] Missing PASSWORD/HASHED_PASSWORD secret."
8
  exit 1
9
fi
10

11
if [[ -d "/data" ]]; then
12
  WORKDIR="/data/workspace"
13
  EXT_DIR="/data/code-server/extensions"
14
  USER_DATA_DIR="/data/code-server/user-data"
15
  CODEX_DIR="/data/.codex"
16
else
17
  WORKDIR="${HOME}/workspace"
18
  EXT_DIR="${HOME}/.local/share/code-server/extensions"
19
  USER_DATA_DIR="${HOME}/.local/share/code-server/user-data"
20
  CODEX_DIR="${HOME}/.codex"
21
fi
22

23
mkdir -p "$WORKDIR" "$EXT_DIR" "$USER_DATA_DIR" "${USER_DATA_DIR}/User" "${HOME}/.config/code-server" "$CODEX_DIR"
24

25
cat > "${HOME}/.config/code-server/config.yaml" <<EOF
26
bind-addr: 0.0.0.0:${PORT}
27
auth: password
28
cert: false
29
EOF
30

31
if [[ -n "${HASHED_PASSWORD:-}" ]]; then
32
  echo "hashed-password: ${HASHED_PASSWORD}" >> "${HOME}/.config/code-server/config.yaml"
33
else
34
  echo "password: ${PASSWORD}" >> "${HOME}/.config/code-server/config.yaml"
35
fi
36

37
# Codex config.toml
38
: "${CODEX_MODEL_PROVIDER:=sub2api}"
39
: "${CODEX_MODEL:=你想用的模型名称}"
40
: "${CODEX_REASONING_EFFORT:=xhigh}"
41
: "${CODEX_NETWORK_ACCESS:=enabled}"
42
: "${CODEX_DISABLE_RESPONSE_STORAGE:=true}"
43
: "${CODEX_WSL_ACK:=true}"
44
: "${CODEX_VERBOSITY:=high}"
45
: "${CODEX_PROVIDER_NAME:=sub2api}"
46
: "${CODEX_BASE_URL:=你的中转站地址}"
47
: "${CODEX_WIRE_API:=responses}"
48
: "${CODEX_REQUIRES_OPENAI_AUTH:=true}"
49
: "${PLAYWRIGHT_MCP_ENABLE:=true}"
50
: "${PLAYWRIGHT_MCP_HOST:=127.0.0.1}"
51
: "${PLAYWRIGHT_MCP_PORT:=8931}"
52
: "${PLAYWRIGHT_MCP_URL:=http://${PLAYWRIGHT_MCP_HOST}:${PLAYWRIGHT_MCP_PORT}/mcp}"
53

54
cat > "${CODEX_DIR}/config.toml" <<EOF
55
model_provider = "${CODEX_MODEL_PROVIDER}"
56
model = "${CODEX_MODEL}"
57
model_reasoning_effort = "${CODEX_REASONING_EFFORT}"
58
network_access = "${CODEX_NETWORK_ACCESS}"
59
disable_response_storage = ${CODEX_DISABLE_RESPONSE_STORAGE}
60
windows_wsl_setup_acknowledged = ${CODEX_WSL_ACK}
61
model_verbosity = "${CODEX_VERBOSITY}"
62

63
[model_providers.${CODEX_PROVIDER_NAME}]
64
name = "${CODEX_PROVIDER_NAME}"
65
base_url = "${CODEX_BASE_URL}"
66
wire_api = "${CODEX_WIRE_API}"
67
requires_openai_auth = ${CODEX_REQUIRES_OPENAI_AUTH}
68
EOF
69

70
if [[ "${PLAYWRIGHT_MCP_ENABLE}" == "true" ]]; then
71
  cat >> "${CODEX_DIR}/config.toml" <<EOF
72

73
[mcp_servers.playwright]
74
url = "${PLAYWRIGHT_MCP_URL}"
75
EOF
76
fi
77

78
if [[ -n "${CODEX_AUTH_JSON:-}" ]]; then
79
  printf '%s\n' "${CODEX_AUTH_JSON}" > "${CODEX_DIR}/auth.json"
80
elif [[ -n "${OPENAI_API_KEY:-}" ]]; then
81
  cat > "${CODEX_DIR}/auth.json" <<EOF
82
{
83
  "OPENAI_API_KEY": "${OPENAI_API_KEY}"
84
}
85
EOF
86
fi
87

88
chmod 600 "${CODEX_DIR}/config.toml" 2>/dev/null || true
89
chmod 600 "${CODEX_DIR}/auth.json" 2>/dev/null || true
90

91
if [[ "${CODEX_DIR}" != "${HOME}/.codex" ]]; then
92
  rm -rf "${HOME}/.codex"
93
  ln -s "${CODEX_DIR}" "${HOME}/.codex"
94
fi
95

96
# 默认中文界面
97
cat > "${USER_DATA_DIR}/User/locale.json" <<EOF
98
{
99
  "locale": "zh-cn"
100
}
101
EOF
102

103
# 首次启动安装扩展（幂等）
104
EXT_MARKER="${USER_DATA_DIR}/.extensions_installed"
105
if [[ ! -f "${EXT_MARKER}" ]]; then
106
  echo "[INFO] Installing extensions on first boot..."
107

108
  install_ext() {
109
    code-server --extensions-dir "${EXT_DIR}" --install-extension "$1" || true
110
  }
111

112
  # 你指定的 3 个（尽量装）
113
  install_ext ms-vscode.cpptools
114
  install_ext ms-vscode.cpptools-themes
115
  install_ext ms-vscode.cpp-devtools
116
  install_ext ms-vscode.cmake-tools
117
  install_ext danielpinto8zz6.c-cpp-compile-run
118
  install_ext golang.go
119
  install_ext rust-lang.rust-analyzer
120
  install_ext redhat.java
121
  install_ext vscjava.vscode-java-debug
122
  install_ext vscjava.vscode-java-test
123
  install_ext vscjava.vscode-maven
124
  install_ext vscjava.vscode-gradle
125
  install_ext vscjava.vscode-java-dependency
126
  install_ext ms-python.vscode-pylance
127
  install_ext ms-python.python
128
  install_ext ms-python.debugpy
129
  install_ext ms-python.vscode-python-envs
130
  install_ext ms-playwright.playwright
131

132
  # Codex
133
  install_ext openai.chatgpt
134

135
  # 若微软扩展不可用，装稳定替代
136
  install_ext MS-CEINTL.vscode-language-pack-zh-hans
137
  install_ext llvm-vs-code-extensions.vscode-clangd
138
  install_ext ms-vscode.makefile-tools
139
  install_ext vadimcn.vscode-lldb
140

141
  touch "${EXT_MARKER}"
142
fi
143

144
if [[ "${PLAYWRIGHT_MCP_ENABLE}" == "true" ]]; then
145
  if command -v playwright-mcp >/dev/null 2>&1; then
146
    echo "[INFO] Starting Playwright MCP server at ${PLAYWRIGHT_MCP_URL}"
147
    nohup playwright-mcp --headless --browser chromium --no-sandbox --port "${PLAYWRIGHT_MCP_PORT}" --host "${PLAYWRIGHT_MCP_HOST}" >/tmp/playwright-mcp.log 2>&1 &
148
  else
149
    echo "[WARN] Playwright MCP not installed; skipping server start."
150
  fi
151
fi
152

153
echo "[INFO] Java:   $(java -version 2>&1 | head -n1 || true)"
154
echo "[INFO] Python: $(python --version || true)"
155
echo "[INFO] Pip:    $(pip --version || true)"
156
echo "[INFO] Node:   $(node --version || true)"
157
echo "[INFO] g++:    $(g++ --version | head -n1 || true)"
158
echo "[INFO] Rust:   $(rustc --version || true)"
159
echo "[INFO] Cargo:  $(cargo --version || true)"
160
echo "[INFO] Go:     $(go version || true)"
161
echo "[INFO] Playwright: $(playwright --version 2>/dev/null || true)"
162

163
exec code-server "$WORKDIR" \
164
  --extensions-dir "$EXT_DIR" \
165
  --user-data-dir "$USER_DATA_DIR" \
166
  --disable-telemetry \
167
  --disable-update-check \
168
  --log warn

进入README.md,开放端口7860

等待程序开始构建（首次部署时间比较久）

3.进入Space Settings，新建两个Secret#

注意：一定是要Secret，确保API_KEY的安全性

1
PASSWORD: 你自己设置的密码
2
API_KEY: 你在你的Codex渠道获取的API_KEY，具体可见上一篇文章

4.等待部署完成，开始愉快的使用#

免责声明#

使用本教程产生的一切不良后果与本人无关，此方法可能会导致Huggingface账号被封禁，请自行承担风险使用本方法造成。另外，此部署方式文件缺少持久化存储，容器重启就会丢失，请配合保活使用

音乐

Lovely firefly!

音乐

使用Huggingface的免费Docker空间运行Code Server

方案涵盖的功能#

方案仍有的不足#

部署教程#

1.进入Huggingface，创建Docker Space#

2.进入Space，新建两个文件#

新建一个名为`Dockerfile`的文件，内容如下：#

新建一个名为`start.sh`的文件，内容如下#

3.进入Space Settings，新建两个Secret#

4.等待部署完成，开始愉快的使用#

免责声明#

文章分享

音乐

目录

音乐

Lovely firefly!

音乐

使用Huggingface的免费Docker空间运行Code Server

方案涵盖的功能#

方案仍有的不足#

部署教程#

1.进入Huggingface，创建Docker Space#

2.进入Space，新建两个文件#

新建一个名为Dockerfile的文件，内容如下：#

新建一个名为start.sh的文件，内容如下#

3.进入Space Settings，新建两个Secret#

4.等待部署完成，开始愉快的使用#

免责声明#

文章分享

音乐

目录

新建一个名为`Dockerfile`的文件，内容如下：#

新建一个名为`start.sh`的文件，内容如下#