Origin — 可扩展交流社区平台
内置插件框架与主题引擎的新一代社区系统 · 镜像一键部署 · 开箱即用
项目简介
Origin 是广州起源节点科技有限公司(ORIGINODE)开发的一个面向现代社交场景设计的全功能社区平台。区别于传统的论坛或博客系统,Origin 从架构之初就将可扩展性作为核心设计目标——内置插件框架与主题引擎,让功能扩展与视觉定制不再受限。
无论是搭建品牌社区、兴趣圈子、知识付费平台,还是运营私域社交产品,Origin 都能以最小成本快速启动,并随着业务增长灵活扩展。
核心特性
插件化架构
- 18 个官方内置插件开箱即用
- 支持远程插件动态安装与热更新
- 插件间通过事件总线松耦合通信
- 权限体系精细到每个插件的能力边界
主题引擎
- 运行时主题切换,无需重启
- 完整的 ThemeModule 组件契约
- 设计 Token 自动映射为 CSS 变量
- 支持本地主题与远程主题双模式
全栈现代化
- Next.js 15 App Router 服务端渲染
- React 19 + TypeScript 5 strict 模式
- Prisma 6 ORM + PostgreSQL 16
- Tailwind CSS 4 原子化样式
功能全景
| 模块 | 功能描述 |
|---|---|
| 信息流 | 图文动态发布、转发、评论、点赞、@提及、话题标签 |
| 圈子 | 公开圈子创建/加入/退出、成员管理、圈内发帖、圈子治理 |
| 私信 | 一对一实时会话、SSE 推送、未读计数、消息搜索 |
| 文章 | Markdown 长文写作、分类标签、独立阅读页、评论点赞 |
| 互动帖 | 投票帖、币红包、抽奖帖(自动开奖/发货) |
| 商城 | 虚拟/实物商品、购物车、订单、评价、售后、卡密发货 |
| VIP 系统 | 十级会员体系、成长值曲线、兑换码、专属角标 |
| AI 助手 | 计划调度小号发帖、智能评论回复、图片搜索 |
| 打赏 | 起源币打赏帖子与评论作者 |
| 签到 | 每日签到、补签卡、心情记录、排行榜 |
| 发现广场 | 推荐圈子、热门用户、趋势话题聚合 |
| 用户认证 | 实名认证申请/审核、全站角标与称号展示 |
| 快捷登录 | QQ / 微信 OAuth 一键登录 |
| 对象存储 | 腾讯云 COS / 阿里云 OSS / AWS S3 / 七牛云 / MinIO |
| 钱包 | 起源币充值、消费流水、余额管理 |
| 通知 | 站内消息推送、广播通知、未读红点 |
技术架构
┌─────────────────────────────────────────────────────────────┐ │ 前端层 │ │ Next.js 15 主站 · 响应式三栏布局 · 管理后台 │ ├─────────────────────────────────────────────────────────────┤ │ 核心层 │ │ 事件总线 · 插件注册表 · 主题引擎 · 平台引导 │ ├─────────────────────────────────────────────────────────────┤ │ 数据层 │ │ Prisma ORM · PostgreSQL · 50+ 数据模型 · 72 个迁移 │ ├─────────────────────────────────────────────────────────────┤ │ 插件层 │ │ 18 个内置插件 · 远程插件市场 · 存储抽象层(S3/COS/OSS/七牛) │ ├─────────────────────────────────────────────────────────────┤ │ 主题层 │ │ 默认主题(Threads/INS 风格)· 远程主题市场 │ └─────────────────────────────────────────────────────────────┘安全设计
- CSRF 防护:Cookie 自动注入 + 请求校验
- 接口限流:登录/注册/Admin API 多层限流保护
- Session 管理:轻量级状态校验 + 自动续期 + 过期清理
- 维护模式:一键切换维护状态,API 返回 503,前端重定向
- Admin 保护:未认证拦截 + 角色校验 + 额外限流
快速部署
环境要求
- Docker + Docker Compose
- PostgreSQL 16(或使用 Docker Compose 内置)
Docker 一键部署
# 1. 下载部署包并进入目录cddeploy-package# 2. 复制环境变量模板cp.env.example .env# 3. 编辑 .env 文件,配置以下关键项:# SESSION_SECRET — 会话密钥(随机字符串)# NEXT_PUBLIC_APP_URL — 站点公网地址# ORIGIN_DOCKER_IMAGE — 镜像地址# DATABASE_URL — 数据库连接(或使用内置 PostgreSQL)# 4. 启动服务dockercompose up-d服务启动后访问:
- 前台首页:
http://<你的域名> - 管理后台:
http://<你的域名>/admin - 应用管理:
http://<你的域名>/admin/apps(安装/卸载插件) - 主题管理:
http://<你的域名>/admin/themes(切换主题)
生产环境首个注册用户自动成为管理员(ADMIN 角色)。
宝塔面板部署
支持宝塔面板 Docker 编排一键部署,详细步骤请参考部署说明.txt。
在线更新
Origin 支持容器内一键热更新,无需停机:
dockercompose pulldockercompose up-d或通过管理后台的"系统更新"模块检测并应用新版本。
插件与主题生态
插件市场
Origin 内置 18 个官方插件,同时支持从远程市场安装第三方插件:
- 进入管理后台 → 应用管理 → 应用市场
- 浏览可用插件,一键安装
- 已安装插件可随时启用/停用/卸载
- 支持远程插件热更新,无需重启服务
主题市场
- 进入管理后台 → 主题管理
- 切换不同主题,实时预览效果
- 支持从远程市场安装新主题
扩展开发(高级)
Origin 提供完整的插件 SDK 与主题引擎接口,支持开发者基于标准契约扩展平台能力:
- 插件:通过
manifest.json声明权限与钩子,注册导航项、个人页标签、侧边栏入口、API 路由、存储提供者等 - 主题:实现
ThemeModule接口,自定义组件、布局与页面
使用说明
首次启动
- 部署完成后访问站点首页
- 点击右上角"注册"创建第一个账号
- 该账号自动获得ADMIN管理员权限
- 登录后进入
/admin管理后台,开始配置站点
常用管理操作
| 操作 | 路径 |
|---|---|
| 站点基本信息设置 | 管理后台 → 系统设置 |
| 插件安装/卸载 | 管理后台 → 应用管理 |
| 主题切换 | 管理后台 → 主题管理 |
| 用户管理 | 管理后台 → 用户管理 |
| 帖子/评论审核 | 管理后台 → 帖子管理 |
| 导航栏配置 | 管理后台 → 导航管理 |
| 通知广播 | 管理后台 → 通知广播 |
| 钱包/订单查看 | 管理后台 → 钱包管理 |
在线更新
管理后台提供"系统更新"模块,可检测新版本并一键应用:
- 进入管理后台 → 系统更新
- 点击"检查更新"
- 如有新版本,点击"应用更新"
- 系统自动下载并部署,无需手动操作
版本发版
Origin 采用语义化版本(SemVer),定期发布更新。当前最新版本请查看发布页面或管理后台的系统更新模块。
主要发版内容通常包括:
- 新功能插件上线
- 主题引擎增强
- 安全补丁与性能优化
- Bug 修复
关于 OriginHub
OriginHub 是 Origin 的商业化管理后台,提供客户授权、实例管理、应用市场、权益分发等商业化能力。如需了解商业授权方案或定制开发,请通过以下方式联系。
免费声明
Origin 目前对个人和非商业场景免费开放使用,可通过 Docker 镜像一键部署。商业用途请联系获取授权。
Built with Next.js · React · Prisma · PostgreSQL · Tailwind CSS