安装 Blocklet CLI

Tutorials
产品 / Blocklet Server
ArcBlock
2024-07-29 08:13
· edited
目前只能在 Linux(Ubuntu) 或 macOS 上安装和运行 Blocklet Server，Windows 平台下的用户请等待新版。
Blocklet CLI 是能够同时用来管理 Blocklet Server 和 Blocklet 的命令行工具，而 Blocklet Server 是 Blocklet 的运行环境，开发 Blocklet 时需要在本机运行 Blocklet Server。
安装 Blocklet CLI#你可以用你偏好的包管理器来安装 Blocklet CLI：
npm install -g @blocklet/cli
# yarn global add @blocklet/cli
# pnpm add -g @blocklet/cli检测是否安装成功：
blocklet -V

                 Powered By
     _             ____  _            _
    / \   _ __ ___| __ )| | ___   ___| | __
   / _ \ | '__/ __|  _ \| |/ _ \ / __| |/ /
  / ___ \| | | (__| |_) | | (_) | (__|   <
 /_/   \_\_|  \___|____/|_|\___/ \___|_|\_\

            Blocklet CLI v1.16.18

1.16.18如果提示 command not found: blocklet，需要额外配置全局环境变量 ：
# 以 yarn 为例，其它包管理工具类似

# 运行命令，查看 yarn 的全局 bin 目录。
yarn global bin

# 把这个目录添加到你的 PATH 环境变量中
open ~/.bashrc

# 在 .bashrc 中写入
export PATH="$PATH:$(yarn global bin)"

# 保存文件，重新加载你的 shell 或者重启你的终端。
source ~/.bashrc安装 Nginx#我们推荐使用 Nginx 作为 Blocklet Server 的网关
如果你无法安装 Nginx, 可以跳过此步骤，使用 Blocklet Server 的内置网关Nginx 版本: >= 1.18.0
在 Mac 上安装 (使用 Homebrew)
brew install nginx
参考: https://formulae.brew.sh/formula/nginx
在 Linux 上安装
参考: https://www.nginx.com/resources/wiki/start/topics/tutorials/install/
检测是否安装成功：
nginx -v
nginx version: nginx/1.21.6设置 DID 钱包#见 设置 DID 钱包
启动 Blocklet Server#安装 Blocklet CLI 后，您可以使用一个空目录存储配置并初始化 Blocklet Server。
运行 mkdir -p ~/blocklet-server-data && cd ~/blocklet-server-data 命令进入目录。 可以将 ~/blocklet-server-data 替换为任何其他目录
运行 blocklet server init 命令初始化 Blocklet Server
执行初始化命令后，系统将确认您要存储配置的目录。确认后，系统将自动生成您的 Blocklet Server 配置。
执行 blocklet server start 启动 Blocklet Server
输出示例% blocklet server init
blocklet server v1.16.18
Are you sure to initialize a Blocklet Server instance in the current directory(/Users/bob/blocklet-server-data) Yes
✔ Blocklet Server configuration is successfully generated /Users/bob/blocklet-server-data/.blocklet-server/config.yml
ℹ blocklet server start

% blocklet server start
blocklet server v1.16.18
✔ Server schema successfully migrated: /Users/bob/blocklet-server-data/.blocklet-server/core/server.db
✔ Service schema successfully migrated: /Users/bob/blocklet-server-data/.blocklet-server/services/service.db
✔ certificate-manager schema successfully migrated: /Users/bob/blocklet-server-data/.blocklet-server/modules/certificate-manager/module.db
ℹ Server DID zNKty6TZ9jkvTQTDQphk12B1osEbsGXHXLFC
ℹ Server config from /Users/linchen/blocklet-server-data/.blocklet-server/config.yml
✔ Starting event hub... Done in 3.044s
✔ Updating wildcard certificates... Done in 1.145s
✔ Starting blocklet service... Done in 32.657s
✔ Starting server daemon... Done in 5.084s
✔ Fetching accessible IPs... Done in 12.142s
✔ Updating DID Domain... Done in 1.232s
✔ You can access your Blocklet Server with either of the following URLs

HTTP URLs:

- http://192.168.31.18/.well-known/server/admin/
- http://bbqa7ka3ty3it3tb4prpraivmdhyr7hfooiirymz6cm.did.abtnet.io/.well-known/server/admin/

Secure URLs (Recommended):

- https://192-168-31-18.ip.abtnet.io/.well-known/server/admin/

访问 Blocklet Server#Blocklet Server 启动成功后。 您会在 terminal 中看到 Blocklet Server 的 URL
HTTP URLs:

- http://192.168.3.28/.well-known/server/admin/
- http://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.did.abtnet.io/.well-known/server/admin/

Secure URLs (Recommended):

- https://192-168-3-28.ip.abtnet.io/.well-known/server/admin/(推荐) http://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.did.abtnet.io/.well-known/server/admin/: 通过 DID Domain 访问
(推荐) https://192-168-3-28.ip.abtnet.io/.well-known/server/admin/: 通过 IP Echo Domain 访问
(不推荐) http://192.168.3.28/.well-known/server/admin/ 通过 IP 访问
注意：请将替换 192.168.3.28 为您的本地网络 IP注意：请不要使用 localhost 或 127.0.0.1 地址访问 Blocklet 服务器。 您将无法使用 DID 钱包连接它。
停止 Blocklet Server#您可以通过执行 blocklet server stop 命令来停止 blocklet 服务器。
#
Sticker