一世贪欢的私域

一世贪欢的私域

vaultwarden 安装

2025-09-30
vaultwarden 安装

vaultwarden 安装

一、介绍

Bitwarden 是一个开源的密码管理软件,可以由用户自行部署使用。不过官方的服务占用空间大(使用MSSQL),部署复杂,所以有开源的第三方,使用 Rust 编写的项目,bitwarden_rs ,后来改名为 vaultwarden

默认的 vaultwarden 镜像使用sqlite 作为后端的数据库存储,自己并不喜欢,换成了 postgres 数据库。

二、Docker部署

自己现在钟爱 docker-compose 来部署,挂载出关键数据,定期备份到腾讯云对象存储,很是方便。

即使遇到迁移服务器,也只需要下载解压,然后重新up 就可重新恢复,添加反向代理即可。

mdkir /opt/selfhost/vaultwarden
cd /opt/selfhost/vaultwarden
cat > docker-compose.yaml
version: "3.8"
services:
  db:
    image: postgres:15-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: vaultwarden
      POSTGRES_PASSWORD: yourStrongPass
      POSTGRES_DB: vaultwarden
    volumes:
      - ./postgres-data:/var/lib/postgresql/data

  vaultwarden:
    image: vaultwarden/server:1.34.3
    depends_on:
      - db
    restart: unless-stopped
    environment:
      DATABASE_URL: "postgres://vaultwarden:yourStrongPass@db:5432/vaultwarden"
      DOMAIN: "https://your.domain.com"
      # ADMIN_TOKEN: 强管理员后台密码
    ports:
      - "80:80"
    volumes:
      - ./vw-data:/data

启动

docker compose up -d

三、配置

3.1 翻译

管理界面默认是英文的,需要翻译成中文。

mkdir -p /opt/selfhost/vaultwarden/vw-data/templates

下载语言包,参考资料

cd ~
git clone https://github.com/wcjxixi/vaultwarden-lang-zhcn
cp -r ~/vaultwarden-lang-zhcn/admin /opt/selfhost/vaultwarden/vw-data/templates
cp -r ~/vaultwarden-lang-zhcn/email\ -\ v1.32.4/ /opt/selfhost/vaultwarden/vw-data/templates
mv /opt/selfhost/vaultwarden/vw-data/templates/email\ -\ v1.32.4/ /opt/selfhost/vaultwarden/vw-data/templates/email

重启vaultwarden

cd /opt/selfhost/vaultwarden
docker compose down
docker compose up -d

3.2 SMTP邮件服务

添加环境变量

ADMIN_TOKEN

进入/admin 后台后设置 SMTP 即可。

3.3 获取真实IP

进入 /admin 后台设置,Client IP header

X-Forwarded-For

3.4 自定义样式

官方文档,新版本已经支持自定义css。

mkdir -p /opt/selfhost/vaultwarden/vw-data/templates/scss

编辑要插入的 css 文件。

vim /opt/selfhost/vaultwarden/vw-data/templates/scss/user.vaultwarden.scss.hbs
/* 页脚文字 */
footer::after {
  content: "Power by 浅空";
  display: block;
  text-align: center;
  margin-top: 10px;
  font-size: 12px;
  color: #007bff;
}

四、封面图

封面图