zbanx

静态站点创建与部署工具 — 基于 snapstatic 模板，一键部署到阿里云 OSS。

安装

bun add -g zbanx         # 全局安装
bun x zbanx <command>    # 或直接运行（免安装）

快速开始

# 创建新项目
zbanx init my-site
cd my-site

# 启动开发服务器
bun dev

# 构建并部署
zbanx deploy

命令

init <project-name>

从 snapstatic 模板脚手架新项目（Vite + React + TypeScript + Tailwind v4 + coss/shadcn + @antv/infographic）。

| 选项 | 说明 | |------|------| | --overwrite | 目标目录已存在时覆盖写入 |

• 项目名：小写字母、数字、连字符（my-site）
• 支持 . 在当前目录创建

deploy

构建并部署到阿里云 OSS。

| 选项 | 说明 | |------|------| | --no-build | 跳过构建，直接上传已有 dist/ |

配置

项目根目录需 deploy.json：

{
  "oss": {
    "region": "oss-cn-hangzhou",
    "bucket": "my-bucket",
    "domain": "my-domain.com"
  },
  "build": {
    "command": "bun run build",
    "outputDir": "dist"
  }
}

及 .env（已 gitignore）：

ALIBABA_CLOUD_ACCESS_KEY_ID=your_key_id
ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_key_secret

身份认证

首次部署交互式收集账号密码，登录成功后缓存到 ~/.zbx/session.json。

# 清除缓存的登录态
rm -f ~/.zbx/session.json

常见问题

| 问题 | 原因/解决 | |------|-----------| | 部署失败 code 300001 | 密码错误或账号不存在 | | bun run build 失败 | 先 bun run lint 检查代码 | | 部署后页面刷新 404 | 确认项目使用 HashRouter（模板默认） |