自托管Sentry文档翻译

最新推荐文章于 2025-06-06 13:08:43 发布

supming1

最新推荐文章于 2025-06-06 13:08:43 发布

阅读量979

点赞数

CC 4.0 BY-SA版权

分类专栏： sentry 文章标签： sentry

原文链接：https://develop.sentry.dev/self-hosted/

sentry 专栏收录该内容

3 篇文章

订阅专栏

Sentry 提供了开源代码及预配置的最小安装选项，适用于简单场景。推荐通过 Docker 和 DockerCompose 进行安装，使用 `./install.sh` 脚本初始化并运行 `docker-compose up -d` 启动服务。主要配置文件包括 `config.yml` 和 `sentry.conf.py`，以及 `.env` 文件进行环境变量覆盖。配置变更后需重启服务。自定义配置涉及邮件、地理位置、单点登录等。生产环境中建议使用负载均衡器，并配置 SSL/TLS。Sentry 不支持多节点扩展，高流量场景需考虑官方服务。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

大部分翻译出来了，部分翻译的不是很通顺，可以结合官方文档阅读。

Sentry除了开源代码之外，还提供并维护了一个最小的设置，对于简单的用例来说，它是现成的. 同时对于展示相关的配置和有用。简单起见，我们采用 Docker和Docker Compose, 并提供安装、升级脚本.

开始

我们的建议是下载最新的self-hosted repository, 然后运行在目录中 ./install.sh . 它会完成所有的东西, 包括一个基础的配置, 然后让你运行 docker-compose up -d 启动 Sentry. Sentry 默认绑定 9000 端口. 访问 http://127.0.0.1:9000.

配置

sentry/config.yml—包含大部分的配置. 这个文件在安装的时候，根据sentry/config.example.yml 生成. 这文件大部分配置都有注释说明。下面是以下常用配置:
1. system.url-prefix (安装完成后，我们会提示您在欢迎屏幕上进行设置)
2. mail.* (虽然我们提供了一个基本的SMTP服务器)
3. GitHub, Slack 等的集成.
sentry/sentry.conf.py—包含更多高级配置. 这个文件在安装的时候，根据 sentry/sentry.conf.example.py 生成.
环境变量—可用的 keys 定义在 .env. 在这里定义的环境变量，会覆盖默认值。避免 Git 改变, 只需创建一个 .env.custom 文件，并写入你的系统依赖的环境变量. 你可以通过运行 docker-compose --env-file /path/to/.env.custom up -d实现.
Geolocation 使用一个自定义的配置文件，适应基础技术

注意

一旦你改变了配置, 你需要重启Sentry 服务，通过运行 docker-compose restart web worker cron sentry-cleanup (或者 docker-compose restart 重启所有的东西).

配置主题

以下是与自托管相关的特定配置主题的进一步信息：

生产

我们建议在你的sentry之前，使用一个专用的负载均衡器，绑定特定的域名或者子域名. 一个负载均衡器作为 SSL/TLS 终端和作为Docker Compose内部网络转发客户端地址，将给你很好的 Sentry 体验. 我们建议配置一个负载均衡健康检查，使用http协议检查 /_health/. 正常返回200错误返回 500.

如果你为sentry设置了负载均衡或者反向代理, 你需要修改 config.yml中的system.url-prefix。 你还要更新sentry/sentry.conf.py中的 SSL/TLS , 否则，你可能会遇到 CSRF-related 错误

所有配置都是单节点的，官方不提供扩展方面的支持，如果流量比较高，需要用官方的服务。