1Panel 部署 Vaultwarden：配置管理员密码与开启邀请注册指南

一、核心步骤：编辑 Compose 文件

进入应用详情
登录 1Panel -> 应用商店 -> 已安装 -> 点击 Vaultwarden。

打开编辑器
点击页面上的 “高级”（或“更多”）按钮，选择 “编辑 Compose”。

添加环境变量
在 services -> vaultwarden -> environment 列表中，按以下格式添加两行代码：

environment:
  - SIGNUPS_ALLOWED=false
  # 新增下面两行 (注意：横杠后有空格，等号前后无空格)
  - ADMIN_TOKEN=你的强密码
  - INVITATIONS_ALLOWED=true

⚠️ 语法警告：

• 每行必须以 - 开头。
• KEY=VALUE 中间严禁空格（例如：ADMIN_TOKEN=123 是对的，ADMIN_TOKEN = 123 是错的）。
• 保持与上方代码一致的缩进。

保存并重启
点击“确认”保存，系统会自动重建容器使配置生效。

二、验证与使用

• 访问后台：浏览器打开 http://IP:端口/admin。
• 登录：输入刚才设置的 ADMIN_TOKEN 密码。
• 邀请用户：登录后进入 "Users" 菜单，即可发送邀请链接（因开启了 INVITATIONS_ALLOWED=true，普通注册已关闭）。

三、重要提示：关于应用升级

由于是直接修改了 Compose 文件，当你在 1Panel 点击“升级”应用时，自定义的配置可能会被官方新模板覆盖而丢失。

解决方案：

1. 升级前：截图或复制你添加的 ADMIN_TOKEN 和 INVITATIONS_ALLOWED 代码行。
2. 升级后：立即再次进入“编辑 Compose”，将这两行代码补回去，并保存重启。

(注：Vaultwarden 版本迭代稳定，无需频繁升级，此手动维护成本极低。)

四、进阶：消除明文密码警告（可选）

若管理面板提示“明文密码不安全”，可替换为哈希值：

1. 进入应用 “终端”。
2. 执行 vaultwarden hash，输入密码获取 argon2id$... 字符串。
3. 在 Compose 文件中，将 ADMIN_TOKEN 的值替换为该字符串。
4. 保存重启。