electerious/ackee

Ackee Docker镜像文档

概述

Ackee是一款注重隐私的自托管分析工具，基于Node.js和MongoDB构建。它运行在您自己的服务器上，分析网站流量并在简洁界面中提供实用统计数据，同时将跟踪数据***化以避免用户可识别，无需跟踪用户所有方面即可提供有价值的洞察。适合不需要Google Analytics或Matomo等全功能营销分析平台的用户。

核心功能和特性

• 自托管：100%开源，完全运行在您自己的服务器上，数据掌控在自己手中
• 现代技术栈：轻量级Node.js和MongoDB架构，资源占用低
• 简洁界面：专注且极简的用户界面，数据展示清晰直观
• 无Cookie跟踪：不使用唯一用户跟踪，因此无需Cookie提示信息
• 事件跟踪：支持按钮点击、 newsletter订阅等自定义事件跟踪
• GraphQL API：提供完整文档的GraphQL API，可基于其构建自定义工具

使用场景和适用范围

• 注重用户隐私保护的个人网站管理员
• 不需要复杂营销分析功能的中小型网站
• 希望完全掌控数据存储和处理的开发者或组织
• 需要轻量级、低资源消耗的网站流量分析工具的场景

部署与使用方法

Docker快速启动

需先确保已安装Docker和MongoDB（可使用Docker容器运行MongoDB）。

1. 启动MongoDB容器（若未安装MongoDB）：

   bash
   docker run -d --name ackee-mongo -v ackee-data:/data/db -e MONGO_INITDB_ROOT_USERNAME=root -e MONGO_INITDB_ROOT_PASSWORD=example mongo:latest
   

2. 启动Ackee容器：

   bash
   docker run -d --name ackee --link ackee-mongo:mongo -p 3000:3000 \
     -e MONGO_URI=mongodb://root:example@mongo:27017/ackee?authSource=admin \
     -e ACKEE_USERNAME=admin \
     -e ACKEE_PASSWORD=yourpassword \
     electerious/ackee:latest
   

3. 访问 http://localhost:3000 即可打开Ackee界面，使用设置的用户名和密码登录。

Docker Compose部署

创建 docker-compose.yml 文件：

yaml
version: '3'

services:
  mongo:
    image: mongo:latest
    restart: always
    volumes:
      - mongo-data:/data/db
    environment:
      - MONGO_INITDB_ROOT_USERNAME=root
      - MONGO_INITDB_ROOT_PASSWORD=example
    networks:
      - ackee-network

  ackee:
    image: electerious/ackee:latest
    restart: always
    depends_on:
      - mongo
    ports:
      - "3000:3000"
    environment:
      - MONGO_URI=mongodb://root:example@mongo:27017/ackee?authSource=admin
      - ACKEE_USERNAME=admin
      - ACKEE_PASSWORD=yourpassword
      - ACKEE_PORT=3000
      - ACKEE_HOST=0.0.0.0
    networks:
      - ackee-network

networks:
  ackee-network:

volumes:
  mongo-data:

启动服务：

bash
docker-compose up -d

环境变量配置

Ackee通过环境变量进行配置，支持 .env 文件（容器中可挂载 .env 文件到 /app/.env）。关键环境变量说明：

相关资源

• 官方网站：[***]
• 在线演示：[***]
• GraphQL Playground：[***]
• 完整文档：https://github.com/electerious/Ackee/tree/master/docs
• 相关工具：
  • https://github.com/electerious/ackee-tracker - 数据传输工具
  • https://github.com/electerious/ackee-bitbar - macOS菜单 bar 统计工具
  • https://github.com/Burnsy/gatsby-plugin-ackee-tracker - Gatsby插件