如何通过宝塔面板部署Plausible

以下是基于宝塔面板部署Plausible的详细步骤，结合了多篇技术文档的实践指南：

一、环境准备

1. 服务器与宝塔面板安装

• 购买一台VPS服务器（推荐Debian系统），并安装宝塔面板。
• 通过SSH登录服务器，执行宝塔官方安装脚本，完成后开放面板端口（如8888）并绑定域名。

2. 安装必要软件

• 在宝塔面板的“软件商店”中安装 Nginx 和 Docker（选择极速安装）。
• 确保服务器已安装Git工具（可通过宝塔终端操作）。

二、域名与目录配置

1. 解析二级域名

• 在域名服务商处添加一个二级域名（如 stats.yourdomain.com），解析到服务器IP。
• 在宝塔面板的“网站”模块中添加该域名，创建对应的网站目录（如 /www/wwwroot/stats）。

2. 克隆Plausible源码

cd /www/wwwroot/stats
git clone -b v2.1.4 --single-branch https://github.com/plausible/community-edition plausible-ce

进入生成的 plausible-ce 目录。

三、配置文件设置

1. 创建 .env 文件

BASE_URL=https://stats.yourdomain.com
SECRET_KEY_BASE=生成的48位Base64密钥（可通过`openssl rand -base64 48`生成）
HTTP_PORT=8090

需替换为实际域名和生成的密钥。

2. 创建 compose.override.yml 文件

services:
  plausible:
    ports:
      - 127.0.0.1:8090:${HTTP_PORT}

确保端口与 .env 中的 HTTP_PORT 一致。

四、Docker部署与启动

1. 启动Docker容器

docker compose up -d

等待容器构建完成，通过 docker ps 检查运行状态。

2. 验证服务

curl --head http://localhost:8090

若返回 HTTP/1.1 200 OK 或 302 状态码，则服务正常。

五、Nginx反向代理配置

1. 添加反向代理规则

• 在宝塔面板的网站设置中，进入“反向代理”模块，添加以下配置：

location / {
    proxy_pass http://127.0.0.1:8090;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

• 开启SSL（可选）：在宝塔面板申请免费SSL证书并部署。

2. 伪静态设置（可选）

• 在网站设置的“伪静态”中添加规则，确保路由正确解析。

六、访问与后续管理

1. 访问Plausible后台

• 通过 https://stats.yourdomain.com 访问，首次登录需设置管理员账号。
• 禁用公开注册（在 .env 中添加 disable_registration=true）以增强安全性。

2. 数据持久化与备份

• 通过宝塔的“计划任务”定期备份Docker容器数据和数据库。
• 使用宝塔的“文件管理”监控日志（如 /var/log/plausible）。

常见问题

• 端口冲突：确保 8090 端口未被占用，或修改 .env 和 compose.override.yml 中的端口号。
• 统计脚本集成：在网站HTML中插入Plausible提供的1KB统计脚本（路径为 /js/script.js）。

通过以上步骤，即可在宝塔面板上完成Plausible的私有化部署，实现轻量、隐私友好的网站流量统计。

引用 3 个网页，4 篇公众号文章

• 1. 再见谷歌分析，拥抱Plausible：如何拥有自己独一无二的流量统计工具
• 2. Plausible: 一款简单、隐私友好的谷歌分析替代品自托管部署指南
• 3. 【linux技术】阿里云轻量应用服务器通过宝塔linux面板安装软件流程记录
• 4. 腾讯云宝塔Linux面板部署项目步骤详解
• 5. Docker部署宝塔面板的步骤是什么? - 酷盾
• 6. 【技术分析】“宝塔面板极速搭建源码部署环境:一键部署便捷操作”-股票软件指标公式技术交流
• 7. 宝塔面板部署服务器的具体步骤和意义是什么? - 酷盾