Comment on page
1.配置概述
[译者注]:
1.某些设置只能通过环境变量配置,如管理页面中Read-Only Config
部分的配置(如日志记录) 2.通过管理页面修改配置后马上生效 3.若直接修改config.json
文件,则需要重启 Vaultwarden 才能生效(因为只有启动时才会读取config.json
文件)
注意:
config.json
文件不是配置您的设置的推荐方式!要么使用环境变量,您可以通过多种方式为您的容器环境(Docker、Docker-Compose、K8s 等)进行配置;或者,如果使用独立的二进制文件(其不是由 Vaultwarden 本身分发的),请使用位于当前工作目录下的 .env
文件。在管理界面中保存设置时会创建并覆盖 config.json
文件!在 Vaultwarden 中,您可以通过环境变量或管理页面(将设置写入数据目录下的
config.json
文件中)执行配置。但请务必注意,config.json
文件中的每个设置都会覆盖相应的环境变量设置。例如,如果您设置环境变量为 DOMAIN=https://vaultwarden.example.com
,但您的 config.json
文件中已经包含 "domain": "https://vw.example.com"
,则 Vaultwarden 将基于配置文件中的内容 (https://vw.example.com
) 生成各种链接。造成这种混乱的一个常见原因就是因为启用了管理 页面(创建了
config.json
文件),通过管理页面更改了某些设置(在 config.json
文件中设置相应的值),然后又尝试通过环境变量更改这些设置(此操作无效,因为 config.json
会覆盖环境变量)。为避免这种混乱,强烈建议您采用其中一种配置方式。也就是说,完全通过环境变量或完全通过 config.json
(无论是使用管理页面还是直接编辑 config.json
)进行配置。请注意,管理页面中的
Read-Only Config
部分下的配置设置只能通过环境变量来设置,所以你必须重启 Vaultwarden 才能使对它们的更改生效。如果您将这些环境变量保存在一个名为
.env
的文件中,您可以按照以下方式加载它们:- 对于独立版的 Vaultwarden,将
.env
放到当前工作目录中,Vaultwarden 会在启动时尝试加载这个文件。请注意,Vaultwarden 仅查找名为.env
的环境文件;而不会查找具有其他名称的环境文件。 - 对于 Docker,使用
docker run --env-file <env-file> ...
(让 Docker 加载.env
文件)或docker run -v /path/to/.env:/.env
(让 Vaultwarden 从容器内部加载.env
文件)。请注意,如果使用--env-file
,Docker 不会取消引用值,因此请确保使用key=val
而不是key="val"
或key='val'
。
倘若有错误或遗漏,源代码在这里:https://github.com/dani-garcia/vaultwarden/blob/master/src/config.rs(检索
make_config! {
)或者,如果您的(基于 Chromium)浏览器支持文本片段,则可以直接参考此链接:https://github.com/dani-garcia/vaultwarden/blob/master/src/config.rs#LC290:~:text=make_config!%20%7B,-folders
确保将
DOMAIN
环境变量(或配置文件中的 domain
选项)设置为用于访问 Vaultwarden 实例的 URL。如果不这样做,可能会出现莫名其妙的功能性问题。一些示例:https://vaultwarden.example.com
https://vaultwarden.example.com:8443
(非默认端口)
最近更新 2mo ago