在 Ubuntu/Debian/CentOS 上安装 Fathom 分析

发表 admin at 2025年2月28日

类别

未分类

标签

在这篇博文中，您将学习在 Linux（Ubuntu/Debian/CentOS/Arch 等）上安装和使用 Fathom Analytics 工具。 Fathom Analytics 是一种开源、易于使用且更注重隐私的 Google Analytics 替代方案。

该工具将帮助您在互联网上收集有关任何网络服务的信息，可用于服务/内容改进、历史分析等。这个免费工具将保护您的数据和所有用户的隐私。此外，Fathom 尊重用户的隐私，不会收集任何个人身份信息。

在 Linux 上安装 Fathom 网站分析工具

安装wget和curl工具：

### Ubuntu / Debian ###
sudo apt update
sudo apt install curl wget

### Fedora / CentOS ###
sudo yum -y install curl wget

使用 wget 下载最新版本的 Fathom

VER=$(curl -s https://api.github.com/repos/usefathom/fathom/releases/latest|grep tag_name|cut -d '"' -f 4|sed 's/v//')
wget https://github.com/usefathom/fathom/releases/download/v${VER}/fathom_${VER}_linux_amd64.tar.gz

解压下载的文件：

tar xvf fathom_${VER}_linux_amd64.tar.gz

使文件可执行

chmod +x fathom

将二进制文件移动到 /usr/local/bin 目录：

sudo mv fathom /usr/local/bin

使用选项--help 打印帮助页面。

$ fathom --help
INFO[0000] Fathom version 1.2.1, commit 8f7c6d2e45ebb28651208e2a7320e29948ecdb2c, built at 2018-11-30T09:21:37Z
NAME:
   Fathom - simple & transparent website analytics

USAGE:
   fathom [global options] command [command options] [arguments...]

VERSION:
   1.2.1, commit 8f7c6d2e45ebb28651208e2a7320e29948ecdb2c, built at 2018-11-30T09:21:37Z

COMMANDS:
     server, s  start the fathom web server
     user       manage registered admin users
     stats      view stats
     help, h    Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --config FILE, -c FILE  Load configuration from FILE (default: ".env")
   --help, -h              show help
   --version, -v           print the version

如何使用 Fathom 分析工具

在开始使用 Fathom 之前，您需要注册您的用户帐户

$ fathom register --email=<email> --password=<password>

样本输出

NFO[0000] Fathom 1.2.1                                 
WARN[0000] Error reading configuration. File `.env` does not exist. 
INFO[0000] Connected to sqlite3 database: /home/jmutai/fathom.db?_loc=auto 
INFO[0000] Created user [email

阅读有关 Fathom 配置文件的更多信息，了解所有可能的配置值。

启动 Fathom Web 服务器

创建一个使用以下内容命名的 .env 配置文件。

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

配置 Fathom 后，您可以使用命令 fathom server 启动 Fathom Web 服务器。

fathom server

这应该会开始使用名为 fathom.db 的 SQLite 数据库文件在端口 9000 上提供网站服务。

使用 systemd 管理服务

为了确保 Fathom Web 服务器在系统重新启动时启动，我们应该使用 Systemd。

创建一个名为 /etc/systemd/system/fathom.service 的新文件，其中包含以下内容。将 $USER 替换为您的实际用户名。

sudo tee /etc/systemd/system/fathom.service<<EOF
[Unit]
Description=Fathom server management service unit
Requires=network.target
After=network.target

[Service]
Type=simple
User=$USER
Restart=always
RestartSec=3
WorkingDirectory=/home/$USER
ExecStart=/usr/local/bin/fathom server

[Install]
WantedBy=multi-user.target
EOF

重新加载 Systemd 配置并启用服务在启动时启动。

sudo systemctl daemon-reload
sudo systemctl enable fathom.service

通过发出以下命令启动 Fathom Web 服务器。

sudo systemctl start fathom.service

该服务应该启动并切换到运行状态。

打开链接 http://server-ip-address-here:9000 以访问 Fathom 仪表板。

使用 NGINX 运行 Fathom

在 CentOS 上安装 nginx

sudo yum install epel-release
sudo yum install nginx

在 Ubuntu/Debian 上安装 nginx

sudo apt install nginx

安装 nginx Arch

sudo pacman -S nginx

然后，我们使用 NGINX 通过指令 proxy_pass 将某个域的所有流量重定向到在端口 8080 上运行的 Fathom 应用程序。

$ sudo ss -tunelp | grep 8080
tcp   LISTEN 0      4096               *:8080             *:*    users:(("fathom",pid=31420,fd=5)) uid:1000 ino:59315 sk:a cgroup:/system.slice/fathom.service v6only:0 <->

在 /etc/nginx/conf.d/fathom.conf 中创建以下文件

sudo vim /etc/nginx/conf.d/fathom.conf

添加：

server {
	server_name fathomsite.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:8080; 
	}
}

测试配置语法并重新启动 nginx

sudo nginx -t
sudo systemctl enable nginx
sudo systemctl restart nginx

打开链接 http://fathomsite.com 以访问 Fathom 仪表板。

使用配置的电子邮件地址和密码登录

跟踪片段

要开始跟踪，请在您的网站上添加以下 JavaScript，并将 yourfathom.com 替换为您的 Fathom 实例的 URL。

<!-- Fathom - simple website analytics - https://github.com/usefathom/fathom -->
<script>
(function(f, a, t, h, o, m){
	a[h]=a[h]||function(){
		(a[h].q=a[h].q||[]).push(arguments)
	};
	o=f.createElement('script'),
	m=f.getElementsByTagName('script')[0];
	o.async=1; o.src=t; o.id='fathom-script';
	m.parentNode.insertBefore(o,m)
})(document, window, '//yourfathom.com/tracker.js', 'fathom');
fathom('trackPageview');
</script>
<!-- / Fathom -->

对于 WordPress 网站，请使用 Fathom WordPress 插件

在 WordPress 管理面板中，转到插件 > 新插件，搜索Fathom Analytics，然后点击“立即安装”

2. 或者，下载插件并将 fathom-analytics.zip 的内容上传到您的插件目录，通常为 /wp-content/plugins/。

安装并激活此插件后，转到设置 > 常规，然后在底部附近的文本字段中输入您的 Fathom 实例的URL。

几分钟后，分析结果应该开始显示。

感谢您使用我们的指南来设置由 Fathom 提供支持的个人分析引擎。对于任何疑问，请发表评论，我很乐意回复。