> ## Documentation Index
> Fetch the complete documentation index at: https://starforge.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# sf login

> 登录、登出与账号状态

## sf login

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf login --server https://<你的 StarForge 域名>   # 首次指定，之后记住
sf login                                    # 浏览器授权（默认）
sf login --device-flow                      # 设备码登录（SSH / 无浏览器）
sf login --token <TOKEN>                    # 非交互（CI）
```

| 选项              | 说明                                             |
| --------------- | ---------------------------------------------- |
| `-s, --server`  | StarForge 服务地址；省略则用上次记住的 / `FORGE_SERVER` 环境变量 |
| `--token`       | 直接用服务令牌登录，跳过浏览器（CI 用）                          |
| `--device-flow` | 强制设备码流程                                        |
| `--no-browser`  | 等同 `--device-flow`                             |

登录态写入 `~/.forge/`（权限 0600）。浏览器流程走 OAuth + PKCE；平台配置 OIDC（如 Casdoor）时自动跳转单点登录。

<Frame caption="控制台登录页。`sf login` 打开浏览器时也是这一页。">
  <img src="https://mintcdn.com/starforge/GatXR2rI5-_Vm4_H/images/console/login.png?fit=max&auto=format&n=GatXR2rI5-_Vm4_H&q=85&s=2306521111801b18e089d0ddd58a6667" alt="StarForge 控制台登录" width="2160" height="1350" data-path="images/console/login.png" />
</Frame>

## sf logout

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf logout
```

吊销 refresh token 并清除本地登录态。

## sf status

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf status
```

输出：当前账号与角色、配额（并发卡 / 作业 / 每日 GPU-时）、当前用量、可用硬件 profile、活跃作业列表。提交前看一眼水位是好习惯。

## `sf login`

Log in to StarForge

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
sf login [options]
```

| 选项               | 说明                                                                                                  |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| `--server`, `-s` | StarForge server address (default [https://starforge.gcoreinc.com](https://starforge.gcoreinc.com)) |
| `--token`        | Non-interactive login: use a service token (for CI)                                                 |
| `--device-flow`  | Force the device-code login (SSH / no browser)                                                      |
| `--no-browser`   | Do not open a browser (same as --device-flow)                                                       |