⚠️ 重要限制： 本模板仅支持自有根域名（zone apex），不支持任何子域名（例如 xxx.zeabur.app）。请务必使用您自己的根域名，并将所有相关环境变量（如 OAuth redirect URI）设为该域名。若您没有自己的根域名，请勿安装本模板。

每次更新环境变量后，请务必重启所有服务，否则新设置不会生效。

OpenPanel

OpenPanel 是一个强大的分析平台，可以捕获并可视化跨网站、移动应用程序和后端服务的用户行为。它结合了 Mixpanel 的强大功能与 Plausible 的简洁性。

功能特色

• 实时分析：实时跟踪用户行为与事件
• 事件追踪：自定义事件跟踪与分析
• 用户分析：用户行为分析与漏斗分析
• 仪表盘：美观的数据可视化仪表盘
• 隐私友好：完全控制您的数据，符合 GDPR 规范
• 开源：完全开源且可自定义

技术栈

• Next.js：仪表盘前端
• Fastify：事件 API
• PostgreSQL：存储基本信息
• ClickHouse：存储事件数据
• Redis：缓存层、发布订阅与队列

架构

此模板部署 OpenPanel 与以下服务：

• Caddy：反向代理与所有流量的入口点
• PostgreSQL：配置与用户数据的主要数据库
• Redis：缓存与队列系统
• ClickHouse：事件存储的分析数据库
• API：后端 API 服务
• Dashboard：前端仪表盘
• Worker：后台任务处理器

使用方法

1. 部署后，将域名绑定到 Caddy 服务（这是入口点）
2. 访问您的域名以使用 OpenPanel
3. 使用提供的电子邮件创建您的第一个管理员账户
4. 开始跟踪您的网站或应用程序

⚠️ 重要：请确保将您的域名绑定到 Caddy 服务，因为它是将流量路由到适当服务的单一入口点。

环境配置

所有环境变量都根据 OpenPanel 的需求预先配置，包括数据库连接、API 端点和工作器设置。

OAuth 登录配置（可选）

如果您需要 Google 或 GitHub 登录功能，可以将以下环境变量添加到您的 API 和 Dashboard 服务：

# GitHub OAuth
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_REDIRECT_URI=https://your-domain/api/oauth/github/callback

# Google OAuth
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=https://your-domain/api/oauth/google/callback

请确保将 your-domain 替换为您绑定到 Caddy 服务的实际域名。

官方资源

• 网站：https://openpanel.dev
• 文档：https://openpanel.dev/docs
• GitHub：https://github.com/Openpanel-dev/openpanel

支持

如需帮助，请访问 OpenPanel 的 Discord 社区或 GitHub Issues。