托管静态页面。

create #

创建 Pages 实例。

npx nest pages create --name <name> --assets <assets_dir> --deploy --description <description> --project <project_name>

参数说明 #

• <name>：string，required
  • 新 Pages 实例的名称。
• <assets_dir>：string，optional
  • 指定静态站资源所在目录，默认以目录中的 index.html 作为入口文件。
• --deploy：boolean，optional
  • 创建后直接部署。
• <description>：string，optional
  • Pages 实例的描述。
• <project_name>：string，optional
  • 项目名称，默认为 default。

示例 #

# 创建一个新的 pages 并直接部署
npx nest pages create --name demo6 --assets ./site --deploy

==> New Pages demo6 created!
==> [info]: Compressing given assets directory ./site...✓
==> [info]: Uploading assets...✓
==> [info]: Deploying pages...✓
==> Pages demo6 is publishing, you can visit it by open http://pywahntknjrhcufp.test.example.com in browser a few minutes later

list #

列出 Pages 实例。

nest pages list --project <project_name>

参数说明 #

• <project_name>：string，optional
  • 项目名称，默认为 default。

示例 #

# 列出默认项目下的 Pages 实例
nest pages list

+--------------------+------------+---------+--------------------+---------+---------------------+-------+
|         ID         |    NAME    | STATUS  |     ASSETS ID      | PROJECT |     CREATE TIME     | EXTRA |
+--------------------+------------+---------+--------------------+---------+---------------------+-------+
| p-2e9j6isfloatfq8r | test-pages | online  | a-22q8vxmsmq6huyr4 | default | 2025-11-11 20:47:16 |       |
| p-2e9hpae39m2sqksy | demo2      | offline | <empty>            | default | 2025-11-19 15:20:57 |       |
| p-2e9ix41fyuj0guxi | demo3      | online  | a-22qaeh86rktz2r17 | default | 2025-11-19 15:22:55 |       |
| p-2e9jgxyrbet8d5bs | demo4      | online  | a-22qarhkxbsi5flnp | default | 2025-11-19 16:00:21 |       |
+--------------------+------------+---------+--------------------+---------+---------------------+-------+

update #

更新 Pages 实例的描述信息。

nest pages update -p <pages_id> --description <description>

参数说明 #

• <pages_id>：string，required
  • Pages 实例 ID。
• <description>：string，optional
  • Pages 实例的描述信息。

示例 #

# 更新 Pages 实例的描述信息
nest pages update -p p-2e9j6isfloatfq8r --description 'some description'

==> [info]: Updating pages p-2e9h57apwag1rlez?✓

offline #

将 Pages 实例下线。

nest pages offline -p <pages_id>

参数说明 #

• <pages_id>：string，required
  • Pages 实例 ID。

示例 #

# 将指定 Pages 实例下线
nest pages offline -p p-2e9j6isfloatfq8r

命令行会提示您选择是否下线该 Pages 实例。

? The website will no longer be accessible after offlined, confirm to offline pages p-2e9jgxyrbet8d5bs?:
▸ No
  Yes

如果您选择 Yes，该 Pages 实例会被下线。

==> [info]: Offlining pages p-2e9jgxyrbet8d5bs...✓
==> Pages p-2e9jgxyrbet8d5bs was offlined, website will be inaccessible after a few minutes.

delete #

删除 Pages 实例。

nest pages delete -p <pages_id>

参数说明 #

• <pages_id>：string，required
  • Pages 实例 ID。

示例 #

# 删除指定 Pages 实例
nest pages delete -p p-2e9j6isfloatfq8r

命令行会提示您选择是否删除该 Pages 实例。

? Confirm to delete pages p-2e9jgxyrbet8d5bs?:
▸ No
  Yes

如果您选择 Yes，该 Pages 实例会被删除。

==> [info]: Deleting pages p-2e9jgxyrbet8d5bs...✓
==> Pages p-2e9jgxyrbet8d5bs was deleted.

list assets #

列出 Pages 实例下的资源。

nest pages list assets -p <pages_id>

参数说明 #

• <pages_id>：string，required
  • Pages 实例 ID。

示例 #

# 列出指定 Pages 实例下的资源
nest pages list assets -p p-2e9ix41fyuj0guxi

+--------------------+--------+---------------------+
|         ID         | STATUS |     CREATE TIME     |
+--------------------+--------+---------------------+
| p-2e9j6isfloatfq8r | online | 2025-11-19 15:23:02 |
+--------------------+--------+---------------------+

upload #

上传资源到 Pages 实例。

nest pages upload -p <pages_id> <assets_dir>

参数说明 #

• <pages_id>：string，required
  • Pages 实例 ID。
• <assets_dir>：string，required
  • 本地资源目录。

示例 #

# 上传本地资源到指定 Pages 实例
nest pages upload -p p-2e9ix41fyuj0guxi ./site

==> [info]: Compressing given assets directory ./site...✓
==> [info]: Uploading assets...✓

deploy #

部署 Pages 实例资源。

nest pages deploy -p <pages_id> <assets_dir>
nest pages deploy -p <pages_id> --assets <assets_id>
nest pages deploy --assets <assets_id>

参数说明 #

• <pages_id>：string，required（当指定本地目录或未指定 --assets 时）
  • Pages 实例 ID。
• <assets_dir>：string，optional
  • 本地资源目录。若指定此参数，命令将先上传资源再部署。
• <assets_id>：string，optional
  • 已上传的资源 ID。

示例 #

使用最新上传的资源部署 Pages 实例

nest pages deploy -p p-2e9j6isfloatfq8r

==> [info]: Deploying pages...✓
==> Pages demo3 is publishing, you can visit it by open http://rdadlxrraxcrgjix.test.example.com in browser a few minutes later

指定资源 ID 部署 Pages 实例

nest pages deploy --assets a-22q986yxgsf1wxhd

nest pages deploy --assets a-22qaeh86rktz2r17   
==> [info]: Deploying assets...✓
==> Assets a-22qaeh86rktz2r17 of Pages demo3 published, preview it by visiting http://rdadlxrraxcrgjix.test.example.com

上传本地资源并部署

nest pages deploy -p p-2e9j6isfloatfq8r ./site

==> [info]: Compressing given assets directory ./site...✓
==> [info]: Uploading assets...✓
==> [info]: Deploying pages...✓
==> Pages demo3 is publishing, you can visit it by open http://rdadlxrraxcrgjix.test.example.com in browser a few minutes later

delete assets #

删除 Pages 实例资源。

nest pages delete assets --assets <assets_id>

参数说明 #

• <assets_id>：string，required
  • 资源 ID。

示例 #

# 删除指定资源
nest pages delete assets --assets a-22q8ee0a63vsbmqa

如果您确认要删除该资源，请选择 Yes。

? Confirm to delete assets ssets?:
▸ No
  Yes

如果您选择 Yes，该资源会被删除。

==> [info]: Deleting assets a-22q8ee0a63vsbmqa...✓
==> Assets a-22q8ee0a63vsbmqa was deleted.

serve #

本地预览 Pages 实例。

nest pages serve --addr <address> <assets_dir>

参数说明 #

• <address>：string，optional
  • 本地预览服务器地址，格式为 ip:port。默认为 :8080。
• <assets_dir>：string，required
  • 本地资源目录。

示例 #

# 在指定地址预览本地资源
nest pages serve --addr :8999 ./site

==> Starting static server on addr :8999 for serving ./site ...