Sentry自托管服务部署问题排查：容器缺失与访问失败的解决方案

问题现象

在使用Sentry官方提供的self-hosted项目进行本地化部署时，用户按照标准流程执行安装脚本后，发现Docker容器列表中缺失关键服务组件（web/nginx/relay），导致无法通过9000端口访问Web界面。通过检查容器列表，仅能看到memcached、snuba-api等基础服务容器在运行。

技术背景

Sentry的自托管方案采用微服务架构，其Docker Compose编排文件定义了多个核心服务模块：

• web：承载Sentry主应用服务
• nginx：作为反向代理处理HTTP请求
• relay：负责事件数据的接收和转发 这些核心组件的缺失会直接导致系统不可用。

原因分析

通过日志审查发现，虽然安装脚本中包含了$dc up -d命令（其中$dc为docker compose的别名变量），但实际执行时该命令未被触发。这种情况通常由以下原因导致：

1. 脚本执行过程中遇到环境检查未通过
2. 用户权限问题导致命令执行中断
3. 脚本中的条件判断跳过了启动步骤

解决方案

完整的部署流程应包含两个关键步骤：

1. 运行安装脚本初始化环境

./install.sh

2. 手动启动Docker服务栈

docker compose up -d

最佳实践建议

1. 部署验证：安装完成后务必检查所有容器状态

docker ps -a | grep sentry

2. 日志审查：安装过程中应实时监控输出日志，特别关注任何错误或警告信息

3. 端口检查：验证9000端口监听状态

netstat -tulnp | grep 9000

4. 健康检查：所有容器启动后，建议等待2-3分钟待服务完全初始化

技术总结

Sentry的自托管部署虽然提供了便捷的安装脚本，但在实际环境中可能因各种因素导致部分步骤未能完整执行。运维人员需要具备基础的Docker编排知识，掌握服务状态检查方法。当遇到服务不可用时，应按照容器状态→服务日志→网络连接的顺序进行系统性排查，这种思路同样适用于其他基于Docker Compose的微服务部署场景。