跳至主要内容

设置 GitHub Codespaces 的超时时间

您可以在个人设置页面中设置 GitHub Codespaces 的默认超时时间。

关于空闲超时

Codespace 在一段时间不活动后将停止运行。默认情况下,此时间段为 30 分钟,但您可以在 GitHub 上的个人设置中指定更长或更短的默认超时时间段。更新的设置将应用于您创建的任何新的 Codespaces,或在您下次启动现有 Codespaces 时应用于它们。您还可以在使用 GitHub CLI 创建 Codespace 时指定超时时间。

警告

Codespaces 计算使用费用按 Codespace 处于活动状态的时长计费。如果您没有使用 Codespace 但它仍在运行且尚未超时,则无论您是否正在使用它,都会对 Codespace 处于活动状态的总时间计费。有关更多信息,请参阅“GitHub Codespaces 的计费说明”。

空闲状态定义

在 Codespaces 空闲超时上下文中,空闲状态定义为缺少表明用户存在的活动。与 Codespace 的个人交互(例如打字或使用鼠标)会重置空闲超时时间段。终端活动(输入或输出)也会重置空闲超时时间段。例如,如果您从 Codespace 的某个端口发布 Web 应用,并且页面请求在 Codespace 上的终端中生成输出,则每次终端输出发生时,超时都会重置。但是,如果您共享一个端口,然后不与 Codespace 交互,并且没有生成终端输出,则 Codespace 会在配置的时间段后超时。

组织拥有的存储库的超时时间段

组织可以为从其某些或所有存储库创建的 Codespaces 设置最大空闲超时策略。如果组织策略设置的最大超时时间小于您设置的默认超时时间,则将使用组织的超时时间,而不是您的设置。Codespace 创建后,您将收到通知。有关更多信息,请参阅“限制空闲超时时间段”。

设置您的默认超时时间段

  1. 在 GitHub 上任何页面的右上角,单击您的个人资料照片,然后单击 设置.

  2. 在侧边栏的“代码、计划和自动化”部分,单击 Codespaces

  3. 在“默认空闲超时”下,输入所需的时间,然后单击“保存”。时间必须在 5 分钟到 240 分钟(4 小时)之间。

    Screenshot of the "Default idle timeout" section of the Codespaces settings, with "90 minutes" entered.

设置 Codespace 的超时时间段

要了解有关 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。

要设置创建 Codespace 时的超时时间段,请将 idle-timeout 参数与 codespace create 子命令一起使用。以分钟为单位指定时间,后跟 m。时间必须在 5 分钟到 240 分钟(4 小时)之间。

gh codespace create --idle-timeout 90m

如果您在创建 Codespace 时未指定超时时间段,则将使用默认超时时间段。有关设置默认超时时间段的信息,请单击此页面上的“Web 浏览器”选项卡。您目前无法通过 GitHub CLI 指定默认超时时间段。

设置超时时间段

您可以在 GitHub 上的 Web 浏览器中设置您的默认超时时间段。或者,如果您使用 GitHub CLI 创建 Codespace,则可以为该特定 Codespace 设置超时时间段。有关更多信息,请单击以上相应的选项卡。

进一步阅读