# 5.更新 Vaultwarden 镜像
{% hint style="success" %}
对应的[官方页面地址](https://github.com/dani-garcia/vaultwarden/wiki/Updating-the-vaultwarden-image)
{% endhint %}
更新非常简单，您只需确保保留了已挂载的卷。如果您使用[此处](/container-image-usage/starting-a-container.md)示例中的 bind-mounted 路径（绑定挂载路径）的方式，则只需使用 `pull` 拉取最新版本的镜像，再使用 `stop` 和 `rm` 来停止和移除当前容器，然后与之前相同的方式启动一个新的容器即可：
```shell
# 拉取最新版本的镜像
docker pull vaultwarden/server:latest
# 停止并移除旧版本容器
docker stop vaultwarden
docker rm vaultwarden
# 使用已挂载的数据启动容器
docker run -d --name vaultwarden -v /vw-data/:/data/ -p 80:80 vaultwarden/server:latest
```
然后访问 [http://localhost:80](http://localhost/)
如果您没有为持久性数据绑定挂载卷，则多一个中间步骤，就是使用中间容器来保留数据：
```shell
# 拉取最新版本的镜像
docker pull vaultwarden/server:latest
# 创建中间容器以保留数据
docker run --volumes-from vaultwarden --name vaultwarden_data busybox true
# 停止并移除旧版本容器
docker stop vaultwarden
docker rm vaultwarden
# 使用已挂载的数据启动容器
docker run -d --volumes-from vaultwarden_data --name vaultwarden -p 80:80 vaultwarden/server:latest
# 移除中间容器（可选）
docker rm vaultwarden_data
# 您可以保留数据容器以用于将来的更新，这样的话，可以跳过最后的移除中间容器这一步。
```
您也可以使用 [Watchtower](https://containrrr.dev/watchtower/) 这样的工具来自动化更新过程。Watchtower 可以定期检查 Docker 镜像的更新，拉取更新后的镜像，并使用更新后的镜像重新创建容器。
## 使用 Docker Compose 时的更新
```shell
docker compose pull # 或者 `docker-compose pull` 如果使用后独立的 Docker Compose 的话
docker compose up -d # 或者 `docker-compose up -d` 如果使用后独立的 Docker Compose 的话
```
## 使用 systemd 服务时的更新（在本例中为 Debian/Raspbian）
```shell
sudo systemctl restart vaultwarden.service
sudo docker system prune -f
# 警告！这将删除已停止或未使用的容器，例如与 Vaultwarden 无关的容器
# 请仔细查看哪个容器是您需要的
docker ps -a
# 查看已停止的容器
#WARNING! This will remove:
# - all stopped #containers
# - all networks not used by at least one container
# - all dangling images
# - all dangling build cache
# 使用以下命令列出所有 Docker 镜像
docker images
# 这里您将看到所有未使用的镜像
#
```
`restart` 命令将会依次停止容器、提取最新镜像、然后运行容器。`prune` 命令将会移除当前较旧的容器（`-f` 表示不需要确认）。
如果需要，可以将它们放入 cronjob 中以计划任务自动运行（根据您的需要修改时间）：
```shell
$ sudo crontab -e
0 2 * * * sudo systemctl restart vaultwarden.service
0 3 * * * sudo /usr/bin/docker system prune -f
```
如果 `/usr/bin/docker` 不是 docker 的正确路径，可以使用 `which docker` 命令查看它的实际路径。
## 使用 DietPi 时的更新
[DietPi](https://dietpi.com/) 是一个轻量级的基于 Debian 的发行版（镜像），适用于各种设备，例如 Raspberry Pi、Odroid、NanoPi 等。它提供了一个软件脚本，用于安装包括 Vaultwarden 在内的各种程序。这样可以让用户免去使用安装命令的烦恼。
Vaultwarden 的更新必须由用户在 DietPi 上手动启动，没有自动安装方式，运行 `apt update && apt upgrade` 也不会执行更新。要更新以前使用 DietPi 软件安装脚本安装的 Vautwarden 实例，请在 DietPi 的命令行中输入以下命令：
```sh
dietpi-software reinstall 183
```
建议使用 DietPi 8.7 或更新版本，因为与以前的版本相比，更新过程已大大加快。
如果您自定义了 Vaultwarden 的配置文件，它将被更新脚本保留。
---
# 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://rs.ppgg.in/container-image-usage/updating-the-vaultwarden-image.md?ask=
```
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.