安装并启动 TeamCity 代理
TeamCity 构建代理 是一种软件，它侦听来自 TeamCity 服务器的命令并启动实际的构建过程。 一个生产环境下的 TeamCity 设置需要在专用机器上安装额外的构建代理。 在此之前，请确保阅读关于 代理服务器通讯、 系统要求、 冲突软件以及 安全性的注释。
如果您安装了与 Tomcat servlet 容器捆绑的 TeamCity ，或使用 TeamCity 的 Windows 安装程序，服务器和一个构建代理都会安装在同一台机器上。 这并不是 生产环境 推荐的配置方式，因为存在 安全问题。 此外，构建过程可能会降低网络用户界面的响应速度，从而影响整体 TeamCity 服务器的运行效率。
代理服务器数据传输
一个 TeamCity 代理通过配置为 serverUrl 代理属性的 URL 连接到 TeamCity 服务器。 这被称为单向 agent-to-server （代理到服务器）连接。
代理使用单向代理至服务器连接通过轮询协议：代理建立一个 HTTP(S) 连接到 TeamCity 服务器，并定期轮询服务器以获取服务器命令。
将本地代理连接到 TeamCity 服务器
远程调试代理
在代理安装并连接之后，您可以直接从 TeamCity UI 调用此代理的机器的终端。 这项功能让您可以远程查看代理日志，检查已安装的软件，并对特定的代理问题进行调试。
要调用终端，请单击 TeamCity 页眉中的 支持人员 ，选择所需的代理，然后单击 打开终端。
您也可以从 构建结果页面 打开此终端。 在这种情况下，终端会在 checkout directory 中打开，而不是在 $HOME 文件夹中打开。
当终端打开时，您可以单击 在单独的标签页中打开 链接以获得更大的客户端区域。
打开终端 按钮适用于所有类型的代理机器（Linux、Windows 和 macOS），并以启动 TeamCity 代理的同一用户身份调用终端。
为了确保您在进行维护时构建代理处于空闲状态，请禁用它，但不要停止它，因为终端会话需要一个 运行中的 构建代理。 停止构建代理会冻结之前打开的终端标签页，阻止用户输入新的命令。
对于在空闲一段时间后自动终止的云代理，您可能需要单击 "禁用以进行维护..." 按钮，以保持代理的机器运行，并防止其在您仍在调查构建问题时关闭。
打开终端 链接仅对其 角色权限 包含 "调用交互式代理终端" 权限的用户可见。 应授予此权限给所有与相应 agent 的 代理池 关联的项目。 具有 "项目管理员" 和 "系统管理员" 角色的用户默认具有此权限。 作为额外的预防措施，每次打开终端的请求都会作为新的 "代理操作 | 连接到代理" 活动记录在 审计日志 中。