Docker Compose 是一个用于定义和配置多容器应用程序的工具。在我们的例子中,我们希望 Vaultwarden 服务器和代理都将 WebSocket 请求重定向到正确的地方。
无反向代理/您自己配置的反向代理的最小模板(以下以 Caddy 为例)
此示例假设您已安装 Docker Compose。此配置可用于不向「外界」开放的本地服务器,也可用作反向代理的模板。
首先在您喜欢的位置创建一个新目录,然后更改到该目录下。然后,创建 compose.yml
文件(旧版本为 docker-compose.yml
):
services:
vaultwarden:
image: vaultwarden/server:latest
container_name: vaultwarden
restart: always
environment:
# DOMAIN: "https://vaultwarden.example.com" # 使用反向代理时必填;您的域名;Vaultwarden 需要知道它是 https 才能正确处理附件
SIGNUPS_ALLOWED: "true" # 创建账户后,使用 "false" 停用此选项,这样就不会有陌生人注册了
卷
volumes:
- ./vw-data:/data # : 前面的路径可以修改
ports:
- 11001:80 # 您可以将 11001 替换为您喜欢的端口
要创建然后运行容器,请运行:
docker compose up -d && docker compose logs -f
要更新然后运行容器,请运行:
docker compose pull && docker compose up -d && docker compose logs -f
带有 HTTP 挑战的 Caddy
本示例假定您已安装 Docker Compose,并且您的 Vaultwarden 实例具有一个可以公开访问的域名(例如 vaultwarden.example.com
)。
Docker Compose 可能以 docker-compose <command> ...
(带破折号)或 docker compose <command> ...
(带空格)运行,具体取决于您安装 Docker Compose 的方式。当 Docker Compose 作为独立的可执行文件分发时,docker-compose
是原始语法。您也可以选择进行独立安装,在这种情况下将继续使用此语法。但是,Docker 目前建议将 Docker Compose 作为 Docker 插件安装,其中 compose
作为 docker
的子命令,其语法为 docker compose <command> ...
。
首先创建一个新的目录,然后切换到该目录下。接下来,创建如下的 compose.yml
文件(旧版本为 docker-compose.yml
),确保将 DOMAIN
和 EMAIL
变量替换为实际的值。
services:
vaultwarden:
image: vaultwarden/server:latest
container_name: vaultwarden
restart: always
environment:
DOMAIN: "https://vaultwarden.example.com" # 您的域名;Vaultwarden 需要知道它是 https 才能正确处理附件
SIGNUPS_ALLOWED: "true"
volumes:
- /vw-data:/data
caddy:
image: caddy:2
container_name: caddy
restart: always
ports:
- 80:80 # ACME HTTP-01 验证需要
- 443:443
- 443:443/udp # HTTP/3 需要
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- ./caddy-config:/config
- ./caddy-data:/data
environment:
DOMAIN: "https://vaultwarden.example.com" # 您的域名,以 http 或 https 作为前缀
EMAIL: "admin@example.com" # 用于 ACME 注册的电子邮件地址
LOG_FILE: "/data/access.log"
在相同的目录下创建如下的 Caddyfile
文件(此文件不需要做修改):
{$DOMAIN} {
log {
level INFO
output file {$LOG_FILE} {
roll_size 10MB
roll_keep 10
}
}
# 使用 ACME HTTP-01 验证方式为已配置的域名获取证书
tls {$EMAIL}
# 此设置可能会在某些浏览器上出现兼容性问题(例如,在 Firefox 上下载附件)
# 如果遇到问题,请尝试禁用此功能
encode zstd gzip
# 将所有代理到 Rocket
reverse_proxy vaultwarden:80 {
# 把真实的远程 IP 发送给 Rocket,让 Vaultwarden 把其放在日志中
# 这样 fail2ban 就可以阻止正确的 IP 了
header_up X-Real-IP {remote_host}
}
}
运行以下命令创建并启动容器。这将为 compose.yml
文件(旧版本为 docker-compose.yml
)中的服务创建私有网络,这样就只有 Caddy 暴露在外面了:
docker compose up -d # 或者 'docker-compose up -d' 如果使用独立的 Docker Compose 的话
停止并销毁容器:
docker compose down # 或者 'docker-compose down' 如果使用独立的 Docker Compose 的话
此处提供了一个类似的基于 Caddy 的适用于 Synology 的示例。
带有 DNS 挑战的 Caddy
这个示例和上一个示例一样,但适用于您不希望您的实例被公开访问的情况(即您只能从您的本地网络访问它)。这个示例使用 Duck DNS 作为 DNS 提供商。更多的背景资料,以及如何设置 Duck DNS 的细节,请参考使用 Let's Encrypt 证书运行私有 Vaultwarden 实例。
首先创建一个新的目录,然后切换到该目录下。接下来,创建如下的 compose.yml
文件(旧版本为 docker-compose.yml
),确保将 DOMAIN
和 EMAIL
变量替换为实际的值。
services:
vaultwarden:
image: vaultwarden/server:latest
container_name: vaultwarden
restart: always
environment:
DOMAIN: "https://vaultwarden.example.com" # 您的域名;Vaultwarden 需要知道它是 https 才能正确处理附件
volumes:
- /vw-data:/data
caddy:
image: caddy:2
container_name: caddy
restart: always
ports:
- 80:80
- 443:443
- 443:443/udp # HTTP/3 需要
volumes:
- ./caddy:/usr/bin/caddy # 您的 Caddy 自定义构建
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- ./caddy-config:/config
- ./caddy-data:/data
environment:
DOMAIN: "https://vaultwarden.example.com" # 您的域名,以 http 或 https 作为前缀
EMAIL: "admin@example.com" # 用于 ACME 注册的电子邮件地址
DUCKDNS_TOKEN: "<token>" # 您的 Duck DNS 令牌
LOG_FILE: "/data/access.log"
原有的 Caddy 构建(包括 Docker 映像中的构建)不包含 DNS 挑战模块,因此接下来您需要获取自定义 Caddy 构建。将自定义构建重命名为 caddy
并将其移动到与 compose.yml
(旧版本为 docker-compose.yml
)相同的目录下。确保 caddy
文件是可执行的(例如 chmod a + x caddy
)。上面的 compose.yml
文件(旧版本为 docker-compose.yml
)会将自定义构建绑定挂载到 caddy:2
容器中,并替换原有的构建。
在相同的目录下,创建如下的 Caddyfile
文件(此文件不需要做修改)。
{$DOMAIN} {
log {
level INFO
output file {$LOG_FILE} {
roll_size 10MB
roll_keep 10
}
}
# 使用 ACME HTTP-01 验证方式为已配置的域名获取证书
tls {
dns duckdns {$DUCKDNS_TOKEN}
}
# 此设置可能会在某些浏览器上出现兼容性问题(例如,在 Firefox 上下载附件)
# 如果遇到问题,请尝试禁用此功能
encode zstd gzip
# 将所有代理到 Rocket
reverse_proxy vaultwarden:80
}
与 HTTP 挑战的示例一样,运行下面的命令以创建并启动容器:
docker compose up -d # 或者 'docker-compose up -d' 如果使用独立的 Docker Compose 的话