Skip to content

数据与备份

服务器的全部数据都在一个目录下——dataDir,默认 /var/lib/code/data(用户态安装:~/.local/share/code/data)。纯文件,没有数据库。

里面有什么

内容
device/绑定的机器和(哈希后的)Web 密码——相当于你的"账号"
会话与消息每个历史会话的聊天记录
设置服务端偏好设置
cert/cache/HTTPS 证书和 Let's Encrypt 账户密钥

你的代码和 Claude Code 凭证不在这里——它们从不离开你自己的电脑。服务器只保存中继数据和历史。

备份

要备的就两样:数据目录和配置文件。

bash
sudo systemctl stop code-server
sudo tar czf code-backup-$(date +%F).tgz /var/lib/code/data /etc/code.yaml
sudo systemctl start code-server

(不停服务也能备,但停一秒能保证快照一致。)

迁移到新服务器

  1. 在新机器上装服务端(安装服务端)。
  2. 停掉服务,把备份恢复到相同路径,chown -R code:code /var/lib/code(容器:10001:10001),再启动。
  3. 把域名 DNS 指向新 IP。

Agent 和浏览器都按域名重连,所以绑定、密码、历史全部原样保留——不需要重新绑定。证书缓存跟着数据走,也不用重签。

重置

想恢复出厂?停掉服务器、删掉数据目录——所有机器、密码、历史都会清空,每个 Agent 都得重新绑定。启动时会重签证书;反复重置可能触发 Let's Encrypt 限流(见 HTTPS 与域名),所以建议保留 cert/cache

bash
sudo systemctl stop code-server
sudo find /var/lib/code/data -mindepth 1 -maxdepth 1 ! -name cert -exec rm -rf {} +
sudo systemctl start code-server