epicmorg/teamcity-agent
epicmorg
JetBrains官方TeamCity最小构建代理镜像，仅包含基础代理功能，不含VCS客户端等工具，适用于简单构建或作为自定义镜像的基础，需连接TeamCity服务器运行。
1 次收藏下载次数: 0状态：社区镜像维护者：epicmorg仓库类型：镜像最近更新：3 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
TeamCity 最小构建代理
这是官方的 https://www.jetbrains.com/teamcity/ 最小构建代理镜像。
https://www.jetbrains.com/help/teamcity/build-agent.html 连接到 TeamCity 服务器并生成实际的构建进程。您可以使用 jetbrains/teamcity-server 镜像运行 TeamCity 服务器。
此最小镜像仅包含 TeamCity 代理，不附带版本控制系统客户端等工具。它适用于简单构建，也可作为自定义镜像的基础。对于 Java 或 .NET 开发，建议使用默认构建代理镜像 https://hub.docker.com/r/jetbrains/teamcity-agent/%E3%80%82
核心功能与特性
- 轻量级设计：仅包含基础代理组件，无额外开发工具
- 灵活扩展：可作为自定义构建环境的基础镜像
- 跨平台支持：可在 Linux 和 Windows 容器中运行
- 自动升级：连接到升级后的服务器时，代理会自动升级
使用场景
- 简单构建任务的执行
- 作为自定义构建环境的基础镜像
- 资源受限环境中的构建代理部署
如何使用此镜像
拉取镜像
从 Docker Hub 仓库拉取 TeamCity 最小镜像：
jetbrains/teamcity-minimal-agent
启动容器
Linux 容器
bashdocker run -it -e SERVER_URL="<TeamCity服务器URL>" \ -v <代理配置文件夹路径>:/data/teamcity_agent/conf \ jetbrains/teamcity-minimal-agent
Windows 容器
bashdocker run -it -e SERVER_URL="<TeamCity服务器URL>" \ -v <代理配置文件夹路径>:C:/BuildAgent/conf \ jetbrains/teamcity-minimal-agent
参数说明：
SERVER_URL：TeamCity 服务器的完整 URL（必填），注意localhost通常不可用，因为它指向容器内部的本地主机<代理配置文件夹路径>：主机上用于持久化代理配置的目录，建议指定以保留授权状态等配置，每个代理需映射不同的文件夹
注意：自 2020.1 版本起，TeamCity 代理 Docker 镜像以非 root 用户运行。有关可能受影响的用例，请参考 https://www.jetbrains.com/help/teamcity/upgrade-notes.html#UpgradeNotes-AgentDockerimagesrunundernon-rootuser%E3%80%82
代理授权
首次运行代理时，需通过 TeamCity 服务器 UI 进行授权：在浏览器中访问 未授权代理 页面完成授权。代理的授权信息存储在配置文件夹中，使用相同配置文件夹启动新容器时，代理名称和授权状态将保留。
环境变量配置
| 环境变量 | 说明 |
|---|---|
SERVER_URL | TeamCity 服务器的 URL（必填），代理将连接到此服务器 |
AGENT_NAME | （可选）代理在 TeamCity UI 中显示的名称，未设置则自动生成 |
AGENT_TOKEN | （可选）代理授权令牌，未设置时需通过 TeamCity UI 授权 |
OWN_ADDRESS | （可选，仅 Linux）代理绑定的 IP 地址，未设置则自动检测 |
OWN_PORT | （可选，仅 Linux）代理绑定的端口，默认 9090 |
Windows 容器限制
有关 Windows 容器中的已知问题，请参阅 https://www.jetbrains.com/help/teamcity/known-issues.html#KnownIssues-WindowsDockerContainers%E3%80%82
自定义镜像
可通过以下步骤自定义镜像：
- 运行基础容器：
bashdocker run -it -e SERVER_URL="<TeamCity服务器URL>" \ -v <代理配置文件夹路径>:/data/teamcity_agent/conf \ --name="my-customized-agent" \ jetbrains/teamcity-minimal-agent
- 进入容器：
bashdocker exec -it my-customized-agent bash
-
根据需求进行修改（安装工具、配置环境等）
-
提交为新镜像：
bashdocker commit my-customized-agent <目标镜像仓库>
许可证
本镜像基于 https://www.jetbrains.com/teamcity/buy/license.html 提供。TeamCity 可免费永久使用，限制为 100 个构建配置（任务）和 3 个代理。https://www.jetbrains.com/help/teamcity/licensing-policy.html%E3%80%82
反馈
请将问题或建议报告至官方 TeamCity https://youtrack.jetbrains.com/issues/TW%E3%80%82
其他 TeamCity 镜像
- https://hub.docker.com/r/jetbrains/teamcity-server/
- https://hub.docker.com/r/jetbrains/teamcity-agent/
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 teamcity-agent 镜像标签
docker pull docker.xuanyuan.run/epicmorg/teamcity-agent:<标签>
DockerHub 原生拉取命令
docker pull epicmorg/teamcity-agent:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"