零门槛追踪比特币收益：BTC Tracker 全面上手指南

想让每一笔比特币投资都有迹可循，却又担心第三方平台泄露隐私？BTC Tracker 这款「自托管收益追踪器」可让你把数据完全留在本地，界面极简却能给出深度收益分析。下文将用自来水般流畅的文字，带你从安装到高阶玩法一次看懂。

快速认识 BTC Tracker

BTC Tracker 是一款开源、Web-端、可 Docker 化的比特币收益追踪工具。它把「Bitcoin 投资收益」这件事拆成三步：一键添加交易、自动拉取 Yahoo Finance 行情、实时计算盈亏。核心关键词：自托管、本地化、零依赖、隐私优先。

• 一句话特点：装在电脑上，数据不上云，行情实时同步，收益一目了然。
• 适用人群：长期囤币党、定投爱好者、或只想隔离交易所行情噪音的持币人。

版本亮点：v0.5.2 升级速递

官方刚推送的 v0.5.2 被称为“公测良心版”，优化集中在这四件事：

1. 多币种汇率同步零翻车（EUR、USD、PLN、GBP、JPY、CHF、BRL 一网打尽）。
2. 下拉框、弹层 UI 统一修边，颜值强迫症患者福音。
3. 快添交易按钮出“闪现”功能，点两下即录入。
4. 彩蛋：输入荒谬数量会跳出比特币梗搞怪校验，实测很疗愈。

为什么选择 BTC Tracker

• 隐私零泄露：所有钱包地址、交易记录在本地 JSON 储存，绝不过网。
• 轻量不简单：剔除了传统「通用钱包」冗余功能，只聚焦 比特币投资管理。
• 行情直连 Yahoo：无需 API Key 即可实时获取币价，且自带缓存防封。
• Windows/Mac/Linux 以及 Docker/Podman 全覆盖，新旧电脑都能跑。

如果你曾因在线平台「年度服务费」「强制 KYC」而心累👉 点我体验零门槛部署，即刻打开 localhost 3000。

功能全览：4 大模块深度拆解

📊 数据与可视化

• 交互图表 带时间滑块，可叠加 K 线。
• 盈亏计算 基于 FIFO 法，自动算出 ROI。
• 历史回放 拖拽即可看任意时间点的持仓价值。

💱 汇率引擎

• 支持 7 种法币，后台每 15 分钟拉一次汇率，缓存 1 小时。
• 小数点后 8 位精准度（satoshi 级），再也不用手算比特币余额。

🎨 UI 与体验

• 一键切换深色/浅色主题，图表智能自适应。
• 手机端同样丝滑，官方打出「马桶上也能安心看收益」的口号。

🔐 安全与权限

• bcryptjs 加密密码 + 4 位 PIN 码快速解锁。
• 内置会话管理，30 天免登录可手动吊销。

5 分钟安装：三种常用姿势

1. 懒人脚本（推荐）

git clone https://github.com/wilqq-the/BTC-Tracker.git
cd BTC-Tracker
chmod +x run-app.sh && ./run-app.sh

脚本会自动检测 Docker 或 Podman，拉镜像并映射本地 ./data 持久化存储。

2. Windows 桌面版

1. Releases 页面下载 BTC-Tracker-Setup.exe；
2. 双击下一步下一步；
3. 首次启动会弹出 CMD 解包 Node，几秒后自动消失。

3. 纯 Docker 一行

docker run -d --name btc-tracker -p 3000:3000 \
  -v "$(pwd)/data:/app/src/data" \
  docker.io/thewilqq/btc-tracker:latest

升级三板斧：

docker pull thewilqq/btc-tracker:latest
docker stop btc-tracker && docker rm btc-tracker
# 重新执行 docker run ...

深度玩法：让 BTC Tracker 替你打工

1. 批量导入

入口：Admin Panel → Upload CSV。官方提供「多空三列」模板：日期、数量、成本价（法币）。

小技巧：把交易所导出的格式改列名即可直接拖进去。

2. 只读 API Key 同步

目前支持 Binance、Coinbase、Kraken、Strike。仅需勾选「读取」权限，系统每 6 小时拉一次增量订单。你的转账密钥仍安全地握在自己手里。

3. 观影模式

Dashboard 右上角有「剧场按钮」，点击后图表自动轮播，当日收益变化像 PPT 翻页，适合做公开分享时充当背景。

想要感受一下「本地 Charts 丝滑」👉 再点这里立即跳转

常见问题 FAQ

Q1：可以追踪其他币吗？
A：目前仅支持 BTC，其余币种尚在路线图上，保持关注即可。

Q2：数据丢失怎么办？
A：BTC Tracker 把 data 文件夹当全部身家，定时备份到网盘或移动硬盘即可。JSON 格式可读性强，万一系统崩溃也能手工修复。

Q3：Yahoo 行情断了怎么办？
A：引擎内置三级容错：先 Yahoo、再 CoinGecko、最后缓存快照。断网情况下也能用最后一次行情继续查看历史曲线。

Q4：Docker 镜像多大？
A：压缩后约 80 MB，基于 Alpine，树莓派也跑得动。

Q5：如何自定义法币？
A：编辑根目录的 config/currencies.json，在 "supported" 数组里新增项即可，重启挂载后即可生效。

Q6：有没有 PWA（Add to Home Screen）？
A：已点亮 Service Worker，浏览器地址栏右侧点「安装到主屏」即可获得离线图表+推送提醒能力。

结语

用 BTC Tracker 追盘、记帐、复盘，真正的「四位一体」：无月费、无门槛、无广告、无隐私泄露。装上它，你的比特币仓位才真正算「自己人在管钱」。如果你已经跃跃欲试，不妨 现在就 fork 仓库，5 分钟跑起来，在「localhost:3000」里看属于自己的第一条绿色收益曲线。