环境配置文件
环境配置文件用于在 Bitwarden 部署完成以后增减某些功能,如配置 SMTP、启用 Yubico、启用系统管理员门户、禁用用户注册等。
环境配置文件位于 ./bwdata/env/global.override.env
其默认内容如下:
global.override.env
1
globalSettings__baseServiceUri__vault=https://vault.bitwarden.in
2
globalSettings__baseServiceUri__api=https://vault.bitwarden.in/api
3
globalSettings__baseServiceUri__identity=https://vault.bitwarden.in/identity
4
globalSettings__baseServiceUri__admin=https://vault.bitwarden.in/admin
5
globalSettings__baseServiceUri__notifications=https://vault.bitwarden.in/notifications
6
globalSettings__baseServiceUri__sso=https://vault.bitwarden.in/sso
7
globalSettings__baseServiceUri__portal=https://vault.bitwarden.in/portal
8
globalSettings__sqlServer__connectionString="Data Source=tcp:mssql,1433;Initial Catalog=vault;Persist Security Info=False;User ID=sa;Password=xGKRrfeggznz5SEAFKAqYPmMNCujUNdK;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=True"
9
globalSettings__identityServer__certificatePassword=UYS4X3urhIikdexM58pNYJ6o535gOxg4
10
globalSettings__attachment__baseDirectory=/etc/bitwarden/core/attachments
11
globalSettings__attachment__baseUrl=https://vault.bitwarden.in/attachments
12
globalSettings__dataProtection__directory=/etc/bitwarden/core/aspnet-dataprotection
13
globalSettings__logDirectory=/etc/bitwarden/logs
14
globalSettings__logRollBySizeLimit=
15
globalSettings__syslog__destination=
16
globalSettings__licenseDirectory=/etc/bitwarden/core/licenses
17
globalSettings__internalIdentityKey=jpGTst16CGZL2BTjvzL5erR2XRTqsWrhBysa4tTomf6KtVXr8TF0hcxuACxVUpt5
18
globalSettings__oidcIdentityClientKey=nZu60QKCaOrpPjF9jxrOHnd07d1RrWXrHp5sxv8C7CL9IBu9w9bhI5s03E8qeyiX
19
globalSettings__duo__aKey=KeW4TH9jYSfmdWGd0c0nROS3TXJHIMdRzNZrw7bHqw0svhE6ePL9jWBiwRRHNc1w
20
globalSettings__installation__id=0e39beb9-5efe-4ebb-919d-ac3e00d7b1c1
21
globalSettings__installation__key=QNruWGv7N0n5UY18f4ay
22
globalSettings__yubico__clientId=REPLACE
23
globalSettings__yubico__key=REPLACE
24
globalSettings__mail__replyToEmail=no-[email protected].bitwarden.in
25
globalSettings__mail__smtp__host=REPLACE
26
globalSettings__mail__smtp__port=587
27
globalSettings__mail__smtp__ssl=false
28
globalSettings__mail__smtp__username=REPLACE
29
globalSettings__mail__smtp__password=REPLACE
30
globalSettings__disableUserRegistration=false
31
globalSettings__hibpApiKey=REPLACE
32
adminSettings__admins=
Copied!
由于环境配置文件只有在 Bitwarden 容器启动时才会被读取,因此,更改环境配置文件后,需要运行重启命令以使更改生效:
1
./bitwarden.sh restart
Copied!
注意环境配置文件中值为 https://vault.bitwarden.in 的所有变量,需要全部修改其值为实际的外部访问地址(包括端口),否则当有链接跳转时,会导致错误,例如验证电子邮件的跳转链接、管理员门户的跳转链接。假设外部访问地址为 https://vault.bitwarden.in:28443,则环境配置文件中值为 https://vault.bitwarden.in 的所有变量的值都要替换为 https://vault.bitwarden.in:28443

已有变量

以下变量在 global.override.env 中已经存在:
变量
描述
globalSettings__sqlServer__connectionString=
globalSettings__oidcIdentityClientKey=
随机生成的 OpenID Connect 客户端密钥。有关更多信息,请参阅 OpenID 文档
globalSettings__duo__aKey=
随机生成的 Duo 密钥。有关更多信息,请参阅 Duo 文档
globalSettings__yubico__clientId=
YubiCloud 验证服务或自托管的 Yubico 验证服务器的客户端 ID。如果是 YubiCloud,请在此处获取您的客户端 ID 和安全密钥。如果是自托管,请参阅可选变量 globalSettings__yubico__validationUrls
globalSettings__yubico__key=
YubiCloud 验证服务或自托管的 Yubico 验证服务器的安全密钥。如果是 YubiCloud,请在此处获取您的客户端 ID 和安全密钥。如果是自托管,请参阅可选变量 globalSettings__yubico__validationUrls
globalSettings__mail__replyToEmail=
用于邀请的电子邮件地址,通常为 [email protected]__host
globalSettings__mail__smtp__host=
SMTP 服务器的主机名(建议)或 IP 地址。
globalSettings__mail__smtp__port=
SMTP 服务器使用的 SMTP 端口。
globalSettings__mail__smtp__ssl=
(布尔值)SMTP 服务器是否使用加密协议: true = SSL false = TLS
globalSettings__mail__smtp__username=
smtp__host 的有效用户名。
globalSettings__mail__smtp__password=
smtp__host 的有效密码。
globalSettings__disableUserRegistration=
指定为 true 将禁用新用户通过注册页面在此实例上注册账户。
globalSettings__hibpApiKey=
您的 HaveIBeenPwned (HIBP) API 密钥,参阅此处
adminSettings__admins=
用于访问系统管理员门户的电子邮件地址。

可选变量

以下变量在 global.override.env 中尚不存在,但可以手动添加:
变量
描述
globalSettings__logDirectory=
指定日志文件的保存目录。默认为 globalSettings__logDirectory=bwdata/logs
globalSettings__logRollBySizeLimit=
开启滚动日志并指定滚动日志文件的大小限制,以字节为单位(例如开启并设置为 1GB globalSettings__logRollBySizeLimit=1073741824 )。
globalSettings__syslog__destination=
指定要将日志文件发送到的 Syslog 服务器或端点(例如 globalSettings__syslog__destination=udp://example.com:514)。
globalSettings__mail__smtp__trustServer=
指定为 true 将以显式信任 SMTP 服务器提供的证书(不建议用于生产中)。
globalSettings__mail__smtp__sslOverride=
指定为 true 将在端口 25 上使用 SSL(而不是 TLS)。
globalSettings__mail__smtp__startTls=
指定为 true 将强制 STARTTLS(随机 TLS)。
globalSettings__organizationInviteExpirationHours=
指定组织邀请到期的小时数。默认为 120 小时。
globalSettings__yubico__validationUrls__0=
自托管 Yubico 验证服务器的主要地址。例如:globalSettings__yubico__validationUrls__0=https://your.url.com/wsapi/2.0/verify
通过创建递增的环境变量来添加其他验证服务器 URL,例如: globalSettings__yubico__validationUrls__1=globalSettings__yubico__validationUrls__2=
adminSettings__deleteTrashDaysAgo=
指定多少天后从回收站永久删除项目。默认为 30 天。
最近更新 20h ago
复制链接