fan-webssh-build

编译产物

补充说明

fan-webssh 项目本身使用 yarn workspace 组织（前端 web/ Vue + Vite，后端 server/ Node.js Koa）。发布版本通过 GitHub Actions 流水线编译：GitHub push v* 标签或手动触发（workflow_dispatch）即可全自动构建多架构二进制与 Docker 镜像。

发布流水线（release.yml）四个阶段

手动编译二进制

# 安装依赖并构建前端
cd web && yarn install --non-interactive && yarn build && cd ..

# 将前端产物内置到 pkg 可查找路径（standalone.js 从 server/app/static 加载）
mkdir -p server/app/static && cp -r web/dist/. server/app/static/

# 用 yao-pkg 编译（node18 target）
npm i -g @yao-pkg/pkg
pkg -t node18-linux-x64 server/standalone.js -o fan-webssh_linux_amd64
pkg -t node18-linux-arm64 server/standalone.js -o fan-webssh_linux_arm64
ls -lh fan-webssh_linux_amd64 fan-webssh_linux_arm64

本地开发

# 安装依赖
yarn install

# 启动开发模式（前后端 concurrently 同时运行）
yarn dev

# 清理依赖
yarn clean

触发发布

# 方式一：打 v 标签推送到 GitHub（自动触发流水线）
git tag v1.0.7 && git push origin v1.0.7

# 方式二：GitHub Actions 手动触发（输入 tag 参数，如 v1.0.4）
# 仓库 → Actions → Release Pipeline → Run workflow

注意事项

• 前端构建需要 Node.js 20（setup-node 固定版本），本地可任意 LTS
• pkg 编译目标为 node18，跨架构需要对应平台或使用流水线（GitHub Actions ubuntu-latest 支持交叉编译 arm64）
• 二进制内置前端静态资源，运行时不依赖 web/dist，可与 systemd 脚本安装方式配合使用
• Docker 镜像为 multi-arch（linux/amd64, linux/arm64），通过 buildx 构建
• 发布标签格式必须为 vX.Y.Z（正则 ^v[0-9]+\.[0-9]+\.[0-9]+.*$），流水线会校验
• Docker Hub 镜像需配置 DOCKERHUB_USERNAME / DOCKERHUB_TOKEN secrets
• CNB 同步可选，未配置 CNB_ACCESS_TOKEN 时自动跳过
• package.json 中版本通过手动更新，建议发版时同步修改

相关命令

• fan-webssh-build 👈 当前所在位置
• fan-webssh
• fan-webssh_backup
• fan-webssh_recover
• dc_inst_fan-webssh