Skip to content

CLI ​

text
claude-vps <command> [options]
命令在哪里运行作用
setup服务器,root 身份执行安装步骤
update服务器,root 身份拉取最新版本,并用首次安装时的参数重新运行 setup
sync服务器先 git pull,再 apply
autosync on|off服务器用 systemd 用户定时器每 30 分钟运行一次 sync
doctor服务器检查 Claude、tmux、Docker、xrdp、Plasma、ufw、ntfy 和 autosync
capture你的电脑把 dotfiles/manifest.txt 里列出的文件复制到 dotfiles/home
publish你的电脑执行 capture,然后 commit 并 push
release X.Y.Z你的电脑写入 VERSION,打上 vX.Y.Z 标签并 push。GitHub 根据 CHANGELOG.md 发布版本
apply任意位置把 dotfiles/home 写入 $HOME,覆盖前先备份
version任意位置显示版本号

setup ​

bash
sudo claude-vps setup [options]
参数默认值
-u, --user NAME$SUDO_USER,否则询问工作用户,不存在时会创建
--rdp-port PORT53389xrdp 端口
--rdp-private关不在 ufw 中开放 RDP 端口
--ntfy-topic NAME询问用于通知的 ntfy.sh topic
--timezone TZ不修改例如 Europe/Istanbul
--no-desktop关等同于 --skip desktop,rdp
--skip a,b要跳过的步骤
--only a,b只运行这些步骤
-y, --yes关不提问。用户名默认为 dev,密码自动生成
-n, --dry-run关只打印命令,不执行

步骤顺序:base user ssh firewall desktop rdp apps claude dotfiles。

更新 ​

有新版本时,在每台服务器上运行:

bash
sudo claude-vps update

它会拉取新代码,显示改了什么,然后重新执行所有 setup 步骤。已经完成的步骤会跳过。只有配置变了才会重启 xrdp 和 SSH,所以已打开的 RDP 会话不会断开。首次安装时选的参数(用户、RDP 端口、跳过的步骤)保存在 /etc/claude-vps.conf,之后会继续使用。

有新版本到达时,claude-vps sync 也会提醒你。

发布新版本 ​

在你的电脑上,往 CHANGELOG.md 里加一个 ## X.Y.Z 小节并 commit,然后运行:

bash
claude-vps release X.Y.Z

release workflow 会检查标签是否和 VERSION 一致,然后在 GitHub 上发布版本,发布说明就是 changelog 里的这一节。

作为配置来源的机器 ​

claude-vps capture 会把运行它的机器标记为配置来源(~/.config/claude-vps/source)。在这样的机器上,apply 和 sync 不会改动你的文件,因为仓库里的副本可能比你正在用的旧。如果确实要覆盖,用 claude-vps apply --force。

install.sh ​

引导脚本会读取三个环境变量:

变量默认值
CLAUDE_VPS_REPOhttps://github.com/halitsever/claude-code-vps.git
CLAUDE_VPS_DIR/opt/claude-vps
CLAUDE_VPS_BRANCHmain

bash -s -- 后面的所有参数都会传给 setup。

MIT licensed. Not affiliated with Anthropic.