快速入门指南#

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

创建帐户#

转到 https://anaconda.cloud/sign-up。

在这里，您有以下几个帐户注册选项：

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

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

手动注册#

  1. 单击 Sign Up with Email（使用电子邮件注册）。

  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 组织访问Token并配置default_channels:在.condarc文件以使用 Anaconda 的私有存储库通道。有关更多信息，请参阅 :d oc：' 通道 <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 使用私有Token对其组织的用户进行身份验证。您必须在组织内分配一个席位才能激活Token。分配席位后，您可以随时为自己生成专用Token。

  1. 转到您组织的页面。

  2. 从左侧导航栏中选择 Token Access。

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

  4. 复制您在电子邮件中收到的私有Token，并在 Navigator 或 CLI 中进行设置：

    1. 启动 Anaconda Navigator。

    2. 选择 Connect（连接），然后登录 Anaconda Professional。

      注意

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

    3. 粘贴Token，然后单击 Set token（设置Token）。

    通过运行以下命令，将 conda 配置为使用此Token：

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

    谨慎

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

    以下是正确设置Token时终端将显示的内容的示例：

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

这.condarcfile 是一个配置文件，它告诉 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:list 优先。如果该通道包含请求的包，则从该通道下载该包。

如果请求的包不在该通道中，conda 将在channels:列表。

当 conda 到达defaults条目的channels:列表中，它会搜索default_channels:列表，按相同的降序排列。

在此示例中，对于业务层，conda 将首先在组织的渠道中查找请求的包，然后按列出的顺序在默认渠道中查找，从 https://repo.anaconda.cloud/repo/main 开始，然后是 https://repo.anaconda.cloud/repo/r，最后是 https://repo.anaconda.cloud/repo/msys2。

对于 Pro 层（旧版），conda 将按列出的顺序查看默认频道，从 https://repo.anaconda.cloud/repo/main 开始，然后是 https://repo.anaconda.cloud/repo/r，最后是 https://repo.anaconda.cloud/repo/msys2。

有关.condarc文件，请参阅 conda 官方文档。

查看您的.condarc文件#

您可以查看和编辑.condarc文件：

在 Anaconda Navigator 中，导航到菜单栏中的 Preferences，然后选择 Configure Conda。

注意

您可以编辑.condarc文件。

在终端中运行以下命令：

cat .condarc

将组织频道添加到您的.condarc文件#

注意

本部分仅适用于 Business 层。

  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. 选择 Channels，然后单击 Add...。

  2. 进入conda-forge作为您的频道。

  3. 按 Enter 键 （Windows）/Return 键 （Mac） 添加频道。

  4. 单击 Update channels 以指示导引更新channels:list 中.condarc文件。

在终端中运行以下命令：

conda config --append channels conda-forge

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

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

要连接到防火墙/代理服务器，您需要包含一个proxy_servers:部分中的.condarc包含代理服务器 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 账户

  • Python 3.10 或更高版本(base)运行环境

    在 Your 中验证 Python(base)运行环境

    检查您拥有的 Python 版本(base)打开 Anaconda Prompt（适用于 macOS/Linux 的终端）并运行以下命令：

    python --version

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

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

    conda update --name base python

    谨慎

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

安装所需的插件#

环境日志记录和扫描需要在(base)环境来扩展 conda 的功能。

通过安装anaconda-env-manager“metapackage” （包含下面列出的所有插件）。安装anaconda-env-manager，请执行以下命令。

conda install --name base anaconda-cloud::anaconda-env-manager
插件由anaconda-env-manager元包

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

  • anaconda-env-log- 每当用户执行create,install,remove,rename或updateaction with conda （还支持手动记录现有环境）。

  • 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>

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

验证您的配置#

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

  1. 转到 运行环境 在左侧导航栏中，然后选择 创建。

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

  3. 将包选择器更改为 Not installed。这将显示您的频道中提供了但尚未安装在您的计算机上的包。

  4. 如果您知道所需包的名称，则可以在搜索栏中输入该名称以查找该包。选择要下载的软件包，然后单击 Apply。

  5. 单击 Apply 以安装选定的软件包（及其依赖项）。

注意

的 Channel 列将显示您组织的渠道路径（如果配置正确）。

  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 --helpcommand 提供可用参数的列表、其函数的简要说明以及来自其他软件包的其他命令的列表。

此 conda 备忘单包含常见 conda 命令列表及其功能的简要说明和示例。

本页内容