Reviewed-on: http://git.xhmcl.com/xhgit/webup-cloud/pulls/2
WebUp Cloud · WebUp 云
本项目公开源码,商用须取得广州广务商务有限公司的付费授权。Bug 修复贡献及其他使用范围见 源码可见专有许可协议。
让创意轻松上线。从开发到部署,一站式上线。官网目标域名 webup.run,项目目标域名 {项目名}.webup.run。这是持续开发中的完整平台工程,目前已实现下列模块;原始需求的全部功能尚未交付。本机真实隔离集群、模型调用与 PostgreSQL / Redis 已开始联调,公网及其他外部服务另行验收。
已实现真实 API、Flyway 数据结构和权限检查的功能:
- 注册 / 登录 / 退出;服务器 PNG 验证码,3 分钟到期、成功或失败均一次性消费;Redis 原子限流。
- BCrypt 密码、数据库持久化会话、令牌摘要存储、设备撤销、登录记录、修改密码后全部下线。
- 管理员 RBAC 基础、用户搜索分页、启停用户、强制下线、配置编辑及事务审计。
- 动态平台名称 / Logo / 域名配置 / 备案 / 公告 / 页脚;注册开关。
- 项目需求的创建、编辑、查询、归档和所有者隔离。归档保留数据。
- Vue 控制台、管理路由隔离、深色模式、响应式布局、空状态和 API 错误提示。
- 支持工单、项目关联、双向回复、未读状态、客服队列、分派与优先级、内部备注和状态审计。
- 自制插件与主题 ZIP 上传,支持启停、版本切换、独立插件工具页和浅色 / 深色配色。
已新增:供应商密钥加密与连接测试、OpenAI / Anthropic / Gemini 协议、模型价格版本、事务钱包账本与预留、Agent 任务队列和 Worker、暂停 / 继续 / 取消 / 异常核对,以及 Kubernetes 隔离网关中的文件 / 终端 / Git 版本 / 源码 ZIP。本机真实模型调用和隔离工具已联通,完整网站生成交付尚未验收。
新增模块:公开产品首页、独立管理后台、实际运营统计与表格、国内外供应商模板(含 MiMo / DeepSeek / Kimi / 第三方兼容接口)、托管套餐购买与快照、服务配置和 Kubernetes 发布 / 回滚 / 日志 / 重启、集成配置(SMTP / SMS / CDN / ESA / DNS / S3)、节点信息、网站审核与封禁任务,以及项目对象存储上传 / 私有下载 / 用量 / 回收站 / 上传结果核对。平台和托管页脚分别配置,品牌 Logo 已生成。
新增项目域名与 HTTPS 模块:平台稳定域名、自定义 TXT 验证、主域名、Ingress / DNS / cert-manager 配置队列、阶段核对、解绑与管理审计。新增 AI 调度:健康心跳、全局并发、单 Worker 并行、人工调序 / 下一位、付费优先及首次执行前取消的自动退费;无可用执行端不再接受新的预算预留。
待开发功能包括在线支付与回调、用户数据库与持久卷、实际镜像构建流水线、ESA 边缘站点 / 回源 / 缓存自动化、自动故障迁移、邮件短信身份验证和密码找回等。已提供适配器或配置页面不代表已完成真实外部服务联调。 具体测试边界见测试报告。
当前开发预览
首页 http://127.0.0.1:5173/,独立后台登录 http://127.0.0.1:5173/admin/login。预览控制面使用独立 H2 文件库和本地临时存储。账号保存在忽略提交的 .runtime/preview-account.json;预览账号不会在重启时重置。AI Worker 已通过本地私有配置启用,使用专用 WSL2 / K3s / gVisor 网关;任务实际调用已配置供应商并执行隔离工具。测试余额不抵扣供应商 API 的真实费用。托管发布和域名 Worker 仍关闭,部署和复验见 本机部署。
若显示“拒绝连接”,先检查 5173 / 8080 的监听进程。前端在 frontend 目录执行 npm run dev 并保持进程运行;Vite 固定监听 127.0.0.1:5173,端口占用时直接报错,避免链接悄悄变为 5174。后端预览通过测试类 PreviewApplication 和 .runtime/preview-java.args 启动;此启动类不打包进正式生产 JAR。后台常驻预览启动脚本曾被本地自动审批策略拦截,当前没有启用自动重启,不能宣称已有进程保活保障。
本地运行
以下 Compose 方案需要可用的 Linux Docker Engine 和 Docker Compose v2。当前 Windows 开发预览与专用 WSL2 集群的运行方式见 本机部署,无需 Docker Desktop。
- 复制
.env.example为.env。 - 为数据库、Redis、MinIO 和初始管理员分别设置独立随机密码,替换全部
CHANGE_ME。管理员密码至少 12 字节且包含字母与数字;上限 72 字节。 - 设置真实的
BOOTSTRAP_ADMIN_EMAIL。 - 在项目根目录执行:
.\scripts\start.ps1
打开 本地控制台。管理员通过环境变量在无超级管理员的数据库中初始化;不会将已注册的普通用户自动提升为管理员。初始化完成后从 .env 移除 BOOTSTRAP_ADMIN_PASSWORD,重新创建后端容器。
docker compose up -d --force-recreate backend
docker compose logs -f backend
数据库迁移在后端启动时自动执行。不要修改已应用迁移;按已有最大版本新增迁移。不要在真实生产库直接运行测试或清空表。
本地端口:前端 8088、后端 8080、PostgreSQL 5432、Redis 6379、MinIO 9000 / 控制台 9001,全部绑定回环地址。当前 Compose 是开发配置,不能直接作为公网生产部署方案。
分别启动前后端
后端需要 Java 21、Maven 3.9+ 和已启动的 PostgreSQL / Redis。将 .env.example 对应变量导入当前进程,另外设置 DATABASE_URL=jdbc:postgresql://localhost:5432/platform、REDIS_HOST=localhost。.env 不会被 Spring Boot 自动读取。
cd backend
./mvnw.cmd verify
./mvnw.cmd spring-boot:run
cd frontend
npm ci
npm run dev
开发前端地址是 http://127.0.0.1:5173,Vite 会代理 /api 到后端。仅启动前端时,登录页面会明确显示后端未就绪,不能登录。
测试
cd backend
./mvnw.cmd verify
cd frontend
npm run build
后端快速测试使用 H2 PostgreSQL 兼容模式及 Mock 的短期存储,不能替代真实 PostgreSQL、Redis 和 Docker 验收。详见 测试报告。
文档
- 架构、数据设计与八阶段计划
- 当前 API 文档
- 模型、钱包、Agent 与隔离网关部署
- AI 队列、付费优先与执行端接入
- 自动核算、源码检查与管理员 AI 报告
- 独立 AI 代码验收、隔离构建与报告权限
- 本机 WSL2 / K3s / gVisor 实际部署与复验
- 域名与 HTTPS 接入及验证边界
- 操作与安全说明
- 私有化商业版方案
- 插件与主题开发文档
- 实施状态与测试边界
原始需求保存在 docs/REQUIREMENTS.md,后续按八阶段计划持续实现与验收。