快速入门指南#

本快速入门指南旨在帮助您创建 Anaconda 帐户，获取 conda 软件，并将其配置为访问您的 Anaconda 实例。

创建帐户#

访问 https://anaconda.cloud/sign-up。

从这里，您有多个帐户注册选项

  • 使用电子邮件和密码手动注册

  • 使用 GitHub、Gmail 或 Microsoft 帐户进行身份验证

手动注册#

  1. 单击使用电子邮件注册。

  2. 输入您的姓名、电子邮件地址和密码。

  3. 检查您的电子邮件以获取验证电子邮件。

  4. 单击电子邮件中的验证链接以完成帐户验证。

订阅 Anaconda#

有关管理订阅的信息和帮助，请参阅 订阅。

安装 Anaconda 软件#

安装 conda#

您可以通过安装 Anaconda Distribution 或 Miniconda 来获取 conda。如果您已经安装了 conda，请跳到 安装 Anaconda Navigator。

如果您没有安装 conda，请下载 Anaconda Distribution 或 Miniconda，并在继续之前将其安装在您的系统上。如果您不确定下载哪个，请参阅我们的 Anaconda 入门 主题以获取指导。

安装 Anaconda Navigator#

Anaconda Navigator 是一个桌面图形用户界面 (GUI)，它使用 conda 来帮助您管理环境。如果您安装了 Anaconda Distribution，您已经拥有 Anaconda Navigator，可以跳到 安装 conda-token。

如果您安装了 Miniconda，您可以通过打开 Anaconda Prompt（macOS/Linux 上的终端）并运行以下命令来安装 Anaconda Navigator

conda install anaconda-navigator

提示

如果您收到“conda:command not found”错误，请参阅此故障排除主题以解决问题。

安装 conda-token#

conda-token 工具用于验证您的 Anaconda Cloud 组织访问令牌，并在您的 .condarc 文件中配置 default_channels: 以使用 Anaconda 的私有存储库通道。有关更多信息，请参阅：doc:` 通道 <channels>`。

  1. 打开 Anaconda Prompt（macOS/Linux 上的终端）。

  2. 通过运行以下命令安装 conda-token

    conda install conda-token --channel https://repo.anaconda.cloud/repo/anaconda-tools --name base

  3. 当提示继续安装时，输入 y。

验证 Anaconda 身份#

Anaconda 使用私有令牌来验证用户对其组织的身份。您必须在组织内被分配一个席位才能激活令牌。一旦您被分配了一个席位，您可以随时为自己生成一个私有令牌。

  1. 转到您组织的页面。

  2. 从左侧导航栏中选择 令牌访问。

  3. 如果您是第一次接收令牌，请选择激活令牌，如果您要获取新令牌，请选择重新颁发令牌。一封包含私有令牌的自动电子邮件将发送到与您的 Anaconda 帐户关联的地址。

  4. 复制您在电子邮件中收到的私有令牌，并在 Navigator 或 CLI 中设置它

    1. 启动 Anaconda Navigator。

    2. 选择连接，然后选择登录到 Anaconda Professional。

      注意

      Pro（旧版）和 Business 层都共享一个精选包存储库。因此，只要您拥有正确的访问令牌，登录 Anaconda Professional 就可以让您访问所需的 Package Security Manager 通道。

    3. 粘贴令牌，然后单击设置令牌。

    通过运行以下命令配置 conda 以使用此令牌

    # Replace <TOKEN> with the token you received in your email
conda token set <TOKEN>

    小心

    每次收到新令牌时，都必须运行此命令。

    以下是正确设置令牌时终端将显示的示例

关于 .condarc 文件的重要信息#

.condarc 文件是一个配置文件，用于告知 conda 在哪里查找包。以下是您的 .condarc 文件可能的样子示例

channels:
  - https://repo.anaconda.cloud/repo/<ORG_ID>/<CHANNEL_NAME> # Business tier only
  - defaults
add_anaconda_token: true
restore_free_channel: false
default_channels:
  - https://repo.anaconda.cloud/repo/main
  - https://repo.anaconda.cloud/repo/r
  - https://repo.anaconda.cloud/repo/msys2

Conda 首先在 channels: 列表顶部列出的通道中搜索请求的包。如果该通道包含请求的包，则从该通道下载。

如果请求的包未在该通道中找到，conda 将在 channels: 列表的下一个条目中搜索该包。

当 conda 到达 channels: 列表的 defaults 条目时，它将在 default_channels: 列表下列出的通道中搜索包，顺序相同，从上到下。

在此商业层示例中，conda 将首先在您组织的通道中查找请求的包，然后将按照列出的顺序在默认通道中查找，首先是 https://repo.anaconda.cloud/repo/main，然后是 https://repo.anaconda.cloud/repo/r，最后是 https://repo.anaconda.cloud/repo/msys2。

对于专业层（旧版），conda 将按照列出的顺序在默认通道中查找，首先是 https://repo.anaconda.cloud/repo/main，然后是 https://repo.anaconda.cloud/repo/r，最后是 https://repo.anaconda.cloud/repo/msys2。

有关 .condarc 文件的更多信息，请参阅官方 conda 文档。

查看您的 .condarc 文件#

您可以在 Navigator 或 CLI 中查看和编辑 .condarc 文件

在 Anaconda Navigator 中，从菜单栏导航到偏好设置，然后选择配置 Conda。

注意

您可以从此视图直接编辑 .condarc 文件。

在终端中运行以下命令

cat .condarc

向您的 .condarc 文件添加组织通道#

注意

本节仅适用于商业层。

  1. 转到您组织的页面。

  2. 选择您的组织。

  3. 从左侧导航栏中选择通道。

  4. 选择 复制通道路径.

  5. 打开您的终端并运行以下命令

    # Replace <CHANNEL_PATH> with the copied channel path
conda config --prepend channels <CHANNEL_PATH>

添加 conda-forge 作为通道#

如果您需要从 conda-forge 存储库安装包，您可以在 Navigator 或 CLI 中执行此操作

  1. 选择通道，然后单击添加…。

  2. 输入 conda-forge 作为您的通道。

  3. 按 Enter 键 (Windows)/Return 键 (Mac) 以添加通道。

  4. 单击更新通道以指示 Navigator 更新您的 .condarc 文件中的 channels: 列表。

在终端中运行以下命令

conda config --append channels conda-forge

在防火墙或代理后方使用 Anaconda（可选）#

一些公司有安全策略，阻止其网络与 Anaconda 等外部服务器进行通信。在这些情况下，您需要连接到您公司的防火墙/代理服务器才能成功下载包。

要连接到防火墙/代理服务器，您需要在 .condarc 文件中包含一个 proxy_servers: 部分，其中包含代理服务器的 URL。此条目还必须包含用于登录代理服务器的用户名和密码。如果您没有此信息，请咨询您的 IT 管理员。

没有命令可以包含 .condarc 文件的这一部分，因此您需要手动包含以下行

小心

如果您的密码包含特殊字符，您需要使用此处描述的百分比编码对其进行转义。

# Replace <USERNAME> with the username for your proxy server
# Replace <PASSWORD> with the password for your proxy server
# Replace <URL> with the URL to your proxy server
proxy_servers:
 http: http://<USERNAME>:<PASSWORD>@<URL>:8080
 https: https://<USERNAME>:<PASSWORD>@<URL>:8443

一旦您配置了与防火墙/代理服务器的连接，您还需要与您的 IT 团队合作，以允许连接到主包存储库。主包存储库是

  • https://anaconda.org

  • https://repo.anaconda.com

  • https://repo.anaconda.cloud

在某些情况下，有必要导出 HTTP_PROXY 和 HTTPS_PROXY 环境变量以利用代理服务器。要导出您的环境变量，请打开终端并运行以下命令

# Replace <USERNAME> with the username for your proxy server
# Replace <PASSWORD> with the password for your proxy server
# Replace <URL> with the URL to your proxy server
export HTTP_PROXY=http://<USERNAME>:<PASSWORD>@<URL>:8080
export HTTPS_PROXY=https://<USERNAME>:<PASSWORD>@<URL>:8443

有关在代理服务器后方使用 conda 的更多信息，请参阅配置 conda 以在代理服务器后方使用。

启用环境管理#

管理员可以通过要求成员向组织记录其本地 conda 环境来增强组织安全性。已向组织记录的环境可以被监控、扫描，并在发现漏洞时阻止使用。有关环境日志记录、扫描和管理的更多信息，请参阅 环境。

注意

实施环境日志记录需要在组织层面进行协调。

先决条件#

环境日志记录和扫描需要以下条件

  • 一个 anaconda.cloud 帐户

  • 您的 (base) 环境中的 Python 3.10 或更高版本

    验证您的 (base) 环境中的 Python

    通过打开 Anaconda Prompt（macOS/Linux 的终端）并运行以下命令，查看您在 (base) 中拥有的 Python 版本

    python --version

    命令的输出可能类似于以下内容

    如果您需要升级 Python，请运行以下命令

    conda update --name base python

    小心

    更新 (base) 环境中的 Python 可能会影响其他已安装的包。在继续之前，请仔细查看建议的更改。

安装必需的插件#

环境日志记录和扫描需要在您的 (base) 环境中安装一些插件，以扩展 conda 的功能。

通过安装 anaconda-env-manager “元包”（其中包含以下列出的所有插件）来获取必要的插件。要安装 anaconda-env-manager，请运行以下命令

conda install --name base anaconda-cloud::anaconda-env-manager
anaconda-env-manager 元包提供的插件

以下插件扩展了您的 conda 安装的功能

  • anaconda-env-log - 每当用户使用 conda 执行 create、install、remove、rename 或 update 操作时，自动记录环境的当前状态（也支持手动记录现有环境）。

  • anaconda-activate-check - 提供检查，以根据管理员定义的安全控制验证环境，然后在激活之前通知用户警告或访问限制，并提供解决指南。

  • anaconda-audit - 允许您扫描本地环境以评估安装或更新包等操作的安全影响，以便您可以主动解决潜在问题，而无需管理员干预。当解决管理员标记的安全问题时，它也可以作为识别问题的宝贵工具。

注意

一旦您安装了 anaconda-env-manager，最好定期运行 conda update anaconda-env-manager 以保持其更新。

注册您的组织#

为确保您的环境已正确记录到 Anaconda Cloud 上的组织，您必须通过 CLI 登录并向 conda 注册您的组织。要注册您的组织

  1. 打开 Anaconda Prompt（macOS/Linux 上的终端）。

  2. 通过运行以下命令登录到 Anaconda Cloud

    anaconda login --at cloud

    系统将提示您输入用户名和密码。输入您的 Anaconda Cloud 凭据，并在打开的浏览器窗口中完成登录过程。

  3. 成功登录后，返回到命令行并通过运行以下命令注册您的组织

    # Replace <ORG_ID> with your ORG_ID (found in your organization's URL —
# https://anaconda.cloud/organizations/<ORG_ID>)
conda env-log register --organization-name <ORG_ID>

注册组织后（并且在 (base) 环境中安装了 anaconda-env-log），新创建的环境将记录到已注册的组织。

验证您的配置#

在 Navigator 或 CLI 中测试您的配置并验证 conda 是否从所需的通道下载包

  1. 转到左侧导航栏中的环境，然后选择窗口底部的创建。

  2. 输入您的环境名称，然后从下拉菜单中选择 Python 版本（首选 3.11），然后单击创建。

  3. 将包选择器更改为未安装。这将显示您可以从您的通道获得但未安装在您的计算机上的包。

  4. 如果您知道您需要的包的名称，您可以在搜索栏中输入它以找到该包。选择一个要下载的包，然后单击应用。

  5. 单击应用以安装选定的包（及其依赖项）。

注意

如果配置正确，通道列将显示您组织的通道路径。

  1. 通过运行以下命令创建环境

    # Replace <ENV_NAME> with a name for your environment
conda create --name <ENV_NAME>

  2. 通过运行以下命令验证您的环境是否创建成功

    conda env list

  3. 通过运行以下命令激活您的环境

    # Replace <ENV_NAME> with the name of your environment
conda activate <ENV_NAME>

  4. 通过运行以下命令安装包

    # Replace <PKG_NAME> with the name of the package you want to download from your channel
conda install <PKG_NAME>

  5. 如有必要，您可以通过运行以下命令删除环境

    # Replace <ENV_NAME> with the name of your environment
conda env remove --name <ENV_NAME>

其他 conda 命令

conda info 命令提供有关当前活动环境的信息（包括您的 .condarc 文件的位置）。

conda --help 命令提供可用参数列表、其功能的简要说明以及来自其他包的其他命令列表。

此conda 速查表包含常用 conda 命令列表及其功能的简要说明和示例。

在本页中