服务与存储

更新于 2026年11月10日

konsolity serve 会像桌面应用那样处理账户中 Claude 连接器的请求,但没有界面:即使您的电脑已关机,Claude 也能在机器的范围和规则内操作您的服务器。它需要 mcp 域和 Studio 套餐的 Claude 集成,并且必须已在 Claude 中添加 Claude 连接器。

在前台试用

konsolity serve

该命令在前台运行,并显示每个已处理或被拒绝的请求。按 Ctrl+C 停止。在正式的服务器上,请将其安装为服务。

Linux:systemd

sudo konsolity service install

该命令会:

  • 创建系统用户 konsolity,该用户没有 shell 也没有密码;
  • 安装 konsolity.service 单元,启用自动重启(Restart=always)和 systemd 沙箱(ProtectSystem=strict、NoNewPrivileges=yes);
  • 将配置存放在 /etc/konsolity/,将状态存放在 /var/lib/konsolity/;
  • 使用 systemd-creds 加密机密(见下文);
  • 将程序复制到 /usr/local/bin/konsolity(沙盒会对服务隐藏 /home);
  • 安装 konsolity-update.timer 定时器:每天两次检查已签名的版本,更新程序并重启服务;
  • 启用并启动服务。

服务随系统启动,并会在出错或网络中断后自动重启。查看其日志:

journalctl -u konsolity
journalctl -u konsolity -f

多台服务器:主中继与备用中继

在两台或更多服务器上激活 Konsolity CLI,每台都运行 service install。每个 Claude 请求只由一个中继处理:优先级最高的那个(设置 › Claude › Claude 中继)。其他中继待命,无需打开应用或 Mac。

主中继正常停止时,下一个中继在一秒内接管。主中继意外宕机时,下一个中继在 6 秒后接管未响应的请求,第三个在 12 秒后接管。同一请求绝不会执行两次。日志会显示每台机器的角色:“活动中继”或“待命”。

若要让备用中继也接管命令,它的规则必须允许命令(设置 › CLI 机器 › 该机器 › 规则)。否则它只接管读取操作(主机、代码片段、会话)。

macOS:launchd

sudo konsolity service install

安装 launchd 服务 com.konsolity.cli,并自动重启(KeepAlive)。机密存储在钥匙串中。日志可在“控制台”应用中查看。

Windows:计划任务

在以管理员身份运行的 PowerShell 中:

konsolity service install

创建一个计划任务,在 Windows 启动时运行 konsolity serve,并在出错后重新启动它。

检查

konsolity status

status 会显示机器是否可访问、令牌的存在时长、范围以及可访问的主机数量。只要机器在最近一分钟内有过活动信号,它就会在 CLI 机器列表中显示为在线。

文件夹

路径 内容
~/.config/konsolity/ Linux 和 macOS,不作为服务使用时:config.json 和机密
%APPDATA%\Konsolity\cli\ Windows:config.json 和 credentials.bin
/etc/konsolity/ Linux 服务:配置
/var/lib/konsolity/ Linux 服务:加密的机密和状态

config.json(服务器地址、机器的标识符和名称、显示的范围)的权限为 0600。其中不包含任何机密。

机密存储

机器的机密是其令牌和机器密钥。根据系统不同,存储方式如下:

系统 存储方式
macOS 钥匙串(条目 com.konsolity.cli)
Linux,作为服务 systemd-creds encrypt,机器有 TPM 时使用 TPM,否则使用主机密钥
Linux,没有 systemd-creds credentials.bin 文件,权限 0600
Windows credentials.bin 中的 DPAPI(当前用户),仅限该账户访问

在所有情况下,内容都会先用根据机器标识符派生的密钥加密:复制到另一台电脑上将无法读取。机密从不出现在日志、命令行参数或环境变量中,唯一的例外是您为长期令牌主动提供的 KONSOLITY_TOKEN。

令牌自动轮换

机器的令牌会每 24 小时自动续期,不会中断服务:在使用新令牌进行首次调用之前,旧令牌仍然有效,最长 10 分钟。如需强制轮换(恢复备份后,或有第三方在机器上操作过之后):

konsolity rotate

长期令牌(setup-token)不会自动轮换;它们最迟在一年后过期。

卸载服务

sudo konsolity service uninstall

服务会被停止并移除。机器在您的账户中仍保持激活状态:如需同时切断它,请运行 konsolity logout,或在 CLI 机器列表中将其撤销。