Linux怎么安装Fathom统计工具-LINUX-PHP中文网

推荐直接用预编译二进制安装fathom，下载最新版tar包解压至/usr/local/bin并赋权；需用-c指定解压路径，避免命令不可用；配置须在/opt/fathom下创建.env文件显式指定sqlite路径。

linux怎么安装fathom统计工具

直接用预编译二进制安装最稳，别碰源码编译——除非你明确需要自定义前端资源或调试 Go 逻辑。

下载并解压到 `/usr/local/bin`

去 GitHub Releases 页面找最新版链接（比如 fathom_1.4.0_linux_amd64.tar.gz），然后执行：

cd /tmp
curl -L -O https://github.com/usefathom/fathom/releases/download/v1.4.0/fathom_1.4.0_linux_amd64.tar.gz
sudo tar -C /usr/local/bin -xzf fathom_1.4.0_linux_amd64.tar.gz
sudo chmod +x /usr/local/bin/fathom

注意点：

tar 必须加 -C /usr/local/bin 指定目标目录，否则解出来是个子目录，fathom 命令会找不到
别用 root 用户直接 curl 下载到 /usr/local/bin——权限混乱容易导致后续 systemd 启动失败
验证：运行 fathom --version，输出带 commit hash 才算真正可用

配置数据库和监听地址用 `.env` 文件

Fathom 默认用 SQLite，但必须显式指定路径，否则启动报 no such file or directory。推荐在 /opt/fathom 下建配置目录：

sudo mkdir -p /opt/fathom
sudo chown $USER:$USER /opt/fathom
cd /opt/fathom
cat > .env <p>关键细节：</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2541" title="PyCharm 2026.2.0.1 Linux版"><img
														src="https://img.php.cn/upload/manual/001/221/864/6a6c402fadae2127.png" alt="PyCharm 2026.2.0.1 Linux版" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/gongju/2541" title="PyCharm 2026.2.0.1 Linux版" class="overflowclass">PyCharm 2026.2.0.1 Linux版</a>
													<p class="overflowclass">PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。</p>
												</div>
												<a rel="nofollow" href="/xiazai/gongju/2541" title="PyCharm 2026.2.0.1 Linux版" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>

FATHOM_DATABASE_NAME 必须是绝对路径，SQLite 不接受相对路径
FATHOM_SERVER_ADDR 写成 :8080（不是 0.0.0.0:8080 或 127.0.0.1:8080），否则 systemd 服务里可能 bind 失败
FATHOM_SECRET 长度无所谓，但不能留空或用默认值，否则会提示 session key invalid

用 systemd 管理服务，别裸跑 `fathom server`

手动前台运行只适合调试；生产环境必须用 systemd，否则进程一断就丢数据。创建服务文件：

sudo tee /etc/systemd/system/fathom.service [Service]
Type=simple
User=$USER
WorkingDirectory=/opt/fathom
EnvironmentFile=/opt/fathom/.env
ExecStart=/usr/local/bin/fathom server
Restart=always
RestartSec=10<p>[Install]
WantedBy=multi-user.target
EOF</p>

然后启用：

sudo systemctl daemon-reload
sudo systemctl enable fathom
sudo systemctl start fathom

常见卡点：

如果 systemctl status fathom 显示 failed to load environment file，说明 EnvironmentFile 路径写错了，或者 .env 文件权限不对（不能是 600，得是 644）
User=$USER 里的 $USER 是字面量，要替换成真实用户名，比如 User=www-data 或 User=fathom
日志查不到？用 journalctl -u fathom -n 50 -f，别翻 /var/log/fathom/——Fathom 默认不写磁盘日志