服务与存储
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 机器列表中将其撤销。