跳至主要內容

Vaultwarden 部署与使用

知秋一叶2026/6/11...大约 2 分钟
0

⚠️ 重要安全提示​：密码管理器必须通过 HTTPS 访问，否则浏览器扩展和移动客户端将无法连接。请务必先完成 Lucky 反向代理和 SSL 证书配置。

一、Docker Compose 部署

  1. 创建工作目录
mkdir -p /opt/vaultwarden
cd /opt/vaultwarden
  1. 创建 docker-compose.yml 文件
services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    ports:
      - "8080:80"      # Web 界面端口
    volumes:
      - ./data:/data    # 数据库和附件存储
    environment:
      - TZ=Asia/Shanghai
      - SIGNUPS_ALLOWED=true  # 首次部署时开启，创建完账户后改为 false
      - DOMAIN=https://vault.yourdomain.com  # 替换为你的域名（必须）
    restart: unless-stopped
  1. 启动服务
docker compose up -d

# 查看启动日志
docker compose logs -f

二、必须的安全配置

  1. 创建管理员账户

    • 访问 http://<Armbian_IP>:8080
    • 点击 ​创建账户，输入邮箱和主密码
    • 登录后测试基本功能正常

  2. 禁用新用户注册

    • 编辑 docker-compose.yml​，将 SIGNUPS_ALLOWED​ 改为 false
    • 重启服务：docker compose up -d

  3. 访问管理界面

    • 访问 https://vault.yourdomain.com/admin
    • 输入你在 ADMIN_TOKEN 中设置的令牌
    • 在这里可以管理用户、查看系统状态和配置高级选项

三、客户端连接与使用

Vaultwarden 完全兼容所有官方 Bitwarden 客户端，支持全平台：

客户端平台下载地址
官方客户端Windows/macOS/LinuxBitwarden 官网
浏览器扩展Chrome/Firefox/Edge对应浏览器应用商店
移动客户端Android/iOS应用商店搜索 "Bitwarden"

连接步骤

  1. 打开 Bitwarden 客户端
  2. 点击左上角 设置 → 自托管环境
  3. 输入服务器地址：https://vault.yourdomain.com
  4. 点击 ​保存，返回登录界面
  5. 输入你创建的邮箱和主密码，点击 登录
最近更新: