Skip to main content

此版本的 GitHub Enterprise 将停止服务 2023-01-18. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

Getting started with GitHub Enterprise Server

Get started with setting up and managing your GitHub Enterprise Server instance.

This guide will walk you through setting up, configuring and managing your GitHub Enterprise Server instance as an enterprise administrator.

GitHub provides two ways to deploy GitHub Enterprise.

  • GitHub Enterprise Cloud
  • GitHub Enterprise Server

GitHub hosts GitHub Enterprise Cloud. You can deploy and host GitHub Enterprise Server in your own datacenter or a supported cloud provider.

For more information about GitHub Enterprise Server, see "About GitHub Enterprise Server."

Part 1: Installing GitHub Enterprise Server

To get started with GitHub Enterprise Server, you will need to create your enterprise account, install the instance, use the Management Console for initial setup, configure your instance, and manage billing.

1. Creating your enterprise account

Before you install GitHub Enterprise Server, you can create an enterprise account on GitHub.com by contacting GitHub's Sales team. An enterprise account on GitHub.com is useful for billing and for shared features with GitHub.com via GitHub Connect. For more information, see "About enterprise accounts."

2. Installing GitHub Enterprise Server

To get started with GitHub Enterprise Server, you will need to install the appliance on a virtualization platform of your choice. For more information, see "Setting up a GitHub Enterprise Server instance."

3. Using the Management Console

You will use the Management Console to walk through the initial setup process when first launching your GitHub Enterprise Server instance. You can also use the Management Console to manage instance settings such as the license, domain, authentication, and TLS. For more information, see "Accessing the management console."

4. Configuring your GitHub Enterprise Server instance

In addition to the Management Console, you can use the site admin dashboard and the administrative shell (SSH) to manage your GitHub Enterprise Server instance. For example, you can configure applications and rate limits, view reports, use command-line utilities. For more information, see "Configuring your enterprise."

You can use the default network settings used by GitHub Enterprise Server via the dynamic host configuration protocol (DHCP), or you can also configure the network settings using the virtual machine console. You can also configure a proxy server or firewall rules. For more information, see "Configuring network settings."

5. Configuring high availability

You can configure your GitHub Enterprise Server instance for high availability to minimize the impact of hardware failures and network outages. For more information, see "Configuring high availability."

6. Setting up a staging instance

You can set up a staging instance to test modifications, plan for disaster recovery, and try out updates before applying them to your GitHub Enterprise Server instance. For more information, see "Setting up a staging instance."

7. Designating backups and disaster recovery

To protect your production data, you can configure automated backups of your GitHub Enterprise Server instance with GitHub Enterprise Server Backup Utilities. For more information, see "Configuring backups on your appliance."

8. Managing billing for your enterprise

Billing for all the organizations and GitHub Enterprise Server instances connected to your enterprise account is aggregated into a single bill charge for all of your paid GitHub.com services. Enterprise owners and billing managers can access and manage billing settings for enterprise accounts. For more information, see "Managing billing for your enterprise."

Part 2: Organizing and managing your team

As an enterprise owner or administrator, you can manage settings on user, repository, team and organization levels. You can manage members of your enterprise, create and manage organizations, set policies for repository management, and create and manage teams.

1. Managing members of your GitHub Enterprise Server instance

You can manage settings and audit activity for the members of your GitHub Enterprise Server instance. You can promote an enterprise member to be a site administrator, manage dormant users, view the audit log for user activity, and customize messages that enterprise members will see. For more information, see "Managing users in your enterprise."

2. Creating organizations

You can create new organizations in your GitHub Enterprise Server instance to reflect your company or group's structure. For more information, see "Creating a new organization from scratch."

3. Adding members to organizations

You can add members to organizations in your GitHub Enterprise Server instance as long as you are an organization owner in the organizations you want to manage. You can also configure visibility of organization membership. For more information, see "Adding people to your organization" and "Configuring visibility for organization membership."

4. Creating teams

团队是可通过组形式向其授予特定存储库权限的组织成员组。 可以在每个组织中创建单个团队或多个级别的嵌套团队。 有关详细信息,请参阅“创建团队”和“将人员添加到团队”。

5. Setting organization and repository permission levels

我们建议为每个组织中的有限成员提供组织所有者角色,该角色为该组织提供完整的管理访问权限。 有关详细信息,请参阅“组织中的角色”。

对于你拥有管理员权限的组织,你还可以使用精细的权限级别自定义对每个存储库的访问权限。 有关详细信息,请参阅“组织的存储库权限级别”。

6. Enforcing repository management policies

As an enterprise owner, you can set repository management policies for all organizations in your GitHub Enterprise Server instance, or allow policies to be set separately in each organization. For more information, see "Enforcing repository management policies in your enterprise."

Part 3: Building securely

To increase the security of your GitHub Enterprise Server instance, you can configure authentication for enterprise members, use tools and audit logging to stay in compliance, configure security and analysis features for your organizations, and optionally enable GitHub Advanced Security.

1. Authenticating enterprise members

You can use GitHub Enterprise Server's built-in authentication method, or you can choose between an external authentication provider, such as CAS, LDAP, or SAML, to integrate your existing accounts and centrally manage user access to your GitHub Enterprise Server instance. For more information, see "About authentication for your enterprise."

You can also require two-factor authentication for each of your organizations. For more information, see "Requiring two factor authentication for an organization."

2. Staying in compliance

You can implement required status checks and commit verifications to enforce your organization's compliance standards and automate compliance workflows. You can also use the audit log for your organization to review actions performed by your team. For more information, see "Enforcing policy with pre-receive hooks" and "About the audit log for your enterprise."

3. Configuring security features for your organizations

To keep the organizations in your GitHub Enterprise Server instance secure, you can use a variety of GitHub security features, including security policies, dependency graphs, secret scanning and Dependabot security and version updates. For more information, see "Securing your organization" and "Managing security and analysis settings for your organization."

4. Enabling GitHub Advanced Security features

You can upgrade your GitHub Enterprise Server license to include GitHub Advanced Security. This provides extra features that help users find and fix security problems in their code, such as code and secret scanning. For more information, see "GitHub Advanced Security for your enterprise."

Part 4: Customizing and automating your enterprise's work on GitHub

You can customize and automate work in organizations in your enterprise with GitHub and OAuth Apps, GitHub Enterprise Server API, GitHub Actions, GitHub Packages , and GitHub Pages.

1. Building GitHub Apps and OAuth Apps

You can build integrations with the GitHub Enterprise Server API, such as GitHub Apps or OAuth Apps, for use in organizations in your enterprise to complement and extend your workflows. For more information, see "About apps."

2. Using the GitHub Enterprise Server API

GitHub Enterprise Server API 有两个版本:REST API 和 GraphQL API。 要自动执行常见任务、备份数据或创建集成,可以使用 GitHub Enterprise Server API。 有关详细信息,请参阅关于 GitHub 的 API

3. Building GitHub Actions

With GitHub Actions, you can automate and customize your GitHub Enterprise Server instance's development workflow on GitHub Enterprise Server. You can create your own actions, and use and customize actions shared by the GitHub community. For more information, see "Learn GitHub Actions."

For more information on enabling and configuring GitHub Actions on GitHub Enterprise Server, see "Getting started with GitHub Actions for GitHub Enterprise Server."

4. Publishing and managing GitHub Packages

GitHub Packages 是一种软件包托管服务,允许您私下或公开托管软件包,并将包用作项目中的依赖项。 有关详细信息,请参阅“GitHub Packages 简介”。

For more information on enabling and configuring GitHub Packages for your GitHub Enterprise Server instance, see "Getting started with GitHub Packages for your enterprise."

5. Using GitHub Pages

GitHub Pages 是一项静态站点托管服务,它直接从存储库获取 HTML、CSS 和 JavaScript 文件并发布网站。 可以在组织级别为企业成员启用或禁用 GitHub Pages。 有关详细信息,请参阅“为企业配置 GitHub Pages”和“关于 GitHub Pages”。

Part 5: Connecting with other GitHub resources

You can use GitHub Connect to share resources.

If you are the owner of both a GitHub Enterprise Server instance and a GitHub Enterprise Cloud organization or enterprise account, you can enable GitHub Connect. GitHub Connect allows you to share specific workflows and features between your GitHub Enterprise Server instance and GitHub Enterprise Cloud, such as unified search and contributions. For more information, see "Connecting GitHub Enterprise Server to GitHub Enterprise Cloud."

Part 6: Using GitHub's learning and support resources

Your enterprise members can learn more about Git and GitHub with our learning resources, and you can get the support you need when setting up and managing your GitHub Enterprise Server instance with GitHub Enterprise Support.

1. Reading about GitHub Enterprise Server on GitHub Docs

You can read documentation that reflects the features available with GitHub Enterprise Server. For more information, see "About versions of GitHub Docs."

若要了解企业如何最有效地使用 GitHub Enterprise Server,请参阅“企业最佳做法”。

2. Learning with GitHub Skills

企业成员可以通过 GitHub Skills 在自己的 GitHub 存储库中完成有趣、逼真的项目来学习新技能。 每门课程都是由 GitHub 社区创建并由友好的机器人教授的实践课程。

有关详细信息,请参阅“Git 和 GitHub 学习资源”。

3. Working with GitHub Enterprise Support

GitHub Enterprise Server 包括对 GitHub Enterprise 支持 的访问权限。 GitHub Enterprise 支持 可帮助排除 GitHub Enterprise Server 上出现的问题。 你还可以选择注册 GitHub 高级支持以获取更多功能。 有关详细信息,请参阅“关于 GitHub Enterprise 支持”。