快速设置
本文介绍了在同一台机器上安装 TeamCity 服务器和一个构建代理的 评估设置 ，适用于最流行的操作系统。
要对如何安装 TeamCity 进行评估有一个大致的了解，您可以观看此视频教程，或阅读下方的完整指南。
要为生产设置安装 TeamCity ，请阅读 此部分。
下载 TeamCity
下载 TeamCity 免费专业版 ，这是一个功能齐全的 TeamCity，捆绑了 3 个构建代理，限制为 100 个构建配置和 10 个流水线。
试用后，您可以 切换到企业版。 阅读我们的 许可政策 和 定价 的详细信息。
在 Windows 上安装并运行
运行下载的 .exe 文件，并遵循 TeamCity 设置向导的指示。 TeamCity 网络服务器和一个构建代理将会被安装在同一台机器上。
在 安装 期间，您可以：
将 TeamCity 安装目录 设置为 TeamCity 将要安装的位置。
选择 TeamCity 服务器和代理是否以 Windows 服务的方式运行
配置服务器端口（默认情况下为
8111）。 请注意，它可能已被您机器上的其他应用程序占用。 如果此端口已被使用，您可以在安装过程中进行更改。
如果您已将 TeamCity 安装为 Windows 服务，请按照 常规程序启动和停止服务。
否则，要启动或停止 TeamCity 服务器和一个默认代理，同时通过命令行启动 runAll 脚本。 脚本位于 <TeamCity 安装目录>\bin 目录中。
对服务器和默认代理执行 start：
.\runAll.bat start对服务器和默认代理执行 stop：
.\runAll.bat stop
如果您在安装过程中没有更改默认端口（8111 ），则可以在同一台机器上运行的网络浏览器中通过 http://localhost 访问 TeamCity 网页界面。 否则，请使用 http://localhost:<port> （在我们的例子中为 http://localhost:7777）。
在 Linux 和 macOS 上安装并运行
确保您已安装 Java 21。 您可以使用捆绑在 TeamCity 安装程序中的 Amazon Corretto。
打开命令行终端，运行以下命令：
java -version请确保
JAVA_HOME环境变量指向 Java 安装目录。 在命令行终端中运行以下命令：echo $JAVA_HOME使用
TeamCity<版本号>.tar.gz存档文件解压捆绑了 Tomcat servlet container 的 TeamCity。
解压存档文件。 例如，在 Linux 下使用：tar xfz TeamCity<version number>.tar.gz解压缩归档文件后，TeamCity 网页服务器和一个构建代理将在当前机器上可用。
要同时启动/停止 TeamCity 服务器和一个默认代理，通过终端运行 runAll 脚本。 脚本位于 <TeamCity 安装目录>/bin 目录中。
对服务器和默认代理执行 start：
./runAll.sh start对服务器和默认代理执行 stop：
./runAll.sh stop
默认情况下，TeamCity 在 http://localhost:8111/ 上运行，并在同一台机器上有一个已注册的构建代理。 如果其他应用程序已经使用了这个端口，TeamCity 服务器（Tomcat 服务器）将无法启动，服务器日志或服务器控制台会出现“ Address already in use ”的错误。
要更改服务器端口，请找到 <TeamCity 安装目录>/conf/server.xml 并在 <Connector> XML 节点中修改端口，例如：
TeamCity 首次启动
当您首次在浏览器中启动 TeamCity 时，它会提示您完成安装：
审查 TeamCity 数据目录的位置，所有的配置信息都存储在这里。 点击 继续。
TeamCity 将构建历史、用户、构建结果和一些运行时数据存储在 SQL 数据库中，并允许您选择数据库类型。
目前，保持默认的内部数据库。 点击 继续。
TeamCity 配置必要组件需要一些时间。
在下一个屏幕上，接受许可协议以继续启动过程。 点击 继续。
TeamCity 显示 创建管理员账户 页面。 指定管理员凭据并点击 创建帐户。
您已登录到 TeamCity ：现在您可以配置您的用户设置并 创建并运行您的第一个构建。
激活 TeamCity
TeamCity 提供各种各样的 授权选项 ，适合任何规模的团队。 除了多种可用的服务器许可证，您还可以购买额外的代理来扩展构建服务器的性能。
服务器和代理许可证可以在 管理 | 许可证 页面上激活。 我们建议激活您的服务器许可证，即使是免费的专业版，以确保系统管理员及时收到有关 TeamCity 服务器安全更新的重要电子邮件通知。
了解更多： 许可政策、 管理 TeamCity 许可证
接下来是什么
在您的服务器启动并运行后，您可以继续创建第一个项目。
项目管理员指南 — 了解基本的 TeamCity 概念，例如构建配置、构建功能、触发器和 VCS 根。
配置并运行您的第一个构建 — 一个分步教程，引导您完成配置项目的主要阶段。
创建构建链 — 了解如何在单个链中链接独立的构建配置，其中多个构建可以并行运行。
用户指南 — 解释普通 TeamCity 用户如何运行构建、检查构建结果并调查问题。