以下是基于宝塔面板部署Plausible的详细步骤,结合了多篇技术文档的实践指南:
一、环境准备
- 服务器与宝塔面板安装
- 购买一台VPS服务器(推荐Debian系统),并安装宝塔面板。
- 通过SSH登录服务器,执行宝塔官方安装脚本,完成后开放面板端口(如8888)并绑定域名。
- 安装必要软件
- 在宝塔面板的“软件商店”中安装 Nginx 和 Docker(选择极速安装)。
- 确保服务器已安装Git工具(可通过宝塔终端操作)。
二、域名与目录配置
- 解析二级域名
- 在域名服务商处添加一个二级域名(如
stats.yourdomain.com
),解析到服务器IP。 - 在宝塔面板的“网站”模块中添加该域名,创建对应的网站目录(如
/www/wwwroot/stats
)。
- 克隆Plausible源码
cd /www/wwwroot/stats
git clone -b v2.1.4 --single-branch https://github.com/plausible/community-edition plausible-ce
进入生成的 plausible-ce
目录。
三、配置文件设置
- 创建
.env
文件
BASE_URL=https://stats.yourdomain.com
SECRET_KEY_BASE=生成的48位Base64密钥(可通过`openssl rand -base64 48`生成)
HTTP_PORT=8090
需替换为实际域名和生成的密钥。
- 创建
compose.override.yml
文件
services:
plausible:
ports:
- 127.0.0.1:8090:${HTTP_PORT}
确保端口与 .env
中的 HTTP_PORT
一致。
四、Docker部署与启动
- 启动Docker容器
docker compose up -d
等待容器构建完成,通过 docker ps
检查运行状态。
- 验证服务
curl --head http://localhost:8090
若返回 HTTP/1.1 200 OK
或 302
状态码,则服务正常。
五、Nginx反向代理配置
- 添加反向代理规则
- 在宝塔面板的网站设置中,进入“反向代理”模块,添加以下配置:
location / {
proxy_pass http://127.0.0.1:8090;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
- 开启SSL(可选):在宝塔面板申请免费SSL证书并部署。
- 伪静态设置(可选)
- 在网站设置的“伪静态”中添加规则,确保路由正确解析。
六、访问与后续管理
- 访问Plausible后台
- 通过
https://stats.yourdomain.com
访问,首次登录需设置管理员账号。 - 禁用公开注册(在
.env
中添加disable_registration=true
)以增强安全性。
- 数据持久化与备份
- 通过宝塔的“计划任务”定期备份Docker容器数据和数据库。
- 使用宝塔的“文件管理”监控日志(如
/var/log/plausible
)。
常见问题
- 端口冲突:确保
8090
端口未被占用,或修改.env
和compose.override.yml
中的端口号。 - 统计脚本集成:在网站HTML中插入Plausible提供的1KB统计脚本(路径为
/js/script.js
)。
通过以上步骤,即可在宝塔面板上完成Plausible的私有化部署,实现轻量、隐私友好的网站流量统计。