Skip to main content

设置 GitHub Codespaces 超时期限

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

关于空闲超时

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

警告:在 codespace 处于活动状态期间对 codespaces 计算用量计费。 如果未使用 codespace,但它仍在运行,并且尚未超时,则无论是否正在使用 codespace,你都需按 codespace 处于活动状态的总时间付费。 有关详细信息,请参阅“关于 GitHub Codespaces 的计费”。

定义的非活动

在 Codespaces 空闲超时的上下文中,非活动定义为用户状态缺少活动指示性。 与 Codespaces 进行个人交互(例如输入或使用鼠标)会重置空闲超时期限。 此外,终端活动(输入或输出)也会重置空闲超时期限。 例如,如果从 codespace 在端口上发布一个 Web 应用且页面请求在 codespace 上的终端中生成输出,则每当发生终端输出时都会重置超时。 但是,如果共享端口,然后不与 codespace 交互并且不生成终端输出,则 codespace 将在配置的时间段后超时。

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

组织可以为从其部分或所有存储库创建的 codespace 设置最大空闲超时策略。 如果组织策略设置的最大超时时间少于你设置的默认超时时间,将使用组织的超时时间而不是你设置的超时时间。 你将在 codespace 创建后收到此通知。 有关详细信息,请参阅“限制空闲超时期限”。

设置默认超时期限

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

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

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

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

    Codespaces 设置的“默认空闲超时”部分的屏幕截图,其中输入了“90 分钟”。

设置 codespace 的超时期限

若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。

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

gh codespace create --idle-timeout 90m

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

设置超时期限

可以通过 Web 浏览器在 GitHub.com 上设置默认超时期限。 或者,如果使用 GitHub CLI 创建 codespace,则可以为该特定 codespace 设置超时期限。 有关详细信息,请单击上面相应的选项卡。

延伸阅读