countly/frontend

Countly Analytics Docker 镜像文档

概述

什么是 Countly?

Countly 是一款产品分析解决方案和创新推动者，帮助团队跨移动、Web 和桌面应用跟踪产品性能、客户旅程和行为。Countly 采用隐私优先设计，让您能够创新和增强产品，提供个性化客户体验，并实现关键业务和收入目标。

Countly 在全球 16,000 多个应用程序上跟踪超过 15 亿唯一身份，使用超过 2,000 台服务器，是全球领先的产品分析平台。它每天在云和本地环境中安全处理数十亿数据点，让您完全控制自己的数据。

主要用途

• 移动应用分析与性能跟踪
• Web 应用用户行为分析
• 桌面应用使用情况监控
• 客户旅程和行为分析
• 产品性能评估
• 推送通知和营销自动化

核心功能和特性

包含组件

• 完整的仪表板用户界面
• 用户、应用和权限管理
• 读写 API
• 基于插件的架构
• 移动、Web 和桌面分析功能
• iOS 和 Android 崩溃报告，Javascript 错误报告
• iOS 和 Android 富交互式推送通知
• 电子邮件报告

跟踪能力

Countly 可以收集和可视化来自以下平台的数据：

• iOS 设备
• Android 设备
• Windows Phone 设备
• 桌面应用（Windows、Mac OS）
• Web 应用

官方和社区支持的 Countly SDK 库列表可在此处找到，每个 SDK 都有自己的安装说明。

独特优势

• 实时移动分析、Web 分析和推送通知
• 数据自主控制 - 可安装在自己的服务器上或使用私有云部署
• 通过开源插件可配置和扩展
• 现代化且易于使用的 Web 仪表板，注重用户体验
• 支持超过 2500 个网站和 *** 个移动应用
• 全球收集超过 600 亿数据点

技术架构

构建组件

• MongoDB - 最流行的 NoSQL 数据库之一
• Node.js - 开源跨平台 JavaScript 运行时环境
• Express.js - 流行的 Node.js Web 应用框架
• Linux - 推荐的操作系统

以及许多开源库。

安全性

安全性对我们至关重要。如果您发现任何与安全相关的问题，请负责任地通过发送电子邮件至 *** 披露信息，而不是创建 GitHub 问题。

社区版与企业版的区别

适用人群

• 社区版：适合个人开发者和小型开发团队
• 企业版：更适合需要高级分析和营销功能以及持续支持的公司

功能差异

• 社区版：基础分析功能、核心插件、开源免费许可
• 企业版：包含社区版所有功能，外加自动化推送通知、高级细分、用户配置文件、应用内购买分析、留存率分析、用户流、行为队列和自定义仪表板

数据粒度

• 社区版：仅以聚合格式存储数据，减少所需存储并使报告速度极快
• 企业版：除聚合格式外，还存储单个数据点，支持更高级功能如细分、漏斗分析、用户配置文件和行为队列

部署与支持

• 社区版：需要具备 Linux、Nginx、Node.js 和 MongoDB 等技术的专业知识
• 企业版：包含托管或本地部署订阅，提供专业支持、高可用性和可扩展性规划，以及服务级别协议(SLA)

安装与配置

Docker 安装方法

使用官方 Docker 镜像

Countly 社区版提供 Docker 支持，可通过以下命令快速安装：

bash
# 拉取 Countly 服务器镜像
docker pull docker.xuanyuan.run/countly/countly-server

# 启动 Countly 容器
docker run -d -p 80:80 -p 443:443 --name countly docker.xuanyuan.run/countly/countly-server

使用 Docker Compose (推荐)

创建 docker-compose.yml 文件：

yaml
version: '3'

services:
  mongodb:
    image: docker.xuanyuan.run/mongo:4.4
    volumes:
      - mongodb_data:/data/db
    restart: always
    
  countly:
    image: docker.xuanyuan.run/countly/countly-server
    ports:
      - "80:80"
      - "443:443"
    depends_on:
      - mongodb
    environment:
      - COUNTLY_MONGODB_HOST=mongodb
      - COUNTLY_MONGODB_PORT=27017
      - COUNTLY_SERVER_URL=http://your-server-ip
    restart: always
    volumes:
      - countly_data:/var/countly

volumes:
  mongodb_data:
  countly_data:

启动服务：

bash
docker-compose up -d

传统安装方法

对于 Ubuntu 或 CentOS 服务器，可使用以下命令安装：

bash
wget -qO- https://c.ly/install | bash

或者，如果您有 Digital Ocean 账户，可以一键在 Digital Ocean 上安装。

环境变量配置

Countly 支持以下关键环境变量进行配置：

使用指南

访问 Countly 仪表板

安装完成后，通过浏览器访问您的服务器地址：http://your-server-ip 或 https://your-server-ip

首次访问时，您需要创建管理员账户并完成初始设置向导。

API 与前端

Countly 拥有完善定义的 API，用于从 Countly 后端读取和写入数据。仪表板使用读取 API 构建，因此您可以使用 Countly API 获取仪表板上看到的任何信息。

插件与扩展

Countly 通过插件架构实现可扩展性。在创建插件之前，建议阅读插件开发介绍文档。

升级 Countly 服务器

要升级 Countly 服务器，建议参考升级文档。对于 Docker 安装，可以通过以下步骤升级：

bash
# 拉取最新镜像
docker pull docker.xuanyuan.run/countly/countly-server

# 停止并删除现有容器
docker stop countly
docker rm countly

# 使用新镜像启动容器
docker run -d -p 80:80 -p 443:443 --name countly docker.xuanyuan.run/countly/countly-server

对于 Docker Compose 安装：

bash
docker-compose pull
docker-compose up -d

支持与资源

学习资源

• 官方文档
• Slack 社区
• 社区论坛
• *** 培训视频

如何贡献

1. Fork 此仓库
2. 创建功能分支 (git checkout -b my-new-super-feature)
3. 提交更改 (git commit -am 'Add some cool feature')
4. 推送到分支 (git push origin my-new-super-feature)
5. 创建新的拉取请求

详细贡献指南请参见https://github.com/Countly/countly-server/blob/master/CONTRIBUTING.md%E3%80%82

链接

• 官方网站
• 移动分析
• Web 分析
• 桌面分析
• 产品信息
• 定价与版本比较
• 插件市场
• 数据隐私原则