wakapi
SHA-256一款轻量级、自托管的编码统计工具,兼容 WakaTime 客户端。
스마트 다운로드
Download 버전 다운로드
v2.17.3 · 14 MB
自己搭的编程时间统计站,免费、可控、兼容 WakaTime。
주요 기능
- 完全免费开源,数据自己掌控
- 支持 Docker、编译、云服务多种部署方式
- 自动统计项目、语言、编辑器、操作系统等维度
- 生成酷炫的网页徽章和每周邮件报告
- 提供 REST API 和 Prometheus 导出接口
할 수 없는 것
- •首次运行请务必设置 WAKAPI_PASSWORD_SALT 环境变量,否则密码加密不安全。2. 使用 SQLite 时数据保存在容器内,升级容器前记得备份数据卷。3. 公网部署建议配置 HTTPS 反向代理(如 Nginx/Caddy)。4. 默认端口 3000,注意防火墙放行。5. 若同时使用官方 WakaTime,需要在客户端配置两套 API URL(详见文档)。
사용 사례
- 个人开发者想记录自己每天的编码时长和项目分布
- 团队内部想搭建私有的开发效率看板,不依赖外部服务
- 从 WakaTime 云服务迁移到自托管以保护隐私
상세 설명
Wakapi 是一款完全开源、可自行托管的编程时间统计后台。它通过 WakaTime 的编辑器插件自动收集你的编码活动,并提供直观的仪表盘、数据徽章、每周邮件报告以及 REST API。支持 SQLite、MySQL 和 PostgreSQL 数据库,可使用 Docker 一键部署或从源码编译运行。相比官方的 WakaTime 云服务,Wakapi 让你掌握数据所有权,且完全免费无限制。
문제 해결 & FAQ (2)
문제 해결How to fix SSRF vulnerability in WakaTime relay middleware via WakatimeApiUrl?
Wakapi를 최신 버전으로 업데이트하세요. 해당 수정(커밋 2af65a058730bd2e2cd603e3dbdb883e5badff34)은 WakatimeApiUrl을 검증하여 사설 IP를 거부하고 허용된 호스트의 허용 목록을 적용합니다.
문제 해결왜 Wakapi 2.17.1이 SQLite에서 마이그레이션을 실행할 때 'SQL logic error near time_real' 오류로 충돌합니까?
이 충돌은 마이그레이션 '20260111-sqlite_real_valued_time_column_heartbeats'의 구문 오류로 인해 발생합니다. 이 문제를 해결하려면 패치된 버전의 Wakapi로 업그레이드하거나(수정 릴리스에 대해서는 issue #903 참조) 수동으로 수정을 적용할 수 있습니다: 1. Wakapi를 중지합니다. 2. sqlite3를 사용하여 올바른 ALTER TABLE 명령을 실행합니다: ALTER TABLE heartbeats ADD COLUMN time_real REAL; 3. 행을 삽입하여 마이그레이션이 적용되었음을 기록합니다: INSERT INTO schema_migrations VALUES ('20260111-sqlite_real_valued_time_column_heartbeats'); 수동으로 스키마를 변경할 수 없는 경우, 패치된 버전이 제공될 때까지 Wakapi 2.17.0으로 다운그레이드하는 것이 임시 해결 방법으로 남아 있습니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
步骤1:使用 Docker 运行(推荐)。执行:docker run -d -p 3000:3000 -e WAKAPI_PASSWORD_SALT=你的随机盐值 -v wakapi-data:/data --name wakapi ghcr.io/muety/wakapi:latest
步骤2:打开浏览器访问 http://localhost:3000,注册账号,在设置页面获取 API Key
步骤3:在本机编辑器安装 WakaTime 插件,编辑 ~/.wakatime.cfg,将 api_url 设为 http://localhost:3000/api,api_key 填入上一步获取的 Key
- 步骤1:使用 Docker 运行(推荐)。执行:docker run -d -p 3000:3000 -e WAKAPI_PASSWORD_SALT=你的随机盐值 -v wakapi-data:/data --name wakapi ghcr.io/muety/wakapi:latest
- 步骤2:打开浏览器访问 http://localhost:3000,注册账号,在设置页面获取 API Key
- 步骤3:在本机编辑器安装 WakaTime 插件,编辑 ~/.wakatime.cfg,将 api_url 设为 http://localhost:3000/api,api_key 填入上一步获取的 Key
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
a422be12dedb76f7c5720e7616e8556de64f84aba708c9eae197217ba9011b4f이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
停止 Docker 容器:docker stop wakapi && docker rm wakapi;删除数据卷(可选):docker volume rm wakapi-data。如果是从源码编译安装,直接删除二进制文件和配置文件即可。
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs