更新记录

1.1.0（2026-09-03）

版本新增

平台兼容性

云端兼容性

阿里云 腾讯云 支付宝云
√ √ √

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

星遇社交部署、发布与效果预览

本文是模板唯一的用户部署与发布说明，包含移动端 uniCloud 部署、独立云空间管理端、插件市场资料、购买者须知以及全部产品展示图。

1. 插件市场基本信息

  • 建议名称：星遇社交 App · uni-app + uniCloud 云端一体模板
  • 建议分类：uniCloud / 云端一体页面模板
  • 建议版本：1.1.0
  • 技术栈：Vue 3、TypeScript、uni-app、uniCloud 云对象、Vue 3 + Element Plus 管理端
  • 平台：Android、iOS、H5、微信/支付宝/百度/抖音/QQ 等 uni-app 支持的小程序端（OAuth、支付、推送以各平台实际配置为准）

    演示APP二维码

演示APP二维码

发布简介

完整社交应用客户端、独立云空间运营管理端与 uniCloud 安全网关模板，包含推荐、附近、动态、评论、关注、访客、通知、私聊、图片和语音、会员订单、支付、举报认证及账号安全。管理端覆盖用户、内容、聊天媒体、风控、交易、集成配置、管理员权限和审计。提供阿里云与腾讯云目录，保留实时 WebSocket，并带插件包自动检查脚本。

2. 准备业务服务

移动端云对象会自动拼接 /api/v1，管理端云函数会自动拼接 /admin/v1。如改用自己的星遇 API，服务必须与模板接口契约匹配、启用有效 HTTPS 证书，并且配置的根地址不能携带接口路径。

需要开放：

  • HTTPS /api/v1/*：登录、内容、社交、IM、会员等移动端业务接口。
  • HTTPS /admin/v1/*：运营管理接口。
  • WSS /ws：即时消息长连接。
  • HTTPS /healthz：云对象健康检查。

3. 关联 uniCloud 服务空间

将插件导入购买者现有的 Vue 3 uni-app 项目，在宿主项目自己的 manifest.json 中填写 DCloud AppID，然后关联阿里云或腾讯云服务空间。插件发布包本身不包含 manifest.json。只部署与实际服务商相符的目录：

  • 阿里云：uniCloud-aliyun
  • 腾讯云：uniCloud-tcb

两个目录的云端源码保持一致，目的是让购买者可以任选服务商，并非要求同时部署两份。

4. 部署移动端云对象

编辑对应云厂商目录下：

cloudfunctions/xingyu-social-gateway/config.js

backendOrigin 默认是 https://xim.bchongw.com；如使用自己的接口再替换它。如果服务空间的临时文件使用自定义存储域名，还要把该域名后缀加入 stagingHostSuffixes 白名单。

在 HBuilderX 中右键 xingyu-social-gateway，选择上传部署并让云端安装 form-data 依赖。该云对象无需开启 URL 化，客户端通过 uniCloud.importObject 调用。

5. 配置和运行移动端

模板已经内置以下默认地址，使用默认服务时无需创建环境文件：

VITE_SERVICE_MODE=unicloud
VITE_CLOUD_OBJECT=xingyu-social-gateway
VITE_API_ORIGIN=https://xim.bchongw.com
VITE_WS_ORIGIN=wss://xim.bchongw.com
VITE_APP_SOCKET_ORIGIN=https://xim.bchongw.com

需要切换服务时，从 .env.example 复制对应环境文件并覆盖。VITE_API_ORIGIN 用于错误提示、OAuth/支付跳转辅助及 REST 调试模式；JSON 请求在 unicloud 模式下不会直接从客户端访问该地址。VITE_WS_ORIGIN 由实时消息模块直接使用。

开发工程中可以执行以下命令完成安装与检查：

pnpm install
pnpm type-check
pnpm test:cloud

购买者从插件市场导入时确认 HBuilderX 显示的页面路由合并提示，然后将 pages/xingyu-social-unicloud-template/xingyu-social-unicloud-template.vue 作为插件入口运行到 App、H5 或所需小程序平台。

6. 配置云存储

上传采用 xingyu-social-staging/<user>/<random> 临时前缀。云对象会在 finally 中删除临时对象；仍建议在服务空间为该前缀设置 1 天生命周期，作为异常中断的兜底。不要将临时前缀当作永久媒体地址。

上传流程：客户端直传临时对象 → 云对象读取 Buffer → multipart 转发到业务 API → API 完成格式校验、缩略图生成和永久存储 → 云对象删除临时对象。

7. 部署云空间管理端网关

cloud-admin 是独立管理端工程，不依赖移动端构建流程。它保留现有运营中心的全部页面，通过当前服务空间的 xingyu-admin-gateway HTTP 云函数访问 https://xim.bchongw.com/admin/v1。

根据服务空间部署以下一份：

  • 阿里云：uniCloud-aliyun/cloudfunctions/xingyu-admin-gateway
  • 腾讯云：uniCloud-tcb/cloudfunctions/xingyu-admin-gateway

默认上游为 https://xim.bchongw.com。如需替换兼容的自建服务，修改 config.js 的 backendOrigin。管理端云函数只允许已列出的管理业务路由，不接收绝对 URL，也不会向上游转发 Cookie、Host 或代理头。

上传云函数后开启 URL 化/HTTP 访问，并记录控制台生成的完整地址，例如：

https://your-space-id.bspapp.com/http/xingyu-admin-gateway

不同服务商的实际域名可能不同，以服务空间控制台显示的地址为准。

限制管理端来源

首次调试时 config.js 的 allowedOrigins 为 ['*']。正式上线前将它改成管理端真实来源并重新部署，例如：

allowedOrigins: ['https://admin.example.com'],

云函数不使用浏览器 Cookie。管理员访问令牌由前端放入 Authorization，刷新令牌保存在管理端自己的 sessionStorage 并通过请求体提交。业务 API 仍负责登录校验、角色权限、审计和风控。

8. 配置、构建和托管管理端

编辑 cloud-admin/.env.production，把 VITE_GLOB_API_URL 替换为第 7 节获得的云函数 URL，并保持：

VITE_ADMIN_TRANSPORT=cloud

开发环境使用 cloud-admin/.env.development。需要临时排查原接口时，可以根据 .env.example 切换到 direct；正式部署建议保持 cloud。

构建管理端：

cd cloud-admin
pnpm install
pnpm build:ele

也可以在模板根目录执行：

pnpm build:cloud-admin

产物位于 cloud-admin/apps/web-ele/dist。将其内容上传到 uniCloud 前端网页托管的 /admin 目录。管理端默认 VITE_BASE=/admin/ 且使用 hash 路由，入口通常是：

https://你的网页托管域名/admin/

如果改为根目录托管，请同时把 cloud-admin/apps/web-ele/.env.production 中的 VITE_BASE 改为 / 后重新构建。

9. 部署验收清单

移动端

  1. 密码和短信登录、Token 自动刷新、退出登录。
  2. 头像、动态图片、举报证据和聊天语音上传。
  3. 推荐、附近、动态、评论、关注、拉黑及访客。
  4. 会话列表、历史消息、实时新消息、已读和撤回。
  5. 会员套餐、订单、支付回跳和退款申请。
  6. 推送注册、通知列表、举报与认证状态。

如云对象提示未配置上游地址，检查是否修改了错误云厂商目录中的 config.js；如 App 能请求接口但没有实时消息，检查 WSS 证书、反向代理升级头和 VITE_APP_SOCKET_ORIGIN。

管理端

  1. 管理员密码登录、令牌刷新、退出及修改密码。
  2. 用户查询、新建、资料修改、认证、会员、封禁、强制下线和处罚记录。
  3. 动态、消息、聊天媒体、举报、风险事件和反馈处理。
  4. 会员套餐、订单支付状态、关闭、退款和删除。
  5. AI、短信、支付、存储、OAuth 与运营参数配置。
  6. 管理员账号、角色权限和审计日志。
  7. 浏览器请求只访问管理端云函数 URL，不直接访问 /admin/v1 上游。

10. 购买者须知

  1. 模板默认连接 https://xim.bchongw.com 和 wss://xim.bchongw.com；购买者也可以部署与接口契约匹配的业务 API/WSS 服务并替换域名。模板不包含服务器密钥或服务商账号。
  2. 短信、OAuth、支付、推送、对象存储和内容审核需购买者自行申请并配置。
  3. AppID、包名、证书、隐私政策、备案和上架资质由购买者负责。
  4. 云函数与云存储会产生服务空间费用；媒体上传会经过临时云存储中转。
  5. 管理端需填写购买者服务空间生成的云函数 URL，并将构建产物部署到 uniCloud 前端网页托管；正式上线前应限制管理端云函数的允许来源。

隐私与权限声明模板

  • 相机/相册：用户主动上传头像、动态图片、认证或举报材料。
  • 麦克风：用户长按录制并发送语音消息。
  • 定位：获得授权后展示附近用户和大致距离。
  • 推送：发送聊天、互动、审核和订单通知。
  • 设备信息：用于登录设备管理、风控和版本兼容。
  • 网络服务：数据发送至购买者自行配置的 uniCloud 服务空间与业务 API 域名。

发布者必须把以上内容替换为自己的真实服务商、域名、处理目的、保存期限和注销方式后再提交审核。

11. 产品效果预览

以下图片直接使用发布者提供的 COS 外链。它们仅用于插件市场和购买者部署后的效果参考，不属于运行依赖，无需复制到购买者的 uniCloud 云存储。

移动端展示图 1

移动端展示图 1

移动端展示图 2-1

移动端展示图 2-1

移动端展示图 2

移动端展示图 2

移动端展示图 3

移动端展示图 3

移动端展示图 4

移动端展示图 4

移动端展示图 5

移动端展示图 5

移动端展示图 6

移动端展示图 6

移动端展示图 7

移动端展示图 7

PC 云空间管理端展示图 1

PC 管理端展示图 1

PC 云空间管理端展示图 2

PC 管理端展示图 2

PC 云空间管理端展示图 3

PC 管理端展示图 3

PC 云空间管理端展示图 4

PC 管理端展示图 4

12. 插件市场发布前检查

发布包必须符合云端一体页面模板结构：不能包含 manifest.json，pages 下只能有 xingyu-social-unicloud-template 一个直接子目录，入口文件必须为 xingyu-social-unicloud-template.vue。node_modules、dist、unpackage、本地环境文件和构建 ZIP 也不能进入插件包。不要手动压缩开发目录，发布前执行：

pnpm verify:marketplace

命令会在开发工程相邻位置生成 xingyu-social-unicloud-page-plugin，检查单页面入口、全部业务路由、双云函数和命名规则。压缩时只压缩该目录的内容，不能把目录本身作为 ZIP 内的额外第一层。

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

评论列表 撰写评论 向官方投诉

暂无用户评论。