---
title: 命令行界面设置
slug: docs-ch/local-development/parse-cli
description: 了解Back4app命令行界面：CLI工具安装、配置及关键功能概览。
image: https://www.back4app.com/_public/img/back4app-og.png
createdAt: 2024-01-25T15:38:03.681Z
---

Back4app 命令行界面 (CLI) 是一个强大的工具，用于管理应用程序、部署代码和直接从终端处理云函数。本指南将引导您完成安装、配置和关键功能，以帮助您入门。

## 您可以使用 Back4app CLI 做什么

- 创建和管理 Back4app 应用程序。
- 部署云代码函数和其他本地文件。
- 管理应用程序版本和发布。
- 部署 Web 应用程序。
- 安装和管理 NPM 模块。

## 1  - 安装

### 先决条件

:::hint{type="info"}
- 一个 Back4app 账户。 [在这里注册](https://www.back4app.com).
- 您的机器上安装 Python。
:::

### 对于 macOS 和 Linux

**选项 1：通过脚本安装**

1. 打开您的终端并运行：

:::BlockQuote
curl https\://raw\.githubusercontent.com/back4app/parse-cli/back4app/installer.sh | sudo /bin/bash
:::

&#x20;   2\.  工具将安装为 `b4a` 在 `/usr/local/bin/b4a.`

**选项 2：手动安装**

1. 通过运行以下命令检查您的系统架构:

:::BlockQuote
<u>uname -pm</u>
:::

&#x20;   2\.  从 [此存储库](https://github.com/back4app/parse-cli/blob/back4app/installer.sh) 下载适合您系统的可执行文件。

&#x20;   3\.  将下载的文件移动到 `/usr/local/bin/`:

:::BlockQuote
mv \<downloaded\_file> /usr/local/bin/b4a
chmod 755 /usr/local/bin/b4a
:::

&#x20;   4\.  CLI 现在可以使用了。

### 对于 Windows

- 从 [b4a.exe](https://github.com/back4app/parse-cli/releases/download/release_3.3.1/b4a.exe) 文件下载 [发布页面](https://github.com/back4app/parse-cli/releases).
- 将文件移动到 `C:\Windows\System32` 以使其可全局访问。2 - 配置

### 将 CLI 连接到您的 Back4app 账户

1. 登录到您的 Back4app 账户。
2. 生成一个账户密钥:
   - 将鼠标悬停在 "Hello, \[username]" 菜单上。
   - 转到 **账户密钥** 并创建一个新密钥。

![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/Vtf9h_neBfwWz0MOTYGb8_screenshot-2024-11-28-at-164118.png)

&#x20;   3\.  在 CLI 中配置密钥:

:::BlockQuote
b4a 配置账户密钥
:::

在提示时粘贴您的账户密钥。

:::hint{type="danger"}
此命令仅在您在特定计算机上进行此设置的 **第一次&#x20;**&#x65F6;有效。否则，请运行 <font color="#2166ae">`b4a configure accountkey -d`</font> 以用新密钥覆盖旧密钥。
:::

您使用的账户密钥存储在 <font color="#2166ae">`${HOME}/.back4app/netrc`</font> 适用于 Mac 和 Linux。

## 3 - 使用

### 创建新应用

1. 打开终端并运行: `b4a new`
2. 选择 "(n)ew" 来创建新应用。
3. 按照提示为您的应用命名并进行设置。

### 部署云函数

1. 创建您的本地云代码文件，例如， `main.js`:

```javascript
Parse.Cloud.define("hello", (request) => {
  return "Hello, world!";
});
```

&#x20;   2\.  部署代码:

:::BlockQuote
b4a 部署
:::

CLI将上传您的 `cloud` 和 `public` 文件夹到Back4app。

### 其他有用的命令

| 命令           | 描述               |
| ------------ | ---------------- |
| b4a list     | 列出所有连接到您帐户的应用程序。 |
| b4a deploy   | 部署云代码和托管文件。      |
| b4a releases | 获取应用程序的版本。       |
| b4a rollback | 回滚给定应用程序的版本。     |

运行 `b4a help` 以获取完整的命令列表。

## 4 - 故障排除

### 常见问题

- **权限错误**: 使用 `sudo` 进行Linux/Mac安装，或确保Windows可执行文件在正确的目录中。
- **连接问题**: 通过重新运行 `b4a configure accountkey` 来验证您的帐户密钥配置。
- **部署错误**: 检查 `.parse.local` 和 `.parse.project` 文件以确保配置正确。

## 5 - 下一步

- 通过编写自定义函数来实验云代码。
- 探索 [本地Parse服务器环境](https://www.back4app.com/docs/local-development/parse-server-local) 以进行离线开发。

## 结论

使用Back4app CLI，您可以高效地管理您的应用程序，部署更新，并利用强大的云代码功能。请遵循本指南以开始并探索Back4app CLI工具的全部潜力。
