MBE 系统访问信息

更新日期:2026-01-27
版本:v1.1(新增开发版远程访问)


1. 生产版 (Production)

访问地址

应用 URL 说明
MBE 后端/管理 https://mbe.hi-maker.com 主后端服务
PWA 前端 https://app.hi-maker.com 移动端 PWA 应用
管理员登录 https://mbe.hi-maker.com/admin/login 管理后台入口
用户登录 https://mbe.hi-maker.com/ui/login 普通用户登录
开发者门户 https://mbe.hi-maker.com/developer/ 开发者中心

账户凭据

角色 邮箱 密码
超级管理员 admin@mbe-test.com Test@123456
运营员 operator@mbe-test.com Test@123456
开发者 developer1@mbe-test.com Test@123456
企业用户 enterprise1@mbe-test.com Test@123456
普通用户 user1@mbe-test.com Test@123456

2. 开发版 (Development - 团队协作)

远程访问地址(团队协作)✅ 已验证可用

应用 URL 状态
MBE 后端/管理 https://dev.hi-maker.com ✅ 可访问
PWA 前端 https://dev-app.hi-maker.com ✅ 可访问
管理员登录 https://dev.hi-maker.com/admin/login ✅ 可访问
用户登录 https://dev.hi-maker.com/ui/login ✅ 可访问
开发者门户 https://dev.hi-maker.com/developer/ ✅ 可访问

💡 团队成员无需 VPN,可直接通过以上地址远程访问系统进行开发测试。

本地访问地址

应用 URL 说明
MBE 后端/管理 http://localhost:8000 本地后端服务
PWA 前端 http://localhost:3000 本地 PWA 开发
管理员登录 http://localhost:8000/admin/login 本地管理后台
用户登录 http://localhost:8000/ui/login 本地用户登录

账户凭据

与生产版相同。

开发版与生产版的关系

项目 说明
数据 共享同一个数据库(注意:开发测试会影响生产数据)
服务 共享同一套 API 和 PWA 服务
隔离性 如需完全独立环境,使用 docker-compose.dev.yml

3. 功能入口

管理员功能

功能 路径 说明
管理后台首页 /admin/ 系统概览仪表板
用户管理 /admin/users 用户列表和管理
工单管理 /admin/tickets 用户支持工单系统
运营大屏 /admin/dashboard-screen 可视化数据大屏
报表生成 /admin/reports 数据报表生成和导出
开发者申请审核 /admin/developer-applications 审核开发者申请
知识库管理 /admin/knowledge/ 知识库管理
终端连接 /admin/terminals/ 查看终端连接状态
计费管理 /admin/billing 账单和支付管理

用户功能

功能 路径 说明
用户仪表板 /user/dashboard 用户个人中心
专家市场 /user/market 浏览和购买专家
帮助中心 /user/support 提交工单和 FAQ
申请成为开发者 /user/apply-developer 提交开发者申请
设备管理 /user/devices 绑定和管理设备
订阅管理 /user/subscription 查看订阅状态
使用统计 /user/usage 查看使用记录
账单充值 /ui/billing 充值和账单

开发者功能

功能 路径 说明
开发者中心 /developer/ 开发者控制台
创建专家 /developer/experts/create 创建新专家
专家管理 /developer/experts 管理已创建专家
知识库管理 /developer/knowledge 管理知识库
训练模型 /developer/training 模型训练入口
收益统计 /developer/earnings 查看收益数据

4. API 接口

认证相关

接口 方法 说明
/api/v1/users/login POST 用户登录
/api/v1/users/register POST 用户注册
/api/v1/users/me GET 获取当前用户信息

专家相关

接口 方法 说明
/api/experts/available GET 获取可用专家列表
/api/experts/{id}/purchase POST 购买专家
/api/experts/user/{id}/purchases GET 获取购买记录

工单相关

接口 方法 说明
/api/v1/users/tickets GET 获取我的工单
/api/v1/users/tickets POST 创建工单
/api/v1/users/tickets/{id} GET 获取工单详情
/api/v1/users/tickets/{id}/reply POST 回复工单

5. Docker 服务

生产版容器

容器名 端口 说明
mbe-api 8000 主 API 服务
mbe-pwa 3000 → 80 PWA 前端
mbe-postgres 5432 PostgreSQL 数据库
mbe-redis 6379 Redis 缓存
mbe-tunnel - 生产版 Cloudflare Tunnel
mbe-tunnel-dev - 开发版 Cloudflare Tunnel (团队协作)

常用命令

# 启动所有服务
docker-compose -f docker-compose.prod.yml up -d

# 查看服务状态
docker ps

# 查看 API 日志
docker logs mbe-api --tail 50

# 重启 Tunnel
docker restart mbe-tunnel

# 重建并启动 API
docker-compose -f docker-compose.prod.yml up -d --build mbe-api

6. Cloudflare Tunnel 配置

生产版 Tunnel (mbe-tunnel)

域名 服务
mbe.hi-maker.com http://mbe-api:8000
app.hi-maker.com http://mbe-pwa:80

开发版 Tunnel (mbe-tunnel-dev) - 团队协作

域名 服务
dev.hi-maker.com http://mbe-api:8000
dev-app.hi-maker.com http://mbe-pwa:80

注意:开发版 Tunnel 目前连接到生产网络 (mbe-network),共享同一套服务。 如需独立开发环境,请使用 docker-compose.dev.yml 启动单独的服务。

故障排查

如果出现 502 错误:

  1. 检查容器状态:docker ps
  2. 确保 Tunnel 容器在 mbe-network 网络中
  3. 重启 Tunnel:
    • 生产版:docker restart mbe-tunnel
    • 开发版:docker restart mbe-tunnel-dev
  4. 检查 Tunnel 日志:docker logs mbe-tunnel --tail 20

7. 快速访问对比

环境 后端 API PWA 前端 用途
生产版 https://mbe.hi-maker.com https://app.hi-maker.com 正式用户使用
开发版 https://dev.hi-maker.com https://dev-app.hi-maker.com 团队开发测试
本地 http://localhost:8000 http://localhost:3000 本地开发调试

8. 团队协作流程

新成员加入

  1. 分享本文档给新成员
  2. 使用开发版地址 https://dev.hi-maker.com 访问系统
  3. 使用测试账户登录(见上方凭据表)

开发测试流程

  1. 代码修改后提交到 Git
  2. 服务器拉取代码并重启服务
  3. 通过 https://dev.hi-maker.com 验证功能

独立开发环境(可选)

如需完全独立的开发环境,执行:

# 启动独立的开发环境(独立数据库)
docker-compose -f docker-compose.dev.yml up -d

# 启动开发环境 + Tunnel(远程访问)
docker-compose -f docker-compose.dev.yml --profile with-tunnel up -d

9. 安全提醒

⚠️ 重要

  1. 生产环境应创建独立的管理员账户
  2. 修改默认密码 Test@123456
  3. 定期备份数据库
  4. 启用 HTTPS(已通过 Cloudflare 实现)
  5. 开发版地址仅供内部团队使用,不要公开分享

最后更新:2026-01-27