LiveAgent

环境要求

• 桌面客户端：从 GitHub Releases 下载对应操作系统的安装包
• 可选远程访问：本机已安装并运行 Docker
• 可选远程访问：浏览器与宿主机网络可互通（默认映射宿主 3000 端口）
• 可选反向代理：自定义域名/HTTPS 的 Nginx 环境

安装与启动步骤

1. 1下载安装包

   打开 GitHub Releases 页面，下载最新版本的安装包（由 GitHub Actions 自动构建、签名并发布），按自己的操作系统选择对应文件。

2. 2安装并启动客户端

   运行安装包完成安装后直接打开桌面客户端。桌面端开箱即用，不依赖任何服务器，无需额外配置即可使用。

3. 3部署远程网关

   仅当需要用浏览器控制本地智能体时才部署。该命令以 HTTP/WebSocket 方式监听宿主机 3000 端口，并把容器 8080 映射出去。

   docker run -d 
     --name liveagent-gateway 
     --restart unless-stopped 
     -p 3000:8080 
     -v liveagent-gateway-data:/var/lib/liveagent 
     -e LIVEAGENT_GATEWAY_TOKEN=your-token 
     ghcr.io/stack-cairn/liveagent-gateway:latest

   复制

4. 4配置远程访问地址

   在桌面端进入「设置 → 远程」页面填写 Gateway 地址。若部署在 Nginx 反向代理之后，必须填 HTTPS 地址并使用 443 端口。

5. 5升级网关版本

   一条命令完成升级：拉取新镜像 → 删除旧容器 → 用相同参数重建并清理旧镜像。若改过端口或 Token，需同步调整参数。

   docker pull ghcr.io/stack-cairn/liveagent-gateway:latest 
     && docker rm -f liveagent-gateway 
     && docker run -d 
       --name liveagent-gateway 
       --restart unless-stopped 
       -p 3000:8080 
       -v liveagent-gateway-data:/var/lib/liveagent 
       -e LIVEAGENT_GATEWAY_TOKEN=your-token 
       ghcr.io/stack-cairn/liveagent-gateway:latest 
     && docker image prune -f

   复制

关键配置

如何确认成功

容器启动后，在浏览器访问宿主机的 3000 端口（如 http://localhost:3000），能打开 WebUI 页面即部署成功。

常见问题

注意事项

• Nginx 反向代理需在整站开启 WebSocket 升级，协议 v2 起 WebUI、HTTP API、浏览器与桌面端的 WebSocket 全部走同一 HTTP 端口（默认 3000）。
• WebSocket 升级发生在 /ws/v2、/ws/v2/agent、/ws/v2/terminal 以及 /t/ 下的隧道等路径。
• 示例中的 your-token 必须替换为你自己的真实令牌后再执行命令。
• 如果通过 Nginx 反向代理暴露，桌面端「设置 → 远程」中的地址必须使用 HTTPS 与 443 端口。