不间断运行#

首先遇到的一个问题就是：这个进程退出 ssh 时会被关掉，就导致你要启动这个服务，ssh 必须在线，这搭建来不就没什么用了？下面是一个解决方案（后台运行配合 Screen）：

首先我们先看看安装/更新 screen：

1
# Debian/Ubuntu
2
sudo apt-get -y install screen
3
# CentOS
4
yum -y install screen

安装完成后新建一个窗口（名为 code），并进入：

1
screen -S code

在这个新窗口里启动/重启即可：

1
# start
2
docker start code-server
3
# restart
4
docker restart code-server

最后按下 CTRL + A + D 返回原页面，而 code-server 则是在 screen 里一直运行不会被关闭。
下一次进入这个窗口使用：

1
screen -r code

这样我们就设置好了不间断运行。

修改管理员密码#

我们发现，在网页版里的设置是没有修改密码的选项的，我们想修改密码需要修改 config.yaml 配置文件。可以用两种方法：

1
/root/.config/code-server/config.yaml

1
screen -r code
2
docker restart code-server

1
docker inspect code-server

1
<MergedDir>/root/.config/code-server/config.yaml

设置中文#

打开 code-server 默认是英文，和 VS Code 原版一样，安装语言包即可。
在扩展（Extensions）中搜索 Chinese，安装 “Chinese (Simplified) Language Pack”，根据提示点击 Restart/Reload 即可。

配置反向代理使用域名访问#

公网访问使用 ip:端口 很不美观，可以通过反向代理使用域名访问。

官方文档有使用 Caddy 的方法：
Using Let’s Encrypt with Caddy

下面演示 Nginx 的反向代理：

使用宝塔面板可直接在面板中安装并修改 Nginx 配置，跳过安装步骤。
请准备好一个域名并 A 记录解析到服务器。

如果 Nginx 未安装，执行（示例为 Docker 外安装，自行选择）：

1
# Debian/Ubuntu
2
sudo apt update && sudo apt install -y nginx
3
# CentOS
4
yum -y install nginx

修改默认配置（如 /etc/nginx/nginx.conf），确保在 http {} 内包含：

1
include /etc/nginx/conf.d/*.conf;

在 /etc/nginx/conf.d/ 下新建配置文件（如 code.conf）：

1
server {
2
    listen 80;
3
    listen [::]:80;
4
    server_name mydomain.com;    # 改为你的域名
5

6
    location / {
7
      proxy_pass http://localhost:8082/;    # 改为你的 code-server 映射端口
8
      proxy_set_header Host $host;
9
      proxy_set_header Upgrade $http_upgrade;
10
      proxy_set_header Connection upgrade;
11
      proxy_set_header Accept-Encoding gzip;
12
    }
13
}

保存后重启 Nginx：

1
service nginx reload
2
# 或
3
systemctl restart nginx

然后即可通过 http://域名 访问。

配置域名 SSL#

使用 http:// 访问 code-server 时右下角会弹出错误提示（剪切板等功能受限），这是因为这些功能依赖于 HTTPS，所以需要给域名配置 SSL。

1
# 使用 curl 安装
2
curl https://get.acme.sh | sh -s email=my@example.com
3

4
# 使用 wget 安装
5
wget -O - https://get.acme.sh | sh -s email=my@example.com

1
acme.sh --issue --nginx -d example.com

1
server {
2
  listen 443 ssl;
3
  listen [::]:443 ssl;
4
  server_name mydomain.com;    # 改为你的域名
5

6
  location / {
7
      proxy_pass http://localhost:8082/;    # 改为你的端口
8
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
9
      proxy_set_header X-Forwarded-Proto $scheme;
10
      proxy_set_header Host $http_host;
11
      proxy_set_header Upgrade $http_upgrade;
12
      proxy_set_header Connection upgrade;
13
      proxy_set_header Accept-Encoding gzip;
14
      proxy_redirect off;
15
  }
16

17
  ssl_certificate     /path/to/your/fullchain.cer;
18
  ssl_certificate_key /path/to/your/private.key;
19
}
20

21
# HTTP 自动跳转 HTTPS（可选）
22
server {
23
    listen 80;
24
    server_name mydomain.com;
25
    return 301 https://$host$request_uri;
26
}

C/C++ 环境配置#

在浏览器的 code-server 界面中安装 C/C++ 支持时，扩展列表可能找不到官方 C/C++ 扩展（仅有 C/C++ Language Basics）。
可从 VS Code 扩展商店手动下载 VSIX 安装包：

• 商店地址：https://marketplace.visualstudio.com/vscode
• 搜索 “C/C++” 下载 VSIX（对应你的平台）
• 在 code-server 的扩展面板中选择 “从 VSIX 安装”（Install from VSIX）

由于运行在容器内，VSIX 文件需位于容器可访问的目录（或挂载目录）中。

安装完成后，在终端安装 gcc：

1
# Debian/Ubuntu
2
sudo apt-get update
3
sudo apt-get install -y gcc
4

5
# CentOS
6
yum -y install gcc gcc-c++ autoconf make

检测是否安装成功：

1
gcc -v

编写一个简单的 hello.c 测试编译运行（示例）：

1
#include <stdio.h>
2
int main() {
3
  printf("hello world\n");
4
  return 0;
5
}

Python 环境配置#

Python 相对简单：

1. 安装 “Python” 扩展
2. 在容器终端中检查 Python 是否可用

1
whereis python
2
python -v
3
python3 -v

若仅 python3 可用，则创建软链接：

1
sudo ln -s /usr/bin/python3 /usr/bin/python

安装 pip：

1
# Debian/Ubuntu
2
sudo apt-get update
3
sudo apt-get install -y python3-pip
4

5
# CentOS
6
yum -y install epel-release
7
yum -y install python-pip

随后即可按需安装第三方库，编写 hello.py 测试：

1
print("hello world")

反向代理 502#

• 在 Nginx 反代配置里，将 proxy_pass 的端口确认指向 code-server 容器暴露的正确端口（例如 8082 → 8080 的映射关系）。
• 或者直接将 docker 运行参数改成 -p 8080:8080，避免端口不一致造成的困扰。
• 确认 Nginx 已重载配置：

1
service nginx reload
2
# 或
3
systemctl restart nginx

WebSocket close with status code 1006#

该错误通常与 WebSocket 未正确代理有关。
在 Nginx 的 location / 配置中，确保包含以下头并开启升级连接：

1
location / {
2
    proxy_pass http://127.0.0.1:8080;    # 按需调整
3
    proxy_http_version 1.1;
4
    proxy_redirect     off;
5

6
    proxy_set_header Host $host;
7
    proxy_set_header X-Real-IP $remote_addr;
8
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
9
    proxy_set_header REMOTE-HOST $remote_addr;
10

11
    proxy_set_header Upgrade $http_upgrade;
12
    proxy_set_header Connection "Upgrade";
13

14
    proxy_connect_timeout      60;
15
    proxy_send_timeout         90;
16
    proxy_read_timeout         90;
17

18
    proxy_buffer_size          4k;
19
    proxy_buffers              4 32k;
20
    proxy_busy_buffers_size    64k;
21
    proxy_temp_file_write_size 64k;
22

23
    add_header X-Cache $upstream_cache_status;
24
    add_header Cache-Control no-cache;
25
}

保存后重启 Nginx，刷新页面即可。

code-server 配置错误证书#

如果在 code-server 的配置文件中直接配置 cert，需要 IP 证书 且路径位于 容器内，否则浏览器可能不认可或访问失败。
通常建议 不要 在 code-server 内启用证书，而是 只在 Nginx 做 TLS 终止（即上文的 HTTPS 反代方案）。