Fathom网站分析工具安装与配置指南

Fathom网站分析工具安装与配置指南

fathom Fathom Lite. Simple, privacy-focused website analytics. Built with Golang & Preact. 项目地址: https://gitcode.com/gh_mirrors/fa/fathom

Fathom是一款轻量级、注重隐私保护的网站分析工具，相比传统分析工具更简洁高效。本文将详细介绍如何从零开始安装和配置Fathom分析系统。

一、Fathom安装准备

在开始安装前，请确保您的服务器满足以下基本要求：

• 64位Linux操作系统（推荐Ubuntu 18.04+）
• 至少1GB内存
• 至少10GB存储空间

1.1 下载与安装

Fathom提供了预编译的二进制文件，安装过程非常简单：

1. 获取适合您系统架构的最新版本Fathom
2. 将下载的压缩包解压到系统二进制目录

tar -C /usr/local/bin -xzf fathom_$VERSION_$OS_$ARCH.tar.gz
chmod +x /usr/local/bin/fathom

安装完成后，可以通过以下命令验证安装是否成功：

fathom --version

正常输出应显示当前Fathom的版本号。

二、Fathom基础配置

2.1 配置文件设置

Fathom支持通过环境变量文件(.env)进行配置。首先创建一个专用目录：

mkdir ~/my-fathom-site
cd ~/my-fathom-site

然后创建.env配置文件，以下是推荐的基础配置：

FATHOM_SERVER_ADDR=9000
FATHOM_GZIP=true
FATHOM_DEBUG=true
FATHOM_DATABASE_DRIVER="sqlite3"
FATHOM_DATABASE_NAME="fathom.db"
FATHOM_SECRET="your-random-secret-string"

关键参数说明：

• FATHOM_SERVER_ADDR：服务监听端口
• FATHOM_DATABASE_DRIVER：数据库类型（支持sqlite3/mysql/postgres）
• FATHOM_SECRET：用于加密会话的安全密钥，建议使用长随机字符串

2.2 启动服务

配置完成后，可以通过以下命令启动服务：

fathom server

服务启动后，默认会在9000端口提供Web界面，您可以通过浏览器访问服务器IP地址加端口号来验证。

三、管理员账户设置

首次使用需要创建管理员账户：

fathom user add --email="your@email.com" --password="your-strong-password"

注意：密码强度建议至少12位，包含大小写字母、数字和特殊字符。

四、生产环境部署优化

4.1 Nginx反向代理配置

为提高性能和安全性，建议使用Nginx作为前端代理：

server {
    server_name your-domain.com;
    
    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header Host $host;
        proxy_pass http://127.0.0.1:9000;
    }
}

配置完成后，需要重新加载Nginx：

nginx -t && systemctl reload nginx

4.2 SSL证书配置

使用Let's Encrypt免费SSL证书：

certbot --nginx -d your-domain.com

证书会自动续期，确保长期有效。

4.3 系统服务配置

为确保Fathom服务稳定运行，建议配置为系统服务：

[Unit]
Description=Fathom Analytics Service
Requires=network.target
After=network.target

[Service]
Type=simple
User=your-username
Restart=always
RestartSec=3
WorkingDirectory=/home/your-username/my-fathom-site
ExecStart=/usr/local/bin/fathom server

[Install]
WantedBy=multi-user.target

启用并启动服务：

systemctl daemon-reload
systemctl enable fathom
systemctl start fathom

五、网站追踪代码集成

在Fathom控制面板中可以获取追踪代码片段，将该代码添加到您需要统计的网站HTML中即可开始收集数据。Fathom的追踪代码非常轻量，不会影响网站加载速度。

六、高级配置建议

1. 数据库选择：对于高流量网站，建议使用MySQL或PostgreSQL替代默认的SQLite
2. 定期备份：定期备份数据库文件或导出统计数据
3. 性能监控：可使用工具监控Fathom服务的资源使用情况
4. 日志管理：配置日志轮转，避免日志文件过大

通过以上步骤，您已经成功部署了一个注重隐私保护的网站分析系统。Fathom的简洁设计让您可以专注于真正重要的数据，而不被繁杂的功能所干扰。

fathom Fathom Lite. Simple, privacy-focused website analytics. Built with Golang & Preact. 项目地址: https://gitcode.com/gh_mirrors/fa/fathom