参考资料

仓库地址：vaultwarden

Docker Hub 地址：vaultwarden | Docker Hub

非官方中文文档地址：非官方中文文档地址

非官方同步仓库地址：vaultwarden-backup

部署教程

docker run -d \
	--name vaultwarden \
	-e SIGNUPS_ALLOWED=false \
	-e INVITATIONS_ALLOWED=false \
	-e ADMIN_TOKEN=some_random_token \
	-e LOG_FILE=/data/vaultwarden.log \
    -e PUSH_ENABLED=true \
    -e PUSH_INSTALLATION_ID=xxxxxx \
    -e PUSH_INSTALLATION_KEY=xxxxxx \
	-v /vw-data/:/data/ \
	--restart unless-stopped \
	-p 8080:80 \
	vaultwarden/server:latest

解释命令含义

• docker run -d：启动一个新的 Docker 容器，并以后台模式运行。
• --name vaultwarden：容器被命名为 vaultwarden。
• -e SIGNUPS_ALLOWED=false：禁用用户注册功能，允许用户注册应将此值设置为true或不设置此变量。
• -e INVITATIONS_ALLOWED=false：禁用邀请功能，即使管理员也无法通过邀请链接添加新用户。
• -e ADMIN_TOKEN=some_random_token：配置管理员令牌，用于访问 Vaultwarden 的管理界面。some_random_token 替换为一个随机生成的令牌。
• -e LOG_FILE=/data/vaultwarden.log：指定日志文件的路径为 /data/vaultwarden.log。由于挂载了主机目录 /vw-data/ 到容器的 /data/，实际日志文件会存储在主机的 /vw-data/vaultwarden.log。
• -e PUSH_ENABLED：激活移动客户端的推送通知，以在移动应用程序、网页扩展程序和网页密码库之间自动同步您的个人密码库，而无需手动同步。
• -e PUSH_INSTALLATION_ID：访问 https://bitwarden.com/host/，获取的Installation ID。
• -e PUSH_INSTALLATION_KEY：访问 https://bitwarden.com/host/，获取的Installation Key。

注

变量PUSH_ENABLED、PUSH_INSTALLATION_ID和PUSH_INSTALLATION_KEY要一起使用。

提示

如果访问 https://bitwarden.com/host/时获取ID和KEY时，选择的地区是美国（US）只需要使用变量PUSH_ENABLED、PUSH_INSTALLATION_ID和PUSH_INSTALLATION_KEY。

如果访问 https://bitwarden.com/host/时获取ID和KEY时，选择的地区是欧盟（EU）除需要使用变量PUSH_ENABLED、PUSH_INSTALLATION_ID和PUSH_INSTALLATION_KEY外，还需要添加如下两个变量PUSH_RELAY_URI和PUSH_IDENTITY_URI。

• -e PUSH_RELAY_URI=https://api.bitwarden.eu
• -e PUSH_IDENTITY_URI=https://identity.bitwarden.eu
• -v /vw-data/:/data/：将主机上的目录 /vw-data/ 挂载到容器内的 /data/ 目录。
• --restart unless-stopped：容器在非手动停止的情况下，容器会自动启动。
• -p 8080:80：将主机的端口 8080 映射到容器的端口 80。
• vaultwarden/server:latest：使用 vaultwarden/server 镜像的最新版本（latest 标签）来启动容器。

反代

• 安装nginx

apt install nginx

• 编辑nginx.conf

vim /etc/nginx/nginx.conf
nano /etc/nginx/nginx.conf

• nginx.conf内容如下

# 定义 Nginx 的主配置文件
user  www-data;
worker_processes  auto;

error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile        on;
    tcp_nopush      on;
    tcp_nodelay     on;
    keepalive_timeout  65;
    types_hash_max_size 2048;

    # 配置虚拟主机 example.com
    server {
        listen 80;
        server_name example.com;

        # 强制 HTTPS 跳转
        return 301 https://$host$request_uri;
    }

    server {
        listen 443 ssl http2;
        server_name example.com;

        # SSL 配置
        ssl_certificate      /vw-data/ssl/example.com.pem;
        ssl_certificate_key  /vw-data/ssl/example.com.key;

        # SSL 安全配置（可选，推荐）
        ssl_protocols TLSv1.2 TLSv1.3;
        ssl_ciphers HIGH:!aNULL:!MD5;
        ssl_prefer_server_ciphers on;

        # 日志配置
        access_log /var/log/nginx/example.com.access.log;
        error_log  /var/log/nginx/example.com.error.log;

        # 反向代理配置
        location / {
            proxy_pass http://127.0.0.1:8080;  # 反代到本地 8080 端口
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
}

• 重新加载nginx.conf

systemctl reload nginx.service

迁移

将现有服务器的/vw-data/文件夹打包，复制到新服务器容器映射的文件夹。