Plausible Community Edition 安装与配置指南

Plausible Community Edition 安装与配置指南

community-edition Example docker-compose setups for hosting Plausible Community Edition 项目地址: https://gitcode.com/gh_mirrors/comm/community-edition

一、项目基础介绍

Plausible Community Edition 是一个开源的分析系统，它提供了简单、隐私友好的网站分析工具。该项目主要用于追踪和记录网站的访问情况，而不需要牺牲用户的隐私。它使用现代的编程语言和技术栈构建，旨在提供一个轻量级、易于部署和管理的解决方案。

主要编程语言：TypeScript、JavaScript

二、项目使用的关键技术和框架

• TypeScript/JavaScript：用于编写项目的主要代码。
• Node.js：作为运行环境，用于执行JavaScript代码。
• Express：一个流行的Node.js框架，用于创建Web服务器。
• ClickHouse：一个用于实时分析的大规模数据数据库管理系统。
• Docker：用于容器化项目，使得部署更加简单和一致。
• Docker Compose：用于定义和运行多容器Docker应用。

三、项目安装和配置的准备工作

在开始安装Plausible Community Edition之前，请确保您的系统已经满足了以下要求：

• Docker：确保您的系统已安装Docker。
• Docker Compose：确保您的系统已安装Docker Compose。
• CPU：CPU必须支持SSE 4.2或NEON指令集或更高版本（由ClickHouse要求）。
• 内存：至少2GB的RAM推荐用于运行ClickHouse和Plausible，以避免内存溢出。

安装步骤

1. 克隆项目仓库：

   git clone -b v2.1.5 --single-branch https://github.com/plausible/community-edition plausible-ce
   

2. 进入项目目录：

   cd plausible-ce
   

3. 创建和配置环境文件：

   touch .env
   echo "BASE_URL=https://plausible.example.com" >> .env
   echo "SECRET_KEY_BASE=$(openssl rand -base64 48)" >> .env
   

   确保将BASE_URL设置为您的实际域名。该域名必须有一个指向您的服务器的DNS记录，以便正确解析并自动颁发Let's Encrypt TLS证书。

4. 创建.compose.override.yml文件：

   echo "HTTP_PORT=80" >> .env
   echo "HTTPS_PORT=443" >> .env
   cat > compose.override.yml << EOF
   services:
     plausible:
       ports:
         - 80:80
         - 443:443
   EOF
   

   设置HTTP_PORT=80和HTTPS_PORT=443将启用自动Let's Encrypt TLS证书颁发。如果您打算在反向代理后面运行Plausible，您可能需要选择其他值。

5. 启动服务：

   docker compose up -d
   

6. 访问您的实例：

   在浏览器中访问您在.env文件中设置的BASE_URL，并创建第一个用户。

以上就是Plausible Community Edition的安装和配置指南。按照上述步骤，您应该能够成功部署并开始使用这个强大的开源分析工具。

community-edition Example docker-compose setups for hosting Plausible Community Edition 项目地址: https://gitcode.com/gh_mirrors/comm/community-edition