配置界面（TUI）

code-server-setup 是服务端的全屏方向键配置界面——类似 nmtui。它编辑的就是服务器读的那个 YAML，保存时自动通知运行中的服务器重载。不用手改 YAML，也不会忘记重启。

运行

sudo code-server-setup                 # 系统安装（编辑 /etc/code.yaml）
code-server-setup --config ~/.config/code/server.yaml   # 用户态安装
podman exec -it code-server code-server-setup           # 容器里

它随服务端一起自动安装。

操作

 code-server-setup — editing /etc/code.yaml
 ─────────────────────────────────────────────
   listen        :80
   tlsDomains    code.example.com
 ▶ tlsEmail      ops@example.com▏
   cookieSecure  [x] true
   dataDir       /var/lib/code/data
 ─────────────────────────────────────────────
 ↑/↓ field   ←/→/Space toggle   type to edit   ⌫ delete   Ctrl+S save   Ctrl+C quit

按键	动作
↑ / ↓	在字段间移动
直接打字 / ⌫	编辑文本字段（tlsDomains 用逗号分隔多个）
← / → / Space	切换布尔值（如 cookieSecure）
Ctrl+S	保存并热重载运行中的服务器
Ctrl+C / Esc	不保存退出

保存时发生什么

Ctrl+S 写入 YAML 并通知运行中的服务器，它会带着新配置原地重启——包括需要重新绑定端口的改动（比如打开 HTTPS）。连接断开一秒左右自动重连，Agent 上正在跑的任务不受影响。

服务器没在运行也没关系——文件照样保存，下次启动时生效。

排错

• save failed——配置文件不可写。容器场景下，宿主机的 /etc/code.yaml 必须以读写方式挂载，且属主是容器用户：chown 10001:10001 /etc/code.yaml。
• 保存了某个键但行为没变——这个键可能被 CODE_* 环境变量覆盖了（容器部署常见）。环境变量优先；去容器定义里改。见配置文件。