forked from xhgit/webup-cloud
109 lines
7.9 KiB
Markdown
109 lines
7.9 KiB
Markdown
# WebUp Cloud · WebUp 云
|
||
|
||
WebUp Cloud — AI 网站开发与云托管平台
|
||
[](http://git.xhmcl.com/xhgit/webup-cloud/activity/contributors)
|
||
|
||
本项目公开源码,商用须取得广州广务商务有限公司的付费授权。Bug 修复贡献及其他使用范围见 [源码可见专有许可协议](LICENSE.md)。
|
||
|
||
让创意轻松上线。从开发到部署,一站式上线。官网目标域名 `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/),独立后台登录 [http://127.0.0.1:5173/admin/login](http://127.0.0.1:5173/admin/login)。预览控制面使用独立 H2 文件库和本地临时存储。账号保存在忽略提交的 `.runtime/preview-account.json`;预览账号不会在重启时重置。AI Worker 已通过本地私有配置启用,使用专用 WSL2 / K3s / gVisor 网关;任务实际调用已配置供应商并执行隔离工具。测试余额不抵扣供应商 API 的真实费用。托管发布和域名 Worker 仍关闭,部署和复验见 [本机部署](docs/LOCAL-DEVELOPMENT.md)。
|
||
|
||
若显示“拒绝连接”,先检查 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 集群的运行方式见 [本机部署](docs/LOCAL-DEVELOPMENT.md),无需 Docker Desktop。
|
||
|
||
1. 复制 `.env.example` 为 `.env`。
|
||
2. 为数据库、Redis、MinIO 和初始管理员分别设置独立随机密码,替换全部 `CHANGE_ME`。管理员密码至少 12 字节且包含字母与数字;上限 72 字节。
|
||
3. 设置真实的 `BOOTSTRAP_ADMIN_EMAIL`。
|
||
4. 在项目根目录执行:
|
||
|
||
```powershell
|
||
.\scripts\start.ps1
|
||
```
|
||
|
||
打开 [本地控制台](http://localhost:8088)。管理员通过环境变量在无超级管理员的数据库中初始化;不会将已注册的普通用户自动提升为管理员。初始化完成后从 `.env` 移除 `BOOTSTRAP_ADMIN_PASSWORD`,重新创建后端容器。
|
||
|
||
```powershell
|
||
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 自动读取。
|
||
|
||
```powershell
|
||
cd backend
|
||
./mvnw.cmd verify
|
||
./mvnw.cmd spring-boot:run
|
||
```
|
||
|
||
```powershell
|
||
cd frontend
|
||
npm ci
|
||
npm run dev
|
||
```
|
||
|
||
开发前端地址是 [http://127.0.0.1:5173](http://127.0.0.1:5173),Vite 会代理 `/api` 到后端。仅启动前端时,登录页面会明确显示后端未就绪,不能登录。
|
||
|
||
## 测试
|
||
|
||
```powershell
|
||
cd backend
|
||
./mvnw.cmd verify
|
||
```
|
||
|
||
```powershell
|
||
cd frontend
|
||
npm run build
|
||
```
|
||
|
||
后端快速测试使用 H2 PostgreSQL 兼容模式及 Mock 的短期存储,**不能替代真实 PostgreSQL、Redis 和 Docker 验收**。详见 [测试报告](docs/TEST-REPORT.md)。
|
||
|
||
## 文档
|
||
|
||
- [架构、数据设计与八阶段计划](docs/ARCHITECTURE.md)
|
||
- [当前 API 文档](docs/API.md)
|
||
- [模型、钱包、Agent 与隔离网关部署](docs/AI-DEVELOPMENT.md)
|
||
- [AI 队列、付费优先与执行端接入](docs/QUEUE.md)
|
||
- [自动核算、源码检查与管理员 AI 报告](docs/AUTOMATIC-REPORTS.md)
|
||
- [独立 AI 代码验收、隔离构建与报告权限](docs/CODE-REVIEWS.md)
|
||
- [本机 WSL2 / K3s / gVisor 实际部署与复验](docs/LOCAL-DEVELOPMENT.md)
|
||
- [域名与 HTTPS 接入及验证边界](docs/DOMAINS.md)
|
||
- [操作与安全说明](docs/OPERATIONS.md)
|
||
- [私有化商业版方案](docs/SELF-HOSTED-EDITION.md)
|
||
- [插件与主题开发文档](frontend/public/extension-development.md)
|
||
- [实施状态与测试边界](docs/TEST-REPORT.md)
|
||
|
||
## 参考的开源项目
|
||
|
||
- [Anthropic Claude Quickstarts](https://github.com/anthropics/claude-quickstarts/tree/4a4224bdf0e9cfb3332167b69c90457403813625)(MIT)。移植了 [Computer Use 示例](https://github.com/anthropics/claude-quickstarts/blob/4a4224bdf0e9cfb3332167b69c90457403813625/computer-use-demo/computer_use_demo/loop.py) 中同批工具遇错跳过和返回失败结果的逻辑,并适配 WebUp Cloud 的 Java Worker。原始版权和许可保存在 [第三方许可文件](backend/src/main/resources/META-INF/anthropic-claude-quickstarts-LICENSE.txt)。
|