## 相关官方文档

https://develop.sentry.dev/self-hosted/email/

https://develop.sentry.dev/services/email/





## 提前准备内容

1. 一个邮箱账号，我这里使用163邮箱
2. 在邮箱内配置授权码
![image.png](https://oss.silon.vip/img/d64cf6bc6a2ef0da29d7f3d21e4f4bc2.image.webp)
![image.png](https://oss.silon.vip/img/7f7f29076de8c905eb0bf890eb4ffdab.image.webp)


## 配置流程

在sentry项目下 `sentry/config.yml`中

找到并修改以下项目

```yml
###############
# Mail Server #
###############
# 邮箱服务类型
mail.backend: 'smtp'  # Use dummy if you want to disable email entirely
# 邮箱服务端地址
mail.host: 'smtp.163.com'
# 使用的协议， smtp 可以使用 25， 465（ssl）， 487（tsl）
mail.port: 465
# 你自己的邮箱地址和授权码，注意这里不是登录密码
mail.username: 'silon_j@163.com'
mail.password: 'xxxxxxxxxxxx'

# sentry发送邮件显示的发件人，同你的邮箱即可
mail.from: 'silon_j@163.com'

# 是否使用tls或ssl
# mail.use-tls: false
mail.use-ssl: true

# 你的sentry 运行的域名
mail.list-namespace: 'sentry.xxx.xxx'

```


:::warning{title="注意"}
如果你使用阿里云搭建sentry服务，则上面的配置不能填写 25端口，因为阿里云官方限制25端口出口

即使通过服务器自行配置出入防火墙都无效，需要向阿里云官方申请

详情可见：
https://developer.aliyun.com/article/1531784?spm=5176.26934566.main.2.479d7d71VXIvik
:::

## 重启服务

返回sentry 根目录，重启服务即可

```
./install.sh
```

## 测试邮件效果 

点击测试，反馈发送成功即为配置成功
![image.png](https://oss.silon.vip/img/f66056a67896bad4507937b9745953f0.image.webp)


![image.png](https://oss.silon.vip/img/fee9bf5710eb4d4b9f950370beddbcb5.image.webp)

Sentry 邮箱配置


## 创建新账户：

执行以下命令创建一个名为"newuser"的账户，并设置密码为"123456"：

`%` 表示不限制用户登录的ip
如果只希望用户从本机登录，可以更改为`localhost`

```sql
CREATE USER 'newuser'@'%' IDENTIFIED BY '123456';
```


## 授予数据库访问权限：

执行以下命令授予"newuser"账户对"app"数据库的访问和操作权限：
```sql
GRANT ALL PRIVILEGES ON app.* TO 'newuser'@'%';
```


## 刷新权限
执行以下命令以使更改生效：
```sql
FLUSH PRIVILEGES;
```


mysql 新建账户并授权

vite preview和serve的区别

# 官方文档
[https://develop.sentry.dev/self-hosted/](https://develop.sentry.dev/self-hosted/)

# 部署流程

## 获取docker镜像

在官方私有化部署的docker项目仓库中，找到指定版本，并下载。官方推荐使用最新的版本

:::warning{title="注意"}
这里不要直接使用master分支，应该下载最新的release版本，保证稳定性  
https://github.com/getsentry/self-hosted/releases
:::

![image.png](https://oss.silon.vip/img/f3723685da13f1cce50f9b078d806234.image.webp)


## 更新dockerfile sources.list镜像源

下载后在项目下执行 `install.sh`，执行后，会自动构建Sentry的docker镜像。

**但是**，该过程会进行apt-get，在国内的网络环境是存在困难的，所以这里需要配置apt-get镜像源

1. 修改文件 jq/Dockerfile

```
FROM debian:bookworm-slim

LABEL MAINTAINER="oss@sentry.io"

RUN set -x \
# 更改 sources.list 为国内阿里镜像源
  && echo "deb http://mirrors.aliyun.com/debian  stable main contrib non-free" > /etc/apt/sources.list  \
  && echo "deb http://mirrors.aliyun.com/debian  stable-updates main contrib non-free" >> /etc/apt/sources.list  \
  && apt-get update -y \
  && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends jq \
  && apt-get clean \
  && rm -rf /var/lib/apt/lists/*

ENTRYPOINT ["jq"]

```
2.  修改 corn/Dockerfile

```
ARG BASE_IMAGE
FROM ${BASE_IMAGE}
USER 0
RUN if [ -z "${http_proxy}" ]; then echo "Acquire::http::proxy \"${http_proxy}\";" >> /etc/apt/apt.conf; fi
RUN if [ -z "${https_proxy}" ]; then echo "Acquire::https::proxy \"${https_proxy}\";" >> /etc/apt/apt.conf; fi
# 更改 sources.list 为国内阿里镜像源
RUN echo "deb http://mirrors.aliyun.com/debian  stable main contrib non-free" > /etc/apt/sources.list  \
  && echo "deb http://mirrors.aliyun.com/debian  stable-updates main contrib non-free" >> /etc/apt/sources.list  \
  && echo "deb https://mirrors.aliyun.com/debian/ bookworm main non-free non-free-firmware contrib" >> /etc/apt/sources.list  \
  && echo "deb-src https://mirrors.aliyun.com/debian/ bookworm main non-free non-free-firmware contrib" >> /etc/apt/sources.list  \
  && echo "deb https://mirrors.aliyun.com/debian-security/ bookworm-security main" >> /etc/apt/sources.list  \
  && echo "deb-src https://mirrors.aliyun.com/debian-security/ bookworm-security main" >> /etc/apt/sources.list  \
  && echo "deb https://mirrors.aliyun.com/debian/ bookworm-updates main non-free non-free-firmware contrib" >> /etc/apt/sources.list  \
  && echo "deb-src https://mirrors.aliyun.com/debian/ bookworm-updates main non-free non-free-firmware contrib" >> /etc/apt/sources.list  \
  && echo "deb https://mirrors.aliyun.com/debian/ bookworm-backports main non-free non-free-firmware contrib" >> /etc/apt/sources.list  \
  && echo "deb-src https://mirrors.aliyun.com/debian/ bookworm-backports main non-free non-free-firmware contrib" >> /etc/apt/sources.list  \
    && apt-get update && apt-get install -y --no-install-recommends cron && \
    rm -r /var/lib/apt/lists/*
COPY entrypoint.sh /entrypoint.sh
ENTRYPOINT ["/entrypoint.sh"]
```

## 修改运行脚本

`install//install-wal2json.sh` 中会从 github中下载文件

如果你的服务器和github访问不稳定，需要修改该下载地址

可以使用开源的gitee仓库，或自己搭建一个容易访问的仓库


![image.png](https://oss.silon.vip/img/0306f7490aa34d34dc09c728119f923a.image.webp)

```
# 使用gitee仓库加速

  docker_curl -L \
    "https://gitee.com/li-jia-dong/wal2json/releases/download/$VERSION/$FILE_NAME" \
    >"$WAL2JSON_DIR/$VERSION/$FILE_NAME"

```

## 开始部署

以上内容都确认过后，就可以开始部署了

部署过程中，会有几次交互

1. 是否愿意发送使用数据，一般选 no
![image.png](https://oss.silon.vip/img/a8f6ac0a67f92bd081370fb8d5287c40.image.webp)

2. 是否要现在创建一个账号
![image.png](https://oss.silon.vip/img/e3a39deefc5199a57da700858817775c.image.webp)


:::tip{title="提示"}
创建账号步骤，填写邮箱后，会等待用户输入密码，看到这里，填写密码回车才能继续
![](https://oss.silon.vip/img/1098bfeedbf8e449779735701ccabc6f.image.webp)
:::


## 服务启动
看到最终提示该内容，说明部署完成

![](https://oss.silon.vip/img/a513ce21b86e73a0d70cbbb32f2392e8.image.webp)

根据提示执行
`docker compose up -d` 即可

过程中会启动极其多的容器，确保全部完成即可

:::danger{title="警告"}
一定注意自己的机器配置。  
Sentry官方说最低系统要求是 2C 4G，完全不够

docker compose的过程，对CPU 和内存要求都高  
实测完成创建所有容器，不接入任何业务的情况，所有Sentry容器占用内存8G左右

所以机器配置至少16G，否则无法完成所有容器创建
:::
![image.png](https://oss.silon.vip/img/7294a6ee0d80175938e5a37a97bc71a2.image.webp)

## 访问Sentry

完成容器创建后，直接访问 http://${ip}:9000 就能访问 Sentry 的 web页面了。  
填写刚才输入的邮箱和密码就可以进入使用了


![image.png](https://oss.silon.vip/img/614b63f0a6b4051734f268109b385a0b.image.webp)

如果登录后提示CSRF 错误

![image.png](https://oss.silon.vip/img/c73c44c6be3af70e8144014beb84aa21.image.webp)

需要在 `sentry.conf.py`中修改 `CSRF_TRUSTED_ORIGINS`

注意：
这里必须带上 http://

```
# 填写可以访问Sentry服务的ip，添加Sentry服务器的ip，被监控服务的ip.
你的Sentry 运行在什么域名下的什么地址，就填什么
CSRF_TRUSTED_ORIGINS = ["https://sentry.example.com", "http://10.100.10.10", "http://127.0.0.1:9000"]
```

修改后无需 docker compose down

直接运行install即可
```
./install.sh
```

运行时会直接重建相关的docker容器


# 私有化部署常见问题解决方案

[官方QA](https://develop.sentry.dev/self-hosted/troubleshooting/)