uv auth

管理身份认证

用法

uv auth [OPTIONS] <COMMAND>

Commands

uv auth login: 登录到服务
uv auth logout: 从服务登出
uv auth token: 显示服务的身份认证令牌
uv auth dir: 显示 uv 凭据目录的路径

登录到服务

用法

uv auth login [OPTIONS] <SERVICE>

Arguments

SERVICE: 要登录的服务的域名或 URL

Options

--allow-insecure-host, --trusted-host allow-insecure-host

允许到主机的非安全连接。

可以多次提供。

期望接收主机名（例如 localhost）、主机-端口对（例如 localhost:8080）或 URL（例如 https://localhost）。

警告：此列表中的主机将不会根据系统的证书存储进行验证。仅在安全的网络中使用 --allow-insecure-host，并确保来源已验证，因为它会绕过 SSL 验证，可能使你暴露于中间人攻击（MITM）的风险中。

也可以通过 UV_INSECURE_HOST 环境变量设置。

--cache-dir cache-dir

缓存目录的路径。

在 macOS 和 Linux 上默认为 $XDG_CACHE_HOME/uv 或 $HOME/.cache/uv，在 Windows 上默认为 %LOCALAPPDATA%\uv\cache。

要查看缓存目录的位置，请运行 uv cache dir。

也可以通过 UV_CACHE_DIR 环境变量设置。

--color color-choice

控制输出中颜色的使用。

默认情况下，uv 在写入终端时会自动检测是否支持颜色。

可选值：

auto: 仅在输出到支持颜色的终端或 TTY 时启用彩色输出
always: 无论检测到的环境如何，始终启用彩色输出
never: 禁用彩色输出

--config-file config-file

用于配置的 uv.toml 文件的路径。

虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许。

也可以通过 UV_CONFIG_FILE 环境变量设置。

--directory directory

在运行命令之前切换到指定目录。

相对路径将以给定目录为基准进行解析。

参见 --project 以仅更改项目根目录。

也可以通过 UV_WORKING_DIR 环境变量设置。

--help, -h

显示此命令的简明帮助

--keyring-provider keyring-provider

用于存储凭据的 keyring 提供程序。

login 仅支持 --keyring-provider native，它通过 uv 内置的集成使用系统 keyring。

也可以通过 UV_KEYRING_PROVIDER 环境变量设置。

可选值：

disabled: 不使用 keyring 进行凭据查找
subprocess: 使用 keyring 命令进行凭据查找

--managed-python

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。

--no-cache, --no-cache-dir, -n

避免读取或写入缓存，而是在操作期间使用临时目录

也可以通过 UV_NO_CACHE 环境变量设置。

--no-config

避免发现配置文件（pyproject.toml、uv.toml）。

通常，配置文件会在当前目录、父目录或用户配置目录中被发现。

也可以通过 UV_NO_CONFIG 环境变量设置。

--no-managed-python

禁用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

相反，uv 将在系统上搜索合适的 Python 版本。

--no-progress

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

例如，旋转指示器或进度条。

--no-python-downloads

禁用 Python 的自动下载。

--offline

禁用网络访问 [env: UV_OFFLINE=]

禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。

--password password

用于服务的密码。

使用 - 从标准输入读取密码。

--project project

在给定目录中发现项目。

所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。

其他命令行参数（如相对路径）将相对于当前工作目录进行解析。

参见 --directory 以完全更改工作目录。

此设置在 uv pip 接口中使用时没有效果。

也可以通过 UV_PROJECT 环境变量设置。

--quiet, -q

使用静默输出。

重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。

--system-certs

是否从平台的原生证书存储中加载 TLS 证书 [env: UV_SYSTEM_CERTS=]

默认情况下，uv 使用内置的 Mozilla 根证书，这提高了可移植性和性能（尤其是在 macOS 上）。

但是，在某些情况下，你可能希望使用平台的原生证书存储，特别是当你依赖系统证书存储中包含的企业信任根（例如，用于强制代理）时。

--token, -t token

用于服务的令牌。

用户名将设置为 __token__。

使用 - 从标准输入读取令牌。

--username, -u username

用于服务的用户名

--verbose, -v

使用详细输出。

你可以使用 RUST_LOG 环境变量配置细粒度的日志记录。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv auth logout

从服务登出

用法

uv auth logout [OPTIONS] <SERVICE>

Arguments

SERVICE: 要登出的服务的域名或 URL

Options

--allow-insecure-host, --trusted-host allow-insecure-host

允许到主机的非安全连接。

可以多次提供。

期望接收主机名（例如 localhost）、主机-端口对（例如 localhost:8080）或 URL（例如 https://localhost）。

警告：此列表中的主机将不会根据系统的证书存储进行验证。仅在安全的网络中使用 --allow-insecure-host，并确保来源已验证，因为它会绕过 SSL 验证，可能使你暴露于中间人攻击（MITM）的风险中。

也可以通过 UV_INSECURE_HOST 环境变量设置。

--cache-dir cache-dir

缓存目录的路径。

在 macOS 和 Linux 上默认为 $XDG_CACHE_HOME/uv 或 $HOME/.cache/uv，在 Windows 上默认为 %LOCALAPPDATA%\uv\cache。

要查看缓存目录的位置，请运行 uv cache dir。

也可以通过 UV_CACHE_DIR 环境变量设置。

--color color-choice

控制输出中颜色的使用。

默认情况下，uv 在写入终端时会自动检测是否支持颜色。

可选值：

auto: 仅在输出到支持颜色的终端或 TTY 时启用彩色输出
always: 无论检测到的环境如何，始终启用彩色输出
never: 禁用彩色输出

--config-file config-file

用于配置的 uv.toml 文件的路径。

虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许。

也可以通过 UV_CONFIG_FILE 环境变量设置。

--directory directory

在运行命令之前切换到指定目录。

相对路径将以给定目录为基准进行解析。

参见 --project 以仅更改项目根目录。

也可以通过 UV_WORKING_DIR 环境变量设置。

--help, -h

显示此命令的简明帮助

--keyring-provider keyring-provider

用于存储凭据的 keyring 提供程序。

logout 仅支持 --keyring-provider native，它通过 uv 内置的集成使用系统 keyring。

也可以通过 UV_KEYRING_PROVIDER 环境变量设置。

可选值：

disabled: 不使用 keyring 进行凭据查找
subprocess: 使用 keyring 命令进行凭据查找

--managed-python

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。

--no-cache, --no-cache-dir, -n

避免读取或写入缓存，而是在操作期间使用临时目录

也可以通过 UV_NO_CACHE 环境变量设置。

--no-config

避免发现配置文件（pyproject.toml、uv.toml）。

通常，配置文件会在当前目录、父目录或用户配置目录中被发现。

也可以通过 UV_NO_CONFIG 环境变量设置。

--no-managed-python

禁用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

相反，uv 将在系统上搜索合适的 Python 版本。

--no-progress

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

例如，旋转指示器或进度条。

--no-python-downloads

禁用 Python 的自动下载。

--offline

禁用网络访问 [env: UV_OFFLINE=]

禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。

--project project

在给定目录中发现项目。

所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。

其他命令行参数（如相对路径）将相对于当前工作目录进行解析。

参见 --directory 以完全更改工作目录。

此设置在 uv pip 接口中使用时没有效果。

也可以通过 UV_PROJECT 环境变量设置。

--quiet, -q

使用静默输出。

重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。

--system-certs

是否从平台的原生证书存储中加载 TLS 证书 [env: UV_SYSTEM_CERTS=]

默认情况下，uv 使用内置的 Mozilla 根证书，这提高了可移植性和性能（尤其是在 macOS 上）。

但是，在某些情况下，你可能希望使用平台的原生证书存储，特别是当你依赖系统证书存储中包含的企业信任根（例如，用于强制代理）时。

--username, -u username

要登出的用户名

--verbose, -v

使用详细输出。

你可以使用 RUST_LOG 环境变量配置细粒度的日志记录。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv auth token

显示服务的身份认证令牌

用法

uv auth token [OPTIONS] <SERVICE>

Arguments

SERVICE: 要查询的服务的域名或 URL

Options

--allow-insecure-host, --trusted-host allow-insecure-host

允许到主机的非安全连接。

可以多次提供。

期望接收主机名（例如 localhost）、主机-端口对（例如 localhost:8080）或 URL（例如 https://localhost）。

警告：此列表中的主机将不会根据系统的证书存储进行验证。仅在安全的网络中使用 --allow-insecure-host，并确保来源已验证，因为它会绕过 SSL 验证，可能使你暴露于中间人攻击（MITM）的风险中。

也可以通过 UV_INSECURE_HOST 环境变量设置。

--cache-dir cache-dir

缓存目录的路径。

在 macOS 和 Linux 上默认为 $XDG_CACHE_HOME/uv 或 $HOME/.cache/uv，在 Windows 上默认为 %LOCALAPPDATA%\uv\cache。

要查看缓存目录的位置，请运行 uv cache dir。

也可以通过 UV_CACHE_DIR 环境变量设置。

--color color-choice

控制输出中颜色的使用。

默认情况下，uv 在写入终端时会自动检测是否支持颜色。

可选值：

auto: 仅在输出到支持颜色的终端或 TTY 时启用彩色输出
always: 无论检测到的环境如何，始终启用彩色输出
never: 禁用彩色输出

--config-file config-file

用于配置的 uv.toml 文件的路径。

虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许。

也可以通过 UV_CONFIG_FILE 环境变量设置。

--directory directory

在运行命令之前切换到指定目录。

相对路径将以给定目录为基准进行解析。

参见 --project 以仅更改项目根目录。

也可以通过 UV_WORKING_DIR 环境变量设置。

--help, -h

显示此命令的简明帮助

--keyring-provider keyring-provider

用于读取凭据的 keyring 提供程序。

也可以通过 UV_KEYRING_PROVIDER 环境变量设置。

可选值：

disabled: 不使用 keyring 进行凭据查找
subprocess: 使用 keyring 命令进行凭据查找

--managed-python

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。

--no-cache, --no-cache-dir, -n

避免读取或写入缓存，而是在操作期间使用临时目录

也可以通过 UV_NO_CACHE 环境变量设置。

--no-config

避免发现配置文件（pyproject.toml、uv.toml）。

通常，配置文件会在当前目录、父目录或用户配置目录中被发现。

也可以通过 UV_NO_CONFIG 环境变量设置。

--no-managed-python

禁用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

相反，uv 将在系统上搜索合适的 Python 版本。

--no-progress

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

例如，旋转指示器或进度条。

--no-python-downloads

禁用 Python 的自动下载。

--offline

禁用网络访问 [env: UV_OFFLINE=]

禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。

--project project

在给定目录中发现项目。

所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。

其他命令行参数（如相对路径）将相对于当前工作目录进行解析。

参见 --directory 以完全更改工作目录。

此设置在 uv pip 接口中使用时没有效果。

也可以通过 UV_PROJECT 环境变量设置。

--quiet, -q

使用静默输出。

重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。

--system-certs

是否从平台的原生证书存储中加载 TLS 证书 [env: UV_SYSTEM_CERTS=]

默认情况下，uv 使用内置的 Mozilla 根证书，这提高了可移植性和性能（尤其是在 macOS 上）。

但是，在某些情况下，你可能希望使用平台的原生证书存储，特别是当你依赖系统证书存储中包含的企业信任根（例如，用于强制代理）时。

--username, -u username

要查询的用户名

--verbose, -v

使用详细输出。

你可以使用 RUST_LOG 环境变量配置细粒度的日志记录。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

uv auth dir

显示 uv 凭据目录的路径。

默认情况下，凭据存储在 uv 数据目录中，在 Unix 上为 $XDG_DATA_HOME/uv/credentials 或 $HOME/.local/share/uv/credentials，在 Windows 上为 %APPDATA%\uv\data\credentials。

凭据目录可以通过 $UV_CREDENTIALS_DIR 环境变量覆盖。

仅当使用明文（plaintext）后端时，凭据才会存储在此目录中；而原生（native）后端则使用系统 keyring。

用法

uv auth dir [OPTIONS] [SERVICE]

Arguments

SERVICE: 要查询的服务的域名或 URL

Options

--allow-insecure-host, --trusted-host allow-insecure-host

允许到主机的非安全连接。

可以多次提供。

期望接收主机名（例如 localhost）、主机-端口对（例如 localhost:8080）或 URL（例如 https://localhost）。

警告：此列表中的主机将不会根据系统的证书存储进行验证。仅在安全的网络中使用 --allow-insecure-host，并确保来源已验证，因为它会绕过 SSL 验证，可能使你暴露于中间人攻击（MITM）的风险中。

也可以通过 UV_INSECURE_HOST 环境变量设置。

--cache-dir cache-dir

缓存目录的路径。

在 macOS 和 Linux 上默认为 $XDG_CACHE_HOME/uv 或 $HOME/.cache/uv，在 Windows 上默认为 %LOCALAPPDATA%\uv\cache。

要查看缓存目录的位置，请运行 uv cache dir。

也可以通过 UV_CACHE_DIR 环境变量设置。

--color color-choice

控制输出中颜色的使用。

默认情况下，uv 在写入终端时会自动检测是否支持颜色。

可选值：

auto: 仅在输出到支持颜色的终端或 TTY 时启用彩色输出
always: 无论检测到的环境如何，始终启用彩色输出
never: 禁用彩色输出

--config-file config-file

用于配置的 uv.toml 文件的路径。

虽然 uv 配置可以包含在 pyproject.toml 文件中，但在此上下文中不允许。

也可以通过 UV_CONFIG_FILE 环境变量设置。

--directory directory

在运行命令之前切换到指定目录。

相对路径将以给定目录为基准进行解析。

参见 --project 以仅更改项目根目录。

也可以通过 UV_WORKING_DIR 环境变量设置。

--help, -h

显示此命令的简明帮助

--managed-python

要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]

默认情况下，uv 优先使用其管理的 Python 版本。但是，如果未安装 uv 管理的 Python，它将使用系统 Python 版本。此选项禁用系统 Python 版本的使用。

--no-cache, --no-cache-dir, -n

避免读取或写入缓存，而是在操作期间使用临时目录

也可以通过 UV_NO_CACHE 环境变量设置。

--no-config

避免发现配置文件（pyproject.toml、uv.toml）。

通常，配置文件会在当前目录、父目录或用户配置目录中被发现。

也可以通过 UV_NO_CONFIG 环境变量设置。

--no-managed-python

禁用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]

相反，uv 将在系统上搜索合适的 Python 版本。

--no-progress

隐藏所有进度输出 [env: UV_NO_PROGRESS=]

例如，旋转指示器或进度条。

--no-python-downloads

禁用 Python 的自动下载。

--offline

禁用网络访问 [env: UV_OFFLINE=]

禁用后，uv 将仅使用本地缓存的数据和本地可用的文件。

--project project

在给定目录中发现项目。

所有 pyproject.toml、uv.toml 和 .python-version 文件将通过从项目根目录向上遍历目录树来发现，项目的虚拟环境（.venv）也是如此。

其他命令行参数（如相对路径）将相对于当前工作目录进行解析。

参见 --directory 以完全更改工作目录。

此设置在 uv pip 接口中使用时没有效果。

也可以通过 UV_PROJECT 环境变量设置。

--quiet, -q

使用静默输出。

重复此选项，例如 -qq，将启用静默模式，在此模式下 uv 不会向标准输出写入任何内容。

--system-certs

是否从平台的原生证书存储中加载 TLS 证书 [env: UV_SYSTEM_CERTS=]

默认情况下，uv 使用内置的 Mozilla 根证书，这提高了可移植性和性能（尤其是在 macOS 上）。

但是，在某些情况下，你可能希望使用平台的原生证书存储，特别是当你依赖系统证书存储中包含的企业信任根（例如，用于强制代理）时。

--verbose, -v

使用详细输出。

你可以使用 RUST_LOG 环境变量配置细粒度的日志记录。 (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)