数据与备份
服务器的全部数据都在一个目录下——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(不停服务也能备,但停一秒能保证快照一致。)
迁移到新服务器
- 在新机器上装服务端(安装服务端)。
- 停掉服务,把备份恢复到相同路径,
chown -R code:code /var/lib/code(容器:10001:10001),再启动。 - 把域名 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