资讯详情

如何10分钟自建错误追踪服务:Rustrak Docker部署完整教程

📅 2026/10/27 10:02:52 | 华诺云谱 👁 阅读
如何10分钟自建错误追踪服务:Rustrak Docker部署完整教程
【免费下载链接】rustrakUltra-lightweight error tracking server compatible with Sentry SDKs项目地址https://gitcode.com/gh_mirrors/ru/rustrak点击查看免费下载Rustrak 是一款超轻量级、自托管的错误追踪Error Tracking服务端完整兼容 Sentry 协议——错误、日志、性能事务、发布健康度与 AI Agent 追踪它一网打尽。得益于默认 SQLite 的单容器设计用 Docker Compose 几条命令即可在 10 分钟内跑起一套属于自己的错误追踪服务本文带你完整走完Rustrak Docker 部署全流程。 为什么选择 Rustrak 做自托管错误追踪优势说明 兼容 Sentry 协议已有的 Sentry SDK 只需把 DSN 改成 Rustrak 地址零代码改造 极致轻量镜像约 20 MB空闲内存低于 100 MB512 MB 的 VPS 就能跑 零外部依赖默认 SQLite无需单独部署数据库一个容器同时提供 API 与仪表盘 完全免费无按事件计费、无座位数、无数据量上限数据留在自己的服务器上整体架构一目了然你的应用 → Sentry SDK → RustrakAPI 仪表盘端口 8080→ SQLite / PostgreSQL️ 部署前准备只需一个前置条件一台安装了Docker和Docker Compose的服务器或本地机器即可。无需数据库、无需消息队列、无需任何中间件。仓库根目录自带开箱即用的编排文件 docker-compose.yml核心内容只有几行services: server: image: rustrak/rustrak-server:latest ports: - 8080:8080 environment: - SESSION_SECRET_KEY${SESSION_SECRET_KEY} - CREATE_SUPERUSER${CREATE_SUPERUSER} volumes: - rustrak_data:/data restart: unless-stopped volumes: rustrak_data:三个必须了解的关键变量完整清单见 apps/docs/content/configuration/environment.mdx变量作用示例SESSION_SECRET_KEY会话 Cookie 签名密钥必须固定否则重启后全员掉线openssl rand -hex 32生成CREATE_SUPERUSER首个管理员账号格式email:passwordadminexample.com:changeme123PUBLIC_URL写入每个 DSN 的对外访问地址不设置会导致 DSN 出现0.0.0.0http://localhost:8080 最快部署方法Docker Compose 三步启动第 1 步生成密钥并导出环境变量export SESSION_SECRET_KEY$(openssl rand -hex 32) export CREATE_SUPERUSERadminexample.com:changeme123 export PUBLIC_URLhttp://localhost:8080第 2 步一条命令启动docker compose up -d第 3 步打开仪表盘浏览器访问http://localhost:8080登录页在/login用CREATE_SUPERUSER里的邮箱密码登录。一个容器同时响应 API 和 Web 界面没有第二个端口要记。⚡CREATE_SUPERUSER只在数据库中还没有任何用户时生效之后修改它不会改变密码。 备选方案不用 Compose单条 docker run 命令更喜欢docker run的话官方安装指南 apps/docs/content/getting-started/installation.mdx 给出了等价写法docker run -d \ --name rustrak \ -p 8080:8080 \ -v rustrak_data:/data \ -e SESSION_SECRET_KEY$(openssl rand -hex 32) \ -e CREATE_SUPERUSERadminexample.com:changeme123 \ -e PUBLIC_URLhttp://localhost:8080 \ rustrak/rustrak-server:latest注意-v rustrak_data:/data这个命名卷SQLite 数据库和上传的 source map 都存在这里保住它数据就能跨重启和版本升级存活。 接入 Sentry SDK只改一行 DSN登录仪表盘后点击New Project创建项目 → 复制生成的 DSN形如http://a1b2c3d4localhost:8080/1→ 在你的应用里初始化 SDK# Python import sentry_sdk sentry_sdk.init(dsnhttp://keylocalhost:8080/project_id)// JavaScript Sentry.init({ dsn: http://keylocalhost:8080/project_id });任何语言的 Sentry SDKGo、Rust、Java……都适用。发一条测试事件sentry_sdk.capture_message(Hello from Rustrak!)回到仪表盘你的项目下就会出现第一条 Issue ️ 数据库怎么选SQLite 还是 PostgreSQL两个镜像变体都自带仪表盘区别只在存储层镜像标签后端适用场景rustrak/rustrak-server:latestSQLite个人项目、小团队约每小时 1000 事件以内rustrak/rustrak-server:postgresPostgreSQL生产环境、高吞吐、并发写入事件量上来后仓库同样提供了现成的 docker-compose.postgres.yml——它把:postgres镜像与一个postgres:16-alpine服务编排在一起并带健康检查echo POSTGRES_PASSWORD$(openssl rand -hex 16) .env docker compose -f docker-compose.postgres.yml up -d已有自己的 PostgreSQL删掉其中的postgres服务把DATABASE_URL指向现有实例即可docker-compose.postgres.yml 中的连接串就是格式示例。 生产部署关键点上线前 3 件事配置反向代理 HTTPS把容器放进代理网络、删掉ports块让 nginx/Caddy/Traefik 直达8080并设置SSL_PROXYtrue启用安全 Cookie。因为仪表盘和 API 同属一个容器只需配置一个上游路由非常省心。PUBLIC_URL设为公网域名如https://rustrak.example.com它是写进每个 DSN 和告警链接里的地址SDK 必须能从外部访问到。备份/data卷SQLite 模式下数据库位于/data/rustrak.db、source map 在/data/sourcemaps最简单的方式是停服后整卷打包PostgreSQL 模式则记得 source map 仍在/data卷里别漏备。完整的生产检查清单见 apps/docs/content/configuration/production.mdx。❓ 常见问题排查现象原因与解法DSN 里是http://0.0.0.0:8080/...未设置PUBLIC_URLSDK 无法访问绑定地址补上即可容器重启后所有人都被登出SESSION_SECRET_KEY变了请固定同一个值仪表盘打不开检查 8080 端口是否被占用docker logs看启动日志健康检查可用GET /health想只留 API 不要界面设置RUSTRAK_DASHBOARDoff服务将只响应 API 小结回到开头10 分钟这个数字不是营销话术——生成密钥、docker compose up -d、登录、建项目、改一行 DSN全程不到十分钟。Rustrak 用 20 MB 的镜像和不到 100 MB 的内存把「Sentry 级」的错误追踪能力装进了你自己的服务器错误分组、source map 反解、性能分析、发布健康、告警推送一应俱全且数据永远属于你。镜像采用 distroless 最小运行时构建见 apps/server/Dockerfile攻击面小适合长期常驻配合restart: unless-stopped即可安心交给运维。赞分享【免费下载链接】rustrakUltra-lightweight error tracking server compatible with Sentry SDKs项目地址https://gitcode.com/gh_mirrors/ru/rustrak点击查看免费下载相关推荐如何快速搭建KIMI AI免费API服务5分钟Docker部署教程如何快速搭建KIMI AI免费API服务5分钟Docker部署教程 KIMI AI免费API服务是一个强大的开源项目让你能够快速搭建与月之暗面KIMI AIAI 应用后端如何快速搭建Dendrite10分钟完成Matrix服务器部署如何快速搭建Dendrite10分钟完成Matrix服务器部署 Dendrite是一个用Go语言编写的第二代Matrix家庭服务器实现提供了高性能、可扩展的后端即时通讯PairDrop Docker完整部署教程5分钟搭建高效文件共享服务PairDrop Docker完整部署教程5分钟搭建高效文件共享服务 想要在局域网内实现跨平台文件共享PairDrop就是你的最佳选择这款基于WebRTC后端前端WebSocket上一篇微信网页版登录失败自救指南3分钟让聊天窗口在浏览器里复活下一篇终极免费指南Windows系统清理工具WindowsCleaner一键释放C盘空间的正确姿势创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。

↑