# 服务器日志

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/server-logs/)
{% endhint %}

本文包含有关访问和配置服务器日志存储的信息。具体内容取决于您的部署方法：

{% tabs %}
{% tab title="Docker" %}

## 实时日志 <a href="#logs-in-real-time" id="logs-in-real-time"></a>

如果您使用 Docker 部署 Bitwarden，请使用 `docker compose logs -f` 命令从终端或命令行实时查看日志。请注意，此命令应从 `/bwdata/docker` 目录运行：

```bash
cd /opt/bitwarden/bwdata/docker
docker compose logs -f
```

## 存储日志 <a href="#logs-in-storage" id="logs-in-storage"></a>

自托管 Bitwarden 服务器生成的日志默认存储在 `bwdata/logs/` 。

要更改默认的日志存储位置，请访问您的 `global.override.env` 文件然后将环境变量 `globalSettings__logDirectory=` 设置为所需位置。

更改环境变量后，您需要重启服务器以应用新的配置：

* 如果您使用的是标准部署方法，请使用 `bitwarden.sh` 或 `bitwarden.ps1 restart` 命令。
* 如果您手动或离线部署 Bitwarden，请使用 `docker compose down` 并回退 `up` ，例如：

```bash
docker compose -f ./docker/docker-compose.yml down && docker compose -f ./docker/docker-compose.yml up -d
```

## 下载日志 <a href="#download-logs" id="download-logs"></a>

如果您使用 `bitwarden.sh` 或 `bitwarden.ps1` 安装脚本通过 Docker 部署了 Bitwarden，您还可以使用 `compresslogs` 命令下载所有服务器日志的 tarball，或指定日期范围内的所有服务器日志：

```bash
./bitwarden.sh compresslogs 20240304 20240305
.\bitwarden.ps1 -compresslogs 20240304 20240305
```

{% endtab %}

{% tab title="Helm" %}

## 实时日志 <a href="#logs-in-real-time" id="logs-in-real-time"></a>

默认情况下，Helm 部署的日志是临时的，不会存储在中心位置。服务器运行时，可以通过容器的 stdout 实时访问日志，例如运行以下命令：

```bash
kubectl logs pod api
```

## 存储日志 <a href="#logs-in-storage" id="logs-in-storage"></a>

您可以通过将您的 `my-values.yaml` 文件中的 `volume.logs.enabled:` 值设置为 `true` 来配置服务器将日志保存到持久卷 (PVC)。默认情况下，日志会保存到新的 PVC，但您可以通过配置 `volume.logs.existingClaim:` 值来使用现有的 PVC。
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.ppgg.in/docs/self-hosting/server-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.