安装网站访客统计工具Plausible最新版本(v3)

测试环境

Debian12
需要安装好docker
解析好统计域名

项目

项目：https://github.com/plausible/community-edition
文档：https://plausible.io/docs/

🔢 总内存占用：765.98 MiB

📦 总镜像大小：996.00 MiB

一键查询内存占用和镜像大小

curl -sS -O https://raw.githubusercontent.com/woniu336/open_shell/main/plausible_stats_v3.sh && chmod +x plausible_stats_v3.sh && ./plausible_stats_v3.sh

安装

git clone -b v3.0.1 --single-branch https://github.com/plausible/community-edition plausible-ce
cd plausible-ce

配置 `.env` 文件

创建 .env 文件并写入以下内容

提醒：把plausible.example.com改成你的统计域名

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

查看确认内容：

cat .env

输出类似如下：

BASE_URL=https://plausible.example.com
SECRET_KEY_BASE=随机生成的密钥
HTTP_PORT=8000

流量高峰通知【可选】

cd plausible-ce
nano .env

添加如下内容,以QQ邮箱为例

MAILER_EMAIL=123456@qq.com # 发信邮箱
SMTP_HOST_ADDR=smtp.qq.com
SMTP_HOST_PORT=465
SMTP_USER_NAME=123456@qq.com # 发信邮箱用户名
SMTP_USER_PWD=admin123 # 发信邮箱密码
SMTP_HOST_SSL_ENABLED=true
SMTP_RETRIES=2 # 发信重试次数

配置 `yml`

将 Docker 服务的端口绑定为本地回环地址，仅供本地反向代理使用：

提醒：如果你要开启cdn，比如cf cdn，请把127.0.0.1改成0.0.0.0

cat > compose.override.yml << EOF
services:
  plausible:
    ports:
      - 127.0.0.1:8000:\${HTTP_PORT}
EOF

启动 Plausible

docker compose up -d

确认服务正常运行：

curl --head http://localhost:8000

应返回：

HTTP/1.1 200 OK
...

停止后重新启动

cd plausible-ce
docker compose down
docker compose up -d

性能优化

禁用透明大页功能（Transparent HugePages），推荐设置为 never 或 madvise

echo never > /sys/kernel/mm/transparent_hugepage/enabled

验证

cat /sys/kernel/mm/transparent_hugepage/enabled

启用延迟统计功能

内核的延迟统计（delay accounting）未启用，因此 ClickHouse 无法收集 OSIOWaitMicroseconds 指标。可以通过以下方式启用：

echo 1 > /proc/sys/kernel/task_delayacct

🚫 如何关闭透明大页

临时关闭（重启失效）：

echo never > /sys/kernel/mm/transparent_hugepage/enabled

永久关闭（推荐）：

编辑 grub：

sudo vim /etc/default/grub

找到 GRUB_CMDLINE_LINUX，添加：

transparent_hugepage=never

然后更新 grub 并重启：

sudo update-grub
sudo reboot

✅ 检查当前状态

cat /sys/kernel/mm/transparent_hugepage/enabled

测试环境

项目

安装

配置 .env 文件

配置 yml

启动 Plausible

性能优化

配置 `.env` 文件

配置 `yml`