能否在Linux容器部署TeamCity Server，Windows容器部署Build Agent并连通？

当然可以实现！我之前帮团队搭建过这种跨容器平台的TeamCity环境，只要搞定网络连通性和Agent的注册配置就行，下面给你一步步拆解：

1. 先搞定跨平台网络连通性 #

Docker现在支持Linux和Windows容器共用同一个自定义网桥（单节点场景下），这是两者能通信的核心：

• 创建一个专属的Docker网络：
  docker network create teamcity-shared-network
• 启动TeamCity Server时，一定要把它加入这个网络，示例启动命令：
  docker run -d --name teamcity-server --network teamcity-shared-network -p 8111:8111 jetbrains/teamcity-server

2. 完成TeamCity Server初始化 #

第一次启动Server后，打开浏览器访问http://localhost:8111，完成初始化流程：

• 选择数据库（可以先选内置的H2数据库用于测试，生产环境建议用外部数据库）
• 创建管理员账号
• 记下Server在容器网络里的标识：要么是容器名teamcity-server（Docker会自动解析），要么是容器的IP（可以用docker inspect teamcity-server查看）

3. 部署Windows容器版Build Agent #

第一步：拉取对应版本的Agent镜像 #

注意要和Server的版本匹配，比如Server用的是2024.03版本，Agent就选带对应版本标签的Windows镜像：
docker pull jetbrains/teamcity-agent:2024.03-windowsservercore-ltsc2019

第二步：启动Agent并指定Server地址 #

启动时要加入同一个共享网络，同时通过环境变量指定Server的访问地址，还要挂载本地目录来持久化Agent的配置和工作文件：

docker run -d --name teamcity-windows-agent --network teamcity-shared-network `
  -v C:\local\teamcity-agent\conf:C:\BuildAgent\conf `
  -v C:\local\teamcity-agent\work:C:\BuildAgent\work `
  -e SERVER_URL=http://teamcity-server:8111 `
  jetbrains/teamcity-agent:2024.03-windowsservercore-ltsc2019

这里的SERVER_URL用容器名teamcity-server就够了，不用记IP，Docker会在共享网络里自动解析。

4. 完成Agent的授权 #

回到TeamCity Server的Web界面，进入Agents页面，你会看到刚启动的Windows Agent处于「未授权」状态：

• 点击Agent卡片上的「授权」按钮
• 等待Agent完成初始化同步，之后就可以给它分配Windows专属的构建任务了（比如.NET项目编译、PowerShell脚本执行等）

几个关键注意事项 #

• 确保Docker Desktop已经开启Windows容器功能：在Docker Desktop设置里切换到「Windows容器」模式（如果是WSL2后端，也可以同时支持Linux和Windows容器）
• 版本一致性：Server和Agent的镜像版本必须完全一致，否则可能出现注册失败或兼容性问题
• 资源分配：Windows容器比较吃资源，记得给Docker分配足够的CPU和内存（比如至少4核8G），避免构建时卡顿
• 网络排查：如果Agent连不上Server，先在Windows容器里测试连通性：进入容器docker exec -it teamcity-windows-agent powershell，然后执行ping teamcity-server，如果不通，检查是否都加入了同一个共享网络

内容的提问来源于stack exchange，提问作者Cameron