服务器参考
一台机器上的多个服务器
一台机器、一个用户账号、多个完全独立的 AgentsServer——各自拥有自己的端口、服务、token、会话历史和终端。适合分开工作与个人用途、在稳定版旁边跑一个测试版,或给每个项目一个专属服务器。
可用性
AgentsServer 1.0.9 及之后版本已支持。先安装默认服务器,再使用 agentsdock new 创建额外的命名服务。初始 npm 安装只创建默认服务。
实例如何工作
你的第一个服务器是默认实例——它保留你现有的路径、服务名和端口。每个额外的服务器都是一个命名实例(work、beta……),拥有自己的服务、端口、配置、状态目录、日志和 tmux 服务,以默认实例的同级身份安装。它们之间不共享任何东西,移除默认实例也绝不会移除命名实例。
实例是为方便而设的独立服务——它们之间不是安全边界,因为都以你的用户账号运行。
创建实例
在服务器机器上运行:
# automatic name and the next free port (7851 upwards) agentsdock new # or choose the name and port agentsdock new work --port 7851 # optional bind address (default 0.0.0.0) agentsdock new lab --port 7852 --bind 0.0.0.0
新实例从空的会话列表开始,并拥有自己新生成的 token。名称须为小写:一个字母开头,后接最多 31 个字母、数字或连字符。
$ agentsdock new work --port 7851
Create: work:7851
[7/7] AgentsServer 1.0.10 is ready
Server URL http://100.100.100.12:7851
AGENTSDOCK_SETUP_RESULT={"server_url":"http://100.100.100.12:7851","access_token":"ad_tok_...","service":"launchd","tailscale_ip":"100.100.100.12","server_version":"1.0.10"}
列出并连接
agentsdock list # name, status, port agentsdock info work # details for one instance
NAME STATUS PORT
default running 7850
Tailscale / other networks: http://100.100.100.12:7850 (recommended)
Same Wi-Fi / LAN: http://192.168.1.23:7850
This machine only: http://127.0.0.1:7850
work running 7851
Tailscale / other networks: http://100.100.100.12:7851 (recommended)
Same Wi-Fi / LAN: http://192.168.1.23:7851
This machine only: http://127.0.0.1:7851
把应用连接到实例的方式和连接任何服务器完全一样——URL 是主机地址加该实例的端口,token 用这条命令获取:
agentsdock token work
在应用里添加多个实例,在服务器切换器中随时切换。
更新实例
每个实例独立更新。请在应用里对要更新的服务器连接使用托管更新。初始 npm 安装不创建也不更新命名实例。
每个实例的位置
把 NAME 替换为实例名。
- 服务:
agents-server-NAME(Linux,systemctl --user)·com.agentsdock.server.NAME(macOS LaunchAgent) - 状态(会话、任务、文件、token):
~/.agentsdock-instances/NAME - 配置:
~/.config/agents-server-instances/NAME - 运行时发布:
~/.local/share/agents-server-instances/NAME - 日志:
~/Library/Logs/AgentsServer-instances/NAME/(macOS)·journalctl --user -u agents-server-NAME(Linux) - 所有实例的注册表:
~/.config/agents-server-manager/instances.json(只含名称、状态、端口——不含任何机密)
默认实例保留文件位置中列出的标准路径。
每个实例的终端
每个命名实例的会话终端都运行在它自己的 tmux 服务上,因此绝不会与默认服务器的会话或你在 tmux 里跑的其他东西混在一起:
tmux ls # default server's chat terminals (zd_*) tmux -L agents-server-work ls # the 'work' instance's terminals (zdi_work_*)
移除实例
agentsdock remove work # one instance agentsdock remove --all # every instance, including default agentsdock remove --all --exclude default # every named instance, keep default
移除会停止服务并删除运行时和配置(包括该实例的 token);其会话历史默认保留。当一个名称被释放时,它的状态目录会被移到私有备份,而不是抹除——见名称释放备份。--purge-state 是唯一的破坏性选项,且总是要求输入完整路径。
规则与限制
- 默认实例不能被释放;只有命名实例可以。
- 移除默认服务器绝不会影响命名实例(它们是同级根目录,不是子目录)。
- 端口必须空闲且未被预留;管理器绝不会为了占用端口而停止已有的监听进程。
- 导入的提供方历史在实例之间互斥,同一个 Claude/Codex 会话不会被采纳两次。
- 实例共享你的用户账号,彼此之间不是沙箱。